antagonist

Vars
antag_datum_blacklist	List of other antag datum types that this type can't coexist with.
antag_hud_name	Holds the name of the hud's icon in the .dmi files, i.e "hudtraitor", "hudvampire", etc.
antag_hud_type	Holds the type of antagonist hud this datum will get, i.e. `ANTAG_HUD_TRAITOR`, `ANTAG_HUD_VAMPIRE`, etc.
antag_memory	Antagonist datum specific information that appears in the player's notes. Information stored here will be removed when the datum is removed from the player.
antag_menu_name	Role name in antag menu
assigned_targets	A list of strings which contain targets of the antagonist's objectives. Used to prevent duplicate objectives.
clown_gain_text	If the owner is a clown, this text will be displayed to them when they gain this datum.
clown_removal_text	If the owner is a clown, this text will be displayed to them when they lose this datum.
delete_on_mind_deletion	If current antag datum should be deleted on mind deletion.
give_objectives	Should we automatically give this antagonist objectives upon them gaining the datum?
job_rank	Used to determine if the player jobbanned from this role. Things like `SPECIAL_ROLE_TRAITOR` should go here to determine the role.
name	The name of the antagonist.
objectives	List of objectives connected to this datum.
owner	Mind that owns this datum.
replace_banned	Should we replace the role-banned player with a ghost?
roundend_category	Section of roundend report, datums with same category will be displayed together, also default header for the section.
russian_wiki_name	Russian name of wiki page
show_in_orbit	Show antag in ghost orbit
show_in_roundend	Set to false to hide the antagonists from roundend report.
silent	Silent will prevent the gain/lose texts to show.
special_role	The special role that will be applied to the owner's `special_role` var. i.e. `SPECIAL_ROLE_TRAITOR`, `SPECIAL_ROLE_VAMPIRE`.
team	Current antagonist teams
wiki_page_name	If antagonist has his own wiki page
Procs
add_antag_hud	Adds this datum's antag hud to `antag_mob`.
add_objective	Create and add an objective of the given type.
add_owner_to_gamemode	Adds the owner to their respective gamemode's list. For example `SSticker.mode.traitors \|= owner`.
announce_objectives	Announces all objectives of this datum, and only this datum.
apply_innate_effects	This handles the application of antag huds/special abilities.
can_be_owned	Loops through the owner's `antag_datums` list and determines if this one is blacklisted by any others.
check_anatag_menu_ability	Return if antag shows in antag menu
create_team	Creates a new antagonist team.
farewell	Displays a message to the antag mob while the datum is being deleted, i.e. "Your powers are gone and you're no longer a vampire!"
finalize_antag	Give the antag any final information or items.
forge_single_objective	Create and assign a single randomized objective.
get_antag_menu_name	Return name for antag menu
get_team	Returns the team the antagonist belongs to, if any.
give_objectives	Give the antagonist their objectives. Base proc, override as needed.
greet	Displays a message and their objectives to the antag mob after the datum is added to them, i.e. "Greetings you are a traitor! etc.
handle_clown_mutation	Handles adding and removing the clumsy mutation from clown antags.
handle_last_instance_removal	When our datum was last and became removed.
is_banned	Checks if the person trying to receive this datum is role banned from it.
on_body_transfer	Removes antagonist datum effects from the old body and applies it to the new one.
on_gain	Proc called when the datum is given to a mind.
remove_antag_hud	Removes this datum's antag hud from `antag_mob`.
remove_innate_effects	This handles the removal of antag huds/special abilities.
remove_owner_from_gamemode	Removes the owner from their respective gamemode's list. For example `SSticker.mode.traitors -= owner`.
replace_banned_player	Attempts to replace the role banned antag with a ghost player.
restore_last_hud_and_role	Re-sets the antag hud and `special_role` of the owner to that of the previous antag datum they had before this one was added.
roundend_report	Individual roundend report.
roundend_report_footer	Displayed at the end of roundend_category section.
roundend_report_header	Displayed at the start of roundend_category section, default to roundend_category header.

Var Details

var
antag_datum_blacklist
– /list

List of other antag datum types that this type can't coexist with.

var
antag_hud_name
–

Holds the name of the hud's icon in the .dmi files, i.e "hudtraitor", "hudvampire", etc.

var
antag_hud_type
–

Holds the type of antagonist hud this datum will get, i.e. ANTAG_HUD_TRAITOR, ANTAG_HUD_VAMPIRE, etc.

var
antag_memory
–

Antagonist datum specific information that appears in the player's notes. Information stored here will be removed when the datum is removed from the player.

var
antag_menu_name
–

Role name in antag menu

var
assigned_targets
– /list

A list of strings which contain targets of the antagonist's objectives. Used to prevent duplicate objectives.

var
clown_gain_text
–

If the owner is a clown, this text will be displayed to them when they gain this datum.

var
clown_removal_text
–

If the owner is a clown, this text will be displayed to them when they lose this datum.

var
delete_on_mind_deletion
–

If current antag datum should be deleted on mind deletion.

var
give_objectives
–

Should we automatically give this antagonist objectives upon them gaining the datum?

var
job_rank
–

Used to determine if the player jobbanned from this role. Things like SPECIAL_ROLE_TRAITOR should go here to determine the role.

var
name
–

The name of the antagonist.

var
objectives
– /list

List of objectives connected to this datum.

var
owner
– /datum/mind

Mind that owns this datum.

var
replace_banned
–

Should we replace the role-banned player with a ghost?

var
roundend_category
–

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

var
russian_wiki_name
–

Russian name of wiki page

var
show_in_orbit
–

Show antag in ghost orbit

var
show_in_roundend
–

Set to false to hide the antagonists from roundend report.

var
silent
–

Silent will prevent the gain/lose texts to show.

var
special_role
–

The special role that will be applied to the owner's special_role var. i.e. SPECIAL_ROLE_TRAITOR, SPECIAL_ROLE_VAMPIRE.

var
team
– /datum/team

Current antagonist teams

var
wiki_page_name
–

If antagonist has his own wiki page

Proc Details

proc
add_antag_hud
(/mob/living/antag_mob)

Adds this datum's antag hud to antag_mob.

Arguments:

antag_mob - the mob to add the antag hud to.

proc
add_objective
(objective_type, explanation_text, /mob/target_override)

Create and add an objective of the given type.

If the given objective type needs a target, it will try to find a target which isn't already the target of different objective for this antag. If one cannot be found, it tries one more time. If one still cannot be found, it will be added as a "Free Objective" without a target.

Arguments:

objective_type - A type path of an objective, for example: /datum/objective/steal
explanation_text - the explanation text that will be passed into the objective's New() proc
mob/target_override - a target for the objective

proc
add_owner_to_gamemode
()

Adds the owner to their respective gamemode's list. For example SSticker.mode.traitors |= owner.

proc
announce_objectives
()

Announces all objectives of this datum, and only this datum.

proc
apply_innate_effects
(/mob/living/mob_override)

This handles the application of antag huds/special abilities.

Gives the antag mob their assigned hud. If they're a clown, removes their clumsy mutataion.

Arguments:

mob/living/mob_override - a mob to apply effects to. Can be null.

proc
can_be_owned
(/datum/mind/new_owner)

Loops through the owner's antag_datums list and determines if this one is blacklisted by any others.

If it's in one of their blacklists, return FALSE. It cannot coexist with the datum we're trying to add here.

proc
check_anatag_menu_ability
()

Return if antag shows in antag menu

proc
create_team
(/datum/team/team)

Creates a new antagonist team.

proc
farewell
()

Displays a message to the antag mob while the datum is being deleted, i.e. "Your powers are gone and you're no longer a vampire!"

Called when datum is qdeled if silent is set to FALSE.

proc
finalize_antag
()

Give the antag any final information or items.

proc
forge_single_objective
()

Create and assign a single randomized objective.

proc
get_antag_menu_name
()

Return name for antag menu

proc
get_team
()

Returns the team the antagonist belongs to, if any.

proc
give_objectives
()

Give the antagonist their objectives. Base proc, override as needed.

proc
greet
()

Displays a message and their objectives to the antag mob after the datum is added to them, i.e. "Greetings you are a traitor! etc.

Called in on_gain() if silent it set to FALSE.

proc
handle_clown_mutation
(/mob/living/carbon/human/clown, message, granting_datum)

Handles adding and removing the clumsy mutation from clown antags.

Arguments:

clown - the mob in which to add or remove clumsy from.
message - the chat message to display to them the clown mob
granting_datum - TRUE if the datum is being applied to the clown mob.

proc
handle_last_instance_removal
()

When our datum was last and became removed.

proc
is_banned
(/mob/user)

Checks if the person trying to receive this datum is role banned from it.

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

Removes antagonist datum effects from the old body and applies it to the new one.

Called in the/datum/mind/proc/transfer_to().

Arguments:

new_body - the new body the antag mob is transferring into.
old_body - the old body the antag mob is leaving.

proc
on_gain
()

Proc called when the datum is given to a mind.

proc
remove_antag_hud
(/mob/living/antag_mob)

Removes this datum's antag hud from antag_mob.

Arguments:

antag_mob - the mob to remove the antag hud from.

proc
remove_innate_effects
(/mob/living/mob_override)

This handles the removal of antag huds/special abilities.

Removes the antag's assigned hud. If they're a clown, gives them back their clumsy mutataion.

Arguments:

mob/living/mob_override - a mob to remove effects from. Can be null.

proc
remove_owner_from_gamemode
()

Removes the owner from their respective gamemode's list. For example SSticker.mode.traitors -= owner.

proc
replace_banned_player
()

Attempts to replace the role banned antag with a ghost player.

proc
restore_last_hud_and_role
()

Re-sets the antag hud and special_role of the owner to that of the previous antag datum they had before this one was added.

For example, if the owner has a traitor datum and a vampire datum, both at index 1 and 2 respectively, After the vampire datum gets removed, it sets the owner's antag hud/role to whatever is set for traitor datum.

proc
roundend_report
()

Individual roundend report.

proc
roundend_report_footer
()

Displayed at the end of roundend_category section.

proc
roundend_report_header
()

Displayed at the start of roundend_category section, default to roundend_category header.

antagonist /datum/antagonist

Vars

Procs

Var Details

var antag_datum_blacklist – /list

var antag_hud_name –

var antag_hud_type –

var antag_memory –

var antag_menu_name –

var assigned_targets – /list

var clown_gain_text –

var clown_removal_text –

var delete_on_mind_deletion –

var give_objectives –

var job_rank –

var name –

var objectives – /list

var owner – /datum/mind

var replace_banned –

var roundend_category –

var russian_wiki_name –

var show_in_orbit –

var show_in_roundend –

var silent –

var special_role –

var team – /datum/team

var wiki_page_name –

Proc Details

proc add_antag_hud(/mob/living/antag_mob)

proc add_objective(objective_type, explanation_text, /mob/target_override)

proc add_owner_to_gamemode()

proc announce_objectives()

proc apply_innate_effects(/mob/living/mob_override)

proc can_be_owned(/datum/mind/new_owner)

proc check_anatag_menu_ability()

proc create_team(/datum/team/team)

proc farewell()

proc finalize_antag()

proc forge_single_objective()

proc get_antag_menu_name()

proc get_team()

proc give_objectives()

proc greet()

proc handle_clown_mutation(/mob/living/carbon/human/clown, message, granting_datum)

proc handle_last_instance_removal()

proc is_banned(/mob/user)

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

proc on_gain()

proc remove_antag_hud(/mob/living/antag_mob)

proc remove_innate_effects(/mob/living/mob_override)

proc remove_owner_from_gamemode()

proc replace_banned_player()

proc restore_last_hud_and_role()

proc roundend_report()

proc roundend_report_footer()

proc roundend_report_header()

antagonist
/datum/antagonist

var
antag_datum_blacklist
– /list

var
antag_hud_name
–

var
antag_hud_type
–

var
antag_memory
–

var
antag_menu_name
–

var
assigned_targets
– /list

var
clown_gain_text
–

var
clown_removal_text
–

var
delete_on_mind_deletion
–

var
give_objectives
–

var
job_rank
–

var
name
–

var
objectives
– /list

var
owner
– /datum/mind

var
replace_banned
–

var
roundend_category
–

var
russian_wiki_name
–

var
show_in_orbit
–

var
show_in_roundend
–

var
silent
–

var
special_role
–

var
team
– /datum/team

var
wiki_page_name
–

proc
add_antag_hud
(/mob/living/antag_mob)

proc
add_objective
(objective_type, explanation_text, /mob/target_override)

proc
add_owner_to_gamemode
()

proc
announce_objectives
()

proc
apply_innate_effects
(/mob/living/mob_override)

proc
can_be_owned
(/datum/mind/new_owner)

proc
check_anatag_menu_ability
()

proc
create_team
(/datum/team/team)

proc
farewell
()

proc
finalize_antag
()

proc
forge_single_objective
()

proc
get_antag_menu_name
()

proc
get_team
()

proc
give_objectives
()

proc
greet
()

proc
handle_clown_mutation
(/mob/living/carbon/human/clown, message, granting_datum)

proc
handle_last_instance_removal
()

proc
is_banned
(/mob/user)

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

proc
on_gain
()

proc
remove_antag_hud
(/mob/living/antag_mob)

proc
remove_innate_effects
(/mob/living/mob_override)

proc
remove_owner_from_gamemode
()

proc
replace_banned_player
()

proc
restore_last_hud_and_role
()

proc
roundend_report
()

proc
roundend_report_footer
()

proc
roundend_report_header
()