job
/datum/job

datum/job/bureaucrat, This is the file you should use to add alternate titles for each job, just follow the way they're done here, it's easy enough and shouldn't take any time at all to add more or add some for a job that doesn't have any.

Vars
allow_bureaucratic_error	Should this job be allowed to be picked for the bureaucratic error event?
alt_titles	The list of alternative job titles people can pick from, null by default.
auto_deadmin_role_flags	Bitflags for the job
blacklist_dresscode_slots	A list of slots that can't have loadout items assigned to them if no_dresscode is applied, used for important items such as ID, PDA, backpack and headset
current_positions	How many players have this job
default_security_status	Default security status. Skipped if null.
department_for_prefs	If specified, this department will be used for the preferences menu.
department_head	Determines who can demote this position
departments_bitflags	Bitfield of departments this job belongs to. These get setup when adding the job into the department, on job datum creation.
departments_list	Lazy list with the departments this job belongs to. Required to be set for playable jobs. The first department will be used in the preferences menu, unless department_for_prefs is set.
description	The description of the job, used for preferences menu. Keep it short and useful. Avoid in-jokes, these are for new players.
employers	What company can employ this job? First index is default
exclusive_mail_goodies	If this job's mail goodies compete with generic goodies.
exp_granted_type	Experience type granted by playing in this job.
exp_required_type	Experience required to play this job, if the config is enabled, and `exp_required_type_department` is not enabled with the proper config.
exp_required_type_department	Department experience required to play this job, if the config is enabled.
exp_requirements	Minutes of experience-time required to play in this job. The type is determined by [exp_required_type] and [exp_required_type_department] depending on configs.
faction	Players will be allowed to spawn in as jobs that are set to "Station"
family_heirlooms	List of family heirlooms this job can get with the family heirloom quirk. List of types.
head_announce	Tells the given channels that the given mob is the new department head. See communications.dm for valid channels.
job_flags	All values = (JOB_ANNOUNCE_ARRIVAL \| JOB_CREW_MANIFEST \| JOB_EQUIP_RANK \| JOB_CREW_MEMBER \| JOB_NEW_PLAYER_JOINABLE \| JOB_ASSIGN_QUIRKS \| JOB_CAN_BE_INTERN)
job_spawn_title	Job title to use for spawning. Allows a job to spawn without needing map edits.
languages	Lazylist of language types to grant.
liver_traits	Lazylist of traits added to the liver of the mob assigned this job (used for the classic "cops heal from donuts" reaction, among others)
mail_goodies	Goodies that can be received via the mail system. Keep the _job definition for this empty and use /obj/item/mail to define general gifts.
minimal_player_age	If you have the use_age_restriction_for_jobs config option enabled and the database set up, this option will add a requirement for players to be at least minimal_player_age days old. (meaning they first signed in at least that many days before.)
minimal_skills	Innate skill levels unlocked at roundstart. Based on config.jobs_have_minimal_access config setting, for example with a full crew. Format is list(/datum/skill/foo = SKILL_EXP_NOVICE) with exp as an integer or as per code/_DEFINES/skills.dm
no_dresscode	With this set to TRUE, the loadout will be applied before a job clothing will be
outfits	Different outfits for alternate job titles and different species
policy_index	String. If set to a non-empty one, it will be the key for the policy text value to show this role on spawn.
radio_help_message	A string added to the on-join block to tell you how to use your radio.
req_admin_notify	If this is set to 1, a text is printed to the player when jobs are assigned, telling him that he should let admins know that he has to disconnect.
rpg_title	RPG job names, for the memes
selection_color	Selection screen color
skills	Innate skill levels unlocked at roundstart. Based on config.jobs_have_minimal_access config setting, for example with a skeleton crew. Format is list(/datum/skill/foo = SKILL_EXP_NOVICE) with exp as an integer or as per code/_DEFINES/skills.dm
spawn_logic	How this job decides where to spawn.
spawn_positions	How many players can spawn in as this job
spawn_type	What kind of mob type joining players with this job as their assigned role are spawned as.
supervisors	Supervisors, who this person answers to directly
title	The name of the job , used for preferences, bans and more. Make sure you know what you're doing before changing this.
total_positions	How many players can be this job
veteran_only	Is this job veteran only? If so, then this job requires the player to be in the veteran_players.txt
voice_of_god_power	Multiplier for general usage of the voice of god.
voice_of_god_silence_power	Multiplier for the silence command of the voice of god.
Procs
after_latejoin_spawn	Called after a successful latejoin spawn. Client is in the mob. This happens after after_spawn()
after_roundstart_spawn	Called after a successful roundstart spawn. Client is not yet in the mob. This happens after after_spawn()
after_spawn	Executes after the mob has been spawned in the map. Client might not be yet in the mob, and is thus a separate variable.
get_jobspawn_landmark	Returns an unused jobspawn landmark. You CAN run out of landmarks, please be mindful of this!
get_latejoin_spawn_point	Finds a valid latejoin spawn point, checking for events and special conditions.
get_mail_goodies	An overridable getter for more dynamic goodies.
get_map_changes	Loads up map configs if necessary and returns job changes for this job.
get_roundstart_spawn_point	Returns either an atom the mob should spawn on.
get_roundstart_spawn_point_fixed	Returns a fixed spawn location to use. This is probably one of a few job landmarks.
get_roundstart_spawn_point_random	Returns a roundstart spawnpoint to use if spawn logic determined it should spawn at a "random" location.
get_spawn_mob	Spawns the mob to be played as, taking into account preferences and the desired spawn point.
on_join_message	Called by SSjob when a player joins the round as this job.
on_join_popup	Called by SSjob when a player joins the round as this job.

Var Details

var
allow_bureaucratic_error
–

Should this job be allowed to be picked for the bureaucratic error event?

var
alt_titles
– /list

The list of alternative job titles people can pick from, null by default.

var
auto_deadmin_role_flags
–

Bitflags for the job

var
blacklist_dresscode_slots
– /list

A list of slots that can't have loadout items assigned to them if no_dresscode is applied, used for important items such as ID, PDA, backpack and headset

var
current_positions
–

How many players have this job

var
default_security_status
–

Default security status. Skipped if null.

var
department_for_prefs
– /datum/job_department

If specified, this department will be used for the preferences menu.

var
department_head
–

Determines who can demote this position

var
departments_bitflags
–

Bitfield of departments this job belongs to. These get setup when adding the job into the department, on job datum creation.

var
departments_list
– /list

Lazy list with the departments this job belongs to. Required to be set for playable jobs. The first department will be used in the preferences menu, unless department_for_prefs is set.

var
description
–

The description of the job, used for preferences menu. Keep it short and useful. Avoid in-jokes, these are for new players.

var
employers
– /list

What company can employ this job? First index is default

var
exclusive_mail_goodies
–

If this job's mail goodies compete with generic goodies.

var
exp_granted_type
–

Experience type granted by playing in this job.

var
exp_required_type
–

Experience required to play this job, if the config is enabled, and exp_required_type_department is not enabled with the proper config.

var
exp_required_type_department
–

Department experience required to play this job, if the config is enabled.

var
exp_requirements
–

Minutes of experience-time required to play in this job. The type is determined by [exp_required_type] and [exp_required_type_department] depending on configs.

var
faction
–

Players will be allowed to spawn in as jobs that are set to "Station"

var
family_heirlooms
– /list

List of family heirlooms this job can get with the family heirloom quirk. List of types.

var
head_announce
– /list

Tells the given channels that the given mob is the new department head. See communications.dm for valid channels.

var
job_flags
–

var
job_spawn_title
–

Job title to use for spawning. Allows a job to spawn without needing map edits.

var
languages
– /list

Lazylist of language types to grant.

var
liver_traits
– /list

Lazylist of traits added to the liver of the mob assigned this job (used for the classic "cops heal from donuts" reaction, among others)

var
mail_goodies
– /list

Goodies that can be received via the mail system. Keep the _job definition for this empty and use /obj/item/mail to define general gifts.

var
minimal_player_age
–

If you have the use_age_restriction_for_jobs config option enabled and the database set up, this option will add a requirement for players to be at least minimal_player_age days old. (meaning they first signed in at least that many days before.)

var
minimal_skills
– /list

Innate skill levels unlocked at roundstart. Based on config.jobs_have_minimal_access config setting, for example with a full crew. Format is list(/datum/skill/foo = SKILL_EXP_NOVICE) with exp as an integer or as per code/_DEFINES/skills.dm

var
no_dresscode
–

With this set to TRUE, the loadout will be applied before a job clothing will be

var
outfits
– /list

Different outfits for alternate job titles and different species

var
policy_index
–

String. If set to a non-empty one, it will be the key for the policy text value to show this role on spawn.

var
radio_help_message
–

A string added to the on-join block to tell you how to use your radio.

var
req_admin_notify
–

If this is set to 1, a text is printed to the player when jobs are assigned, telling him that he should let admins know that he has to disconnect.

var
rpg_title
–

RPG job names, for the memes

var
selection_color
–

Selection screen color

var
skills
– /list

Innate skill levels unlocked at roundstart. Based on config.jobs_have_minimal_access config setting, for example with a skeleton crew. Format is list(/datum/skill/foo = SKILL_EXP_NOVICE) with exp as an integer or as per code/_DEFINES/skills.dm

var
spawn_logic
–

How this job decides where to spawn.

var
spawn_positions
–

How many players can spawn in as this job

var
spawn_type
–

What kind of mob type joining players with this job as their assigned role are spawned as.

var
supervisors
–

Supervisors, who this person answers to directly

var
title
–

The name of the job , used for preferences, bans and more. Make sure you know what you're doing before changing this.

var
total_positions
–

How many players can be this job

var
veteran_only
–

Is this job veteran only? If so, then this job requires the player to be in the veteran_players.txt

var
voice_of_god_power
–

Multiplier for general usage of the voice of god.

var
voice_of_god_silence_power
–

Multiplier for the silence command of the voice of god.

Proc Details

proc
after_latejoin_spawn
(/mob/living/spawning)

Called after a successful latejoin spawn. Client is in the mob. This happens after after_spawn()

proc
after_roundstart_spawn
(/mob/living/spawning, /client/player_client)

Called after a successful roundstart spawn. Client is not yet in the mob. This happens after after_spawn()

proc
after_spawn
(/mob/living/spawned, /client/player_client)

Executes after the mob has been spawned in the map. Client might not be yet in the mob, and is thus a separate variable.

proc
get_jobspawn_landmark
()

Returns an unused jobspawn landmark. You CAN run out of landmarks, please be mindful of this!

proc
get_latejoin_spawn_point
()

Finds a valid latejoin spawn point, checking for events and special conditions.

proc
get_mail_goodies
(/mob/recipient)

An overridable getter for more dynamic goodies.

proc
get_map_changes
()

Loads up map configs if necessary and returns job changes for this job.

proc
get_roundstart_spawn_point
()

Returns either an atom the mob should spawn on.

proc
get_roundstart_spawn_point_fixed
()

Returns a fixed spawn location to use. This is probably one of a few job landmarks.

proc
get_roundstart_spawn_point_random
()

Returns a roundstart spawnpoint to use if spawn logic determined it should spawn at a "random" location.

proc
get_spawn_mob
(/client/player_client, /atom/spawn_point)

Spawns the mob to be played as, taking into account preferences and the desired spawn point.

proc
on_join_message
(/client/C, job_title_pref)

Called by SSjob when a player joins the round as this job.

proc
on_join_popup
(/client/C, job_title_pref)

Called by SSjob when a player joins the round as this job.

job /datum/job

Vars

Procs

Var Details

var allow_bureaucratic_error –

var alt_titles – /list

var auto_deadmin_role_flags –

var blacklist_dresscode_slots – /list

var current_positions –

var default_security_status –

var department_for_prefs – /datum/job_department

var department_head –

var departments_bitflags –

var departments_list – /list

var description –

var employers – /list

var exclusive_mail_goodies –

var exp_granted_type –

var exp_required_type –

var exp_required_type_department –

var exp_requirements –

var faction –

var family_heirlooms – /list

var head_announce – /list

var job_flags –

var job_spawn_title –

var languages – /list

var liver_traits – /list

var mail_goodies – /list

var minimal_player_age –

var minimal_skills – /list

var no_dresscode –

var outfits – /list

var policy_index –

var radio_help_message –

var req_admin_notify –

var rpg_title –

var selection_color –

var skills – /list

var spawn_logic –

var spawn_positions –

var spawn_type –

var supervisors –

var title –

var total_positions –

var veteran_only –

var voice_of_god_power –

var voice_of_god_silence_power –