From 56752b0e78eace31c753612c26e6567b2397bc82 Mon Sep 17 00:00:00 2001
From: AffectedArc07 <25063394+AffectedArc07@users.noreply.github.com>
Date: Sat, 7 Nov 2020 16:57:47 +0000
Subject: [PATCH] SShttp + SSdiscord | ASYNCHRONOUS STUFF IN BYOND! (#14762)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* SShttp + SSdiscord | ASYNCHRONOUS STUFF IN BYOND!
* Cleanup
* HTTP Callback example
* Fixes rust instability
* More refactors
* This works
* The sanitizer (Now worth £3000)
* New configs + other stuff
* Lets give this a shot
* Farie changes
* Mentor support
* Farie fixes
---
_build_dependencies.sh | 2 +-
code/__DEFINES/misc.dm | 9 ++
code/__DEFINES/rust_g.dm | 9 +-
code/_globalvars/logging.dm | 2 +
code/_onclick/ai.dm | 4 +-
code/controllers/configuration.dm | 58 ++++---
code/controllers/subsystem/discord.dm | 82 ++++++++++
code/controllers/subsystem/http.dm | 120 ++++++++++++++
code/controllers/subsystem/ticker.dm | 4 +-
code/datums/discord.dm | 130 +++++++++++++++
code/datums/http.dm | 151 ++++++++++++++++++
code/game/gamemodes/game_mode.dm | 2 +-
code/game/verbs/who.dm | 3 +-
code/game/world.dm | 18 ++-
code/modules/admin/db_ban/functions.dm | 10 +-
code/modules/admin/ipintel.dm | 1 +
code/modules/admin/verbs/adminhelp.dm | 78 +++------
code/modules/admin/verbs/adminpm.dm | 26 +--
code/modules/client/client_defines.dm | 11 +-
code/modules/client/client_procs.dm | 19 +--
code/modules/ext_scripts/irc.dm | 21 ---
code/modules/ext_scripts/python.dm | 9 --
code/modules/mob/logout.dm | 2 +-
code/modules/power/supermatter/supermatter.dm | 5 +-
code/modules/shuttle/emergency.dm | 2 +-
config/example/config.txt | 50 +++---
paradise.dme | 6 +-
rust_g.dll | Bin 5744640 -> 5474304 bytes
scripts/ircbot_message.py | 31 ----
29 files changed, 652 insertions(+), 213 deletions(-)
create mode 100644 code/controllers/subsystem/discord.dm
create mode 100644 code/controllers/subsystem/http.dm
create mode 100644 code/datums/discord.dm
create mode 100644 code/datums/http.dm
delete mode 100644 code/modules/ext_scripts/irc.dm
delete mode 100644 code/modules/ext_scripts/python.dm
delete mode 100644 scripts/ircbot_message.py
diff --git a/_build_dependencies.sh b/_build_dependencies.sh
index 6fb033ad07f..eaeb1716435 100644
--- a/_build_dependencies.sh
+++ b/_build_dependencies.sh
@@ -10,4 +10,4 @@ export BYOND_MAJOR=513
# Byond Minor
export BYOND_MINOR=1526
# For the RUSTG library
-export RUSTG_VERSION=2.0
+export RUSTG_VERSION=2.1-P
diff --git a/code/__DEFINES/misc.dm b/code/__DEFINES/misc.dm
index b23380098e6..04008d6779f 100644
--- a/code/__DEFINES/misc.dm
+++ b/code/__DEFINES/misc.dm
@@ -482,3 +482,12 @@
#define LINDA_SPAWN_N2O 64
#define LINDA_SPAWN_AGENT_B 128
#define LINDA_SPAWN_AIR 256
+
+/// Send to the primary Discord webhook
+#define DISCORD_WEBHOOK_PRIMARY "PRIMARY"
+
+/// Send to the admin Discord webhook
+#define DISCORD_WEBHOOK_ADMIN "ADMIN"
+
+/// Send to the mentor Discord webhook
+#define DISCORD_WEBHOOK_MENTOR "MENTOR"
diff --git a/code/__DEFINES/rust_g.dm b/code/__DEFINES/rust_g.dm
index 1a2e8a91c84..ad6f95a8654 100644
--- a/code/__DEFINES/rust_g.dm
+++ b/code/__DEFINES/rust_g.dm
@@ -20,16 +20,21 @@
#define rustg_log_write(fname, text) call(RUST_G, "log_write")(fname, text)
/proc/rustg_log_close_all() return call(RUST_G, "log_close_all")()
-// HTTP library stuff // - AA TODO: Add in SShttp
+// HTTP library stuff //
#define RUSTG_HTTP_METHOD_GET "get"
#define RUSTG_HTTP_METHOD_PUT "put"
#define RUSTG_HTTP_METHOD_DELETE "delete"
#define RUSTG_HTTP_METHOD_PATCH "patch"
#define RUSTG_HTTP_METHOD_HEAD "head"
#define RUSTG_HTTP_METHOD_POST "post"
-#define rustg_http_request_blocking(method, url, body, headers) call(RUST_G, "http_request_blocking")(method, url, body, headers)
+
+// Commented out because this thing locks up the entire DD process when you use it
+// DO NOT USE FOR THE LOVE OF GOD
+// #define rustg_http_request_blocking(method, url, body, headers) call(RUST_G, "http_request_blocking")(method, url, body, headers)
#define rustg_http_request_async(method, url, body, headers) call(RUST_G, "http_request_async")(method, url, body, headers)
#define rustg_http_check_request(req_id) call(RUST_G, "http_check_request")(req_id)
+/proc/rustg_create_async_http_client() return call(RUST_G, "start_http_client")()
+/proc/rustg_close_async_http_client() return call(RUST_G, "shutdown_http_client")()
// SQL stuff // - AA TODO: Async SQL + SSdbcore
#define rustg_sql_connect_pool(options) call(RUST_G, "sql_connect_pool")(options)
diff --git a/code/_globalvars/logging.dm b/code/_globalvars/logging.dm
index 50e70bc62a4..6c6dce80186 100644
--- a/code/_globalvars/logging.dm
+++ b/code/_globalvars/logging.dm
@@ -17,6 +17,8 @@ GLOBAL_VAR(runtime_summary_log)
GLOBAL_PROTECT(runtime_summary_log)
GLOBAL_VAR(tgui_log)
GLOBAL_PROTECT(tgui_log)
+GLOBAL_VAR(http_log)
+GLOBAL_PROTECT(http_log)
GLOBAL_LIST_EMPTY(jobMax)
GLOBAL_PROTECT(jobMax)
diff --git a/code/_onclick/ai.dm b/code/_onclick/ai.dm
index 03d34395479..07c5cefbdb3 100644
--- a/code/_onclick/ai.dm
+++ b/code/_onclick/ai.dm
@@ -52,7 +52,7 @@
add_attack_logs(src, src, "[key_name_admin(src)] might be running a modified client! (failed can_see on AI click of [A]([ADMIN_COORDJMP(pixel_turf)]))", ATKLOG_ALL)
var/message = "[key_name(src)] might be running a modified client! (failed can_see on AI click of [A]([COORD(pixel_turf)]))"
log_admin(message)
- send2irc_adminless_only("NOCHEAT", "[key_name(src)] might be running a modified client! (failed checkTurfVis on AI click of [A]([COORD(pixel_turf)]))")
+ SSdiscord.send2discord_simple_noadmins("[key_name(src)] might be running a modified client! (failed checkTurfVis on AI click of [A]([COORD(pixel_turf)]))")
var/turf_visible
@@ -65,7 +65,7 @@
if(pixel_turf.obscured)
log_admin("[key_name_admin(src)] might be running a modified client! (failed checkTurfVis on AI click of [A]([COORD(pixel_turf)])")
add_attack_logs(src, src, "[key_name_admin(src)] might be running a modified client! (failed checkTurfVis on AI click of [A]([ADMIN_COORDJMP(pixel_turf)]))", ATKLOG_ALL)
- send2irc_adminless_only("NOCHEAT", "[key_name(src)] might be running a modified client! (failed checkTurfVis on AI click of [A]([COORD(pixel_turf)]))")
+ SSdiscord.send2discord_simple_noadmins("[key_name(src)] might be running a modified client! (failed checkTurfVis on AI click of [A]([COORD(pixel_turf)]))")
return
var/list/modifiers = params2list(params)
diff --git a/code/controllers/configuration.dm b/code/controllers/configuration.dm
index 693fb42f5cb..7c54ef79a06 100644
--- a/code/controllers/configuration.dm
+++ b/code/controllers/configuration.dm
@@ -164,13 +164,6 @@
var/comms_password = ""
- var/use_irc_bot = 0
- var/list/irc_bot_host = list()
- var/main_irc = ""
- var/admin_irc = ""
- var/admin_notify_irc = ""
- var/cidrandomizer_irc = ""
-
var/default_laws = 0 //Controls what laws the AI spawns with.
var/list/station_levels = list(1) // Defines which Z-levels the station exists on.
@@ -253,6 +246,25 @@
/// BYOND account age limit for notifcations of new accounts (Any accounts older than this value will not send notifications on first join)
var/byond_account_age_threshold = 7
+ /// Are discord webhooks enabled?
+ var/discord_webhooks_enabled = FALSE
+
+ /// Role ID to be pinged for administrative events
+ var/discord_admin_role_id = null // Intentional null usage
+
+ /// Webhook URL for the main public webhook
+ var/discord_main_webhook_url
+
+ /// Webhook URL for the admin webhook
+ var/discord_admin_webhook_url
+
+ /// Webhook URL for the mentor webhook
+ var/discord_mentor_webhook_url
+
+ /// Do we want to forward all adminhelps to the discord or just ahelps when admins are offline.
+ /// (This does not mean all ahelps are pinged, only ahelps sent when staff are offline get the ping, regardless of this setting)
+ var/discord_forward_all_ahelps = FALSE
+
/datum/configuration/New()
for(var/T in subtypesof(/datum/game_mode))
var/datum/game_mode/M = T
@@ -562,9 +574,6 @@
if("allow_holidays")
config.allow_holidays = 1
- if("use_irc_bot")
- use_irc_bot = 1
-
if("ticklag")
Ticklag = text2num(value)
@@ -605,21 +614,6 @@
if("comms_password")
config.comms_password = value
- if("irc_bot_host")
- config.irc_bot_host = splittext(value, ";")
-
- if("main_irc")
- config.main_irc = value
-
- if("admin_irc")
- config.admin_irc = value
-
- if("admin_notify_irc")
- config.admin_notify_irc = value
-
- if("cidrandomizer_irc")
- config.cidrandomizer_irc = value
-
if("python_path")
if(value)
GLOB.python_path = value
@@ -746,6 +740,20 @@
config.enable_gamemode_player_limit = 1
if("byond_account_age_threshold")
config.byond_account_age_threshold = text2num(value)
+ // Discord stuff
+ if("enable_discord_webhooks")
+ discord_webhooks_enabled = TRUE
+ if("discord_webhooks_admin_role_id")
+ discord_admin_role_id = "[value]" // This MUST be a string because BYOND doesnt like massive integers
+ if("discord_webhooks_main_url")
+ discord_main_webhook_url = value
+ if("discord_webhooks_admin_url")
+ discord_admin_webhook_url = value
+ if("discord_webhooks_mentor_url")
+ discord_mentor_webhook_url = value
+ if("discord_forward_all_ahelps")
+ discord_forward_all_ahelps = TRUE
+ // End discord stuff
else
log_config("Unknown setting in configuration: '[name]'")
diff --git a/code/controllers/subsystem/discord.dm b/code/controllers/subsystem/discord.dm
new file mode 100644
index 00000000000..1360b7f9bfb
--- /dev/null
+++ b/code/controllers/subsystem/discord.dm
@@ -0,0 +1,82 @@
+SUBSYSTEM_DEF(discord)
+ name = "Discord"
+ flags = SS_NO_FIRE
+ /// Is the SS enabled
+ var/enabled = FALSE
+ /// Last time the administrator ping was dropped. This ensures administrators cannot be mass pinged if a large chunk of ahelps go off at once (IE: tesloose)
+ var/last_administration_ping = 0
+
+/datum/controller/subsystem/discord/Initialize(start_timeofday)
+ if(config.discord_webhooks_enabled)
+ enabled = TRUE
+ return ..()
+
+// This is designed for ease of simplicity for sending quick messages from parts of the code
+/datum/controller/subsystem/discord/proc/send2discord_simple(destination, content)
+ if(!enabled)
+ return
+ var/webhook_url
+ switch(destination)
+ if(DISCORD_WEBHOOK_ADMIN)
+ webhook_url = config.discord_admin_webhook_url
+ if(DISCORD_WEBHOOK_PRIMARY)
+ webhook_url = config.discord_main_webhook_url
+ if(DISCORD_WEBHOOK_MENTOR)
+ webhook_url = config.discord_mentor_webhook_url
+
+ var/datum/discord_webhook_payload/dwp = new()
+ dwp.webhook_content = content
+ SShttp.create_async_request(RUSTG_HTTP_METHOD_POST, webhook_url, dwp.serialize2json(), list("content-type" = "application/json"))
+
+// This one is designed to take in a [/datum/discord_webhook_payload] which was prepared beforehand
+/datum/controller/subsystem/discord/proc/send2discord_complex(destination, datum/discord_webhook_payload/dwp)
+ if(!enabled)
+ return
+ var/webhook_url
+ switch(destination)
+ if(DISCORD_WEBHOOK_ADMIN)
+ webhook_url = config.discord_admin_webhook_url
+ if(DISCORD_WEBHOOK_PRIMARY)
+ webhook_url = config.discord_main_webhook_url
+ SShttp.create_async_request(RUSTG_HTTP_METHOD_POST, webhook_url, dwp.serialize2json(), list("content-type" = "application/json"))
+
+// This one is for sending messages to the admin channel if no admins are active, complete with a ping to the game admins role
+/datum/controller/subsystem/discord/proc/send2discord_simple_noadmins(content, check_send_always = FALSE)
+ // Setup some stuff
+ var/alerttext
+ var/list/admincounter = staff_countup(R_BAN)
+ var/active_admins = admincounter[1]
+ var/inactive_admins = admincounter[3]
+ var/add_ping = TRUE
+
+ if(active_admins <= 0)
+ if(inactive_admins > 0)
+ alerttext = " | **ALL ADMINS AFK**"
+ else
+ alerttext = " | **NO ADMINS ONLINE**"
+ else
+ if(check_send_always && config.discord_forward_all_ahelps)
+ // If we are here, there are admins online. We want to forward everything, but obviously dont want to add a ping, so we do this
+ add_ping = FALSE
+ else
+ // We have active admins, we dont care about the rest of this proc
+ return
+
+ var/message = "[content] [alerttext] [add_ping ? handle_administrator_ping() : ""]"
+
+ var/datum/discord_webhook_payload/dwp = new()
+ dwp.webhook_content = message
+
+ SShttp.create_async_request(RUSTG_HTTP_METHOD_POST, config.discord_admin_webhook_url, dwp.serialize2json(), list("content-type" = "application/json"))
+
+// Helper to make administrator ping easier
+/datum/controller/subsystem/discord/proc/handle_administrator_ping()
+ // Check if a role is even set
+ if(config.discord_admin_role_id)
+ if(last_administration_ping > world.time)
+ return "*(Role pinged recently)*"
+
+ last_administration_ping = world.time + 60 SECONDS
+ return "<@&[config.discord_admin_role_id]>"
+
+ return "*(Role not configured)*"
diff --git a/code/controllers/subsystem/http.dm b/code/controllers/subsystem/http.dm
new file mode 100644
index 00000000000..3a857f76137
--- /dev/null
+++ b/code/controllers/subsystem/http.dm
@@ -0,0 +1,120 @@
+SUBSYSTEM_DEF(http)
+ name = "HTTP"
+ flags = SS_TICKER | SS_BACKGROUND // Measure in ticks, but also only run if we have the spare CPU. We also dont init.
+ wait = 1
+ runlevels = RUNLEVELS_DEFAULT | RUNLEVEL_LOBBY // All the time
+ // Assuming for the worst, since only discord is hooked into this for now, but that may change
+ offline_implications = "The server is no longer capable of making async HTTP requests. Shuttle call recommended."
+ /// List of all async HTTP requests in the processing chain
+ var/list/datum/http_request/active_async_requests
+ /// Variable to define if logging is enabled or not. Disabled by default since we know the requests the server is making. Enable with VV if you need to debug requests
+ var/logging_enabled = FALSE
+
+/datum/controller/subsystem/http/Initialize(start_timeofday)
+ rustg_create_async_http_client() // Open the door
+ active_async_requests = list()
+ return ..()
+
+/datum/controller/subsystem/http/fire(resumed)
+ for(var/r in active_async_requests)
+ var/datum/http_request/req = r
+ // Check if we are complete
+ if(req.is_complete())
+ // If so, take it out the processing list
+ active_async_requests -= req
+ var/datum/http_response/res = req.into_response()
+
+ // If the request has a callback, invoke it.Async of course to avoid choking the SS
+ if(req.cb)
+ req.cb.InvokeAsync(res)
+
+ // And log the result
+ if(logging_enabled)
+ var/list/log_data = list()
+ log_data += "BEGIN ASYNC RESPONSE (ID: [req.id])"
+ if(res.errored)
+ log_data += "\t ----- RESPONSE ERRROR -----"
+ log_data += "\t [res.error]"
+ else
+ log_data += "\tResponse status code: [res.status_code]"
+ log_data += "\tResponse body: [res.body]"
+ log_data += "\tResponse headers: [json_encode(res.headers)]"
+ log_data += "END ASYNC RESPONSE (ID: [req.id])"
+ rustg_log_write(GLOB.http_log, log_data.Join("\n[GLOB.log_end]"))
+
+/**
+ * Async request creator
+ *
+ * Generates an async request, and adds it to the subsystem's processing list
+ * These should be used as they do not lock the entire DD process up as they execute inside their own thread pool inside RUSTG
+ */
+/datum/controller/subsystem/http/proc/create_async_request(method, url, body = "", list/headers, datum/callback/proc_callback)
+ var/datum/http_request/req = new()
+ req.prepare(method, url, body, headers)
+ if(proc_callback)
+ req.cb = proc_callback
+
+ // Begin it and add it to the SS active list
+ req.begin_async()
+ active_async_requests += req
+
+ if(logging_enabled)
+ // Create a log holder
+ var/list/log_data = list()
+ log_data += "BEGIN ASYNC REQUEST (ID: [req.id])"
+ log_data += "\t[uppertext(req.method)] [req.url]"
+ log_data += "\tRequest body: [req.body]"
+ log_data += "\tRequest headers: [req.headers]"
+ log_data += "END ASYNC REQUEST (ID: [req.id])"
+
+ // Write the log data
+ rustg_log_write(GLOB.http_log, log_data.Join("\n[GLOB.log_end]"))
+
+/**
+ * Blocking request creator
+ *
+ * Generates a blocking request, executes it, logs the info then cleanly returns the response
+ * Exists as a proof of concept, and should never be used
+ */
+/datum/controller/subsystem/http/proc/make_blocking_request(method, url, body = "", list/headers)
+ CRASH("Attempted use of a blocking HTTP request")
+ /*
+ var/datum/http_request/req = new()
+ req.prepare(method, url, body, headers)
+ req.execute_blocking()
+ var/datum/http_response/res = req.into_response()
+
+ // Now generate a logfile
+ var/list/log_data = list()
+ log_data += "NEW BLOCKING REQUEST"
+ log_data += "\t[uppertext(req.method)] [req.url]"
+ log_data += "\tRequest body: [req.body]"
+ log_data += "\tRequest headers: [req.headers]"
+ if(res.errored)
+ log_data += "\t ----- RESPONSE ERRROR -----"
+ log_data += "\t [res.error]"
+ else
+ log_data += "\tResponse status code: [res.status_code]"
+ log_data += "\tResponse body: [res.body]"
+ log_data += "\tResponse headers: [json_encode(res.headers)]"
+ log_data += "END BLOCKING REQUEST"
+
+ // Write the log data
+ rustg_log_write(GLOB.http_log, log_data.Join("\n[GLOB.log_end]"))
+
+ return res
+ */
+
+/*
+
+ Example of how to use callbacks properly
+
+/client/verb/testing()
+ set name = "Testing"
+
+ var/datum/callback/cb = CALLBACK(src, /client/.proc/response, usr)
+ SShttp.create_async_request(RUSTG_HTTP_METHOD_GET, "http://site.domain/page.html", proc_callback=cb)
+
+/client/proc/response(mob/user, datum/http_response/response)
+ to_chat(user, "Code: [response.status_code] | Content: [response.body]")
+*/
diff --git a/code/controllers/subsystem/ticker.dm b/code/controllers/subsystem/ticker.dm
index 3a1ba7595c0..d4bbf0fd9e3 100644
--- a/code/controllers/subsystem/ticker.dm
+++ b/code/controllers/subsystem/ticker.dm
@@ -276,9 +276,7 @@ SUBSYSTEM_DEF(ticker)
//start_events() //handles random events and space dust.
//new random event system is handled from the MC.
- var/list/admins_number = staff_countup(R_BAN)
- if(admins_number[1] == 0 && admins_number[3] == 0)
- send2irc(config.admin_notify_irc, "Round has started with no admins online.")
+ SSdiscord.send2discord_simple_noadmins("Round has started")
auto_toggle_ooc(0) // Turn it off
round_start_time = world.time
diff --git a/code/datums/discord.dm b/code/datums/discord.dm
new file mode 100644
index 00000000000..48550b6a7b9
--- /dev/null
+++ b/code/datums/discord.dm
@@ -0,0 +1,130 @@
+/********************************************************************************************************
+* DO NOT EDIT ANYTHING IN HERE WITHOUT CHECKING THE DISCORD API SPEC AND TESTING THE JSON POST FORMAT *
+* OTHERWISE, YOU **WILL** BREAK STUFF -aa *************************************************************
+********************************************/
+
+/**
+ * # Discord Webhook Payload
+ *
+ * Holder datum for discord webhook POST send data
+ *
+ * Holds all information that a webhook would need,
+ * as well as a method to serialize the entire thing into JSON.
+ * See https://discord.com/developers/docs/resources/webhook#execute-webhook-jsonform-params
+ */
+/datum/discord_webhook_payload
+ /// Name the webhook user should post as
+ var/webhook_name
+ /// Content of the webhook message
+ var/webhook_content
+ /// List of all embed objects in the message
+ var/list/datum/discord_embed/embeds
+
+/datum/discord_webhook_payload/New()
+ embeds = list()
+
+/**
+ * Webhook Serializer
+ *
+ * Converts the DM webhook object into JSON for a POST request.
+ * Not called serialize() because thats a proc at the /datum level already
+ */
+/datum/discord_webhook_payload/proc/serialize2json()
+ var/list/json = list()
+ if(webhook_name)
+ json["username"] = webhook_name
+ if(webhook_content)
+ var/sanitized_content = webhook_content
+ sanitized_content = replacetext(sanitized_content, "@everyone", "(Attempted atEveryone)")
+ sanitized_content = replacetext(sanitized_content, "@here", "(Attempted atHere)")
+ json["content"] = sanitized_content
+
+ // Now serialize the embeds
+ if(length(embeds))
+ json["embeds"] = list()
+ if(length(embeds) > 10)
+ embeds.Cut(11) // Cut to 10 embeds because thats the limit of the Discord API
+
+ for(var/e in embeds)
+ var/datum/discord_embed/embed = e
+ json["embeds"] += list(embed.serialize2list())
+
+ return json_encode(json)
+
+/**
+ * # Discord Embed
+ *
+ * Holder datum for discord embeds
+ *
+ * Used in [/datum/discord_webhook_payload] and serves as a code-first means to add an embed.
+ * See https://discord.com/developers/docs/resources/channel#embed-object
+ */
+/datum/discord_embed
+ /// Title of the embed
+ var/embed_title
+ /// Content of the embed
+ var/embed_content
+ /// Colour of the strip on the side of the embed. Must be in hexadecimal WITHOUT leading hash
+ var/embed_colour
+ /// Timestamp the embed was sent at. Must be in 8601 format. Will be autoset on /New()
+ var/embed_timestamp
+ /// List of all fields in the embed
+ var/list/datum/discord_embed_field/fields
+
+/datum/discord_embed/New()
+ embed_timestamp = time_stamp() // 8601 is king
+ fields = list() // Initialize the list
+
+/**
+ * Embed Serializer
+ *
+ * Converts the DM embed object into JSON for a POST request.
+ * Not called serialize() because thats a proc at the /datum level already
+ */
+/datum/discord_embed/proc/serialize2list()
+ var/list/json = list()
+ // All these fields can be nulled so presence check them all
+ if(embed_title)
+ json["title"] = embed_title
+ if(embed_content)
+ json["description"] = embed_content
+ if(embed_colour)
+ json["color"] = hex2num(embed_colour)
+ json["timestamp"] = embed_timestamp
+
+ // Now serialize the fields
+ if(length(fields))
+ json["fields"] = list()
+ for(var/f in fields)
+ var/datum/discord_embed_field/field = f
+ json["fields"] += list(field.serialize2list())
+
+ return json
+
+/**
+ * # Discord Embed Field
+ *
+ * Holder datum for discord embed fields
+ *
+ * Used in [/datum/discord_embed] and serves as a code-first means to add fields to an embed
+ * See https://discord.com/developers/docs/resources/channel#embed-object-embed-field-structure
+ */
+/datum/discord_embed_field
+ /// Name of the field
+ var/field_name
+ /// Content of the field
+ var/field_content
+ /// Inline flag
+ var/inline = TRUE
+
+/datum/discord_embed_field/proc/serialize2list()
+ // name and content CANNOT be nulled, so assert them
+ ASSERT(field_name)
+ ASSERT(field_content)
+ // Now serialize
+ var/list/json = list()
+ json["name"] = field_name
+ json["value"] = field_content
+ json["inline"] = inline ? "true" : "false" // Yes this has to be text IN THIS EXACT FORMAT. NO TOUCH.
+
+ return json
diff --git a/code/datums/http.dm b/code/datums/http.dm
new file mode 100644
index 00000000000..e7ba1620854
--- /dev/null
+++ b/code/datums/http.dm
@@ -0,0 +1,151 @@
+/**
+ * # HTTP Request
+ *
+ * Holder datum for ingame HTTP requests
+ *
+ * Holds information regarding to methods used, URL, and response,
+ * as well as job IDs and progress tracking for async requests
+ */
+/datum/http_request
+ /// The ID of the request (Only set if it is an async request)
+ var/id
+ /// Is the request in progress? (Only set if it is an async request)
+ var/in_progress = FALSE
+ /// HTTP method used
+ var/method
+ /// Body of the request being sent
+ var/body
+ /// Request headers being sent
+ var/headers
+ /// URL that the request is being sent to
+ var/url
+ /// The raw response, which will be decoeded into a [/datum/http_response]
+ var/_raw_response
+ /// Callback for executing after async requests. Will be called with an argument of [/datum/http_response] as first argument
+ var/datum/callback/cb
+
+/*
+###########################################################################
+THE METHODS IN THIS FILE ARE TO BE USED BY THE SUBSYSTEM AS A MANGEMENT HUB
+----------------------- DO NOT MANUALLY INVOKE THEM -----------------------
+###########################################################################
+*/
+
+/**
+ * Preparation handler
+ *
+ * Call this with relevant parameters to form the request you want to make
+ *
+ * Arguments:
+ * * _method - HTTP Method to use, see code/__DEFINES/rust_g.dm for a full list
+ * * _url - The URL to send the request to
+ * * _body - The body of the request, if applicable
+ * * _headers - Associative list of HTTP headers to send, if applicab;e
+ */
+/datum/http_request/proc/prepare(_method, _url, _body = "", list/_headers)
+ if(!length(_headers))
+ headers = ""
+ else
+ headers = json_encode(_headers)
+
+ method = _method
+ url = _url
+ body = _body
+
+/**
+ * Blocking executor
+ *
+ * Remains as a proof of concept to show it works, but should NEVER be used to do FFI halting the entire DD process up
+ * Async rqeuests are much preferred, but also require the subsystem to be firing for them to be answered
+ */
+/datum/http_request/proc/execute_blocking()
+ CRASH("Attempted to execute a blocking HTTP request")
+ // _raw_response = rustg_http_request_blocking(method, url, body, headers)
+
+/**
+ * Async execution starter
+ *
+ * Tells the request to start executing inside its own thread inside RUSTG
+ * Preferred over blocking, but also requires SShttp to be active
+ * As such, you cannot use this for events which may happen at roundstart (EG: IPIntel, BYOND account tracking, etc)
+ */
+/datum/http_request/proc/begin_async()
+ if(in_progress)
+ CRASH("Attempted to re-use a request object.")
+
+ id = rustg_http_request_async(method, url, body, headers)
+
+ if(isnull(text2num(id)))
+ _raw_response = "Proc error: [id]"
+ CRASH("Proc error: [id]")
+ else
+ in_progress = TRUE
+
+/**
+ * Async completion checker
+ *
+ * Checks if an async request has been complete
+ * Has safety checks built in to compensate if you call this on blocking requests,
+ * or async requests which have already finished
+ */
+/datum/http_request/proc/is_complete()
+ // If we dont have an ID, were blocking, so assume complete
+ if(isnull(id))
+ return TRUE
+
+ // If we arent in progress, assume complete
+ if(!in_progress)
+ return TRUE
+
+ // We got here, so check the status
+ var/result = rustg_http_check_request(id)
+
+ // If we have no result, were not finished
+ if(result == RUSTG_JOB_NO_RESULTS_YET)
+ return FALSE
+ else
+ // If we got here, we have a result to parse
+ _raw_response = result
+ in_progress = FALSE
+ return TRUE
+
+/**
+ * Response deserializer
+ *
+ * Takes a HTTP request object, and converts it into a [/datum/http_response]
+ * The entire thing is wrapped in try/catch to ensure it doesnt break on invalid requests
+ * Can be called on async and blocking requests
+ */
+/datum/http_request/proc/into_response()
+ var/datum/http_response/R = new()
+
+ try
+ var/list/L = json_decode(_raw_response)
+ R.status_code = L["status_code"]
+ R.headers = L["headers"]
+ R.body = L["body"]
+ catch
+ R.errored = TRUE
+ R.error = _raw_response
+
+ return R
+
+/**
+ * # HTTP Response
+ *
+ * Holder datum for HTTP responses
+ *
+ * Created from calling [/datum/http_request/proc/into_response()]
+ * Contains vars about the result of the response
+ */
+/datum/http_response
+ /// The HTTP status code of the response
+ var/status_code
+ /// The body of the response from the server
+ var/body
+ /// Associative list of headers sent from the server
+ var/list/headers
+ /// Has the request errored
+ var/errored = FALSE
+ /// Raw response if we errored
+ var/error
diff --git a/code/game/gamemodes/game_mode.dm b/code/game/gamemodes/game_mode.dm
index 8757fa00d4f..e52721c29e3 100644
--- a/code/game/gamemodes/game_mode.dm
+++ b/code/game/gamemodes/game_mode.dm
@@ -209,7 +209,7 @@
if(escaped_on_pod_5 > 0)
feedback_set("escaped_on_pod_5",escaped_on_pod_5)
- send2mainirc("A round of [src.name] has ended - [surviving_total] survivors, [ghosts] ghosts.")
+ SSdiscord.send2discord_simple(DISCORD_WEBHOOK_PRIMARY, "A round of [name] has ended - [surviving_total] survivors, [ghosts] ghosts.")
return 0
diff --git a/code/game/verbs/who.dm b/code/game/verbs/who.dm
index 95b11353b86..a31ae85a5bd 100644
--- a/code/game/verbs/who.dm
+++ b/code/game/verbs/who.dm
@@ -126,5 +126,6 @@
modmsg += "\t[C] is a [C.holder.rank]\n"
num_mods_online++
- msg = "Current Admins ([num_admins_online]):\n" + msg + "\nCurrent Mentors ([num_mods_online]):\n" + modmsg
+ var/noadmins_info = "\nIf no admins or mentors are online, make a ticket anyways. Adminhelps and mentorhelps will be relayed to discord, and staff will still be informed."
+ msg = "Current Admins ([num_admins_online]):\n" + msg + "\nCurrent Mentors ([num_mods_online]):\n" + modmsg + noadmins_info
to_chat(src, msg)
diff --git a/code/game/world.dm b/code/game/world.dm
index 936a66ed18b..a25ba837cc3 100644
--- a/code/game/world.dm
+++ b/code/game/world.dm
@@ -193,13 +193,14 @@ GLOBAL_VAR_INIT(world_topic_spam_protect_time, world.timeofday)
if(!C)
return "No client with that name on server"
- var/message = "IRC-Admin PM from [C.holder ? "IRC-" + input["sender"] : "Administrator"]: [input["msg"]]"
- var/amessage = "IRC-Admin PM from IRC-[input["sender"]] to [key_name(C)] : [input["msg"]]"
+ var/message = "Discord PM from [input["sender"]]: [input["msg"]]"
+ var/amessage = "Discord PM from [input["sender"]] to [key_name(C)]: [input["msg"]]"
- C.received_irc_pm = world.time
- C.irc_admin = input["sender"]
+ // THESE TWO VARS DO VERY DIFFERENT THINGS. DO NOT ATTEMPT TO COMBINE THEM
+ C.received_discord_pm = world.time
+ C.last_discord_pm_time = 0
- C << 'sound/effects/adminhelp.ogg'
+ SEND_SOUND(C, 'sound/effects/adminhelp.ogg')
to_chat(C, message)
for(var/client/A in GLOB.admins)
@@ -448,11 +449,13 @@ GLOBAL_VAR_INIT(failed_old_db_connections, 0)
GLOB.world_qdel_log = "[GLOB.log_directory]/qdel.log"
GLOB.world_asset_log = "[GLOB.log_directory]/asset.log"
GLOB.tgui_log = "[GLOB.log_directory]/tgui.log"
+ GLOB.http_log = "[GLOB.log_directory]/http.log"
start_log(GLOB.world_game_log)
start_log(GLOB.world_href_log)
start_log(GLOB.world_runtime_log)
start_log(GLOB.world_qdel_log)
start_log(GLOB.tgui_log)
+ start_log(GLOB.http_log)
// This log follows a special format and this path should NOT be used for anything else
GLOB.runtime_summary_log = "data/logs/runtime_summary.log"
@@ -515,3 +518,8 @@ GLOBAL_VAR_INIT(failed_old_db_connections, 0)
var/dll = world.GetConfig("env", "EXTOOLS_DLL")
if (dll)
call(dll, "debug_initialize")()
+
+
+/world/Del()
+ rustg_close_async_http_client() // Close the HTTP client. If you dont do this, youll get phantom threads which can crash DD from memory access violations
+ ..()
diff --git a/code/modules/admin/db_ban/functions.dm b/code/modules/admin/db_ban/functions.dm
index fd998677d75..87afbcd7b4b 100644
--- a/code/modules/admin/db_ban/functions.dm
+++ b/code/modules/admin/db_ban/functions.dm
@@ -12,7 +12,7 @@
var/bantype_pass = 0
var/bantype_str
var/maxadminbancheck //Used to limit the number of active bans of a certein type that each admin can give. Used to protect against abuse or mutiny.
- var/announceinirc //When set, it announces the ban in irc. Intended to be a way to raise an alarm, so to speak.
+ var/announce_in_discord = FALSE //When set, it announces the ban in irc. Intended to be a way to raise an alarm, so to speak.
var/blockselfban //Used to prevent the banning of yourself.
var/kickbannedckey //Defines whether this proc should kick the banned person, if they are connected (if banned_mob is defined).
//some ban types kick players after this proc passes (tempban, permaban), but some are specific to db_ban, so
@@ -46,14 +46,14 @@
duration = -1
bantype_pass = 1
maxadminbancheck = 1
- announceinirc = 1
+ announce_in_discord = TRUE
blockselfban = 1
kickbannedckey = 1
if(BANTYPE_ADMIN_TEMP)
bantype_str = "ADMIN_TEMPBAN"
bantype_pass = 1
maxadminbancheck = 1
- announceinirc = 1
+ announce_in_discord = TRUE
blockselfban = 1
kickbannedckey = 1
@@ -141,8 +141,8 @@
to_chat(usr, "Ban saved to database.")
message_admins("[key_name_admin(usr)] has added a [bantype_str] for [ckey] [(job)?"([job])":""] [(duration > 0)?"([duration] minutes)":""] with the reason: \"[reason]\" to the ban database.",1)
- if(announceinirc)
- send2irc("BAN ALERT","[a_ckey] applied a [bantype_str] on [ckey]")
+ if(announce_in_discord)
+ SSdiscord.send2discord_simple(DISCORD_WEBHOOK_ADMIN, "**BAN ALERT** [a_ckey] applied a [bantype_str] on [ckey]")
if(kickbannedckey)
if(banned_mob && banned_mob.client && banned_mob.client.ckey == banckey)
diff --git a/code/modules/admin/ipintel.dm b/code/modules/admin/ipintel.dm
index 8bfce6c05f0..40acc051b7d 100644
--- a/code/modules/admin/ipintel.dm
+++ b/code/modules/admin/ipintel.dm
@@ -82,6 +82,7 @@
if(!SSipintel.enabled)
return
+ // Do not refactor this to use SShttp, because that requires the subsystem to be firing for requests to be made, and this will be triggered before the MC has finished loading
var/list/http[] = world.Export("http://[config.ipintel_domain]/check.php?ip=[ip]&contact=[config.ipintel_email]&format=json&flags=b")
if(http)
diff --git a/code/modules/admin/verbs/adminhelp.dm b/code/modules/admin/verbs/adminhelp.dm
index 4289df8ffbc..324899028fc 100644
--- a/code/modules/admin/verbs/adminhelp.dm
+++ b/code/modules/admin/verbs/adminhelp.dm
@@ -34,62 +34,30 @@ GLOBAL_LIST_INIT(adminhelp_ignored_words, list("unknown","the","a","an","of","mo
else
SStickets.newHelpRequest(src, msg)
- //See how many staff are on
- var/admin_number_afk = 0
- var/list/mentorholders = list()
- var/list/modholders = list()
- var/list/adminholders = list()
- for(var/client/X in GLOB.admins)
- if(check_rights(R_ADMIN, 0, X.mob))
- if(X.is_afk())
- admin_number_afk++
- adminholders += X
- continue
- if(check_rights(R_MOD, 0, X.mob))
- modholders += X
- continue
- if(check_rights(R_MENTOR, 0, X.mob))
- mentorholders += X
- continue
-
//show it to the person adminhelping too
to_chat(src, "[selected_type]: [msg]")
-
- var/admin_number_present = adminholders.len - admin_number_afk
- log_admin("[selected_type]: [key_name(src)]: [msg] - heard by [admin_number_present] non-AFK admins.")
- if(admin_number_present <= 0)
- if(!admin_number_afk)
- send2adminirc("[selected_type] from [key_name(src)]: [msg] - !!No admins online!!")
- else
- send2adminirc("[selected_type] from [key_name(src)]: [msg] - !!All admins AFK ([admin_number_afk])!!")
- else
- send2adminirc("[selected_type] from [key_name(src)]: [msg]")
feedback_add_details("admin_verb","AH") //If you are copy-pasting this, ensure the 2nd parameter is unique to the new proc!
- return
-/proc/send2irc_adminless_only(source, msg, requiredflags = R_BAN)
- var/admin_number_total = 0 //Total number of admins
- var/admin_number_afk = 0 //Holds the number of admins who are afk
- var/admin_number_ignored = 0 //Holds the number of admins without +BAN (so admins who are not really admins)
- var/admin_number_decrease = 0 //Holds the number of admins with are afk, ignored or both
- for(var/client/X in GLOB.admins)
- admin_number_total++
- var/invalid = 0
- if(requiredflags != 0 && !check_rights_for(X, requiredflags))
- admin_number_ignored++
- invalid = 1
- if(X.is_afk())
- admin_number_afk++
- invalid = 1
- if(X.holder.fakekey)
- admin_number_ignored++
- invalid = 1
- if(invalid)
- admin_number_decrease++
- var/admin_number_present = admin_number_total - admin_number_decrease //Number of admins who are neither afk nor invalid
- if(admin_number_present <= 0)
- if(!admin_number_afk && !admin_number_ignored)
- send2irc(source, "[msg] - No admins online")
- else
- send2irc(source, "[msg] - All admins AFK ([admin_number_afk]/[admin_number_total]) or skipped ([admin_number_ignored]/[admin_number_total])")
- return admin_number_present
+ switch(selected_type)
+ if("Adminhelp")
+ //See how many staff are on
+ var/list/admincount = staff_countup(R_BAN)
+ var/active_admins = admincount[1]
+
+ log_admin("[selected_type]: [key_name(src)]: [msg] - heard by [active_admins] non-AFK admins.")
+ SSdiscord.send2discord_simple_noadmins("[selected_type] from [key_name(src)]: [msg]", check_send_always = TRUE)
+
+ if("Mentorhelp")
+ var/alerttext
+ var/list/mentorcount = staff_countup(R_MENTOR)
+ var/active_mentors = mentorcount[1]
+ var/inactive_mentors = mentorcount[3]
+
+ if(active_mentors <= 0)
+ if(inactive_mentors > 0)
+ alerttext = " | **ALL MENTORS AFK**"
+ else
+ alerttext = " | **NO MENTORS ONLINE**"
+
+ log_admin("[selected_type]: [key_name(src)]: [msg] - heard by [active_mentors] non-AFK mentors.")
+ SSdiscord.send2discord_simple(DISCORD_WEBHOOK_MENTOR, "[key_name(src)]: [msg][alerttext]")
diff --git a/code/modules/admin/verbs/adminpm.dm b/code/modules/admin/verbs/adminpm.dm
index 48c407e6866..c3b0c9e2ae7 100644
--- a/code/modules/admin/verbs/adminpm.dm
+++ b/code/modules/admin/verbs/adminpm.dm
@@ -211,34 +211,40 @@
i.addResponse(src, msg)
return
-
-/client/proc/cmd_admin_irc_pm()
+/client/proc/cmd_admin_discord_pm()
if(prefs.muted & MUTE_ADMINHELP)
- to_chat(src, "Error: Private-Message: You are unable to use PM-s (muted).")
+ to_chat(src, "Error: Private-Message: You are unable to use PMs (muted).")
return
- var/msg = clean_input("Message:", "Private message to admins on IRC / 400 character limit", , src)
+ if(last_discord_pm_time > world.time)
+ to_chat(usr, "Please wait [(last_discord_pm_time - world.time)/10] seconds, or for a reply, before sending another PM to Discord.")
+ return
+
+ // We only allow PMs once every 10 seconds, othewrise the channel can get spammed very quickly
+ last_discord_pm_time = world.time + 10 SECONDS
+
+ var/msg = clean_input("Message:", "Private message to admins on Discord / 400 character limit", , src)
if(!msg)
return
sanitize(msg)
- if(length(msg) > 400) // TODO: if message length is over 400, divide it up into seperate messages, the message length restriction is based on IRC limitations. Probably easier to do this on the bots ends.
+ if(length(msg) > 400) // Dont want them super spamming
to_chat(src, "Your message was not sent because it was more then 400 characters find your message below for ease of copy/pasting")
to_chat(src, "[msg]")
return
- send2adminirc("PlayerPM from [key_name(src)]: [html_decode(msg)]")
+ SSdiscord.send2discord_simple(DISCORD_WEBHOOK_ADMIN, "PM from [key_name(src)]: [html_decode(msg)]")
- to_chat(src, "IRC PM to-IRC-Admins: [msg]")
+ to_chat(src, "PM to-Discord Admins: [msg]")
- log_admin("PM: [key_name(src)]->IRC: [msg]")
+ log_admin("PM: [key_name(src)]->Discord: [msg]")
for(var/client/X in GLOB.admins)
if(X == src)
continue
- if(check_rights(R_ADMIN|R_MOD|R_MENTOR, 0, X.mob))
- to_chat(X, "PM: [key_name(src, TRUE, 0)]->IRC-Admins: [msg]")
+ if(check_rights(R_ADMIN, 0, X.mob))
+ to_chat(X, "PM: [key_name_admin(src)]->Discord Admins: [msg]")
/client/verb/open_pms_ui()
set name = "My PMs"
diff --git a/code/modules/client/client_defines.dm b/code/modules/client/client_defines.dm
index bf15eb66303..70e50610352 100644
--- a/code/modules/client/client_defines.dm
+++ b/code/modules/client/client_defines.dm
@@ -43,9 +43,6 @@
// comment out the line below when debugging locally to enable the options & messages menu
//control_freak = 1
- var/received_irc_pm = -99999
- var/irc_admin //IRC admin that spoke with them last.
- var/mute_irc = 0
var/ssd_warning_acknowledged = FALSE
////////////////////////////////////
@@ -99,3 +96,11 @@
var/byondacc_date
/// Days since the client's BYOND account was created
var/byondacc_age = 0
+
+
+ // Do not attempt to merge these vars together. They are for different things
+ /// Last world.time that a PM was send to discord by a player
+ var/last_discord_pm_time = 0
+
+ /// Last world/time that a PM was sent to the player by an admin
+ var/received_discord_pm = -99999 // Yes this super low number is intentional
diff --git a/code/modules/client/client_procs.dm b/code/modules/client/client_procs.dm
index 4009d2fb835..8458ac77595 100644
--- a/code/modules/client/client_procs.dm
+++ b/code/modules/client/client_procs.dm
@@ -113,14 +113,14 @@
cmd_admin_pm(ckey_txt, null, href_list["type"])
return
- if(href_list["irc_msg"])
- if(!holder && received_irc_pm < world.time - 6000) //Worse they can do is spam IRC for 10 minutes
- to_chat(usr, "You are no longer able to use this, it's been more then 10 minutes since an admin on IRC has responded to you")
+ if(href_list["discord_msg"])
+ if(!holder && received_discord_pm < world.time - 6000) // Worse they can do is spam discord for 10 minutes
+ to_chat(usr, "You are no longer able to use this, it's been more then 10 minutes since an admin on Discord has responded to you")
return
- if(mute_irc)
- to_chat(usr, "")
+ if(prefs.muted & MUTE_ADMINHELP)
+ to_chat(usr, "You cannot use this as your client has been muted from sending messages to the admins on Discord")
return
- cmd_admin_irc_pm()
+ cmd_admin_discord_pm()
return
@@ -561,7 +561,7 @@
var/watchreason = check_watchlist(ckey)
if(watchreason)
message_admins("Notice: [key_name_admin(src)] is on the watchlist and has just connected - Reason: [watchreason]")
- send2irc(config.admin_notify_irc, "Watchlist - [key_name(src)] is on the watchlist and has just connected - Reason: [watchreason]")
+ SSdiscord.send2discord_simple_noadmins("**\[Watchlist]** [key_name(src)] is on the watchlist and has just connected - Reason: [watchreason]")
//Just the standard check to see if it's actually a number
@@ -760,7 +760,7 @@
if(!cidcheck_failedckeys[ckey])
message_admins("[key_name(src)] has been detected as using a CID randomizer. Connection rejected.")
- send2irc(config.cidrandomizer_irc, "[key_name(src)] has been detected as using a CID randomizer. Connection rejected.")
+ SSdiscord.send2discord_simple_noadmins("[key_name(src)] has been detected as using a CID randomizer. Connection rejected.")
cidcheck_failedckeys[ckey] = TRUE
note_randomizer_user()
@@ -773,7 +773,7 @@
if(cidcheck_failedckeys[ckey])
// Atonement
message_admins("[key_name_admin(src)] has been allowed to connect after showing they removed their cid randomizer")
- send2irc(config.cidrandomizer_irc, "[key_name(src)] has been allowed to connect after showing they removed their cid randomizer.")
+ SSdiscord.send2discord_simple_noadmins("[key_name(src)] has been allowed to connect after showing they removed their cid randomizer.")
cidcheck_failedckeys -= ckey
if (cidcheck_spoofckeys[ckey])
message_admins("[key_name_admin(src)] has been allowed to connect after appearing to have attempted to spoof a cid randomizer check because it appears they aren't spoofing one this time")
@@ -988,6 +988,7 @@
* Returns the data in a parsed, associative list
*/
/client/proc/retrieve_byondacc_data()
+ // Do not refactor this to use SShttp, because that requires the subsystem to be firing for requests to be made, and this will be triggered before the MC has finished loading
var/list/http[] = world.Export("http://www.byond.com/members/[ckey]?format=text")
if(http)
var/status = text2num(http["STATUS"])
diff --git a/code/modules/ext_scripts/irc.dm b/code/modules/ext_scripts/irc.dm
deleted file mode 100644
index 7f87413694a..00000000000
--- a/code/modules/ext_scripts/irc.dm
+++ /dev/null
@@ -1,21 +0,0 @@
-/proc/send2irc(var/channel, var/msg, var/lesser_sanitize = FALSE)
- if(config.use_irc_bot && config.irc_bot_host.len)
- for(var/IP in config.irc_bot_host)
- spawn(0)
- if(lesser_sanitize == 7355608) // Super random number because this could be bad if done accidentally
- // Runs sanitization but allows <> and // (Needed for discord)
- ext_python("ircbot_message.py", "[config.comms_password] [IP] [channel] [not_as_paranoid_sanitize(msg)]")
- else
- // I have no means of trusting you, cmd
- ext_python("ircbot_message.py", "[config.comms_password] [IP] [channel] [paranoid_sanitize(msg)]")
- return
-
-/proc/send2mainirc(var/msg, var/lesser_sanitize = FALSE)
- if(config.main_irc)
- send2irc(config.main_irc, msg, lesser_sanitize)
- return
-
-/proc/send2adminirc(var/msg)
- if(config.admin_irc)
- send2irc(config.admin_irc, msg)
- return
diff --git a/code/modules/ext_scripts/python.dm b/code/modules/ext_scripts/python.dm
deleted file mode 100644
index bee1244b94b..00000000000
--- a/code/modules/ext_scripts/python.dm
+++ /dev/null
@@ -1,9 +0,0 @@
-/proc/ext_python(var/script, var/args, var/scriptsprefix = 1)
- if(scriptsprefix) script = "scripts/" + script
-
- if(world.system_type == MS_WINDOWS)
- script = replacetext(script, "/", "\\")
-
- var/command = GLOB.python_path + " " + script + " " + args
- shell("[command]")
- return
diff --git a/code/modules/mob/logout.dm b/code/modules/mob/logout.dm
index 91bf5f0ab9c..041fa87807b 100644
--- a/code/modules/mob/logout.dm
+++ b/code/modules/mob/logout.dm
@@ -15,7 +15,7 @@
message_admins("Admin logout: [key_name_admin(src)]")
var/list/admincounter = staff_countup(R_BAN)
if(admincounter[1] == 0) // No active admins
- send2irc(config.admin_notify_irc, "[key_name(src)] logged out - No active admins, [admincounter[2]] non-admin staff, [admincounter[3]] inactive staff.")
+ SSdiscord.send2discord_simple(DISCORD_WEBHOOK_ADMIN, "[key_name(src)] logged out - No active admins, [admincounter[2]] non-admin staff, [admincounter[3]] inactive staff.")
..()
update_morgue()
diff --git a/code/modules/power/supermatter/supermatter.dm b/code/modules/power/supermatter/supermatter.dm
index 844615d5be7..84f32308964 100644
--- a/code/modules/power/supermatter/supermatter.dm
+++ b/code/modules/power/supermatter/supermatter.dm
@@ -121,13 +121,12 @@
aw_emerg = status_adminwarn_check(SUPERMATTER_EMERGENCY, aw_emerg, "CRIT: Supermatter integrity is below 50%!(JMP).", FALSE)
aw_delam = status_adminwarn_check(SUPERMATTER_DELAMINATING, aw_delam, "CRIT: Supermatter is delaminating!(JMP).", TRUE)
-/obj/machinery/power/supermatter_shard/proc/status_adminwarn_check(var/min_status, var/current_state, var/message, var/send_to_irc = FALSE)
+/obj/machinery/power/supermatter_shard/proc/status_adminwarn_check(min_status, current_state, message)
var/status = get_status()
if(status >= min_status)
if(!current_state)
log_and_message_admins(message)
- if(send_to_irc)
- send2adminirc(message)
+ SSdiscord.send2discord_simple_noadmins(message)
return TRUE
else
return FALSE
diff --git a/code/modules/shuttle/emergency.dm b/code/modules/shuttle/emergency.dm
index cafe92bcc87..2a50ccff03b 100644
--- a/code/modules/shuttle/emergency.dm
+++ b/code/modules/shuttle/emergency.dm
@@ -231,7 +231,7 @@
return
mode = SHUTTLE_DOCKED
timer = world.time
- send2irc("Server", "The Emergency Shuttle has docked with the station.")
+ SSdiscord.send2discord_simple(DISCORD_WEBHOOK_PRIMARY, "The Emergency Shuttle has docked with the station.")
emergency_shuttle_docked.Announce("The Emergency Shuttle has docked with the station. You have [timeLeft(600)] minutes to board the Emergency Shuttle.")
/*
diff --git a/config/example/config.txt b/config/example/config.txt
index b97b6f701f3..54622806507 100644
--- a/config/example/config.txt
+++ b/config/example/config.txt
@@ -311,31 +311,9 @@ ALIEN_PLAYER_RATIO 0.2
##Remove the # to let ghosts spin chairs
GHOST_INTERACTION
-## Password used for authorizing ircbot and other external tools.
+## Password used for authorizing external tools via world/Topic.
#COMMS_PASSWORD
-## Uncomment to enable sending data to the IRC bot.
-#USE_IRC_BOT
-
-## Host(s) where the IRC bot is hosted. Seperate IP's by ;. Port 45678 needs to be open.
-#IRC_BOT_HOST 127.0.0.1;localhost
-
-## IRC channel to send information to. Leave blank to disable.
-#MAIN_IRC #main
-
-## IRC channel to send adminhelps to. Leave blank to disable adminhelps-to-irc.
-#ADMIN_IRC #admin
-
-## IRC channel to send direct messages to admins to. Leave blank to disable.
-#ADMIN_NOTIFY_IRC #paradiseStaff
-
-## IRC channel to log CID randomizer blocker hits to. Leave blank to silence
-#CIDRANDOMIZER_IRC #cidrandomizer
-
-## Path to the python2 executable on the system. Leave blank for default.
-## Default is "python" on Windows, "/usr/bin/env python2" on UNIX.
-#PYTHON_PATH pythonw
-
## Expected round length in minutes
EXPECTED_ROUND_LENGTH 120
@@ -461,3 +439,29 @@ DISABLE_HIGH_POP_MC_MODE_AMOUNT 60
## BYOND accounts younger than the value below will alert admins when they connect for the first time,
## as well as making the BYOND account age in player panel bold
BYOND_ACCOUNT_AGE_THRESHOLD 7
+
+##### DISCORD STUFF #####
+
+## If you are going to enable discord webhooks, fill out EVERYTHING in this section
+
+## Uncomment the line below to enable Discord webhooks
+#ENABLE_DISCORD_WEBHOOKS
+
+## Role ID to be pinged with administrative events. If unset, all pings to this role will be disabled
+## IF YOU ARE DISABLING THIS COMMENT IT OUT ENTIRELY, DONT LEAVE IT BLANK
+#DISCORD_WEBHOOKS_ADMIN_ROLE_ID
+
+## Webhook URL for the main discord webhook
+#DISCORD_WEBHOOKS_MAIN_URL
+
+## Webhook URL for the admin discord webhook
+#DISCORD_WEBHOOKS_ADMIN_URL
+
+## Webhook URL for the mentor discord webhook
+#DISCORD_WEBHOOKS_MENTOR_URL
+
+## Uncomment to send all ahelps to discord. If the line is commented, only ahelps made when no admins are online will be forwarded
+## Ahelps forwarded when staff are online will never have the role ping, regardless of the setting above
+#DISCORD_FORWARD_ALL_AHELPS
+
+##### END DISCORD STUFF #####
diff --git a/paradise.dme b/paradise.dme
index f5a81db4362..b4174049832 100644
--- a/paradise.dme
+++ b/paradise.dme
@@ -222,11 +222,13 @@
#include "code\controllers\subsystem\atoms.dm"
#include "code\controllers\subsystem\changelog.dm"
#include "code\controllers\subsystem\cleanup.dm"
+#include "code\controllers\subsystem\discord.dm"
#include "code\controllers\subsystem\events.dm"
#include "code\controllers\subsystem\fires.dm"
#include "code\controllers\subsystem\garbage.dm"
#include "code\controllers\subsystem\ghost_spawns.dm"
#include "code\controllers\subsystem\holiday.dm"
+#include "code\controllers\subsystem\http.dm"
#include "code\controllers\subsystem\icon_smooth.dm"
#include "code\controllers\subsystem\idlenpcpool.dm"
#include "code\controllers\subsystem\input.dm"
@@ -277,9 +279,11 @@
#include "code\datums\datacore.dm"
#include "code\datums\datum.dm"
#include "code\datums\datumvars.dm"
+#include "code\datums\discord.dm"
#include "code\datums\dog_fashion.dm"
#include "code\datums\gas_mixture.dm"
#include "code\datums\holocall.dm"
+#include "code\datums\http.dm"
#include "code\datums\hud.dm"
#include "code\datums\log_record.dm"
#include "code\datums\log_viewer.dm"
@@ -1502,8 +1506,6 @@
#include "code\modules\examine\descriptions\structures.dm"
#include "code\modules\examine\descriptions\turfs.dm"
#include "code\modules\examine\descriptions\weapons.dm"
-#include "code\modules\ext_scripts\irc.dm"
-#include "code\modules\ext_scripts\python.dm"
#include "code\modules\fish\fish_eggs.dm"
#include "code\modules\fish\fish_items.dm"
#include "code\modules\fish\fish_types.dm"
diff --git a/rust_g.dll b/rust_g.dll
index fb8df35878fe27f5f73abec2e153ba5562dd3c9d..8e80d194a08df3cdd3a6c4788ce2c06e1f6f00c9 100644
GIT binary patch
literal 5474304
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