Commands/Lua
Reference for console commands, Lua hooks and Lua commands in CS2D.
- Console Commands are entered in console, executed with key-binds, cfg-files or with Lua parse
- Lua Hooks execute Lua when events occur - some have a return value which can change the game behavior
- Lua Commands are used to retrieve game data or to perform actions in Lua scripts
CS2D Console Commands
Lua Hooks
connect_initplayer
Categories
Parameters
- id: player id
Info
When a player instance is created during the connection process. From this moment on you can use the command player to retrieve details about the player.
The instance is created directly after starting the connection process when first sanity checks and conditions are passed. It may not be invoked when the server is full, the password is wrong, the player is banned or the connection process was cancelled early for any other reason. It may also be delayed by the U.S.G.N. verification process (sv_checkusgnlogin set to 1) which will then also delay the invocation of this hook.
For the server/other players this is the moment when the new player is displayed in the HUD ("xyz connected") and starts to appear in the scoreboard. The player however is not yet able to interact with the server (e.g. can't choose a team yet).
The connecting player may fail to fully connect after this hook is called. That's because error-prone tasks like file transfer, map loading and server data loading all happen afterwards.
Hook execution order when a player connects/joins:
The instance is created directly after starting the connection process when first sanity checks and conditions are passed. It may not be invoked when the server is full, the password is wrong, the player is banned or the connection process was cancelled early for any other reason. It may also be delayed by the U.S.G.N. verification process (sv_checkusgnlogin set to 1) which will then also delay the invocation of this hook.
For the server/other players this is the moment when the new player is displayed in the HUD ("xyz connected") and starts to appear in the scoreboard. The player however is not yet able to interact with the server (e.g. can't choose a team yet).
The connecting player may fail to fully connect after this hook is called. That's because error-prone tasks like file transfer, map loading and server data loading all happen afterwards.
Hook execution order when a player connects/joins:
Note: This hook is NOT triggered for bots!
Note: If cs2d:sv_checkusgnlogin is 1, the U.S.G.N. ID of the player is already verified at this point. If it's 0 the U.S.G.N. ID is NOT verified at this point.
Attention: This hook is not triggered if the connection process is cancelled in early stages for any reason.
Attention: The player is not fully connected at that point. You should not try to display Lua images, message or other things at this point. Use the join hook instead if you want to show stuff to the new player.
Return Values
none - related action(s) [if there are any] performed by CS2D cannot be altered/omitted