/tg/ Station 13 - Modules - TypesVar Details - Proc Details

/client

Vars

AI_InteractUsed for admin AI interaction
account_ageAge of byond account in days
account_join_dateDate of byond account creation in ISO 8601 format
ambience_playingCurrently playing ambience sound
areaCurrent area of the controlled mob
avgpingAverage ping of the client
ban_cacheUsed to cache this client's bans to save on DB queries
char_render_holdersShould only be a key-value list of north/south/east/west = obj/screen.
chatOutputgoonchat chatoutput of the client
click_interceptNeeds to implement InterceptClickOn(user,params,atom) proc
clicklimiterUsed for limiting the rate of clicks sends by the client to avoid abuse
client_keysend_amountAmount of keydowns in the last keysend checking interval
connection_realtimeworld.realtime they connected
connection_timeworld.time they connected
connection_timeofdayworld.timeofday they connected
creditslazy list of all credit object bound to this client
current_key_addressused to keep track of the current rolling buffer position
externalreplyamountInternal counter for clients sending external (IRC/Discord) relay messages via ahelp to prevent spamming. Set to a number every time an admin reply is sent, decremented for every client send.
holderContains admin info. Null if client is not an admin.
inprefsIf the client is currently in player preferences
ip_intelUsed for ip intel checking to identify evaders, disabled because of issues with traffic
keys_heldA rolling buffer of any keys held currently
keysend_trippedWhen set to true, user will be autokicked if they trip the keysends in a second limit again
last_messageContains the last message sent by this client - used to protect against copy-paste spamming.
last_message_countcontins a number of how many times a message identical to last_message was sent.
last_turnlast turn of the controlled mob, I think this is only used by mechs?
lastpingLast ping of the client
mouse_down_iconused to make a special mouse cursor, this one for mouse up icon
mouse_up_iconused to make a special mouse cursor, this one for mouse up icon
move_delayMove delay of controlled mob, related to input handling
movement_keyscustom movement keys for this client
next_keysend_resetWorld tick time where client_keysend_amount will reset
next_keysend_trip_resetWorld tick time where keysend_tripped will reset back to false
next_move_dir_addThese next two vars are to apply movement for keypresses and releases made while move delayed. Because discarding that input makes the game less responsive. On next move, add this dir to the move that would otherwise be done
next_move_dir_subOn next move, subtract this dir from the move that would otherwise be done
playedWhether an ambience sound has been played and one shouldn't be played again, unset by a callback
player_ageUsed to determine how old the account is - in days.
player_detailsthese persist between logins/logouts during the same round.
player_join_dateDate that this account was first seen in the server
prefsPlayer preferences datum for the client
related_accounts_cidSo admins know why it isn't working - Used to determine what other accounts previously logged in from this computer id
related_accounts_ipSo admins know why it isn't working - Used to determine what other accounts previously logged in from this ip
tooltipsdatum that controls the displaying and hiding of tooltips
topiclimiterUsed for limiting the rate of topic sends by the client to avoid abuse
total_count_resetNext tick to reset the total message counter
total_message_countHow many messages sent in the last 10 seconds

Procs

MoveMove a client in a direction
Move_objectforce move the control_object of your client mob
Process_GrabChecks to see if you're being grabbed and if so attempts to break it
Process_IncorpmoveAllows mobs to ignore density and phase through objects
ResetAmbiencePlayedReset the played var to false on the client
body_chestHidden verb to target the chest, bound to 5
body_groinHidden verb to target the groin, bound to 2
body_l_armHidden verb to target the left arm, bound to 6
body_l_legHidden verb to target the left leg, bound to 3
body_r_armHidden verb to target the right arm, bound to 4
body_r_legHidden verb to target the right leg, bound to 1
body_toggle_headHidden verb to set the target zone of a mob to the head
check_has_body_selectValidate the client's mob has a valid zone selected
drop_itemIf your mob is concious, drop the item in the active hand
keyUpCheck if the key is short enough to even be a real key
toggle_walk_runVerb to toggle the walk or run status
uicloseverb

Var Details

AI_Interact

Used for admin AI interaction

account_age

Age of byond account in days

account_join_date

Date of byond account creation in ISO 8601 format

ambience_playing

Currently playing ambience sound

area

Current area of the controlled mob

avgping

Average ping of the client

ban_cache

Used to cache this client's bans to save on DB queries

char_render_holders

Should only be a key-value list of north/south/east/west = obj/screen.

chatOutput

goonchat chatoutput of the client

click_intercept

Needs to implement InterceptClickOn(user,params,atom) proc

clicklimiter

Used for limiting the rate of clicks sends by the client to avoid abuse

client_keysend_amount

Amount of keydowns in the last keysend checking interval

connection_realtime

world.realtime they connected

connection_time

world.time they connected

connection_timeofday

world.timeofday they connected

credits

lazy list of all credit object bound to this client

current_key_address

used to keep track of the current rolling buffer position

externalreplyamount

Internal counter for clients sending external (IRC/Discord) relay messages via ahelp to prevent spamming. Set to a number every time an admin reply is sent, decremented for every client send.

holder

Contains admin info. Null if client is not an admin.

inprefs

If the client is currently in player preferences

ip_intel

Used for ip intel checking to identify evaders, disabled because of issues with traffic

keys_held

A rolling buffer of any keys held currently

keysend_tripped

When set to true, user will be autokicked if they trip the keysends in a second limit again

last_message

Contains the last message sent by this client - used to protect against copy-paste spamming.

last_message_count

contins a number of how many times a message identical to last_message was sent.

last_turn

last turn of the controlled mob, I think this is only used by mechs?

lastping

Last ping of the client

mouse_down_icon

used to make a special mouse cursor, this one for mouse up icon

mouse_up_icon

used to make a special mouse cursor, this one for mouse up icon

move_delay

Move delay of controlled mob, related to input handling

movement_keys

custom movement keys for this client

next_keysend_reset

World tick time where client_keysend_amount will reset

next_keysend_trip_reset

World tick time where keysend_tripped will reset back to false

next_move_dir_add

These next two vars are to apply movement for keypresses and releases made while move delayed. Because discarding that input makes the game less responsive. On next move, add this dir to the move that would otherwise be done

next_move_dir_sub

On next move, subtract this dir from the move that would otherwise be done

played

Whether an ambience sound has been played and one shouldn't be played again, unset by a callback

player_age

Used to determine how old the account is - in days.

player_details

these persist between logins/logouts during the same round.

player_join_date

Date that this account was first seen in the server

prefs

Player preferences datum for the client

related_accounts_cid

So admins know why it isn't working - Used to determine what other accounts previously logged in from this computer id

related_accounts_ip

So admins know why it isn't working - Used to determine what other accounts previously logged in from this ip

tooltips

datum that controls the displaying and hiding of tooltips

topiclimiter

Used for limiting the rate of topic sends by the client to avoid abuse

total_count_reset

Next tick to reset the total message counter

total_message_count

How many messages sent in the last 10 seconds

Proc Details

Move

Move a client in a direction

Huge proc, has a lot of functionality

Mostly it will despatch to the mob that you are the owner of to actually move in the physical realm

Things that stop you moving as a mob:

Things that stop you moving as a mob living (why even have OO if you're just shoving it all in the parent proc with istype checks right?):

At this point, if the mob is is confused, then a random direction and target turf will be calculated for you to travel to instead

Now the parent call is made (to the byond builtin move), which moves you

Some final move delay calculations (doubling if you moved diagonally successfully)

if mob throwing is set I believe it's unset at this point via a call to finalize

Finally if you're pulling an object and it's dense, you are turned 180 after the move (if you ask me, this should be at the top of the move so you don't dance around)

Move_object

force move the control_object of your client mob

Used in admin possession and called from the client Move proc ensures the possessed object moves and not the admin mob

Has no sanity other than checking density

Process_Grab

Checks to see if you're being grabbed and if so attempts to break it

Called by client/Move()

Process_Incorpmove

Allows mobs to ignore density and phase through objects

Called by client/Move()

The behaviour depends on the incorporeal_move value of the mob

You'll note this is another mob living level proc living at the client level

ResetAmbiencePlayed

Reset the played var to false on the client

body_chest

Hidden verb to target the chest, bound to 5

body_groin

Hidden verb to target the groin, bound to 2

body_l_arm

Hidden verb to target the left arm, bound to 6

body_l_leg

Hidden verb to target the left leg, bound to 3

body_r_arm

Hidden verb to target the right arm, bound to 4

body_r_leg

Hidden verb to target the right leg, bound to 1

body_toggle_head

Hidden verb to set the target zone of a mob to the head

(bound to 8) - repeated presses toggles through head - eyes - mouth

check_has_body_select

Validate the client's mob has a valid zone selected

drop_item

If your mob is concious, drop the item in the active hand

This is a hidden verb, likely for binding with winset for hotkeys

keyUp

Check if the key is short enough to even be a real key

toggle_walk_run

Verb to toggle the walk or run status

uiclose

verb

Called by UIs when they are closed. Must be a verb so winset() can call it.

required uiref ref The UI that was closed.