new_player

Vars
ineligible_for_roles	Used to make sure someone doesn't get spammed with messages if they're ineligible for roles.
jobs_menu_mounted	Used to track if the player's jobs menu sent a message saying it successfully mounted.
new_character	For instant transfer once the round is set up
ready	String Values tied to Defines that state whether the new_player is ready to play or not. Do try your best to compare this value directly against the defines for certainty but helper procs do exist in bulkier situations.
spawning	Referenced when you want to delete the new_player later on in the code.
Procs
auto_deadmin_on_ready_or_latejoin	Auto deadmins an admin when they click to toggle the ready button or join game button in the menu
create_character	Creates, assigns and returns the new_character to spawn as. Assumes a valid mind.assigned_role exists.
handle_player_polling	Shows a list of currently running polls a player can vote/has voted on
hide_title_screen	Removes the lobby menu entirely from a mob.
is_ready_to_play	Quickly gets a boolean of whether the new_player is ready to play or not in places where we would like the boolean logic. The assertion is that readiness must be an opted in TRUE, while all other states (e.g. not ready, broken, etc) are FALSE. We organize it this way to ensure the system is extensible for other possible ready states.
poll_player	Redirects a player to the correct poll window based on poll type.
poll_player_irv	Shows voting window for an IRV type poll, listing its options and relevant details.
poll_player_multi	Shows voting window for a multiple choice type poll, listing its options and relevant details.
poll_player_option	Shows voting window for an option type poll, listing its options and relevant details.
poll_player_rating	Shows voting window for a rating type poll, listing its options and relevant details.
poll_player_text	Shows voting window for a text response type poll, listing its relevant details.
ready	Readies up for the round
register_for_interview	Prepares a client for the interview system, and provides them with a new interview
server_swap	Allows the player to select a server to join from any loaded servers.
show_title_screen	Shows the lobby menu to a new player. the lobby menu itself already knows how to show/hide based on the client's mob type (see /datum/lobby_menu/proc/update_visibility).
symphony_blocks_play	Return whether the whitelist gate prevents this player from entering the round.
symphony_blocks_play_cached	Non-sleeping admission check: TRUE blocks play, FALSE permits it, and null means uncached. Keeping unknown separate from denied prevents a rejection flash when the cache expires.
symphony_gate_state	Resolve admission as open, blocked, or unavailable, preserving the reason for a denial. Uses the whitelist cache and may sleep on a miss. Never call from process().
symphony_validate_ready	Validate pending admission before job selection and again immediately before character creation.
symphony_validate_roundstart_transfer	Equipment and manifest setup can yield after creation; revalidate at the final roundstart transfer.
unready	Unreadies for the round
update_ready_report	Keeps the job estimation in step with tg's ready report, which runs on every ready toggle, job pref change, character load and logout
vote_on_poll_handler	Runs some poll validation before a vote is processed.
vote_on_poll_irv	Processes vote form data and saves results to the database for an IRV type poll.
vote_on_poll_multi	Processes vote form data and saves results to the database for a multiple choice type poll.
vote_on_poll_option	Processes vote form data and saves results to the database for an option type poll.
vote_on_poll_rating	Processes vote form data and saves results to the database for a rating type poll.
vote_on_poll_text	Processes response form data and saves results to the database for a text response type poll.

Var Details

var
ineligible_for_roles

Used to make sure someone doesn't get spammed with messages if they're ineligible for roles.

var
jobs_menu_mounted

Used to track if the player's jobs menu sent a message saying it successfully mounted.

var
new_character
– /mob/living

For instant transfer once the round is set up

var
ready

String Values tied to Defines that state whether the new_player is ready to play or not. Do try your best to compare this value directly against the defines for certainty but helper procs do exist in bulkier situations.

var
spawning

Referenced when you want to delete the new_player later on in the code.

Proc Details

proc
auto_deadmin_on_ready_or_latejoin
()

Auto deadmins an admin when they click to toggle the ready button or join game button in the menu

proc
create_character
(/atom/destination, forced_slot)

Creates, assigns and returns the new_character to spawn as. Assumes a valid mind.assigned_role exists.

destination - where to spawn the character
forced_slot - if provided, will load whatever character is in that slot instead of their active slot

proc
handle_player_polling
()

Shows a list of currently running polls a player can vote/has voted on

proc
hide_title_screen
()

Removes the lobby menu entirely from a mob.

proc
is_ready_to_play
()

Quickly gets a boolean of whether the new_player is ready to play or not in places where we would like the boolean logic. The assertion is that readiness must be an opted in TRUE, while all other states (e.g. not ready, broken, etc) are FALSE. We organize it this way to ensure the system is extensible for other possible ready states.

proc
poll_player
(/datum/poll_question/poll)

Redirects a player to the correct poll window based on poll type.

proc
poll_player_irv
(/datum/poll_question/poll)

Shows voting window for an IRV type poll, listing its options and relevant details.

If already voted on, the options are sorted how a player voted for them, otherwise they are randomly shuffled.

proc
poll_player_multi
(/datum/poll_question/poll)

Shows voting window for a multiple choice type poll, listing its options and relevant details.

If already voted on, the options a player voted for are pre-selected.

proc
poll_player_option
(/datum/poll_question/poll)

Shows voting window for an option type poll, listing its options and relevant details.

If already voted on, the option a player voted for is pre-selected.

proc
poll_player_rating
(/datum/poll_question/poll)

Shows voting window for a rating type poll, listing its options and relevant details.

If already voted on, the options a player voted for are pre-selected.

proc
poll_player_text
(/datum/poll_question/poll)

Shows voting window for a text response type poll, listing its relevant details.

If already responded to, the saved response of a player is shown.

proc
ready
()

Readies up for the round

proc
register_for_interview
()

Prepares a client for the interview system, and provides them with a new interview

This proc will both prepare the user by removing all verbs from them, as well as giving them the interview form and forcing it to appear.

proc
server_swap
()

Allows the player to select a server to join from any loaded servers.

proc
show_title_screen
()

Shows the lobby menu to a new player. the lobby menu itself already knows how to show/hide based on the client's mob type (see /datum/lobby_menu/proc/update_visibility).

proc
symphony_blocks_play
()

Return whether the whitelist gate prevents this player from entering the round.

proc
symphony_blocks_play_cached
()

Non-sleeping admission check: TRUE blocks play, FALSE permits it, and null means uncached. Keeping unknown separate from denied prevents a rejection flash when the cache expires.

proc
symphony_gate_state
()

Resolve admission as open, blocked, or unavailable, preserving the reason for a denial. Uses the whitelist cache and may sleep on a miss. Never call from process().

proc
symphony_validate_ready
()

Validate pending admission before job selection and again immediately before character creation.

proc
symphony_validate_roundstart_transfer
()

Equipment and manifest setup can yield after creation; revalidate at the final roundstart transfer.

proc
unready
()

Unreadies for the round

proc
update_ready_report
()

Keeps the job estimation in step with tg's ready report, which runs on every ready toggle, job pref change, character load and logout

proc
vote_on_poll_handler
(/datum/poll_question/poll, href_list)

Runs some poll validation before a vote is processed.

Checks a player is who they claim to be and that a poll is actually still running. Also loads the vote_id to pass onto single-option and text polls. Increments the vote count when successful.

proc
vote_on_poll_irv
(/datum/poll_question/poll, /list/href_list, admin_rank, sql_poll_id)

Processes vote form data and saves results to the database for an IRV type poll.

proc
vote_on_poll_multi
(/datum/poll_question/poll, /list/href_list, admin_rank, sql_poll_id)

Processes vote form data and saves results to the database for a multiple choice type poll.

proc
vote_on_poll_option
(/datum/poll_question/poll, href_list, admin_rank, sql_poll_id, vote_id)

Processes vote form data and saves results to the database for an option type poll.

proc
vote_on_poll_rating
(/datum/poll_question/poll, /list/href_list, admin_rank, sql_poll_id)

Processes vote form data and saves results to the database for a rating type poll.

proc
vote_on_poll_text
(href_list, admin_rank, sql_poll_id, vote_id)

Processes response form data and saves results to the database for a text response type poll.

new_player /mob/dead/new_player

Vars

Procs

Var Details

var ineligible_for_roles

var jobs_menu_mounted

var new_character – /mob/living

var ready

var spawning

Proc Details

proc auto_deadmin_on_ready_or_latejoin()

proc create_character(/atom/destination, forced_slot)

proc handle_player_polling()

proc hide_title_screen()

proc is_ready_to_play()

proc poll_player(/datum/poll_question/poll)

proc poll_player_irv(/datum/poll_question/poll)

proc poll_player_multi(/datum/poll_question/poll)

proc poll_player_option(/datum/poll_question/poll)

proc poll_player_rating(/datum/poll_question/poll)

proc poll_player_text(/datum/poll_question/poll)

proc ready()

proc register_for_interview()

proc server_swap()

proc show_title_screen()

proc symphony_blocks_play()

proc symphony_blocks_play_cached()

proc symphony_gate_state()

proc symphony_validate_ready()

proc symphony_validate_roundstart_transfer()

proc unready()

proc update_ready_report()

proc vote_on_poll_handler(/datum/poll_question/poll, href_list)

proc vote_on_poll_irv(/datum/poll_question/poll, /list/href_list, admin_rank, sql_poll_id)

proc vote_on_poll_multi(/datum/poll_question/poll, /list/href_list, admin_rank, sql_poll_id)

proc vote_on_poll_option(/datum/poll_question/poll, href_list, admin_rank, sql_poll_id, vote_id)

proc vote_on_poll_rating(/datum/poll_question/poll, /list/href_list, admin_rank, sql_poll_id)

proc vote_on_poll_text(href_list, admin_rank, sql_poll_id, vote_id)