emote

Most of the text that's not someone talking is based off of this.

Yes, the displayed message is stored on the datum, it would cause problems for emotes with a message that can vary, but that's handled differently in run_emote(), so be sure to use can_message_change if you plan to have different displayed messages from player to player.

Vars
alt_message	Message displayed for audible emotes if someone's deaf. Only use this if key_third_person can't be acceptably used. ie. if someone says *medic and someone's deaf, they'd receive [X] calls for a medic! silently., which is not ideal.
audio_cooldown	How long is the cooldown on the audio of the emote, if it has one?
can_message_change	Does this message have a message that can be modified by the user?
cooldown	The cooldown between the uses of the emote.
emote_type	Whether the emote is visible and/or audible bitflag
hands_use_check	Checks if the mob can use its hands before performing the emote.
key	What calls the emote.
key_third_person	This will also call the emote.
keybind	Should this emote generate a keybind?
keybind_category	Does this emote have a custom keybind category?
message	Message displayed when emote is used.
message_param	Message with %t at the end to allow adding params to the message, like for mobs doing an emote relatively to something else.
mob_type_allowed_typecache	Types that are allowed to use that emote.
mob_type_blacklist_typecache	Types that are NOT allowed to use that emote.
mob_type_ignore_stat_typecache	Types that can use this emote regardless of their state.
muzzle_ignore	Will only work if the emote is EMOTE_AUDIBLE.
only_forced_audio	Can only code call this event instead of the player.
say_message	What message to make the user send with the emote?
sound	Sound to play when emote is called.
stat_allowed	In which state can you use this emote? (Check stat.dm for a full list of them)
vary	Used for the honk borg emote.
volume	What volume should the sound be played at?
Procs
can_run_emote	Check to see if the user is allowed to run the emote.
check_cooldown	For handling emote cooldown, return true to allow the emote to happen.
get_sound	To get the sound that the emote plays, for special sound interactions depending on the mob.
replace_pronoun	To replace pronouns in the inputed string with the user's proper pronouns.
run_emote	Handles the modifications and execution of emotes.
run_langchat	Handles above-head chat automatically running on an emote.
select_message_type	Selects the message type to override the message with.
select_param	Replaces the %t in the message in message_param by params.
should_play_sound	Check to see if the user should play a sound when performing the emote.

Var Details

var
alt_message
–

Message displayed for audible emotes if someone's deaf. Only use this if key_third_person can't be acceptably used. ie. if someone says *medic and someone's deaf, they'd receive [X] calls for a medic! silently., which is not ideal.

var
audio_cooldown
–

How long is the cooldown on the audio of the emote, if it has one?

var
can_message_change
–

Does this message have a message that can be modified by the user?

var
cooldown
–

The cooldown between the uses of the emote.

var
emote_type
–

Whether the emote is visible and/or audible bitflag

var
hands_use_check
–

Checks if the mob can use its hands before performing the emote.

var
key
–

What calls the emote.

var
key_third_person
–

This will also call the emote.

var
keybind
–

Should this emote generate a keybind?

var
keybind_category
–

Does this emote have a custom keybind category?

var
message
–

Message displayed when emote is used.

var
message_param
–

Message with %t at the end to allow adding params to the message, like for mobs doing an emote relatively to something else.

var
mob_type_allowed_typecache
– /list

Types that are allowed to use that emote.

var
mob_type_blacklist_typecache
– /list

Types that are NOT allowed to use that emote.

var
mob_type_ignore_stat_typecache
– /list

Types that can use this emote regardless of their state.

var
muzzle_ignore
–

Will only work if the emote is EMOTE_AUDIBLE.

var
only_forced_audio
–

Can only code call this event instead of the player.

var
say_message
–

What message to make the user send with the emote?

var
sound
–

Sound to play when emote is called.

var
stat_allowed
–

In which state can you use this emote? (Check stat.dm for a full list of them)

var
vary
–

Used for the honk borg emote.

var
volume
–

What volume should the sound be played at?

Proc Details

proc
can_run_emote
(/mob/user, status_check, intentional)

Check to see if the user is allowed to run the emote.

Arguments:

user - Person that is trying to send the emote.
status_check - Bool that says whether we should check their stat or not.
intentional - Bool that says whether the emote was forced (FALSE) or not (TRUE).

Returns a bool about whether or not the user can run the emote.

proc
check_cooldown
(/mob/user, intentional)

For handling emote cooldown, return true to allow the emote to happen.

Arguments:

user - Person that is trying to send the emote.
intentional - Bool that says whether the emote was forced (FALSE) or not (TRUE).

Returns FALSE if the cooldown is not over, TRUE if the cooldown is over.

proc
get_sound
(/mob/living/user)

To get the sound that the emote plays, for special sound interactions depending on the mob.

Arguments:

user - Person that is trying to send the emote.

Returns the sound that will be made while sending the emote.

proc
replace_pronoun
(/mob/user, msg)

To replace pronouns in the inputed string with the user's proper pronouns.

Arguments:

user - Person that is trying to send the emote.
msg - The string to modify.

Returns the modified msg string.

proc
run_emote
(/mob/user, params, type_override, intentional)

Handles the modifications and execution of emotes.

Arguments:

user - Person that is trying to send the emote.
params - Parameters added after the emote.
type_override - Override to the current emote_type.
intentional - Bool that says whether the emote was forced (FALSE) or not (TRUE).

Returns TRUE if it was able to run the emote, FALSE otherwise.

proc
run_langchat
(/mob/user, /list/group)

Handles above-head chat automatically running on an emote.

Arguments:

user - Person trying to send the emote
group - The list of people that will see this emote being

proc
select_message_type
(/mob/user, msg, intentional)

Selects the message type to override the message with.

Arguments:

user - Person that is trying to send the emote.
msg - The string to modify.
intentional - Bool that says whether the emote was forced (FALSE) or not (TRUE).

Returns the new message, or msg directly, if no change was needed.

proc
select_param
(/mob/user, params)

Replaces the %t in the message in message_param by params.

Arguments:

user - Person that is trying to send the emote.
params - Parameters added after the emote.

Returns the modified string.

proc
should_play_sound
(/mob/user, intentional)

Check to see if the user should play a sound when performing the emote.

Arguments:

user - Person that is doing the emote.
intentional - Bool that says whether the emote was forced (FALSE) or not (TRUE).

Returns a bool about whether or not the user should play a sound when performing the emote.

Emote /datum/emote

Vars

Procs

Var Details

var alt_message –

var audio_cooldown –

var can_message_change –

var cooldown –

var emote_type –

var hands_use_check –

var key –

var key_third_person –

var keybind –

var keybind_category –

var message –

var message_param –

var mob_type_allowed_typecache – /list

var mob_type_blacklist_typecache – /list

var mob_type_ignore_stat_typecache – /list

var muzzle_ignore –

var only_forced_audio –

var say_message –

var sound –

var stat_allowed –

var vary –

var volume –

Proc Details

proc can_run_emote(/mob/user, status_check, intentional)

proc check_cooldown(/mob/user, intentional)

proc get_sound(/mob/living/user)

proc replace_pronoun(/mob/user, msg)

proc run_emote(/mob/user, params, type_override, intentional)

proc run_langchat(/mob/user, /list/group)

proc select_message_type(/mob/user, msg, intentional)

proc select_param(/mob/user, params)

proc should_play_sound(/mob/user, intentional)

Emote
/datum/emote

var
alt_message
–

var
audio_cooldown
–

var
can_message_change
–

var
cooldown
–

var
emote_type
–

var
hands_use_check
–

var
key
–

var
key_third_person
–

var
keybind
–

var
keybind_category
–

var
message
–

var
message_param
–

var
mob_type_allowed_typecache
– /list

var
mob_type_blacklist_typecache
– /list

var
mob_type_ignore_stat_typecache
– /list

var
muzzle_ignore
–

var
only_forced_audio
–

var
say_message
–

var
sound
–

var
stat_allowed
–

var
vary
–

var
volume
–

proc
can_run_emote
(/mob/user, status_check, intentional)

proc
check_cooldown
(/mob/user, intentional)

proc
get_sound
(/mob/living/user)

proc
replace_pronoun
(/mob/user, msg)

proc
run_emote
(/mob/user, params, type_override, intentional)

proc
run_langchat
(/mob/user, /list/group)

proc
select_message_type
(/mob/user, msg, intentional)

proc
select_param
(/mob/user, params)

proc
should_play_sound
(/mob/user, intentional)