From 8c45d4466cdddeb3d7d59eb69bf7658a4f46a208 Mon Sep 17 00:00:00 2001
From: tonty <39193182+tontyGH@users.noreply.github.com>
Date: Tue, 2 Dec 2025 13:38:51 -0500
Subject: [PATCH] [MDB IGNORE] Cleans up AI core structure, un-spaghettis some
AI code (#93873)
## About The Pull Request
The AI core structure now fully integrates item/tool interactions and no
longer uses attackby/take_damage overrides. Construction behaviour has
been isolated into its own file.
All handling relating to the AI core's status when shunted has been
turned into signals. For this reason, helper procs for managing core
link state have been made and integrated into the relevant users (APC
shunting, mech takeover). The AI core no longer references the remote AI
mob.
/obj/structure/ai_core/deactivated has been removed from code since it
had no function after refactoring. There was only a single instance of
it being used in a map, which has been replaced with a var edit.
There may be more things I changed, but I'm h
---
_maps/RandomRuins/SpaceRuins/oldstation.dmm | 4 +-
code/__DEFINES/construction/structures.dm | 12 +-
.../signals_mob/signals_mob_silicon.dm | 4 -
code/game/machinery/ai_core/_core.dm | 247 +++++++++
.../machinery/ai_core/core_construction.dm | 253 +++++++++
.../game/objects/items/devices/aicard_evil.dm | 2 +-
code/game/objects/structures/ai_core.dm | 484 ------------------
code/modules/antagonists/malf_ai/malf_ai.dm | 10 -
code/modules/mob/living/silicon/ai/ai.dm | 177 +++++--
.../mob/living/silicon/ai/ai_defines.dm | 4 +-
code/modules/mob/living/silicon/ai/death.dm | 9 +-
code/modules/power/apc/apc_malf.dm | 7 +-
code/modules/vehicles/mecha/_mecha.dm | 1 +
.../vehicles/mecha/mecha_ai_interaction.dm | 5 +-
.../vehicles/mecha/mecha_mob_interaction.dm | 6 +-
icons/mob/silicon/ai.dmi | Bin 419492 -> 419436 bytes
tgstation.dme | 3 +-
.../Scripts/93873_aicore_refactor.txt | 1 +
18 files changed, 657 insertions(+), 572 deletions(-)
create mode 100644 code/game/machinery/ai_core/_core.dm
create mode 100644 code/game/machinery/ai_core/core_construction.dm
delete mode 100644 code/game/objects/structures/ai_core.dm
create mode 100644 tools/UpdatePaths/Scripts/93873_aicore_refactor.txt
diff --git a/_maps/RandomRuins/SpaceRuins/oldstation.dmm b/_maps/RandomRuins/SpaceRuins/oldstation.dmm
index a857a39a40a..180a0eb6d41 100644
--- a/_maps/RandomRuins/SpaceRuins/oldstation.dmm
+++ b/_maps/RandomRuins/SpaceRuins/oldstation.dmm
@@ -288,7 +288,9 @@
/turf/open/floor/iron,
/area/ruin/space/ancientstation/charlie/bridge)
"bA" = (
-/obj/structure/ai_core/deactivated,
+/obj/structure/ai_core{
+ state = 5
+ },
/turf/open/floor/iron/dark,
/area/ruin/space/ancientstation/delta/ai)
"bC" = (
diff --git a/code/__DEFINES/construction/structures.dm b/code/__DEFINES/construction/structures.dm
index e48dc078ca4..874978a8cc9 100644
--- a/code/__DEFINES/construction/structures.dm
+++ b/code/__DEFINES/construction/structures.dm
@@ -1,12 +1,12 @@
//Defines for construction states
//ai core defines
-#define EMPTY_CORE 0
-#define CIRCUIT_CORE 1
-#define SCREWED_CORE 2
-#define CABLED_CORE 3
-#define GLASS_CORE 4
-#define AI_READY_CORE 5
+#define CORE_STATE_EMPTY 0
+#define CORE_STATE_CIRCUIT 1
+#define CORE_STATE_SCREWED 2
+#define CORE_STATE_CABLED 3
+#define CORE_STATE_GLASSED 4
+#define CORE_STATE_FINISHED 5
//girder construction states
#define GIRDER_NORMAL 0
diff --git a/code/__DEFINES/dcs/signals/signals_mob/signals_mob_silicon.dm b/code/__DEFINES/dcs/signals/signals_mob/signals_mob_silicon.dm
index 564465dfcf2..f68b0840205 100644
--- a/code/__DEFINES/dcs/signals/signals_mob/signals_mob_silicon.dm
+++ b/code/__DEFINES/dcs/signals/signals_mob/signals_mob_silicon.dm
@@ -8,10 +8,6 @@
#define COMSIG_BORG_HUG_HANDLED 1
///called from /mob/living/silicon/attack_hand proc
#define COMSIG_MOB_PAT_BORG "mob_pat_borg"
-///called when someone is inquiring about an AI's linked core
-#define COMSIG_SILICON_AI_CORE_STATUS "AI_core_status"
- #define COMPONENT_CORE_ALL_GOOD (1<<0)
- #define COMPONENT_CORE_DISCONNECTED (1<<1)
///called when an AI (malf or perhaps combat upgraded or some other circumstance that has them inhabit
///an APC) enters an APC
#define COMSIG_SILICON_AI_OCCUPY_APC "AI_occupy_apc"
diff --git a/code/game/machinery/ai_core/_core.dm b/code/game/machinery/ai_core/_core.dm
new file mode 100644
index 00000000000..50fb2a9c732
--- /dev/null
+++ b/code/game/machinery/ai_core/_core.dm
@@ -0,0 +1,247 @@
+#define AI_CORE_BRAIN(X) X.braintype == "Android" ? "brain" : "MMI"
+
+/obj/structure/ai_core
+ name = "\improper AI core"
+ desc = "The framework for an artificial intelligence core."
+ icon = 'icons/mob/silicon/ai.dmi'
+ icon_state = "build_0"
+ base_icon_state = "build_"
+ density = TRUE
+ anchored = FALSE
+ max_integrity = 500
+ var/state = CORE_STATE_EMPTY
+ var/datum/ai_laws/laws
+ var/obj/item/circuitboard/aicore/circuit
+ var/obj/item/mmi/core_mmi
+
+/obj/structure/ai_core/Initialize(mapload, state = src.state, obj/item/mmi/core_mmi = null)
+ . = ..()
+ laws = new
+ laws.set_laws_config()
+
+ if(core_mmi && state < CORE_STATE_CABLED)
+ stack_trace("supplied a core_mmi as constructor argument, but core state wouldn't have accepted it!")
+ state = CORE_STATE_FINISHED // just in case...
+ src.state = state
+ if(state >= CORE_STATE_CIRCUIT)
+ circuit = new(src)
+ if(state >= CORE_STATE_CABLED)
+ if(!core_mmi)
+ core_mmi = new /obj/item/mmi(src)
+ core_mmi.brain = new(core_mmi)
+ core_mmi.brain.organ_flags |= ORGAN_FROZEN
+ core_mmi.set_brainmob(new /mob/living/brain())
+ core_mmi.brainmob.container = core_mmi
+ core_mmi.update_appearance()
+ core_mmi.forceMove(src)
+ src.core_mmi = core_mmi
+ set_anchored(TRUE)
+
+ update_appearance(UPDATE_ICON_STATE)
+
+/obj/structure/ai_core/update_icon_state()
+ if(state != CORE_STATE_FINISHED)
+ icon_state = "[base_icon_state][state]"
+ if(state == CORE_STATE_CABLED && core_mmi)
+ icon_state += "b"
+ else
+ icon_state = "ai-empty"
+ return ..()
+
+/obj/structure/ai_core/Exited(atom/movable/gone, direction)
+ . = ..()
+ if(gone == circuit)
+ circuit = null
+ if((state != CORE_STATE_GLASSED) && (state != CORE_STATE_FINISHED))
+ state = CORE_STATE_EMPTY
+ update_appearance()
+ if(gone == core_mmi)
+ core_mmi = null
+ update_appearance()
+
+/obj/structure/ai_core/atom_deconstruct(disassembled = TRUE)
+ if(state >= CORE_STATE_GLASSED)
+ new /obj/item/stack/sheet/rglass(drop_location(), 2)
+ if(state >= CORE_STATE_CABLED)
+ new /obj/item/stack/cable_coil(drop_location(), 5)
+ core_mmi?.forceMove(drop_location())
+ circuit?.forceMove(drop_location())
+ new /obj/item/stack/sheet/plasteel(drop_location(), 4)
+
+/obj/structure/ai_core/Destroy()
+ QDEL_NULL(circuit)
+ QDEL_NULL(core_mmi)
+ QDEL_NULL(laws)
+ return ..()
+
+/obj/structure/ai_core/examine(mob/user)
+ . = ..()
+ . += span_notice("It has some bolts that look [anchored ? "tightened" : "loosened"].")
+
+ switch(state)
+ if(CORE_STATE_EMPTY)
+ . += span_notice("There is a slot for a circuit board, the frame can be melted down.")
+ if(CORE_STATE_CIRCUIT)
+ . += span_notice("The circuit board can be screwed into place or pried out.")
+ if(CORE_STATE_SCREWED)
+ . += span_notice("The frame can be wired, the circuit board can be unfastened.")
+ if(CORE_STATE_CABLED)
+ if(!core_mmi)
+ . += span_notice("There are wires which could be hooked up to an MMI or positronic brain, or cut.")
+ else
+ var/accept_laws = TRUE
+ if(core_mmi.laws.id != DEFAULT_AI_LAWID || !core_mmi.brainmob || !core_mmi.brainmob?.mind)
+ accept_laws = FALSE
+ . += span_notice("There is a slot for a reinforced glass panel, the [AI_CORE_BRAIN(core_mmi)] could be pried out.[accept_laws ? " A law module can be swiped across." : ""]")
+ if(CORE_STATE_GLASSED)
+ . += span_notice("The monitor [core_mmi?.brainmob?.mind && !suicide_check() ? "and neural interface " : ""]can be screwed in, the panel can be pried out.")
+ if(CORE_STATE_FINISHED)
+ . += span_notice("The monitor's connection can be cut[core_mmi?.brainmob?.mind && !suicide_check() ? " the neural interface can be screwed in." : "."]")
+
+/obj/structure/ai_core/item_interaction(mob/living/user, obj/item/tool, list/modifiers)
+ if(state < CORE_STATE_FINISHED)
+ return construction_item_interaction(user, tool, modifiers)
+
+ return NONE
+
+/// Exists to be used for callbacks.
+/obj/structure/ai_core/proc/check_state(state_to_check)
+ return (state == state_to_check)
+
+/obj/structure/ai_core/latejoin_inactive
+ name = "networked AI core"
+ desc = "This AI core is connected by bluespace transmitters to NTNet, allowing for an AI personality to be downloaded to it on the fly mid-shift."
+ anchored = TRUE
+ state = CORE_STATE_FINISHED
+ var/available = TRUE
+ var/safety_checks = TRUE
+ var/active = TRUE
+
+/obj/structure/ai_core/latejoin_inactive/Initialize(mapload, state, posibrain)
+ . = ..()
+ GLOB.latejoin_ai_cores += src
+
+/obj/structure/ai_core/latejoin_inactive/Destroy()
+ GLOB.latejoin_ai_cores -= src
+ return ..()
+
+/obj/structure/ai_core/latejoin_inactive/examine(mob/user)
+ . = ..()
+ . += "Its transmitter seems to be [active? "on" : "off"]."
+ . += span_notice("You could [active? "deactivate" : "activate"] it with a multitool.")
+
+/obj/structure/ai_core/latejoin_inactive/proc/is_available() //If people still manage to use this feature to spawn-kill AI latejoins ahelp them.
+ if(!available)
+ return FALSE
+ if(!safety_checks)
+ return TRUE
+ if(!active)
+ return FALSE
+ var/turf/T = get_turf(src)
+ var/area/A = get_area(src)
+ if(!(A.area_flags & BLOBS_ALLOWED))
+ return FALSE
+ if(!A.power_equip)
+ return FALSE
+ if(!SSmapping.level_trait(T.z,ZTRAIT_STATION))
+ return FALSE
+ if(!isfloorturf(T))
+ return FALSE
+ return TRUE
+
+/obj/structure/ai_core/latejoin_inactive/multitool_act(mob/living/user, obj/item/tool)
+ if(user.combat_mode)
+ return NONE
+
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50))
+ return ITEM_INTERACT_BLOCKING
+
+ active = !active
+ balloon_alert(user, "[active ? "activated" : "deactivated"] transmitters")
+ return ITEM_INTERACT_SUCCESS
+
+/obj/structure/ai_core/proc/ai_structure_to_mob()
+ var/mob/living/brain/the_brainmob = core_mmi.brainmob
+ if(!the_brainmob.mind || suicide_check())
+ return FALSE
+ the_brainmob.mind.remove_antags_for_borging()
+ if(!the_brainmob.mind.has_ever_been_ai)
+ SSblackbox.record_feedback("amount", "ais_created", 1)
+ var/mob/living/silicon/ai/ai_mob = null
+
+ if(core_mmi.overrides_aicore_laws)
+ ai_mob = new /mob/living/silicon/ai(loc, core_mmi.laws, the_brainmob)
+ core_mmi.laws = null //MMI's law datum is being donated, so we need the MMI to let it go or the GC will eat it
+ else
+ ai_mob = new /mob/living/silicon/ai(loc, laws, the_brainmob)
+ laws = null //we're giving the new AI this datum, so let's not delete it when we qdel(src) 5 lines from now
+
+ var/datum/antagonist/malf_ai/malf_datum = IS_MALF_AI(ai_mob)
+ if(malf_datum)
+ malf_datum.add_law_zero()
+
+ if(!isnull(the_brainmob.client))
+ ai_mob.set_gender(the_brainmob.client)
+ if(core_mmi.force_replace_ai_name)
+ ai_mob.fully_replace_character_name(ai_mob.name, core_mmi.replacement_ai_name())
+ ai_mob.posibrain_inside = core_mmi.braintype == "Android"
+ deadchat_broadcast(" has been brought online at [get_area_name(ai_mob, format_text = TRUE)].", span_name("[ai_mob]"), follow_target = ai_mob, message_type = DEADCHAT_ANNOUNCEMENT)
+ qdel(src)
+ return ai_mob
+
+/// Quick proc to call to see if the brainmob inside of us has suicided. Returns TRUE if we have, FALSE in any other scenario.
+/obj/structure/ai_core/proc/suicide_check()
+ if(isnull(core_mmi) || isnull(core_mmi.brainmob))
+ return FALSE
+ return HAS_TRAIT(core_mmi.brainmob, TRAIT_SUICIDED)
+
+/*
+This is a good place for AI-related object verbs so I'm sticking it here.
+If adding stuff to this, don't forget that an AI need to cancel_camera() whenever it physically moves to a different location.
+That prevents a few funky behaviors.
+*/
+//The type of interaction, the player performing the operation, the AI itself, and the card object, if any.
+
+
+/atom/proc/transfer_ai(interaction, mob/user, mob/living/silicon/ai/AI, obj/item/aicard/card)
+ SHOULD_CALL_PARENT(TRUE)
+ if(istype(card))
+ if(card.flush)
+ to_chat(user, span_alert("ERROR: AI flush is in progress, cannot execute transfer protocol."))
+ return FALSE
+ return TRUE
+
+/obj/structure/ai_core/transfer_ai(interaction, mob/user, mob/living/silicon/ai/AI, obj/item/aicard/card)
+ if(state != CORE_STATE_FINISHED || !..())
+ return
+ if(core_mmi && core_mmi.brainmob)
+ if(core_mmi.brainmob.mind)
+ to_chat(user, span_warning("[src] already contains an active mind!"))
+ return
+ else if(suicide_check())
+ to_chat(user, span_warning("[AI_CORE_BRAIN(core_mmi)] installed in [src] is completely useless!"))
+ return
+ //Transferring a carded AI to a core.
+ if(interaction == AI_TRANS_FROM_CARD)
+ AI.set_control_disabled(FALSE)
+ AI.radio_enabled = TRUE
+ AI.forceMove(loc) // to replace the terminal.
+ to_chat(AI, span_notice("You have been uploaded to a stationary terminal. Remote device connection restored."))
+ to_chat(user, "[span_boldnotice("Transfer successful")]: [AI.name] ([rand(1000,9999)].exe) installed and executed successfully. Local copy has been removed.")
+ card.AI = null
+ AI.battery = circuit.battery
+ AI.posibrain_inside = isnull(core_mmi) || core_mmi.braintype == "Android"
+ qdel(src)
+ else //If for some reason you use an empty card on an empty AI terminal.
+ to_chat(user, span_alert("There is no AI loaded on this terminal."))
+
+/obj/item/circuitboard/aicore
+ name = "AI core (AI Core Board)" //Well, duh, but best to be consistent
+ var/battery = 200 //backup battery for when the AI loses power. Copied to/from AI mobs when carding, and placed here to avoid recharge via deconning the core
+
+/obj/item/circuitboard/aicore/Initialize(mapload)
+ . = ..()
+ if(mapload && HAS_TRAIT(SSstation, STATION_TRAIT_HUMAN_AI))
+ return INITIALIZE_HINT_QDEL
+
+#undef AI_CORE_BRAIN
diff --git a/code/game/machinery/ai_core/core_construction.dm b/code/game/machinery/ai_core/core_construction.dm
new file mode 100644
index 00000000000..df1a36782da
--- /dev/null
+++ b/code/game/machinery/ai_core/core_construction.dm
@@ -0,0 +1,253 @@
+#define AI_CORE_BRAIN(X) X.braintype == "Android" ? "brain" : "MMI"
+#define UPDATE_STATE(new_state) state = new_state; update_appearance(UPDATE_ICON_STATE)
+#define CHECK_STATE_CALLBACK(maintained_state) CALLBACK(src, PROC_REF(check_state), maintained_state)
+
+/obj/structure/ai_core/welder_act(mob/living/user, obj/item/tool)
+ if(state != CORE_STATE_EMPTY)
+ balloon_alert(user, "frame has to be empty!")
+ return ITEM_INTERACT_BLOCKING
+
+ if(!tool.tool_start_check(user, 1))
+ return ITEM_INTERACT_BLOCKING
+
+ if(!tool.use_tool(src, user, 2 SECONDS, 1, 50, CHECK_STATE_CALLBACK(CORE_STATE_EMPTY)))
+ return ITEM_INTERACT_BLOCKING
+
+ deconstruct(TRUE)
+ return ITEM_INTERACT_SUCCESS
+
+/obj/structure/ai_core/wrench_act(mob/living/user, obj/item/tool)
+ if(state >= CORE_STATE_FINISHED)
+ set_anchored(TRUE) //teehee
+ balloon_alert(user, "can't unanchor!")
+ return ITEM_INTERACT_BLOCKING
+
+ default_unfasten_wrench(user, tool)
+ return ITEM_INTERACT_SUCCESS
+
+/obj/structure/ai_core/screwdriver_act(mob/living/user, obj/item/tool)
+ switch(state)
+ if(CORE_STATE_EMPTY)
+ balloon_alert(user, "nothing to screw in there!")
+ return ITEM_INTERACT_BLOCKING
+ if(CORE_STATE_CIRCUIT)
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_CIRCUIT)))
+ return ITEM_INTERACT_BLOCKING
+ balloon_alert(user, "board secured")
+ UPDATE_STATE(CORE_STATE_SCREWED)
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_SCREWED)
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_SCREWED)))
+ return ITEM_INTERACT_BLOCKING
+ balloon_alert(user, "board unsecured")
+ UPDATE_STATE(CORE_STATE_CIRCUIT)
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_CABLED)
+ balloon_alert(user, "can't reach the board!")
+ return ITEM_INTERACT_BLOCKING
+ if(CORE_STATE_GLASSED)
+ if(!anchored)
+ balloon_alert(user, "isn't anchored!")
+ return ITEM_INTERACT_BLOCKING
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_GLASSED)))
+ return ITEM_INTERACT_BLOCKING
+ if(suicide_check())
+ balloon_alert(user, "processor is completely useless!")
+ return ITEM_INTERACT_BLOCKING
+
+ var/atom/movable/alert_source = src
+ if(core_mmi.brainmob?.mind)
+ alert_source = ai_structure_to_mob() || alert_source
+ else
+ UPDATE_STATE(CORE_STATE_FINISHED)
+ alert_source.balloon_alert(user, "connected monitor[core_mmi?.brainmob?.mind ? " and neural network" : ""]")
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_FINISHED)
+ if(!core_mmi?.brainmob?.mind || suicide_check())
+ balloon_alert(user, "processor is inactive!")
+ return ITEM_INTERACT_BLOCKING
+
+ if(!anchored)
+ balloon_alert(user, "anchor it first!")
+ return ITEM_INTERACT_BLOCKING
+
+ balloon_alert(user, "connecting neural network...")
+ if(!tool.use_tool(src, user, 10 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_FINISHED)))
+ return ITEM_INTERACT_BLOCKING
+
+ var/atom/movable/alert_source = ai_structure_to_mob()
+ if(!alert_source)
+ balloon_alert(user, "processor is inactive!")
+ return ITEM_INTERACT_BLOCKING
+
+ alert_source.balloon_alert(user, "connected neural network")
+ return ITEM_INTERACT_SUCCESS
+
+/obj/structure/ai_core/crowbar_act(mob/living/user, obj/item/tool)
+ switch(state)
+ if(CORE_STATE_EMPTY)
+ balloon_alert(user, "nothing to pry out!")
+ return ITEM_INTERACT_BLOCKING
+ if(CORE_STATE_CIRCUIT)
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_CIRCUIT)))
+ return ITEM_INTERACT_BLOCKING
+
+ circuit.forceMove(drop_location())
+ UPDATE_STATE(CORE_STATE_EMPTY)
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_SCREWED)
+ balloon_alert(user, "won't budge!")
+ return ITEM_INTERACT_BLOCKING
+ if(CORE_STATE_CABLED)
+ if(!core_mmi)
+ balloon_alert(user, "nothing to pry out!")
+ return ITEM_INTERACT_BLOCKING
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_CABLED)) || !core_mmi)
+ return ITEM_INTERACT_BLOCKING
+
+ core_mmi.forceMove(drop_location())
+ UPDATE_STATE(CORE_STATE_CABLED)
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_GLASSED)
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_GLASSED)))
+ return ITEM_INTERACT_BLOCKING
+
+ new /obj/item/stack/sheet/rglass(drop_location(), 2)
+ UPDATE_STATE(CORE_STATE_CABLED)
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_FINISHED)
+ balloon_alert(user, "display is on!")
+ return ITEM_INTERACT_SUCCESS
+
+/obj/structure/ai_core/wirecutter_act(mob/living/user, obj/item/tool)
+ switch(state)
+ if(CORE_STATE_EMPTY to CORE_STATE_CIRCUIT)
+ balloon_alert(user, "nothing to cut!")
+ return ITEM_INTERACT_BLOCKING
+ if(CORE_STATE_CABLED)
+ if(core_mmi)
+ balloon_alert(user, "[AI_CORE_BRAIN(core_mmi)] in the way!")
+ return ITEM_INTERACT_BLOCKING
+
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_CABLED)) || core_mmi)
+ return ITEM_INTERACT_BLOCKING
+
+ new /obj/item/stack/cable_coil(drop_location(), 5)
+ UPDATE_STATE(CORE_STATE_SCREWED)
+ return ITEM_INTERACT_SUCCESS
+ if(CORE_STATE_GLASSED)
+ balloon_alert(user, "nothing left to cut!")
+ return ITEM_INTERACT_BLOCKING
+ if(CORE_STATE_FINISHED)
+ if(!tool.use_tool(src, user, 0 SECONDS, 0, 50, CHECK_STATE_CALLBACK(CORE_STATE_FINISHED)))
+ return ITEM_INTERACT_BLOCKING
+
+ UPDATE_STATE(CORE_STATE_GLASSED)
+ return ITEM_INTERACT_SUCCESS
+
+/// Handles the interaction chain the same as item_interaction. Exists to isolate construction behaviour from other item behaviour.
+/obj/structure/ai_core/proc/construction_item_interaction(mob/living/user, obj/item/tool, list/modifiers)
+ if(istype(tool, /obj/item/circuitboard/aicore))
+ return install_board(user, tool) ? ITEM_INTERACT_SUCCESS : ITEM_INTERACT_BLOCKING
+
+ if(istype(tool, /obj/item/stack/cable_coil))
+ return add_cabling(user, tool) ? ITEM_INTERACT_SUCCESS : ITEM_INTERACT_BLOCKING
+
+ if(istype(tool, /obj/item/mmi))
+ return install_mmi(user, tool) ? ITEM_INTERACT_SUCCESS : ITEM_INTERACT_BLOCKING
+ if(istype(tool, /obj/item/ai_module))
+ return update_laws(user, tool) ? ITEM_INTERACT_SUCCESS : ITEM_INTERACT_BLOCKING
+ if(istype(tool, /obj/item/stack/sheet/rglass))
+ return install_glass(user, tool) ? ITEM_INTERACT_SUCCESS : ITEM_INTERACT_BLOCKING
+
+ return NONE
+
+/obj/structure/ai_core/proc/install_board(mob/living/user, obj/item/circuitboard/aicore/circuit)
+ if(state != CORE_STATE_EMPTY)
+ return FALSE
+ if(!user.transferItemToLoc(circuit, src))
+ return FALSE
+
+ playsound(src, 'sound/items/deconstruct.ogg', 50, TRUE)
+ src.circuit = circuit
+ UPDATE_STATE(CORE_STATE_CIRCUIT)
+ return TRUE
+
+/obj/structure/ai_core/proc/add_cabling(mob/living/user, obj/item/stack/cable_coil/cable)
+ if(state != CORE_STATE_SCREWED)
+ return FALSE
+
+ if(cable.get_amount() < 5)
+ balloon_alert(user, "not enough [cable::name]!")
+ return FALSE
+
+ balloon_alert(user, "adding cable...")
+ if(!cable.use_tool(src, user, 2 SECONDS, 5, 50, CHECK_STATE_CALLBACK(CORE_STATE_SCREWED)))
+ return FALSE
+
+ UPDATE_STATE(CORE_STATE_CABLED)
+ return TRUE
+
+/obj/structure/ai_core/proc/install_mmi(mob/living/user, obj/item/mmi/mmi)
+ if(state != CORE_STATE_CABLED)
+ return FALSE
+
+ if(!mmi.brain_check(user))
+ var/wants_install = (tgui_alert(user, "This [AI_CORE_BRAIN(mmi)] is inactive, would you like to make an inactive AI?", "Installing AI [AI_CORE_BRAIN(mmi)]", list("Yes", "No")) == "Yes")
+ if(!wants_install)
+ return FALSE
+ if(QDELETED(src) || QDELETED(user) || QDELETED(mmi) || !user.is_holding(mmi) || !Adjacent(user))
+ return FALSE
+ if(mmi.brainmob && HAS_TRAIT(mmi.brainmob, TRAIT_SUICIDED))
+ balloon_alert(user, "[AI_CORE_BRAIN(mmi)] is useless!")
+ return FALSE
+ else
+ var/mob/living/brain/mmi_brainmob = mmi.brainmob
+ if(!CONFIG_GET(flag/allow_ai) || (mmi_brainmob && is_banned_from(mmi_brainmob.ckey, JOB_AI)))
+ if(!QDELETED(src) && !QDELETED(user) && !QDELETED(mmi) && user.is_holding(mmi) && Adjacent(user))
+ balloon_alert(user, "[mmi] won't fit!")
+ return FALSE
+
+ if(state != CORE_STATE_CABLED)
+ return FALSE
+ if(!user.transferItemToLoc(mmi, src))
+ return FALSE
+
+ core_mmi = mmi
+ UPDATE_STATE(CORE_STATE_CABLED)
+ return TRUE
+
+/obj/structure/ai_core/proc/update_laws(mob/living/user, obj/item/ai_module/module)
+ if(!core_mmi)
+ balloon_alert(user, "no brain installed!")
+ return FALSE
+ if(!core_mmi.brainmob || !core_mmi.brainmob?.mind || suicide_check())
+ balloon_alert(user, "[AI_CORE_BRAIN(core_mmi)] is inactive!")
+ return FALSE
+ if(core_mmi.laws.id != DEFAULT_AI_LAWID)
+ balloon_alert(user, "[AI_CORE_BRAIN(core_mmi)] already has set laws!")
+ return FALSE
+
+ module.install(laws, user)
+ return TRUE
+
+/obj/structure/ai_core/proc/install_glass(mob/living/user, obj/item/stack/sheet/rglass/glass)
+ if(state != CORE_STATE_CABLED)
+ return FALSE
+
+ if(!core_mmi)
+ balloon_alert(user, "needs a processor!")
+ return FALSE
+ if(glass.get_amount() < 2)
+ balloon_alert(user, "not enough [glass::name]!")
+ return FALSE
+
+ if(!glass.use_tool(src, user, 2 SECONDS, 2, 50, CHECK_STATE_CALLBACK(CORE_STATE_CABLED)) || !core_mmi)
+ return FALSE
+
+ UPDATE_STATE(CORE_STATE_GLASSED)
+ return TRUE
+
+#undef CHECK_STATE_CALLBACK
+#undef UPDATE_STATE
+#undef AI_CORE_BRAIN
diff --git a/code/game/objects/items/devices/aicard_evil.dm b/code/game/objects/items/devices/aicard_evil.dm
index b63ecf25870..0c9f0c6f9c4 100644
--- a/code/game/objects/items/devices/aicard_evil.dm
+++ b/code/game/objects/items/devices/aicard_evil.dm
@@ -69,7 +69,7 @@
// Transfer the AI from the core we created into the card, then delete the core
capture_ai(new_ai, user)
- var/obj/structure/ai_core/deactivated/detritus = locate() in get_turf(src)
+ var/obj/structure/ai_core/detritus = locate() in get_turf(src)
qdel(detritus)
AI.set_control_disabled(FALSE)
AI.radio_enabled = TRUE
diff --git a/code/game/objects/structures/ai_core.dm b/code/game/objects/structures/ai_core.dm
deleted file mode 100644
index 6eee27ce24e..00000000000
--- a/code/game/objects/structures/ai_core.dm
+++ /dev/null
@@ -1,484 +0,0 @@
-#define AI_CORE_BRAIN(X) X.braintype == "Android" ? "brain" : "MMI"
-
-/obj/structure/ai_core
- density = TRUE
- anchored = FALSE
- name = "\improper AI core"
- icon = 'icons/mob/silicon/ai.dmi'
- icon_state = "0"
- desc = "The framework for an artificial intelligence core."
- max_integrity = 500
- var/state = EMPTY_CORE
- var/datum/ai_laws/laws
- var/obj/item/circuitboard/aicore/circuit
- var/obj/item/mmi/core_mmi
- /// only used in cases of AIs piloting mechs or shunted malf AIs, possible later use cases
- var/mob/living/silicon/ai/remote_ai = null
-
-/obj/structure/ai_core/Initialize(mapload)
- . = ..()
- laws = new
- laws.set_laws_config()
-
-/obj/structure/ai_core/examine(mob/user)
- . = ..()
- if(!anchored)
- if(state != EMPTY_CORE)
- . += span_notice("It has some bolts that could be tightened.")
- else
- . += span_notice("It has some bolts that could be tightened. The frame can be melted down.")
- else
- switch(state)
- if(EMPTY_CORE)
- . += span_notice("There is a slot for a circuit board, its bolts can be loosened.")
- if(CIRCUIT_CORE)
- . += span_notice("The circuit board can be screwed into place or pried out.")
- if(SCREWED_CORE)
- . += span_notice("The frame can be wired, the circuit board can be unfastened.")
- if(CABLED_CORE)
- if(!core_mmi)
- . += span_notice("There are wires which could be hooked up to an MMI or positronic brain, or cut.")
- else
- var/accept_laws = TRUE
- if(core_mmi.laws.id != DEFAULT_AI_LAWID || !core_mmi.brainmob || !core_mmi.brainmob?.mind)
- accept_laws = FALSE
- . += span_notice("There is a slot for a reinforced glass panel, the [AI_CORE_BRAIN(core_mmi)] could be pried out.[accept_laws ? " A law module can be swiped across." : ""]")
- if(GLASS_CORE)
- . += span_notice("The monitor [core_mmi?.brainmob?.mind && !suicide_check() ? "and neural interface " : ""]can be screwed in, the panel can be pried out.")
- if(AI_READY_CORE)
- . += span_notice("The monitor's connection can be cut[core_mmi?.brainmob?.mind && !suicide_check() ? " the neural interface can be screwed in." : "."]")
-
-/obj/structure/ai_core/Exited(atom/movable/gone, direction)
- . = ..()
- if(gone == circuit)
- circuit = null
- if((state != GLASS_CORE) && (state != AI_READY_CORE))
- state = EMPTY_CORE
- update_appearance()
- if(gone == core_mmi)
- core_mmi = null
- update_appearance()
-
-/obj/structure/ai_core/Destroy()
- if(istype(remote_ai))
- remote_ai = null
- QDEL_NULL(circuit)
- QDEL_NULL(core_mmi)
- QDEL_NULL(laws)
- return ..()
-
-/obj/structure/ai_core/take_damage(damage_amount, damage_type, damage_flag, sound_effect, attack_dir, armour_penetration)
- . = ..()
- if(. > 0 && istype(remote_ai))
- to_chat(remote_ai, span_danger("Your core is under attack!"))
-
-
-/obj/structure/ai_core/deactivated
- icon_state = "ai-empty"
- anchored = TRUE
- state = AI_READY_CORE
- var/mob/living/silicon/ai/attached_ai
-
-/obj/structure/ai_core/deactivated/Initialize(mapload, skip_mmi_creation = FALSE, posibrain = FALSE, linked_ai)
- . = ..()
- circuit = new(src)
- if(linked_ai)
- attached_ai = linked_ai
- if(skip_mmi_creation)
- return
- if(posibrain)
- core_mmi = new/obj/item/mmi/posibrain(src, /* autoping = */ FALSE)
- else
- core_mmi = new(src)
- core_mmi.brain = new(core_mmi)
- core_mmi.update_appearance()
-
-/obj/structure/ai_core/deactivated/Destroy()
- if(attached_ai)
- attached_ai.linked_core = null
- attached_ai = null
- . = ..()
-
-/obj/structure/ai_core/deactivated/proc/disable_doomsday(datum/source)
- SIGNAL_HANDLER
- attached_ai.ShutOffDoomsdayDevice()
-
-/obj/structure/ai_core/latejoin_inactive
- name = "networked AI core"
- desc = "This AI core is connected by bluespace transmitters to NTNet, allowing for an AI personality to be downloaded to it on the fly mid-shift."
- icon_state = "ai-empty"
- anchored = TRUE
- state = AI_READY_CORE
- var/available = TRUE
- var/safety_checks = TRUE
- var/active = TRUE
-
-/obj/structure/ai_core/latejoin_inactive/Initialize(mapload)
- . = ..()
- circuit = new(src)
- core_mmi = new(src)
- core_mmi.brain = new(core_mmi)
- core_mmi.update_appearance()
- GLOB.latejoin_ai_cores += src
-
-/obj/structure/ai_core/latejoin_inactive/Destroy()
- GLOB.latejoin_ai_cores -= src
- return ..()
-
-/obj/structure/ai_core/latejoin_inactive/examine(mob/user)
- . = ..()
- . += "Its transmitter seems to be [active? "on" : "off"]."
- . += span_notice("You could [active? "deactivate" : "activate"] it with a multitool.")
-
-/obj/structure/ai_core/latejoin_inactive/proc/is_available() //If people still manage to use this feature to spawn-kill AI latejoins ahelp them.
- if(!available)
- return FALSE
- if(!safety_checks)
- return TRUE
- if(!active)
- return FALSE
- var/turf/T = get_turf(src)
- var/area/A = get_area(src)
- if(!(A.area_flags & BLOBS_ALLOWED))
- return FALSE
- if(!A.power_equip)
- return FALSE
- if(!SSmapping.level_trait(T.z,ZTRAIT_STATION))
- return FALSE
- if(!isfloorturf(T))
- return FALSE
- return TRUE
-
-/obj/structure/ai_core/latejoin_inactive/attackby(obj/item/tool, mob/user, list/modifiers, list/attack_modifiers)
- if(tool.tool_behaviour == TOOL_MULTITOOL)
- active = !active
- to_chat(user, span_notice("You [active? "activate" : "deactivate"] \the [src]'s transmitters."))
- return
- return ..()
-
-/obj/structure/ai_core/wrench_act(mob/living/user, obj/item/tool)
- . = ..()
- default_unfasten_wrench(user, tool)
- return ITEM_INTERACT_SUCCESS
-
-/obj/structure/ai_core/screwdriver_act(mob/living/user, obj/item/tool)
- . = ..()
- if(state == AI_READY_CORE)
- if(!core_mmi)
- balloon_alert(user, "no brain installed!")
- return ITEM_INTERACT_SUCCESS
- else if(!core_mmi.brainmob?.mind || suicide_check())
- balloon_alert(user, "brain is inactive!")
- return ITEM_INTERACT_SUCCESS
- else
- balloon_alert(user, "connecting neural network...")
- if(!tool.use_tool(src, user, 10 SECONDS))
- return ITEM_INTERACT_SUCCESS
- if(!ai_structure_to_mob())
- return ITEM_INTERACT_SUCCESS
- balloon_alert(user, "connected neural network")
- return ITEM_INTERACT_SUCCESS
-
-/obj/structure/ai_core/attackby(obj/item/tool, mob/living/user, list/modifiers, list/attack_modifiers)
- if(remote_ai)
- to_chat(remote_ai, span_danger("CORE TAMPERING DETECTED!"))
- if(!anchored)
- if(tool.tool_behaviour == TOOL_WELDER)
- if(state != EMPTY_CORE)
- balloon_alert(user, "core must be empty to deconstruct it!")
- return
-
- if(!tool.tool_start_check(user, amount=1))
- return
-
- balloon_alert(user, "deconstructing frame...")
- if(tool.use_tool(src, user, 20, volume=50) && state == EMPTY_CORE)
- balloon_alert(user, "deconstructed frame")
- deconstruct(TRUE)
- return
- else
- if(!user.combat_mode)
- balloon_alert(user, "bolt it down first!")
- return
- else
- return ..()
- else
- switch(state)
- if(EMPTY_CORE)
- if(istype(tool, /obj/item/circuitboard/aicore))
- if(!user.transferItemToLoc(tool, src))
- return
- playsound(loc, 'sound/items/deconstruct.ogg', 50, TRUE)
- balloon_alert(user, "circuit board inserted")
- update_appearance()
- state = CIRCUIT_CORE
- circuit = tool
- return
- if(CIRCUIT_CORE)
- if(tool.tool_behaviour == TOOL_SCREWDRIVER)
- tool.play_tool_sound(src)
- balloon_alert(user, "board screwed into place")
- state = SCREWED_CORE
- update_appearance()
- return
- if(tool.tool_behaviour == TOOL_CROWBAR)
- tool.play_tool_sound(src)
- balloon_alert(user, "circuit board removed")
- state = EMPTY_CORE
- circuit.forceMove(loc)
- return
- if(SCREWED_CORE)
- if(tool.tool_behaviour == TOOL_SCREWDRIVER && circuit)
- tool.play_tool_sound(src)
- balloon_alert(user, "circuit board unfastened")
- state = CIRCUIT_CORE
- update_appearance()
- return
- if(istype(tool, /obj/item/stack/cable_coil))
- var/obj/item/stack/cable_coil/C = tool
- if(C.get_amount() >= 5)
- playsound(loc, 'sound/items/deconstruct.ogg', 50, TRUE)
- balloon_alert(user, "adding cables to frame...")
- if(do_after(user, 2 SECONDS, target = src) && state == SCREWED_CORE && C.use(5))
- balloon_alert(user, "added cables to frame.")
- state = CABLED_CORE
- update_appearance()
- else
- balloon_alert(user, "need five lengths of cable!")
- return
- if(CABLED_CORE)
- if(tool.tool_behaviour == TOOL_WIRECUTTER)
- if(core_mmi)
- balloon_alert(user, "remove the [AI_CORE_BRAIN(core_mmi)] first!")
- else
- tool.play_tool_sound(src)
- balloon_alert(user, "cables removed")
- state = SCREWED_CORE
- update_appearance()
- new /obj/item/stack/cable_coil(drop_location(), 5)
- return
-
- if(istype(tool, /obj/item/stack/sheet/rglass))
- if(!core_mmi)
- balloon_alert(user, "add a brain first!")
- return
- var/obj/item/stack/sheet/rglass/G = tool
- if(G.get_amount() >= 2)
- playsound(loc, 'sound/items/deconstruct.ogg', 50, TRUE)
- balloon_alert(user, "adding glass panel...")
- if(do_after(user, 2 SECONDS, target = src) && state == CABLED_CORE && G.use(2))
- balloon_alert(user, "added glass panel")
- state = GLASS_CORE
- update_appearance()
- else
- balloon_alert(user, "need two sheets of reinforced glass!")
- return
-
- if(istype(tool, /obj/item/ai_module))
- if(!core_mmi)
- balloon_alert(user, "no brain installed!")
- return
- if(!core_mmi.brainmob || !core_mmi.brainmob?.mind || suicide_check())
- balloon_alert(user, "[AI_CORE_BRAIN(core_mmi)] is inactive!")
- return
- if(core_mmi.laws.id != DEFAULT_AI_LAWID)
- balloon_alert(user, "[AI_CORE_BRAIN(core_mmi)] already has set laws!")
- return
- var/obj/item/ai_module/module = tool
- module.install(laws, user)
- return
-
- if(istype(tool, /obj/item/mmi) && !core_mmi)
- var/obj/item/mmi/M = tool
- if(!M.brain_check(user))
- var/install = tgui_alert(user, "This [AI_CORE_BRAIN(M)] is inactive, would you like to make an inactive AI?", "Installing AI [AI_CORE_BRAIN(M)]", list("Yes", "No"))
- if(install != "Yes")
- return
- if(M.brainmob && HAS_TRAIT(M.brainmob, TRAIT_SUICIDED))
- to_chat(user, span_warning("[M.name] is completely useless!"))
- return
- if(!user.transferItemToLoc(M, src))
- return
- core_mmi = M
- balloon_alert(user, "added [AI_CORE_BRAIN(core_mmi)] to frame")
- update_appearance()
- return
-
- var/mob/living/brain/B = M.brainmob
- if(!CONFIG_GET(flag/allow_ai) || (is_banned_from(B.ckey, JOB_AI) && !QDELETED(src) && !QDELETED(user) && !QDELETED(M) && !QDELETED(user) && Adjacent(user)))
- if(!QDELETED(M))
- to_chat(user, span_warning("This [M.name] does not seem to fit!"))
- return
- if(!user.transferItemToLoc(M,src))
- return
-
- core_mmi = M
- balloon_alert(user, "added [AI_CORE_BRAIN(core_mmi)] to frame")
- update_appearance()
- return
-
- if(tool.tool_behaviour == TOOL_CROWBAR && core_mmi)
- tool.play_tool_sound(src)
- balloon_alert(user, "removed [AI_CORE_BRAIN(core_mmi)]")
- if(remote_ai)
- var/mob/living/silicon/ai/remoted_ai = remote_ai
- remoted_ai.break_core_link()
- if(!IS_MALF_AI(remoted_ai))
- //don't pull back shunted malf AIs
- remoted_ai.death(gibbed = TRUE, drop_mmi = FALSE)
- ///the drop_mmi param determines whether the MMI is dropped at their current location
- ///which in this case would be somewhere else, so we drop their MMI at the core instead
- remoted_ai.make_mmi_drop_and_transfer(core_mmi, src)
- core_mmi.forceMove(loc) //if they're malf, just drops a blank MMI, or if it's an incomplete shell
- return //it drops the mmi that was put in before it was finished
-
- if(GLASS_CORE)
- if(tool.tool_behaviour == TOOL_CROWBAR)
- tool.play_tool_sound(src)
- balloon_alert(user, "removed glass panel")
- state = CABLED_CORE
- update_appearance()
- new /obj/item/stack/sheet/rglass(loc, 2)
- return
-
- if(tool.tool_behaviour == TOOL_SCREWDRIVER)
- if(suicide_check())
- to_chat(user, span_warning("The brain installed is completely useless."))
- return
- tool.play_tool_sound(src)
-
- var/atom/alert_source = src
- if(core_mmi.brainmob?.mind)
- alert_source = ai_structure_to_mob() || alert_source
- else
- state = AI_READY_CORE
- update_appearance()
- alert_source.balloon_alert(user, "connected monitor[core_mmi?.brainmob?.mind ? " and neural network" : ""]")
- return
-
- if(AI_READY_CORE)
- if(istype(tool, /obj/item/aicard))
- return //handled by /obj/structure/ai_core/transfer_ai()
-
- if(tool.tool_behaviour == TOOL_WIRECUTTER)
- tool.play_tool_sound(src)
- balloon_alert(user, "disconnected monitor")
- state = GLASS_CORE
- update_appearance()
- return
- return ..()
-
-/obj/structure/ai_core/proc/ai_structure_to_mob()
- var/mob/living/brain/the_brainmob = core_mmi.brainmob
- if(!the_brainmob.mind || suicide_check())
- return FALSE
- the_brainmob.mind.remove_antags_for_borging()
- if(!the_brainmob.mind.has_ever_been_ai)
- SSblackbox.record_feedback("amount", "ais_created", 1)
- var/mob/living/silicon/ai/ai_mob = null
-
- if(core_mmi.overrides_aicore_laws)
- ai_mob = new /mob/living/silicon/ai(loc, core_mmi.laws, the_brainmob)
- core_mmi.laws = null //MMI's law datum is being donated, so we need the MMI to let it go or the GC will eat it
- else
- ai_mob = new /mob/living/silicon/ai(loc, laws, the_brainmob)
- laws = null //we're giving the new AI this datum, so let's not delete it when we qdel(src) 5 lines from now
-
- var/datum/antagonist/malf_ai/malf_datum = IS_MALF_AI(ai_mob)
- if(malf_datum)
- malf_datum.add_law_zero()
-
- if(!isnull(the_brainmob.client))
- ai_mob.set_gender(the_brainmob.client)
- if(core_mmi.force_replace_ai_name)
- ai_mob.fully_replace_character_name(ai_mob.name, core_mmi.replacement_ai_name())
- ai_mob.posibrain_inside = core_mmi.braintype == "Android"
- deadchat_broadcast(" has been brought online at [get_area_name(ai_mob, format_text = TRUE)].", span_name("[ai_mob]"), follow_target = ai_mob, message_type = DEADCHAT_ANNOUNCEMENT)
- qdel(src)
- return ai_mob
-
-/obj/structure/ai_core/update_icon_state()
- switch(state)
- if(EMPTY_CORE)
- icon_state = "0"
- if(CIRCUIT_CORE)
- icon_state = "1"
- if(SCREWED_CORE)
- icon_state = "2"
- if(CABLED_CORE)
- if(core_mmi)
- icon_state = "3b"
- else
- icon_state = "3"
- if(GLASS_CORE)
- icon_state = "4"
- if(AI_READY_CORE)
- icon_state = "ai-empty"
- return ..()
-
-/obj/structure/ai_core/atom_deconstruct(disassembled = TRUE)
- if(state >= GLASS_CORE)
- new /obj/item/stack/sheet/rglass(loc, 2)
- if(state >= CABLED_CORE)
- new /obj/item/stack/cable_coil(loc, 5)
- if(circuit)
- circuit.forceMove(loc)
- circuit = null
- new /obj/item/stack/sheet/plasteel(loc, 4)
-
-/// Quick proc to call to see if the brainmob inside of us has suicided. Returns TRUE if we have, FALSE in any other scenario.
-/obj/structure/ai_core/proc/suicide_check()
- if(isnull(core_mmi) || isnull(core_mmi.brainmob))
- return FALSE
- return HAS_TRAIT(core_mmi.brainmob, TRAIT_SUICIDED)
-
-/*
-This is a good place for AI-related object verbs so I'm sticking it here.
-If adding stuff to this, don't forget that an AI need to cancel_camera() whenever it physically moves to a different location.
-That prevents a few funky behaviors.
-*/
-//The type of interaction, the player performing the operation, the AI itself, and the card object, if any.
-
-
-/atom/proc/transfer_ai(interaction, mob/user, mob/living/silicon/ai/AI, obj/item/aicard/card)
- SHOULD_CALL_PARENT(TRUE)
- if(istype(card))
- if(card.flush)
- to_chat(user, span_alert("ERROR: AI flush is in progress, cannot execute transfer protocol."))
- return FALSE
- return TRUE
-
-/obj/structure/ai_core/transfer_ai(interaction, mob/user, mob/living/silicon/ai/AI, obj/item/aicard/card)
- if(state != AI_READY_CORE || !..())
- return
- if(core_mmi && core_mmi.brainmob)
- if(core_mmi.brainmob.mind)
- to_chat(user, span_warning("[src] already contains an active mind!"))
- return
- else if(suicide_check())
- to_chat(user, span_warning("[AI_CORE_BRAIN(core_mmi)] installed in [src] is completely useless!"))
- return
- //Transferring a carded AI to a core.
- if(interaction == AI_TRANS_FROM_CARD)
- AI.set_control_disabled(FALSE)
- AI.radio_enabled = TRUE
- AI.forceMove(loc) // to replace the terminal.
- to_chat(AI, span_notice("You have been uploaded to a stationary terminal. Remote device connection restored."))
- to_chat(user, "[span_boldnotice("Transfer successful")]: [AI.name] ([rand(1000,9999)].exe) installed and executed successfully. Local copy has been removed.")
- card.AI = null
- AI.battery = circuit.battery
- AI.posibrain_inside = isnull(core_mmi) || core_mmi.braintype == "Android"
- qdel(src)
- else //If for some reason you use an empty card on an empty AI terminal.
- to_chat(user, span_alert("There is no AI loaded on this terminal."))
-
-/obj/item/circuitboard/aicore
- name = "AI core (AI Core Board)" //Well, duh, but best to be consistent
- var/battery = 200 //backup battery for when the AI loses power. Copied to/from AI mobs when carding, and placed here to avoid recharge via deconning the core
-
-/obj/item/circuitboard/aicore/Initialize(mapload)
- . = ..()
- if(mapload && HAS_TRAIT(SSstation, STATION_TRAIT_HUMAN_AI))
- return INITIALIZE_HINT_QDEL
-
-#undef AI_CORE_BRAIN
diff --git a/code/modules/antagonists/malf_ai/malf_ai.dm b/code/modules/antagonists/malf_ai/malf_ai.dm
index f448670eeda..d35a00f8b7c 100644
--- a/code/modules/antagonists/malf_ai/malf_ai.dm
+++ b/code/modules/antagonists/malf_ai/malf_ai.dm
@@ -40,7 +40,6 @@
malfunction_flavor = strings(MALFUNCTION_FLAVOR_FILE, employer)
add_law_zero()
- RegisterSignal(owner.current, COMSIG_SILICON_AI_CORE_STATUS, PROC_REF(core_status))
if(malf_sound)
owner.current.playsound_local(get_turf(owner.current), malf_sound, 100, FALSE, pressure_affected = FALSE, use_reverb = FALSE)
owner.current.grant_language(/datum/language/codespeak, source = LANGUAGE_MALF)
@@ -57,7 +56,6 @@
malf_ai.remove_malf_abilities()
QDEL_NULL(malf_ai.malf_picker)
- UnregisterSignal(owner, COMSIG_SILICON_AI_CORE_STATUS)
return ..()
/// Generates a complete set of malf AI objectives up to the traitor objective limit.
@@ -271,14 +269,6 @@
return malf_ai_icon
-/datum/antagonist/malf_ai/proc/core_status(datum/source)
- SIGNAL_HANDLER
-
- var/mob/living/silicon/ai/malf_owner = owner.current
- if(malf_owner?.linked_core)
- return COMPONENT_CORE_ALL_GOOD
- return COMPONENT_CORE_DISCONNECTED
-
//Subtype of Malf AI datum, used for one of the traitor final objectives
/datum/antagonist/malf_ai/infected
name = "Infected AI"
diff --git a/code/modules/mob/living/silicon/ai/ai.dm b/code/modules/mob/living/silicon/ai/ai.dm
index 329a5f29823..67aa473c47e 100644
--- a/code/modules/mob/living/silicon/ai/ai.dm
+++ b/code/modules/mob/living/silicon/ai/ai.dm
@@ -5,7 +5,7 @@
/mob/living/silicon/ai/Initialize(mapload, datum/ai_laws/L, mob/target_ai)
. = ..()
if(!target_ai) //If there is no player/brain inside.
- new/obj/structure/ai_core/deactivated(loc) //New empty terminal.
+ new/obj/structure/ai_core(loc, CORE_STATE_FINISHED) //New empty terminal.
return INITIALIZE_HINT_QDEL //Delete AI.
ADD_TRAIT(src, TRAIT_NO_TELEPORT, AI_ANCHOR_TRAIT)
@@ -152,7 +152,7 @@
current = null
bot_ref = null
controlled_equipment = null
- linked_core = null
+ break_core_link()
apc_override = null
if(ai_voicechanger)
ai_voicechanger.owner = null
@@ -363,53 +363,45 @@
status_flags &= ~CANPUSH //we dont want the core to be push-able when anchored
ADD_TRAIT(src, TRAIT_NO_TELEPORT, AI_ANCHOR_TRAIT)
+/// Creates an MMI of the AI based on its configuration.
+/mob/living/silicon/ai/proc/make_mmi(atom/destination) as /obj/item/mmi
+ RETURN_TYPE(/obj/item/mmi)
+ //FIXME: this code is really bad, we shouldn't be doing most of this ourselves. MMI code needs a good refactoring....
+ var/obj/item/mmi/copied_mmi
+ if(posibrain_inside)
+ copied_mmi = new /obj/item/mmi/posibrain(destination, FALSE)
+ copied_mmi.name = "[initial(copied_mmi.name)] ([real_name])"
+ else
+ copied_mmi = new /obj/item/mmi(destination)
+ copied_mmi.name = "[initial(copied_mmi.name)]: [real_name]"
+ copied_mmi.brain = new /obj/item/organ/brain(copied_mmi)
+ copied_mmi.brain.organ_flags |= ORGAN_FROZEN
+ copied_mmi.brain.name = "[real_name]'s brain"
+ copied_mmi.set_brainmob(new /mob/living/brain(copied_mmi))
+ copied_mmi.brainmob.container = copied_mmi
+
+ copied_mmi.brainmob.name = real_name
+ copied_mmi.brainmob.real_name = real_name
+ copied_mmi.brainmob.gender = gender
+
+ var/suicided = HAS_TRAIT(src, TRAIT_SUICIDED)
+ copied_mmi.brainmob.set_suicide(suicided)
+ copied_mmi.brain?.suicided = suicided // we can't guarantee that the MMI has a brain... sigh
+
+ if(copied_mmi.brainmob.stat == DEAD && !suicided)
+ copied_mmi.brainmob.set_stat(CONSCIOUS)
+
+ copied_mmi.update_appearance()
+ return copied_mmi
+
/mob/living/silicon/ai/proc/ai_mob_to_structure()
disconnect_shell()
ShutOffDoomsdayDevice()
- var/obj/structure/ai_core/deactivated/ai_core = new(get_turf(src), /* skip_mmi_creation = */ TRUE)
- if(make_mmi_drop_and_transfer(ai_core.core_mmi, the_core = ai_core))
- qdel(src)
+ var/obj/structure/ai_core/ai_core = new(get_turf(src), CORE_STATE_FINISHED, make_mmi())
+ mind?.transfer_to(ai_core.core_mmi.brainmob)
+ qdel(src)
return ai_core
-/mob/living/silicon/ai/proc/break_core_link()
- to_chat(src, span_danger("Your core has been destroyed!"))
- linked_core = null
-
-/mob/living/silicon/ai/proc/make_mmi_drop_and_transfer(obj/item/mmi/the_mmi, the_core)
- var/mmi_type
- if(posibrain_inside)
- mmi_type = new/obj/item/mmi/posibrain(src, /* autoping = */ FALSE)
- else
- mmi_type = new/obj/item/mmi(src)
- if(hack_software)
- new/obj/item/malf_upgrade(get_turf(src))
- the_mmi = mmi_type
- the_mmi.brain = new /obj/item/organ/brain(the_mmi)
- the_mmi.brain.organ_flags |= ORGAN_FROZEN
- the_mmi.brain.name = "[real_name]'s brain"
- the_mmi.name = "[initial(the_mmi.name)]: [real_name]"
- the_mmi.set_brainmob(new /mob/living/brain(the_mmi))
- the_mmi.brainmob.name = src.real_name
- the_mmi.brainmob.real_name = src.real_name
- the_mmi.brainmob.container = the_mmi
- the_mmi.brainmob.gender = src.gender
-
- var/has_suicided_trait = HAS_TRAIT(src, TRAIT_SUICIDED)
- the_mmi.brainmob.set_suicide(has_suicided_trait)
- the_mmi.brain.suicided = has_suicided_trait
- if(the_core)
- var/obj/structure/ai_core/core = the_core
- core.core_mmi = the_mmi
- the_mmi.forceMove(the_core)
- else
- the_mmi.forceMove(get_turf(src))
- if(the_mmi.brainmob.stat == DEAD && !has_suicided_trait)
- the_mmi.brainmob.set_stat(CONSCIOUS)
- if(mind)
- mind.transfer_to(the_mmi.brainmob)
- the_mmi.update_appearance()
- return TRUE
-
/mob/living/silicon/ai/Topic(href, href_list)
..()
if(usr != src)
@@ -702,7 +694,7 @@
if(!istype(apc))
to_chat(owner, span_notice("You are already in your Main Core."))
return
- if(SEND_SIGNAL(owner, COMSIG_SILICON_AI_CORE_STATUS) & COMPONENT_CORE_ALL_GOOD)
+ if(astype(owner, /mob/living/silicon/ai)?.linked_core)
apc.malfvacate()
else
to_chat(owner, span_danger("Linked core not detected!"))
@@ -786,7 +778,7 @@
balloon_alert(user, "no intelligence detected!") // average tg coder am i right
return
ShutOffDoomsdayDevice()
- var/obj/structure/ai_core/new_core = new /obj/structure/ai_core/deactivated(loc, posibrain_inside)//Spawns a deactivated terminal at AI location.
+ var/obj/structure/ai_core/new_core = new /obj/structure/ai_core(loc, CORE_STATE_FINISHED, make_mmi())
new_core.circuit.battery = battery
ai_restore_power()//So the AI initially has power.
set_control_disabled(TRUE) //Can't control things remotely if you're stuck in a card!
@@ -1109,6 +1101,99 @@
SEND_SIGNAL(src, COMSIG_SILICON_AI_SET_CONTROL_DISABLED, control_disabled)
src.control_disabled = control_disabled
+
+/// Establishes a "core link" with a supplied core structure.
+/// This will register multiple signals and give the AI a strong reference to it.
+/// See [proc/resolve_core_link] or [proc/break_core_link] for ways to end the connection.
+/mob/living/silicon/ai/proc/create_core_link(obj/structure/ai_core/core)
+ if(linked_core) //uh oh
+ break_core_link(linked_core)
+ linked_core = core
+
+ //this block is kind of sketchy, but I don't think this should cause any problems
+ qdel(core.core_mmi)
+ core.core_mmi = make_mmi(core)
+
+ RegisterSignals(linked_core, list(COMSIG_ATOM_DESTRUCTION, COMSIG_QDELETING), PROC_REF(on_core_destroyed))
+ RegisterSignals(linked_core, list(
+ COMSIG_ATOM_ITEM_INTERACTION,
+ COMSIG_ATOM_TOOL_ACT(TOOL_CROWBAR),
+ COMSIG_ATOM_TOOL_ACT(TOOL_WRENCH),
+ COMSIG_ATOM_TOOL_ACT(TOOL_WELDER),
+ COMSIG_ATOM_TOOL_ACT(TOOL_WIRECUTTER),
+ COMSIG_ATOM_TOOL_ACT(TOOL_SCREWDRIVER),
+ ), PROC_REF(on_core_item_interaction))
+ RegisterSignal(linked_core, COMSIG_ATOM_TAKE_DAMAGE, PROC_REF(on_core_take_damage))
+ RegisterSignal(linked_core, COMSIG_ATOM_EXITED, PROC_REF(on_core_exited))
+
+/// Elegantly closes the AI's link to a core structure,
+/// moving them to its location and cleaning it up. This is generally what you want to call.
+/// Prefer calling [proc/break_core_link] directly if the connection is meant to be suddenly severed.
+/mob/living/silicon/ai/proc/resolve_core_link()
+ if(!linked_core) //oh no bro
+ CRASH("tried to resolve a core link with no core!!!!")
+
+ forceMove(linked_core.loc)
+ var/obj/structure/ai_core/unlinked_core = linked_core
+ break_core_link()
+ qdel(unlinked_core)
+ cancel_camera()
+
+/// Handles unregistering the AI from its core. The core itself will not be cleaned up.
+/// Prefer calling [proc/resolve_core_link] if the connection is being closed elegantly.
+/mob/living/silicon/ai/proc/break_core_link()
+ if(!linked_core)
+ return
+
+ UnregisterSignal(linked_core, list(
+ COMSIG_QDELETING, COMSIG_ATOM_DESTRUCTION, //on_core_destroyed
+ //on_core_item_interaction
+ COMSIG_ATOM_ITEM_INTERACTION,
+ COMSIG_ATOM_TOOL_ACT(TOOL_CROWBAR),
+ COMSIG_ATOM_TOOL_ACT(TOOL_WRENCH),
+ COMSIG_ATOM_TOOL_ACT(TOOL_WELDER),
+ COMSIG_ATOM_TOOL_ACT(TOOL_WIRECUTTER),
+ COMSIG_ATOM_TOOL_ACT(TOOL_SCREWDRIVER),
+ COMSIG_ATOM_TAKE_DAMAGE, //on_core_take_damage
+ COMSIG_ATOM_EXITED, //on_core_exited
+ ))
+ linked_core = null
+
+/mob/living/silicon/ai/proc/on_core_item_interaction(datum/source, mob/living/user, obj/item/tool, list/processing_recipes)
+ SIGNAL_HANDLER
+ if(user.combat_mode)
+ return NONE
+
+ to_chat(src, span_danger("CORE TAMPERING DETECTED!"))
+ return NONE
+
+/mob/living/silicon/ai/proc/on_core_take_damage(datum/source, damage_taken, ...)
+ SIGNAL_HANDLER
+
+ if(damage_taken > 0)
+ to_chat(src, span_danger("CORE DAMAGE DETECTED!"))
+ return NONE
+
+/mob/living/silicon/ai/proc/on_core_destroyed(datum/source, damage_flag)
+ SIGNAL_HANDLER
+
+ to_chat(src, span_danger("Your core has been destroyed!"))
+ ShutOffDoomsdayDevice()
+ break_core_link()
+
+/mob/living/silicon/ai/proc/on_core_exited(datum/source, atom/movable/gone, direction)
+ SIGNAL_HANDLER
+
+ if(istype(gone, /obj/item/mmi))
+ var/obj/item/mmi/mmi_gone = gone
+ on_core_destroyed(source, NONE)
+ if(!IS_MALF_AI(src)) //don't pull back shunted malf AIs
+ death(gibbed = TRUE, drop_mmi = FALSE)
+ ///the drop_mmi param determines whether the MMI is dropped at their current location
+ ///which in this case would be somewhere else, so we drop their MMI at the core instead
+ mind?.transfer_to(mmi_gone.brainmob)
+ qdel(src)
+
#undef HOLOGRAM_CHOICE_CHARACTER
#undef CHARACTER_TYPE_SELF
#undef CHARACTER_TYPE_CREWMEMBER
diff --git a/code/modules/mob/living/silicon/ai/ai_defines.dm b/code/modules/mob/living/silicon/ai/ai_defines.dm
index de631e7b867..30201c9e703 100644
--- a/code/modules/mob/living/silicon/ai/ai_defines.dm
+++ b/code/modules/mob/living/silicon/ai/ai_defines.dm
@@ -122,8 +122,8 @@
/* REMOTE CONTROL */
/// Equipment that the AI is controlling remotely, to determine whether to relaymove or use the AI eye
VAR_FINAL/obj/controlled_equipment
- /// AI core that this AI is linked to, used when put into an exosuit
- VAR_FINAL/obj/structure/ai_core/deactivated/linked_core
+ /// AI core that this AI is linked to. See [proc/create_core_link] [proc/resolve_core_link] [proc/break_core_link]
+ VAR_FINAL/obj/structure/ai_core/linked_core
/// Robot that this AI is currently using
VAR_FINAL/mob/living/silicon/robot/deployed_shell
/// Action to deploy to a shell from a list of options
diff --git a/code/modules/mob/living/silicon/ai/death.dm b/code/modules/mob/living/silicon/ai/death.dm
index aad3df39d80..6f76f3294a9 100644
--- a/code/modules/mob/living/silicon/ai/death.dm
+++ b/code/modules/mob/living/silicon/ai/death.dm
@@ -34,7 +34,8 @@
ShutOffDoomsdayDevice()
if(gibbed && drop_mmi)
- make_mmi_drop_and_transfer()
+ var/obj/item/mmi/loose_cpu = make_mmi(get_turf(src))
+ mind?.transfer_to(loose_cpu.brainmob)
if(explodes_on_death)
addtimer(CALLBACK(GLOBAL_PROC, GLOBAL_PROC_REF(explosion), loc, 3, 6, 12, null, 15), 1 SECONDS)
@@ -42,7 +43,5 @@
SSblackbox.ReportDeath(src)
/mob/living/silicon/ai/proc/ShutOffDoomsdayDevice()
- if(nuking)
- nuking = FALSE
- if(doomsday_device)
- qdel(doomsday_device)
+ nuking = FALSE
+ QDEL_NULL(doomsday_device)
diff --git a/code/modules/power/apc/apc_malf.dm b/code/modules/power/apc/apc_malf.dm
index c4cafb9d5e7..eb0526e32ca 100644
--- a/code/modules/power/apc/apc_malf.dm
+++ b/code/modules/power/apc/apc_malf.dm
@@ -45,8 +45,7 @@
malf.ShutOffDoomsdayDevice()
occupier = malf
if (isturf(malf.loc)) // create a deactivated AI core if the AI isn't coming from an emergency mech shunt
- malf.linked_core = new /obj/structure/ai_core/deactivated(malf.loc)
- malf.linked_core.remote_ai = malf // note that we do not set the deactivated core's core_mmi.brainmob
+ malf.create_core_link(new /obj/structure/ai_core(malf.loc, CORE_STATE_FINISHED, malf.make_mmi()))
malf.forceMove(src) // move INTO the APC, not to its tile
if(!findtext(occupier.name, "APC Copy"))
occupier.name = "[malf.name] APC Copy"
@@ -74,9 +73,7 @@
return
if(occupier.linked_core)
occupier.shunted = FALSE
- occupier.forceMove(occupier.linked_core.loc)
- qdel(occupier.linked_core)
- occupier.cancel_camera()
+ occupier.resolve_core_link()
occupier = null
else
stack_trace("An AI: [occupier] has vacated an APC with no linked core and without being gibbed.")
diff --git a/code/modules/vehicles/mecha/_mecha.dm b/code/modules/vehicles/mecha/_mecha.dm
index b666a013479..44690288175 100644
--- a/code/modules/vehicles/mecha/_mecha.dm
+++ b/code/modules/vehicles/mecha/_mecha.dm
@@ -332,6 +332,7 @@
var/mob/living/silicon/ai/unlucky_ai
for(var/mob/living/occupant as anything in occupants)
if(isAI(occupant))
+ //FIXME: Nothiing about this block works
var/mob/living/silicon/ai/ai = occupant
if(!ai.linked_core && !ai.can_shunt) // we probably shouldnt gib AIs with a core or shunting abilities
unlucky_ai = occupant
diff --git a/code/modules/vehicles/mecha/mecha_ai_interaction.dm b/code/modules/vehicles/mecha/mecha_ai_interaction.dm
index 02bc2c89953..7a13e423bb4 100644
--- a/code/modules/vehicles/mecha/mecha_ai_interaction.dm
+++ b/code/modules/vehicles/mecha/mecha_ai_interaction.dm
@@ -78,10 +78,7 @@
return
if(AI_MECH_HACK) //Called by AIs on the mech
- var/obj/structure/ai_core/deactivated/deactivated_core = new(AI.loc, FALSE, FALSE, AI)
- AI.linked_core = deactivated_core
- AI.linked_core.RegisterSignal(deactivated_core, COMSIG_ATOM_DESTRUCTION, TYPE_PROC_REF(/obj/structure/ai_core/deactivated, disable_doomsday)) //Protect that core! The structure goes bye-bye when we re-shunt back in so no need for cleanup.
- AI.linked_core.remote_ai = AI
+ AI.create_core_link(new /obj/structure/ai_core(AI.loc, CORE_STATE_FINISHED, AI.make_mmi()))
if(AI.can_dominate_mechs && LAZYLEN(occupants)) //Oh, I am sorry, were you using that?
to_chat(AI, span_warning("Occupants detected! Forced ejection initiated!"))
to_chat(occupants, span_danger("You have been forcibly ejected!"))
diff --git a/code/modules/vehicles/mecha/mecha_mob_interaction.dm b/code/modules/vehicles/mecha/mecha_mob_interaction.dm
index f5bf2fed81c..57250ecb437 100644
--- a/code/modules/vehicles/mecha/mecha_mob_interaction.dm
+++ b/code/modules/vehicles/mecha/mecha_mob_interaction.dm
@@ -111,7 +111,9 @@
brain_mob.log_message("was put into [src] by [key_name(user)]", LOG_GAME, log_globally = FALSE)
return TRUE
+
/obj/vehicle/sealed/mecha/mob_exit(mob/M, silent = FALSE, randomstep = FALSE, forced = FALSE)
+ // FIXME: this code is really bad (shocker). Needs a refactor
var/atom/movable/mob_container
var/turf/newloc = get_turf(src)
if(ishuman(M))
@@ -147,9 +149,7 @@
if(!forced && !silent)
to_chat(AI, span_notice("Returning to core..."))
mecha_flags &= ~SILICON_PILOT
- newloc = get_turf(AI.linked_core)
- qdel(AI.linked_core)
- AI.forceMove(newloc)
+ AI.resolve_core_link()
if(forced)
to_chat(AI, span_danger("ZZUZULU.ERR--ERRR-NEUROLOG-- PERCEP--- DIST-B**@"))
for(var/count in 1 to 5)
diff --git a/icons/mob/silicon/ai.dmi b/icons/mob/silicon/ai.dmi
index df9059fb09e6af97b2aaa6398c6550824f18d91f..be9060ecd554476f96109397ba4d9581f4b35258 100644
GIT binary patch
literal 419436
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