Admin Panel
Events, Hooks & Custom Actions
React to what happens in the panel, change its behaviour in the open hook files and add your own actions.
Server events
lg_admin:server:playerBanned
A player was banned (panel, command, bot or export).
What you receive
banIdnumberbantable{ name, reason, by, hours, expiresAt, target, identifiers }
Example
AddEventHandler('lg_admin:server:playerBanned', function(banId, ban)
print(('%s was banned by %s: %s'):format(ban.name, ban.by, ban.reason))
end)lg_admin:server:playerUnbanned
A ban was lifted.
What you receive
banIdnumberbystring
lg_admin:server:playerKicked
A player was kicked.
What you receive
srcnumberreasonstringbystring
lg_admin:server:playerWarned
A player was warned.
What you receive
srcnumberreasonstringbystring
lg_admin:server:reportCreated
A player opened a report.
What you receive
reportIdnumbersrcnumbersubjectstringcategorystring
lg_admin:server:staffChanged
A player got, lost or changed staff access.
What you receive
srcnumberstafftable | nil{ role, label, priority }, nil when access was lost.
lg_admin:server:toolChanged
A staff member turned a tool on or off.
What you receive
srcnumbertoolstringonboolean
lg_admin:server:alert
A suspicious activity alert was raised.
What you receive
kindstring'money','money_total','item','item_total','kills','watch','script'srcnumberdatatable
lg_admin:server:punished
A timed punishment was given.
What you receive
srcnumber | nilnil when the player is offline.
identifierstringkindstringminutesnumberreasonstring
lg_admin:server:log
Every log line.
What you receive
categorystringactionstringactorNamestringtargetNamestringdatatable
lg_admin:server:societyChanged
Job money changed.
What you receive
jobstringbalancenumberbeforenumber
Client events
lg_admin:client:panelOpened
The admin panel opened - hide your HUD here.
What you receive
No data.
Example
AddEventHandler('lg_admin:client:panelOpened', function() exports.myhud:Hide() end)lg_admin:client:panelClosed
The admin panel closed.
What you receive
No data.
lg_admin:client:toolChanged
A tool was turned on or off.
What you receive
toolstringonbooleanmodestringoptionalInfinite ammo only:
'noreload'or'reload'.
lg_admin:client:spectateChanged
Spectating started or ended.
What you receive
targetnumber | nilServer id, nil when it ended.
Server hooks
In server/hooks.lua (not encrypted):
| Hook | When |
|---|---|
Hooks.CanUseAction(admin, action, target, data) | Before a staff action on a player - return false to block it. |
Hooks.OnBan(admin, target, ban) | After a ban. |
Hooks.OnLog(category, action, actor, target, data) | Every log line (for your own logging system). |
Hooks.OnPlayerLeft(src) | A player left. |
Client hooks
In client/hooks.lua:
| Hook | When |
|---|---|
ClientHooks.OnPanelOpen() / OnPanelClose() | The panel opened / closed. |
ClientHooks.OnHealed() | The player was healed or revived by staff - reset hunger, thirst or injuries of your scripts here. |
Custom actions
actions.lua (not encrypted) adds your own buttons to the player profile, the quick menu or both. Each action has a label, an icon, optional fields (number, text, toggle, select, item, vehicle) and code that runs on the server, on the staff member's client or on the target. Quick menu actions can be buttons or toggles. Each gets its own permission custom.<id>. The file has a full guide and examples.
Last updated