antagonist

Vars
antag_hud_name	Name of the antag hud we provide to this mob.
antag_hud_type	What is the configuration of this antagonist's hud icon, such as it's screen position and style, so thatit doesn't break other in-game hud icons.
antag_memory	String dialogue that is added to the player's in-round notes and memories regarding specifics of that antagonist, eg. the nuke code for nuke ops, or your unlock code for traitors.
antag_moodlet	typepath of moodlet that the mob will gain when granted this antagonist type.
antagpanel_category	Antagpanel will display these together, REQUIRED
blacklisted_quirks	Quirks that will be removed upon gaining this antag. Pacifist and mute are default.
can_coexist_with_others	Whether or not the person will be able to have more than one datum
hijack_speed	If above 0, this is the multiplier for the speed at which we hijack the shuttle. Do not directly read, use hijack_speed().
info_button	button to access antag interface
job_rank	The define string we use to identify the role for bans/player polls to spawn a random new one in.
name	Public name for this antagonist. Appears for player prompts and round-end reports.
objectives	List of the objective datums that this role currently has, completing all objectives at round-end will cause this antagonist to greentext.
owner	Mind that owns this datum
prevent_roundtype_conversion	If false, the roundtype will still convert with this antag active
preview_outfit	The typepath for the outfit to show in the preview for the preferences menu.
replace_banned	Should replace jobbanned player with ghosts if granted.
requested_objective_changes	Lazy list for antagonists to request the admins objectives.
roundend_category	Section of roundend report, datums with same category will be displayed together, also default header for the section
show_in_antagpanel	This will hide adding this antag type in antag panel, use only for internal subtypes that shouldn't be added directly but still show if possessed by mind
show_in_roundend	Set to false to hide the antagonists from roundend report
show_name_in_check_antagonists	Will append antagonist name in admin listings - use for categories that share more than one antag type
show_to_ghosts	Should this antagonist be shown as antag to ghosts? Shouldn't be used for stealthy antagonists like traitors
silent	Silent will prevent the gain/lose texts to show
soft_antag	If set to true, the antag will not be added to the living antag list.
suicide_cry	The battlecry this antagonist shouts when suiciding with C4/X4.
threat	Amount of threat this antag poses, for dynamic mode
typecache_datum_blacklist	List of datums this type can't coexist with
ui_name	name of the UI that will try to open, right now having nothing means this won't exist but in the future all should.
Procs
antag_panel_data	Additional data to display in the antagonist panel section. For example, nuke disk code, genome count, etc
clean_request_from_del_objective	Clears change requests from deleted objectives to avoid broken references.
clear_antag_moodies	Proc that removes this antagonist's ascribed moodlet from the player.
farewell	Proc that sends fluff or instructional messages to the player when they lose this antag datum. Use this proc for playing sounds, sending alerts, or otherwise informing the player that they're no longer a specific antagonist type.
finish_preview_icon	Given an icon, will crop it to be consistent of those in the preferences menu. Not necessary, and in fact will look bad if it's anything other than a human.
get_admin_commands	List of ["Command"] = CALLBACK(), user will be appeneded to callback arguments on execution
get_objectives	generic helper to send objectives as data through tgui. supports smart objectives too!
get_preview_icon	Returns the icon to show on the preferences menu.
get_team	Proc that will return the team this antagonist belongs to, when called. Helpful with antagonists that may belong to multiple potential teams in a single round, like families.
give_antag_moodies	Proc that assigns this antagonist's ascribed moodlet to the player.
greet	Proc that sends fluff or instructional messages to the player when they are given this antag datum. Use this proc for playing sounds, sending alerts, or helping to setup non-gameplay influencing aspects of the antagonist type.
handle_clown_mutation	Handles adding and removing the clumsy mutation from clown antags. Gets called in apply/remove_innate_effects
hijack_speed	Gets how fast we can hijack the shuttle, return FALSE for can not hijack. Defaults to hijack_speed var, override for custom stuff like buffing hijack speed for hijack objectives or something.
is_banned	Proc that checks the sent mob aganst the banlistfor this antagonist. Returns FALSE if no mob is sent, or the mob is not found to be banned.
on_body_transfer	Called by the transfer_to() mind proc after the mind (mind.current and new_character.mind) has moved but before the player (key and client) is transfered.
on_gain	Called by the add_antag_datum() mind proc after the instanced datum is added to the mind's antag_datums list.
on_mindshield	This is called when the antagonist is successfully mindshielded.
on_removal	Called by the remove_antag_datum() and remove_all_antag_datums() mind procs for the antag datum to handle its own removal and deletion.
pre_mindshield	This is called when the antagonist is being mindshielded.
remove_blacklisted_quirks	Removes invalid quirks.
render_preview_outfit	Creates an icon from the preview outfit. Custom implementors of `get_preview_icon` should use this, as the result of `get_preview_icon` is expected to be the completed version.
replace_banned_player	Proc that replaces a player who cannot play a specific antagonist due to being banned via a poll, and alerts the player of their being on the banlist.
roundend_report	Proc that sends string information for the end-round report window to the server. This runs on every instance of every antagonist that exists at the end of the round. This is the body of the message, sandwiched between roundend_report_header and roundend_report_footer.
roundend_report_footer	Proc that sends string data for the round-end report. Displayed after roundend_report and roundend_report_footer. Appears at the end of the roundend_catagory section.
roundend_report_header	Proc that sends string data for the round-end report. Displayed before roundend_report and roundend_report_footer. Appears at start of roundend_catagory section.
threat	Gets our threat level. Override this proc for custom functionality/dynamic threat level.
ui_interact	ANTAGONIST UI STUFF

Var Details

var
antag_hud_name
–

Name of the antag hud we provide to this mob.

var
antag_hud_type
–

What is the configuration of this antagonist's hud icon, such as it's screen position and style, so thatit doesn't break other in-game hud icons.

var
antag_memory
–

String dialogue that is added to the player's in-round notes and memories regarding specifics of that antagonist, eg. the nuke code for nuke ops, or your unlock code for traitors.

var
antag_moodlet
–

typepath of moodlet that the mob will gain when granted this antagonist type.

var
antagpanel_category
–

Antagpanel will display these together, REQUIRED

var
blacklisted_quirks
– /list

Quirks that will be removed upon gaining this antag. Pacifist and mute are default.

var
can_coexist_with_others
–

Whether or not the person will be able to have more than one datum

var
hijack_speed
–

If above 0, this is the multiplier for the speed at which we hijack the shuttle. Do not directly read, use hijack_speed().

var
info_button
– /datum/action/antag_info

button to access antag interface

var
job_rank
–

The define string we use to identify the role for bans/player polls to spawn a random new one in.

var
name
–

Public name for this antagonist. Appears for player prompts and round-end reports.

var
objectives
– /list

List of the objective datums that this role currently has, completing all objectives at round-end will cause this antagonist to greentext.

var
owner
– /datum/mind

Mind that owns this datum

var
prevent_roundtype_conversion
–

If false, the roundtype will still convert with this antag active

var
preview_outfit
–

The typepath for the outfit to show in the preview for the preferences menu.

var
replace_banned
–

Should replace jobbanned player with ghosts if granted.

var
requested_objective_changes
– /list

Lazy list for antagonists to request the admins objectives.

var
roundend_category
–

Section of roundend report, datums with same category will be displayed together, also default header for the section

var
show_in_antagpanel
–

This will hide adding this antag type in antag panel, use only for internal subtypes that shouldn't be added directly but still show if possessed by mind

var
show_in_roundend
–

Set to false to hide the antagonists from roundend report

var
show_name_in_check_antagonists
–

Will append antagonist name in admin listings - use for categories that share more than one antag type

var
show_to_ghosts
–

Should this antagonist be shown as antag to ghosts? Shouldn't be used for stealthy antagonists like traitors

var
silent
–

Silent will prevent the gain/lose texts to show

var
soft_antag
–

If set to true, the antag will not be added to the living antag list.

var
suicide_cry
–

The battlecry this antagonist shouts when suiciding with C4/X4.

var
threat
–

Amount of threat this antag poses, for dynamic mode

var
typecache_datum_blacklist
– /list

List of datums this type can't coexist with

var
ui_name
–

name of the UI that will try to open, right now having nothing means this won't exist but in the future all should.

Proc Details

proc
antag_panel_data
()

Additional data to display in the antagonist panel section. For example, nuke disk code, genome count, etc

proc
clean_request_from_del_objective
(/datum/objective/source, force)

Clears change requests from deleted objectives to avoid broken references.

proc
clear_antag_moodies
()

Proc that removes this antagonist's ascribed moodlet from the player.

proc
farewell
()

Proc that sends fluff or instructional messages to the player when they lose this antag datum. Use this proc for playing sounds, sending alerts, or otherwise informing the player that they're no longer a specific antagonist type.

proc
finish_preview_icon
(/icon/icon)

Given an icon, will crop it to be consistent of those in the preferences menu. Not necessary, and in fact will look bad if it's anything other than a human.

proc
get_admin_commands
()

List of ["Command"] = CALLBACK(), user will be appeneded to callback arguments on execution

proc
get_objectives
()

generic helper to send objectives as data through tgui. supports smart objectives too!

proc
get_preview_icon
()

Returns the icon to show on the preferences menu.

proc
get_team
()

Proc that will return the team this antagonist belongs to, when called. Helpful with antagonists that may belong to multiple potential teams in a single round, like families.

proc
give_antag_moodies
()

Proc that assigns this antagonist's ascribed moodlet to the player.

proc
greet
()

Proc that sends fluff or instructional messages to the player when they are given this antag datum. Use this proc for playing sounds, sending alerts, or helping to setup non-gameplay influencing aspects of the antagonist type.

proc
handle_clown_mutation
(/mob/living/mob_override, message, removing)

Handles adding and removing the clumsy mutation from clown antags. Gets called in apply/remove_innate_effects

proc
hijack_speed
()

Gets how fast we can hijack the shuttle, return FALSE for can not hijack. Defaults to hijack_speed var, override for custom stuff like buffing hijack speed for hijack objectives or something.

proc
is_banned
(/mob/M)

Proc that checks the sent mob aganst the banlistfor this antagonist. Returns FALSE if no mob is sent, or the mob is not found to be banned.

mob/M: The mob that you are looking for on the banlist.

proc
on_body_transfer
(/mob/living/old_body, /mob/living/new_body)

Called by the transfer_to() mind proc after the mind (mind.current and new_character.mind) has moved but before the player (key and client) is transfered.

proc
on_gain
()

Called by the add_antag_datum() mind proc after the instanced datum is added to the mind's antag_datums list.

proc
on_mindshield
(/mob/implanter, /mob/living/mob_override)

This is called when the antagonist is successfully mindshielded.

proc
on_removal
()

Called by the remove_antag_datum() and remove_all_antag_datums() mind procs for the antag datum to handle its own removal and deletion.

proc
pre_mindshield
(/mob/implanter, /mob/living/mob_override)

This is called when the antagonist is being mindshielded.

proc
remove_blacklisted_quirks
()

Removes invalid quirks.

proc
render_preview_outfit
(/datum/outfit/outfit, /mob/living/carbon/human/dummy)

Creates an icon from the preview outfit. Custom implementors of get_preview_icon should use this, as the result of get_preview_icon is expected to be the completed version.

proc
replace_banned_player
()

Proc that replaces a player who cannot play a specific antagonist due to being banned via a poll, and alerts the player of their being on the banlist.

proc
roundend_report
()

Proc that sends string information for the end-round report window to the server. This runs on every instance of every antagonist that exists at the end of the round. This is the body of the message, sandwiched between roundend_report_header and roundend_report_footer.

proc
roundend_report_footer
()

Proc that sends string data for the round-end report. Displayed after roundend_report and roundend_report_footer. Appears at the end of the roundend_catagory section.

proc
roundend_report_header
()

Proc that sends string data for the round-end report. Displayed before roundend_report and roundend_report_footer. Appears at start of roundend_catagory section.

proc
threat
()

Gets our threat level. Override this proc for custom functionality/dynamic threat level.

↑
ui_interact
(/mob/user, /datum/tgui/ui)

ANTAGONIST UI STUFF

antagonist /datum/antagonist

Vars

Procs

Var Details

var antag_hud_name –

var antag_hud_type –

var antag_memory –

var antag_moodlet –

var antagpanel_category –

var blacklisted_quirks – /list

var can_coexist_with_others –

var hijack_speed –

var info_button – /datum/action/antag_info

var job_rank –

var name –

var objectives – /list

var owner – /datum/mind

var prevent_roundtype_conversion –

var preview_outfit –

var replace_banned –

var requested_objective_changes – /list

var roundend_category –

var show_in_antagpanel –

var show_in_roundend –

var show_name_in_check_antagonists –

var show_to_ghosts –

var silent –

var soft_antag –

var suicide_cry –

var threat –

var typecache_datum_blacklist – /list

var ui_name –

Proc Details

proc antag_panel_data()

proc clean_request_from_del_objective(/datum/objective/source, force)

proc clear_antag_moodies()

proc farewell()

proc finish_preview_icon(/icon/icon)

proc get_admin_commands()

proc get_objectives()

proc get_preview_icon()

proc get_team()

proc give_antag_moodies()

proc greet()

proc handle_clown_mutation(/mob/living/mob_override, message, removing)

proc hijack_speed()

proc is_banned(/mob/M)

proc on_body_transfer(/mob/living/old_body, /mob/living/new_body)

proc on_gain()

proc on_mindshield(/mob/implanter, /mob/living/mob_override)

proc on_removal()

proc pre_mindshield(/mob/implanter, /mob/living/mob_override)

proc remove_blacklisted_quirks()

proc render_preview_outfit(/datum/outfit/outfit, /mob/living/carbon/human/dummy)

proc replace_banned_player()

proc roundend_report()

proc roundend_report_footer()

proc roundend_report_header()

proc threat()

↑ui_interact(/mob/user, /datum/tgui/ui)