job
/datum/controller/subsystem/job

Vars
additional_jobs_with_icons	A list of additional jobs that have various icons associated with them including sechud and card trims.
all_occupations	List of all jobs.
assigned_captain	If TRUE, some player has been assigned Captaincy or Acting Captaincy at some point during the shift and has been given the spare ID safe code.
centcom_jobs	A list of jobs associed with Centcom and should use the standard NT Centcom icons.
chain_of_command	Keys should be assigned job roles. Values should be >= 1. Represents the chain of command on the station. Lower numbers mean higher priority. Used to give the Cap's Spare safe code to a an appropriate player. Assumed Captain is always the highest in the chain of command. See [/datum/controller/subsystem/ticker/proc/equip_characters]
dynamic_forced_occupations	Lazylist of mob:occupation_string pairs.
experience_jobs_map	Dictionary of jobs indexed by the experience type they grant.
head_of_staff_jobs	A list of all Head of Staff jobs.
job_priorities_to_strings	Dictionary that maps job priorities to low/medium/high. Keys have to be number-strings as assoc lists cannot be indexed by integers. Set in setup_job_lists.
joinable_departments	List of all departments with joinable jobs.
joinable_departments_by_type	List of all joinable departments indexed by their typepath, sorted by their own display order.
joinable_occupations	List of jobs that can be joined through the starting menu.
name_occupations	Dictionary of all jobs, keys are titles.
safe_code_request_loc	The loc to which the emergency safe code has been requested for delivery.
safe_code_requested	Whether the emergency safe code has been requested via a comms console on shifts with no Captain or Acting Captain.
safe_code_timer_id	Timer ID for the emergency safe code request.
station_jobs	A list of all jobs associated with the station. These jobs also have various icons associated with them including sechud and card trims.
type_occupations	Dictionary of all jobs, keys are types.
Procs
AssignRole	Assigns the given job role to the player.
CheckHeadPositions	Attempts to fill out all possible head positions for players with that job at a a given job priority level.
DivideOccupations
DropLandAtRandomHallwayPoint	Lands specified mob at a random spot in the hallways
FillHeadPosition	Will try to select a head, ignoring ALL non-head preferences for every level until.
assign_priority_positions	Blindly assigns the required roles to every player in the dynamic_forced_occupations list.
check_job_eligibility	Runs a standard suite of eligibility checks to make sure the player can take the reqeusted job.
fill_ai_positions	Attempts to fill out all available AI positions.
job_priority_level_to_string	Takes a job priority #define such as JP_LOW and gets its string representation for logging.
send_spare_id_safe_code	Send a drop pod containing a piece of paper with the spare ID safe code to loc
setup_job_lists	Builds various lists of jobs based on station, centcom and additional jobs with icons associated with them.

Var Details

var
additional_jobs_with_icons
– /list

A list of additional jobs that have various icons associated with them including sechud and card trims.

var
all_occupations
– /list/datum/job

List of all jobs.

var
assigned_captain
–

If TRUE, some player has been assigned Captaincy or Acting Captaincy at some point during the shift and has been given the spare ID safe code.

var
centcom_jobs
– /list

A list of jobs associed with Centcom and should use the standard NT Centcom icons.

var
chain_of_command
– /list

Keys should be assigned job roles. Values should be >= 1. Represents the chain of command on the station. Lower numbers mean higher priority. Used to give the Cap's Spare safe code to a an appropriate player. Assumed Captain is always the highest in the chain of command. See [/datum/controller/subsystem/ticker/proc/equip_characters]

var
dynamic_forced_occupations
– /list

Lazylist of mob:occupation_string pairs.

var
experience_jobs_map
– /list

Dictionary of jobs indexed by the experience type they grant.

var
head_of_staff_jobs
– /list

A list of all Head of Staff jobs.

var
job_priorities_to_strings
– /list

Dictionary that maps job priorities to low/medium/high. Keys have to be number-strings as assoc lists cannot be indexed by integers. Set in setup_job_lists.

var
joinable_departments
– /list/datum/job_department

List of all departments with joinable jobs.

var
joinable_departments_by_type
– /list/datum/job_department

List of all joinable departments indexed by their typepath, sorted by their own display order.

var
joinable_occupations
– /list/datum/job

List of jobs that can be joined through the starting menu.

var
name_occupations
– /list

Dictionary of all jobs, keys are titles.

var
safe_code_request_loc
– /turf

The loc to which the emergency safe code has been requested for delivery.

var
safe_code_requested
–

Whether the emergency safe code has been requested via a comms console on shifts with no Captain or Acting Captain.

var
safe_code_timer_id
–

Timer ID for the emergency safe code request.

var
station_jobs
– /list

A list of all jobs associated with the station. These jobs also have various icons associated with them including sechud and card trims.

var
type_occupations
– /list/datum/job

Dictionary of all jobs, keys are types.

Proc Details

proc
AssignRole
(/mob/dead/new_player/player, /datum/job/job, latejoin, do_eligibility_checks)

Assigns the given job role to the player.

Arguments:

player - The player to assign the job to
job - The job to assign
latejoin - Set to TRUE if this is a latejoin role assignment.
do_eligibility_checks - Set to TRUE to conduct all job eligibility tests and reject on failure. Set to FALSE if job eligibility has been tested elsewhere and they can be safely skipped.

proc
CheckHeadPositions
(level)

Attempts to fill out all possible head positions for players with that job at a a given job priority level.

Arguments:

level - One of the JP_LOW, JP_MEDIUM or JP_HIGH defines. Attempts to find candidates with head jobs at this priority only.

proc
DivideOccupations
()

Proc DivideOccupations
fills var "assigned_role" for all ready players.
This proc must not have any side effect besides of modifying "assigned_role".

proc
DropLandAtRandomHallwayPoint
(/mob/living/living_mob)

Lands specified mob at a random spot in the hallways

proc
FillHeadPosition
()

Will try to select a head, ignoring ALL non-head preferences for every level until.

Basically tries to ensure there is at least one head in every shift if anyone has that job preference enabled at all.

proc
assign_priority_positions
()

Blindly assigns the required roles to every player in the dynamic_forced_occupations list.

proc
check_job_eligibility
(/mob/dead/new_player/player, /datum/job/possible_job, debug_prefix, add_job_to_log)

Runs a standard suite of eligibility checks to make sure the player can take the reqeusted job.

Checks:

Role bans
How many days old the player account is
Whether the player has the required hours in other jobs to take that role
If the job is in the mind's restricted roles, for example if they have an antag datum that's incompatible with certain roles.

Arguments:

player - The player to check for job eligibility.
possible_job - The job to check for eligibility against.
debug_prefix - Logging prefix for the JobDebug log entries. For example, GRJ during GiveRandomJob or DO during DivideOccupations.
add_job_to_log - If TRUE, appends the job type to the log entry. If FALSE, does not. Set to FALSE when check is part of iterating over players for a specific job, set to TRUE when check is part of iterating over jobs for a specific player and you don't want extra log entry spam.

proc
fill_ai_positions
()

Attempts to fill out all available AI positions.

proc
job_priority_level_to_string
(priority)

Takes a job priority #define such as JP_LOW and gets its string representation for logging.

proc
send_spare_id_safe_code
(loc)

Send a drop pod containing a piece of paper with the spare ID safe code to loc

proc
setup_job_lists
()

Builds various lists of jobs based on station, centcom and additional jobs with icons associated with them.

job /datum/controller/subsystem/job

Vars

Procs

Var Details

var additional_jobs_with_icons – /list

var all_occupations – /list/datum/job

var assigned_captain –

var centcom_jobs – /list

var chain_of_command – /list

var dynamic_forced_occupations – /list

var experience_jobs_map – /list

var head_of_staff_jobs – /list

var job_priorities_to_strings – /list

var joinable_departments – /list/datum/job_department

var joinable_departments_by_type – /list/datum/job_department

var joinable_occupations – /list/datum/job

var name_occupations – /list

var safe_code_request_loc – /turf

var safe_code_requested –

var safe_code_timer_id –

var station_jobs – /list

var type_occupations – /list/datum/job

Proc Details

proc AssignRole(/mob/dead/new_player/player, /datum/job/job, latejoin, do_eligibility_checks)

proc CheckHeadPositions(level)

proc DivideOccupations()

proc DropLandAtRandomHallwayPoint(/mob/living/living_mob)

proc FillHeadPosition()

proc assign_priority_positions()

proc check_job_eligibility(/mob/dead/new_player/player, /datum/job/possible_job, debug_prefix, add_job_to_log)

proc fill_ai_positions()

proc job_priority_level_to_string(priority)

proc send_spare_id_safe_code(loc)

proc setup_job_lists()

job
/datum/controller/subsystem/job

var
additional_jobs_with_icons
– /list

var
all_occupations
– /list/datum/job

var
assigned_captain
–

var
centcom_jobs
– /list

var
chain_of_command
– /list

var
dynamic_forced_occupations
– /list

var
experience_jobs_map
– /list

var
head_of_staff_jobs
– /list

var
job_priorities_to_strings
– /list

var
joinable_departments
– /list/datum/job_department

var
joinable_departments_by_type
– /list/datum/job_department

var
joinable_occupations
– /list/datum/job

var
name_occupations
– /list

var
safe_code_request_loc
– /turf

var
safe_code_requested
–

var
safe_code_timer_id
–

var
station_jobs
– /list

var
type_occupations
– /list/datum/job

proc
AssignRole
(/mob/dead/new_player/player, /datum/job/job, latejoin, do_eligibility_checks)

proc
CheckHeadPositions
(level)

proc
DivideOccupations
()

proc
DropLandAtRandomHallwayPoint
(/mob/living/living_mob)

proc
FillHeadPosition
()

proc
assign_priority_positions
()

proc
check_job_eligibility
(/mob/dead/new_player/player, /datum/job/possible_job, debug_prefix, add_job_to_log)

proc
fill_ai_positions
()

proc
job_priority_level_to_string
(priority)

proc
send_spare_id_safe_code
(loc)

proc
setup_job_lists
()