Files
LuaCsForBarotraumaEP/docs/lua/Hooks.lua
2021-09-12 15:58:59 -03:00

128 lines
3.1 KiB
Lua

-- luacheck: ignore 111
--[[--
Hooks are basically functions that get called when events happen in-game, like chat messages.
]]
-- @code Hooks
local Hook = {}
--- Adds a hook.
-- @tparam string eventname event name
-- @tparam string hookname hook name
-- @tparam function func callback
-- @realm shared
-- @usage
-- Hook.Add("characterDeath", "characterDeathExample", function(character)
-- print(character)
-- end)
function Hook.Add(eventname, hookname, func) end
--- Removes a hook.
-- @tparam string eventname event name
-- @tparam string hookname hook name
-- @realm shared
-- @usage
-- Hook.Remove("characterDeath", "characterDeathExample")
function Hook.Remove(eventname, hookname) end
--- Calls a hook.
-- @tparam string eventname event name
-- @tparam table parameters parameters to be passed in
-- @realm shared
-- @usage
-- Hook.Add("think", "happyDebuggingSuckers", function()
-- Hook.Call("characterDead", {}) -- ruin someone's day
-- end)
function Hook.Call(eventname, parameters) end
--- Gets called everytime someone sends a chat message, return true to cancel message
-- @tparam string message
-- @tparam client sender
-- @realm shared
function chatMessage(message, sender) end
--- Called every update
-- @realm shared
function think() end
--- Called when a client connects
-- @tparam client connectedClient
-- @realm shared
function clientConnected(connectedClient) end
--- Called when a client disconnects
-- @tparam client disconnectedClient
-- @realm shared
function clientDisconnected(disconnectedClient) end
--- Called on round start
-- @realm shared
function roundStart() end
--- Called on round end
-- @realm shared
function roundEnd() end
--- Gets callled everytime a character is created.
-- @tparam character createdCharacter
-- @realm shared
function characterCreated(createdCharacter) end
--- Gets called everytime a Character dies.
-- @tparam Character character A dead Character.
-- @realm shared
-- @usage
-- Hook.Add("characterDeath", "characterDeathExample", function(character)
-- print(character)
-- end)
function characterDeath(character) end
---
-- @realm shared
function afflictionApplied(affliction, characterHealth, limb) end
---
-- @realm shared
function afflictionUpdate(affliction, characterHealth, limb) end
---
-- @realm shared
function itemUse(item, itemUser, targetLimb) end
---
-- @realm shared
function itemSecondaryUse(item, itemUser) end
---
-- @realm shared
function itemApplyTreatment(item, usingCharacter, targetCharacter, limb) end
--- Gets called whenever an item is dropped, You can return true to cancel.
-- @realm shared
function itemDrop(item, character) end
--- Gets called whenever an item is equipped. Return true to cancel.
-- @realm shared
function itemEquip(item, character) end
--- Same as itemEquip, but for unequipping.
-- @realm shared
function itemUnequip() end
---
-- @realm shared
function changeFallDamage() end
---
-- @realm shared
function gapOxygenUpdate() end
---
-- @realm shared
function signalReceived() end
---
-- @realm shared
function signalReceived.YourComponentIdentifier() end
---
-- @realm shared
function wifiSignalTransmitted() end
---
-- @realm shared
function serverLog() end