syndicate_contract

Describes a contract that can be completed by a /datum/antagonist/contractor.

Vars
chosen_difficulty	The selected difficulty.
completed_time	Formatted station time at which the contract was completed, if applicable.
contract	The /datum/objective/contract associated to this contract.
credits_base	The base credits reward upon completion. Multiplied by the two lower bounds below.
dead_extraction	Whether the contract was completed with the victim being dead on extraction.
extraction_cooldown	Cooldown before making another extraction request in deciseconds.
extraction_deadline	The world.time at which the current extraction fulton will vanish and another extraction can be requested.
extraction_flare	The flare indicating the extraction point.
extraction_timer_handle	Deadline reached timer handle. Deletes the portal and tells the agent to call extraction again.
fail_reason	Visual reason as to why the contract failed, if applicable.
fluff_message	Fluff message explaining why the kidnapee is the target.
nt_am_board_resigned	Whether the additional fluff story from any contractor completing all of their contracts was made already or not.
owning_hub	The owning contractor hub.
pod	The extraction portal.
portal_duration	How long an extraction portal remains before going away. Should be less than /datum/syndicate_contract/var/extraction_cooldown.
prison_time	How long a target remains in the Syndicate jail.
prisoner_timer_handle	Prisoner jail timer handle. On completion, returns the prisoner back to station.
reward_credits	Amount of credits the contractor will receive upon completion.
reward_tc	Amount of telecrystals the contract will receive upon completion, depending on the chosen difficulty. Structure: EXTRACTION_DIFFICULTY_(EASY\|MEDIUM\|HARD) => number
souvenirs	List of items a target can get randomly after their return.
status	Current contract status.
target_name	Name of the target to display on the UI.
target_photo	The target's photo to display on the UI.
temp_objs	Temporary objects that are available to the kidnapee during their time in jail. These are deleted when the victim is returned.
victim_belongings	The kidnapee's belongings. Set upon extraction by the contractor.
victim_timerid	timerid for stuff that handles victim chat messages, effects and returnal
Procs
clean_up	Cleans up the contract.
complete	Marks the contract as completed and gives the rewards to the contractor.
deadline_reached	Called when the extraction window closes.
fail	Marks the contract as failed and stops it.
generate	Fills the contract with valid data to be used.
handle_target_return	Handles the target's return to station.
handle_victim_experience	handle_victim_experience
initiate	Begins the contract if possible.
invalidate	Marks the contract as invalid and effectively cancels it for later use.
notify_completion	Notifies the uplink's holder that a contract has been completed.
open_extraction_portal	Opens the extraction portal.
start_extraction_process	Initiates the extraction process if conditions are met.

Var Details

var
chosen_difficulty
–

The selected difficulty.

var
completed_time
–

Formatted station time at which the contract was completed, if applicable.

var
contract
– /datum/objective/contract

The /datum/objective/contract associated to this contract.

var
credits_base
–

The base credits reward upon completion. Multiplied by the two lower bounds below.

var
dead_extraction
–

Whether the contract was completed with the victim being dead on extraction.

var
extraction_cooldown
–

Cooldown before making another extraction request in deciseconds.

var
extraction_deadline
–

The world.time at which the current extraction fulton will vanish and another extraction can be requested.

var
extraction_flare
– /obj/effect/contractor_flare

The flare indicating the extraction point.

var
extraction_timer_handle
–

Deadline reached timer handle. Deletes the portal and tells the agent to call extraction again.

var
fail_reason
–

Visual reason as to why the contract failed, if applicable.

var
fluff_message
–

Fluff message explaining why the kidnapee is the target.

var
nt_am_board_resigned
– /static

Whether the additional fluff story from any contractor completing all of their contracts was made already or not.

var
owning_hub
– /datum/contractor_hub

The owning contractor hub.

var
pod
– /obj/structure/closet/supplypod/extractionpod

The extraction portal.

var
portal_duration
–

How long an extraction portal remains before going away. Should be less than /datum/syndicate_contract/var/extraction_cooldown.

var
prison_time
–

How long a target remains in the Syndicate jail.

var
prisoner_timer_handle
–

Prisoner jail timer handle. On completion, returns the prisoner back to station.

var
reward_credits
–

Amount of credits the contractor will receive upon completion.

var
reward_tc
– /list

Amount of telecrystals the contract will receive upon completion, depending on the chosen difficulty. Structure: EXTRACTION_DIFFICULTY_(EASY|MEDIUM|HARD) => number

var
souvenirs
– /list/obj/item

List of items a target can get randomly after their return.

var
status
–

Current contract status.

var
target_name
–

Name of the target to display on the UI.

var
target_photo
– /image

The target's photo to display on the UI.

var
temp_objs
– /list/obj

Temporary objects that are available to the kidnapee during their time in jail. These are deleted when the victim is returned.

var
victim_belongings
– /list/obj/item

The kidnapee's belongings. Set upon extraction by the contractor.

var
victim_timerid
–

timerid for stuff that handles victim chat messages, effects and returnal

Proc Details

proc
clean_up
(clean_pod)

Cleans up the contract.

proc
complete
(target_dead)

Marks the contract as completed and gives the rewards to the contractor.

Arguments:

target_dead - Whether the target was extracted dead.

proc
deadline_reached
()

Called when the extraction window closes.

proc
fail
(reason)

Marks the contract as failed and stops it.

Arguments:

difficulty - The visual reason as to why the contract failed.

proc
generate
(target_override)

Fills the contract with valid data to be used.

proc
handle_target_return
(/mob/living/victim)

Handles the target's return to station.

Arguments:

victim - The target mob.

proc
handle_victim_experience
(/mob/living/victim, level)

handle_victim_experience

Handles the effects given to victims upon being contracted. We heal them up and cause them immersive effects, just for fun. Args: victim - The person we're harassing level - The current stage of harassement they are facing. This increases by itself, looping until finished.

proc
initiate
(/mob/living/contractor, difficulty)

Begins the contract if possible.

Arguments:

contractor - The contractor.
difficulty - The chosen difficulty level.

proc
invalidate
()

Marks the contract as invalid and effectively cancels it for later use.

proc
notify_completion
(tc, creds, target_dead)

Notifies the uplink's holder that a contract has been completed.

Arguments:

tc - How many telecrystals they have received.
creds - How many credits they have received.
target_dead - Whether the target was extracted dead.

proc
open_extraction_portal
(/obj/item/contractor_uplink/uplink, /mob/living/carbon/human/contractor, /obj/effect/contractor_flare/flare)

Opens the extraction portal.

Arguments:

uplink - The uplink.
contractor - The contractor.
flare - The flare.

proc
start_extraction_process
(/obj/item/contractor_uplink/uplink, /mob/living/carbon/human/contractor)

Initiates the extraction process if conditions are met.

Arguments:

contractor - The contractor.

Syndicate Contract /datum/syndicate_contract

Vars

Procs

Var Details

var chosen_difficulty –

var completed_time –

var contract – /datum/objective/contract

var credits_base –

var dead_extraction –

var extraction_cooldown –

var extraction_deadline –

var extraction_flare – /obj/effect/contractor_flare

var extraction_timer_handle –

var fail_reason –

var fluff_message –

var nt_am_board_resigned – /static

var owning_hub – /datum/contractor_hub

var pod – /obj/structure/closet/supplypod/extractionpod

var portal_duration –

var prison_time –

var prisoner_timer_handle –

var reward_credits –

var reward_tc – /list

var souvenirs – /list/obj/item

var status –

var target_name –

var target_photo – /image

var temp_objs – /list/obj

var victim_belongings – /list/obj/item

var victim_timerid –

Proc Details

proc clean_up(clean_pod)

proc complete(target_dead)

proc deadline_reached()

proc fail(reason)

proc generate(target_override)

proc handle_target_return(/mob/living/victim)

proc handle_victim_experience(/mob/living/victim, level)

proc initiate(/mob/living/contractor, difficulty)

proc invalidate()

proc notify_completion(tc, creds, target_dead)

proc open_extraction_portal(/obj/item/contractor_uplink/uplink, /mob/living/carbon/human/contractor, /obj/effect/contractor_flare/flare)

proc start_extraction_process(/obj/item/contractor_uplink/uplink, /mob/living/carbon/human/contractor)

Syndicate Contract
/datum/syndicate_contract

var
chosen_difficulty
–

var
completed_time
–

var
contract
– /datum/objective/contract

var
credits_base
–

var
dead_extraction
–

var
extraction_cooldown
–

var
extraction_deadline
–

var
extraction_flare
– /obj/effect/contractor_flare

var
extraction_timer_handle
–

var
fail_reason
–

var
fluff_message
–

var
nt_am_board_resigned
– /static

var
owning_hub
– /datum/contractor_hub

var
pod
– /obj/structure/closet/supplypod/extractionpod

var
portal_duration
–

var
prison_time
–

var
prisoner_timer_handle
–

var
reward_credits
–

var
reward_tc
– /list

var
souvenirs
– /list/obj/item

var
status
–

var
target_name
–

var
target_photo
– /image

var
temp_objs
– /list/obj

var
victim_belongings
– /list/obj/item

var
victim_timerid
–

proc
clean_up
(clean_pod)

proc
complete
(target_dead)

proc
deadline_reached
()

proc
fail
(reason)

proc
generate
(target_override)

proc
handle_target_return
(/mob/living/victim)

proc
handle_victim_experience
(/mob/living/victim, level)

proc
initiate
(/mob/living/contractor, difficulty)

proc
invalidate
()

proc
notify_completion
(tc, creds, target_dead)

proc
open_extraction_portal
(/obj/item/contractor_uplink/uplink, /mob/living/carbon/human/contractor, /obj/effect/contractor_flare/flare)

proc
start_extraction_process
(/obj/item/contractor_uplink/uplink, /mob/living/carbon/human/contractor)