interaction

Optional text is immutable input per interaction; no per-mob or global lookup cache.

Vars
category	What category this interaction will fall under in the menu.
color	What color should the interaction button be?
description	The description of the interacton.
distance_allowed	If it can be done at a distance.
interaction_requires	What requirements does this interaction have? See defines.
lewd	Is this lewd?
message	A list of possible messages displayed loaded by the JSON.
message_auto_emotes	Emote keys the actor fires when a specific `message` template is picked: list("template" = "moan"). Optional.
message_nippleless	Messages used instead of `message` when that chest is pecs drawn without nipples. Optional.
message_pokes_out	Messages replacing the whole `message` pool while the bulge's penis pokes out (bulge_pokes_out()): bare-skin text for when head-through-cloth lines no longer apply. Optional.
message_sweaty	Extra `message` options joining the pool while the sweaty participant is visibly sweating. Optional.
name	The name to be displayed in the interaction menu for this interaction
name_nippleless	The menu label when that chest is pecs drawn without nipples, e.g. "Kiss pecs". Falls back to `name_pecs`. Optional.
name_pecs	The menu label instead of `name` when the chest this interaction uses is pecs, e.g. "Pecjob". Optional.
sexuality	What sexuality preference do we display for.
sound_cache	Stores the sound for later.
sound_possible	A list of possible sounds.
sound_range	If it plays a sound, how far does it travel?
sound_use	Does this interaction play a sound?
sound_vary	Does the interaction sound vary in pitch each time?
sweaty_is_user	Whose sweat the `*_sweaty` text follows: the target's by default, the user's when set (pitjobs, smothering).
target_arousal	The amount of arousal the target receives from this interaction.
target_messages	A list of possible messages displayed directly to the TARGET.
target_messages_nippleless	Messages used instead of `target_messages` when that chest is pecs drawn without nipples. Optional.
target_messages_pokes_out	Messages replacing the whole `target_messages` pool while the bulge's penis pokes out. Optional.
target_messages_sweaty	Extra `target_messages` options joining the pool while the sweaty participant is visibly sweating. Optional.
target_pain	The amount of pain the target receives.
target_pleasure	The amount of pleasure the target receives from this interaciton.
target_required_parts	What parts do they need(IMPORTANT TO GET IT TO THE CORRECT DEFINE, ORGAN SLOT)?
usage	Defines how we interact with ourselves or others.
user_arousal	The amount of arousal the user receives.
user_messages	A list of possible messages displayed directly to the USER.
user_messages_nippleless	Messages used instead of `user_messages` when that chest is pecs drawn without nipples. Optional.
user_messages_pokes_out	Messages replacing the whole `user_messages` pool while the bulge's penis pokes out. Optional.
user_messages_sweaty	Extra `user_messages` options joining the pool while the sweaty participant is visibly sweating. Optional.
user_pain	The amount of pain the user receives.
user_pleasure	The amount of pleasure the user receives.
user_required_parts	What parts do WE need(IMPORTANT TO GET IT TO THE CORRECT DEFINE, ORGAN SLOT)?
Procs
apply_effects	Applies side effects only while the interaction's original authority remains valid.
can_execute	Shared authority checks for the menu, immediate execution, and deferred effects.
chest_owner	Whose chest this interaction is about: the user's when it needs their breasts, otherwise the target's.
display_name_for	The menu label for these participants: `name_pecs`, or `name_nippleless`, when that chest is pecs.
format_message_for	Expands a message for an observer by default, or for the recipient of a private notice. Anonymity takes precedence over recipient identity, including when both roles belong to one mob. Placeholders match case-sensitively, exactly as templates write them, such as %USER% and %TARGET_PRONOUN_THEIR%.
interaction_route_is_valid	Revalidates whichever route supplied this interaction. A null route is a plain face-to-face interaction.
load_aphelion_text	Reads the optional Aphelion text: pit-hair and sweaty extras, and per-line auto emotes.
load_chest_text	Reads the optional pec and nippleless text, which both JSON loaders share.
participants_accept_interaction	Checks the preferences required at both execution boundaries.
participants_are_actionable	Returns TRUE only while both participants can consciously take part in an interaction.
save_aphelion_text	Writes back whichever optional Aphelion text is set.
save_chest_text	Writes back whichever optional pec and nippleless text is set.
texts_for	The list to pick messages from: `nippleless_texts`, if given, replaces everything when that chest is pecs drawn without nipples, and `pokes_out_texts` replaces everything while the bulge's penis pokes out, since head-through-cloth lines no longer apply then. `sweaty_texts` and `pit_hair_texts` are extra options, added to the pool while the sweaty participant is visibly sweating or the target grew physical pit hair.

Var Details

var
category

What category this interaction will fall under in the menu.

var
color

What color should the interaction button be?

var
description

The description of the interacton.

var
distance_allowed

If it can be done at a distance.

var
interaction_requires
– /list

What requirements does this interaction have? See defines.

var
lewd

Is this lewd?

var
message
– /list

A list of possible messages displayed loaded by the JSON.

var
message_auto_emotes
– /list

Emote keys the actor fires when a specific message template is picked: list("template" = "moan"). Optional.

var
message_nippleless
– /list

Messages used instead of message when that chest is pecs drawn without nipples. Optional.

var
message_pokes_out
– /list

Messages replacing the whole message pool while the bulge's penis pokes out (bulge_pokes_out()): bare-skin text for when head-through-cloth lines no longer apply. Optional.

var
message_sweaty
– /list

Extra message options joining the pool while the sweaty participant is visibly sweating. Optional.

var
name

The name to be displayed in the interaction menu for this interaction

var
name_nippleless

The menu label when that chest is pecs drawn without nipples, e.g. "Kiss pecs". Falls back to name_pecs. Optional.

var
name_pecs

The menu label instead of name when the chest this interaction uses is pecs, e.g. "Pecjob". Optional.

var
sexuality

What sexuality preference do we display for.

var
sound_cache

Stores the sound for later.

var
sound_possible
– /list

A list of possible sounds.

var
sound_range

If it plays a sound, how far does it travel?

var
sound_use

Does this interaction play a sound?

var
sound_vary

Does the interaction sound vary in pitch each time?

var
sweaty_is_user

Whose sweat the *_sweaty text follows: the target's by default, the user's when set (pitjobs, smothering).

var
target_arousal

The amount of arousal the target receives from this interaction.

var
target_messages
– /list

A list of possible messages displayed directly to the TARGET.

var
target_messages_nippleless
– /list

Messages used instead of target_messages when that chest is pecs drawn without nipples. Optional.

var
target_messages_pokes_out
– /list

Messages replacing the whole target_messages pool while the bulge's penis pokes out. Optional.

var
target_messages_sweaty
– /list

Extra target_messages options joining the pool while the sweaty participant is visibly sweating. Optional.

var
target_pain

The amount of pain the target receives.

var
target_pleasure

The amount of pleasure the target receives from this interaciton.

var
target_required_parts
– /list

What parts do they need(IMPORTANT TO GET IT TO THE CORRECT DEFINE, ORGAN SLOT)?

var
usage

Defines how we interact with ourselves or others.

var
user_arousal

The amount of arousal the user receives.

var
user_messages
– /list

A list of possible messages displayed directly to the USER.

var
user_messages_nippleless
– /list

Messages used instead of user_messages when that chest is pecs drawn without nipples. Optional.

var
user_messages_pokes_out
– /list

Messages replacing the whole user_messages pool while the bulge's penis pokes out. Optional.

var
user_messages_sweaty
– /list

Extra user_messages options joining the pool while the sweaty participant is visibly sweating. Optional.

var
user_pain

The amount of pain the user receives.

var
user_pleasure

The amount of pleasure the user receives.

var
user_required_parts
– /list

What parts do WE need(IMPORTANT TO GET IT TO THE CORRECT DEFINE, ORGAN SLOT)?

Proc Details

proc
apply_effects
(/datum/weakref/user_ref, /datum/weakref/target_ref, /datum/interaction_route/route)

Applies side effects only while the interaction's original authority remains valid.

proc
can_execute
(/mob/living/carbon/human/user, /mob/living/carbon/human/target, /datum/interaction_route/route, ignore_cooldown)

Shared authority checks for the menu, immediate execution, and deferred effects.

proc
chest_owner
(/mob/living/carbon/human/user, /mob/living/carbon/human/target) as /mob/living/carbon/human

Whose chest this interaction is about: the user's when it needs their breasts, otherwise the target's.

proc
display_name_for
(/mob/living/carbon/human/user, /mob/living/carbon/human/target)

The menu label for these participants: name_pecs, or name_nippleless, when that chest is pecs.

proc
format_message_for
(message_template, /mob/living/carbon/human/user, /mob/living/carbon/human/target, /datum/interaction_route/route, omit_user, user_anonymous, target_anonymous, /mob/living/carbon/human/recipient)

Expands a message for an observer by default, or for the recipient of a private notice. Anonymity takes precedence over recipient identity, including when both roles belong to one mob. Placeholders match case-sensitively, exactly as templates write them, such as %USER% and %TARGET_PRONOUN_THEIR%.

proc
interaction_route_is_valid
(/datum/interaction_route/route, /mob/living/carbon/human/user, /mob/living/carbon/human/target, ignore_cooldown)

Revalidates whichever route supplied this interaction. A null route is a plain face-to-face interaction.

proc
load_aphelion_text
(/list/json)

Reads the optional Aphelion text: pit-hair and sweaty extras, and per-line auto emotes.

proc
load_chest_text
(/list/json)

Reads the optional pec and nippleless text, which both JSON loaders share.

proc
participants_accept_interaction
(/mob/living/carbon/human/user, /mob/living/carbon/human/target, /datum/interaction_route/route)

Checks the preferences required at both execution boundaries.

proc
participants_are_actionable
(/mob/living/carbon/human/user, /mob/living/carbon/human/target)

Returns TRUE only while both participants can consciously take part in an interaction.

proc
save_aphelion_text
(/list/json)

Writes back whichever optional Aphelion text is set.

proc
save_chest_text
(/list/json)

Writes back whichever optional pec and nippleless text is set.

proc
texts_for
(/list/usual, /list/nippleless_texts, /mob/living/carbon/human/user, /mob/living/carbon/human/target, /list/pit_hair_texts, /list/sweaty_texts, /list/pokes_out_texts)

The list to pick messages from: nippleless_texts, if given, replaces everything when that chest is pecs drawn without nipples, and pokes_out_texts replaces everything while the bulge's penis pokes out, since head-through-cloth lines no longer apply then. sweaty_texts and pit_hair_texts are extra options, added to the pool while the sweaty participant is visibly sweating or the target grew physical pit hair.

interaction /datum/interaction

Vars

Procs

Var Details

var category

var color

var description

var distance_allowed

var interaction_requires – /list

var lewd

var message – /list

var message_auto_emotes – /list

var message_nippleless – /list

var message_pokes_out – /list

var message_sweaty – /list

var name

var name_nippleless

var name_pecs

var sexuality

var sound_cache

var sound_possible – /list

var sound_range

var sound_use

var sound_vary

var sweaty_is_user

var target_arousal

var target_messages – /list

var target_messages_nippleless – /list

var target_messages_pokes_out – /list

var target_messages_sweaty – /list

var target_pain

var target_pleasure

var target_required_parts – /list

var usage

var user_arousal

var user_messages – /list

var user_messages_nippleless – /list

var user_messages_pokes_out – /list

var user_messages_sweaty – /list

var user_pain

var user_pleasure

var user_required_parts – /list