game: events — in-browser gameplay
Audience: Plugin authors and AI agents · Prereqs: Events (concept)
Every plugins.emit(...) call site found in the files below, extracted directly from source - not hand-maintained. Unprefixed at the call site; PluginManager.emit adds game: before checking for listeners, so e.g. the first row below actually fires as game:startUp.
| Event | Location | Payload | Fires when |
|---|---|---|---|
startUp | server-client/src/client-static/src/shellshock.min.js:99 | { } | The in-browser game client script finished its own top-level setup. |
afterBullshit | server-client/src/client-static/src/shellshock.min.js:402 | {} | Fires after an early setup block (the name is kept verbatim from the original game source). |
LegacyShellOnMessage | server-client/src/client-static/src/shellshock.min.js:442 | {cmd, cmdName, input} | Every incoming server packet, after opcode decoding, before dispatch — a general-purpose network message hook; data.input is a still-positioned Comm.In reader, so a plugin can read a custom opcode's payload here. |
roomParamsUpdated | server-client/src/client-static/src/shellshock.min.js:459 | { roomParamsObj } | A Comm.Code.updateRoomParams payload was just parsed (cheatsEnabled/Object.assign already handled by core) - lets a plugin render its own gameOptions.plugins-owned fields (e.g. legacyweather's weather/time rendering). |
roundEndSFX | server-client/src/client-static/src/shellshock.min.js:507 | {roundLength, roundEndTime, betweenRounds} | Round-end sound/UI cue. |
playerDeathAnimation | server-client/src/client-static/src/shellshock.min.js:690 | {killedPlayer} | A player's death animation is playing. |
inGameSync1 | server-client/src/client-static/src/shellshock.min.js:797 | { id, stateIdx, x, y, z, dx, dy, dz, climbing, pingLevelInt } | First stage of processing an incoming per-player sync entry. |
inGameSync2 | server-client/src/client-static/src/shellshock.min.js:893 | { id, stateIdx, x, y, z, dx, dy, dz, climbing, pingLevelInt, dist, player } | Second stage of processing an incoming per-player sync entry (remote players, distance-based detail). |
inGameSync3 | server-client/src/client-static/src/shellshock.min.js:927 | { id, stateIdx, x, y, z, dx, dy, dz, climbing, pingLevelInt, player } | Third stage of processing an incoming per-player sync entry. |
clearItemButtons | server-client/src/client-static/src/shellshock.min.js:1336 | { i, canvas } | Shop/loadout UI item-button reset. |
encloseRenderPageFunc | server-client/src/client-static/src/shellshock.min.js:1486 | { i, b, canvas, renderingItem, locked, requiresPhysicalUnlock } | Rendering one catalog item tile in the shop UI. |
playerActorBodyMeshCreated | server-client/src/client-static/src/shellshock.min.js:1746 | { playerActor: this, bodyMesh: this.bodyMesh, player } | A player's visual body mesh finished loading. |
playerActorShadowRenderList | server-client/src/client-static/src/shellshock.min.js:1775 | { playerActor: this, shadowGen: shadowGen } | The player mesh was registered with the shadow generator. |
playerActorRemoveFromPlay | server-client/src/client-static/src/shellshock.min.js:1958 | { playerActor: this } | A player's visual actor is being hidden (died or left). |
playerActorRestoreToPlay | server-client/src/client-static/src/shellshock.min.js:1967 | { playerActor: this } | A player's visual actor is being restored (respawned). |
bulletActorFired | server-client/src/client-static/src/shellshock.min.js:2127 | { bulletActor: this } | A visual bullet actor was fired client-side. |
gunActorSetup | server-client/src/client-static/src/shellshock.min.js:2198 | { gunActor: this, shadowGen } | A weapon's visual model finished setup. |
onPageLoadedEnd | server-client/src/client-static/src/shellshock.min.js:2996 | {} | The game's HTML page finished loading. |
joinGame | server-client/src/client-static/src/shellshock.min.js:3029 | { joinGameIdPassed } | The client is about to send its join request. |
onExtraParams | server-client/src/client-static/src/shellshock.min.js:3119 | { extraParams } | Extra join params (session, custom map, etc.) are being assembled. |
clientOnExtraGameInfo | server-client/src/client-static/src/shellshock.min.js:3227 | { extraInfo } | Extra per-game info received from the server after joining. |
onShadowGeneratorCreated | server-client/src/client-static/src/shellshock.min.js:3383 | { shadowGen } | The Babylon shadow generator was created for the scene. |
loadMaterials | server-client/src/client-static/src/shellshock.min.js:3675 | { scene } | Core's built-in materials have just been defined - lets a plugin define its own right after (e.g. legacyweather's wetMaterial). |
loadSounds | server-client/src/client-static/src/shellshock.min.js:3729 | { soundsList } | Before the Apollo/Howler sound list is loaded. |
createMapCellsMapLoaded | server-client/src/client-static/src/shellshock.min.js:3797 | { minMap, SPS, gameScene, shadowGen, shadowLight } | The raw map JSON has been fetched and is about to be turned into cells. |
modifyMinMap | server-client/src/client-static/src/shellshock.min.js:3828 | event | A direct hook to rewrite the map data itself before cell generation. |
createMapCells | server-client/src/client-static/src/shellshock.min.js:3855 | { minMap, SPS, gameScene, shadowGen, shadowLight } | Map cells are being generated from minMap. |
onMapCompleteBeforeSetup | server-client/src/client-static/src/shellshock.min.js:4112 | { gameScene, minMap } | Before final map setup finishes. |
onMapComplete | server-client/src/client-static/src/shellshock.min.js:4125 | { gameScene } | After final map setup finishes. |
resetGamePlayer | server-client/src/client-static/src/shellshock.min.js:4396 | {player} | Client-local counterpart to the server's resetGamePlayer — round-scoped UI/state reset. |
addKillTextBefore | server-client/src/client-static/src/shellshock.min.js:4761 | {msgs} | Before the kill-feed text is rendered. |
onBalanceUpdated | server-client/src/client-static/src/shellshock.min.js:4783 | {balance: playerAccount.currentBalance} | The player's currency balance display changed. |
onResourcesLoadedEnd | server-client/src/client-static/src/shellshock.min.js:4828 | {} | All game resources (models/sounds/textures) finished loading. |
shellFragBurstBefore | server-client/src/client-static/src/shellshock.min.js:5922 | { player, count, theSize, theAnimLength } | Before a shell-casing particle burst effect plays. |
syncToServer | server-client/src/client-static/src/shellshock.min.js:6485 | {loadout} | The client is about to push a loadout change to the server. |
waitForSetupAndAuthComplete | server-client/src/client-static/src/shellshock.min.js:6722 | {waitIteration} | The startup poll loop, waiting for auth and page setup to both finish, has started. |
waitForSetupAndAuthCompleteCheck | server-client/src/client-static/src/shellshock.min.js:6735 | {waitIteration, customizer, authAttemptComplete, houseAdsLoaded} | The startup poll loop is checking whether auth and page setup have both finished yet. |
waitForSetupAndAuthCompleteReady | server-client/src/client-static/src/shellshock.min.js:6738 | {waitIteration} | The startup poll loop has confirmed both auth and page setup are ready. |
setupComplete | server-client/src/client-static/src/shellshock.min.js:6753 | {} | The startup poll loop concluded successfully. |
reachedEnd | server-client/src/client-static/src/shellshock.min.js:7587 | {} | End of the whole client script file, once. |
loadMeshesBeforeMaterial | server-client/src/client-static/editor/js/mapEdit.js:88278 | {mesh} | Same hook as the shared loading.js version, duplicated for the standalone map-editor page. |
This page was drafted with AI assistance and reviewed for accuracy. If something looks wrong, please open a PR or flag it.