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.

View in store

Server events

ServerEventYou listen to it

lg_admin:server:playerBanned

A player was banned (panel, command, bot or export).

What you receive

  • banIdnumber
  • bantable

    { name, reason, by, hours, expiresAt, target, identifiers }

Example

Lua
AddEventHandler('lg_admin:server:playerBanned', function(banId, ban)
    print(('%s was banned by %s: %s'):format(ban.name, ban.by, ban.reason))
end)
ServerEventYou listen to it

lg_admin:server:playerUnbanned

A ban was lifted.

What you receive

  • banIdnumber
  • bystring
ServerEventYou listen to it

lg_admin:server:playerKicked

A player was kicked.

What you receive

  • srcnumber
  • reasonstring
  • bystring
ServerEventYou listen to it

lg_admin:server:playerWarned

A player was warned.

What you receive

  • srcnumber
  • reasonstring
  • bystring
ServerEventYou listen to it

lg_admin:server:reportCreated

A player opened a report.

What you receive

  • reportIdnumber
  • srcnumber
  • subjectstring
  • categorystring
ServerEventYou listen to it

lg_admin:server:staffChanged

A player got, lost or changed staff access.

What you receive

  • srcnumber
  • stafftable | nil

    { role, label, priority }, nil when access was lost.

ServerEventYou listen to it

lg_admin:server:toolChanged

A staff member turned a tool on or off.

What you receive

  • srcnumber
  • toolstring
  • onboolean
ServerEventYou listen to it

lg_admin:server:alert

A suspicious activity alert was raised.

What you receive

  • kindstring

    'money', 'money_total', 'item', 'item_total', 'kills', 'watch', 'script'

  • srcnumber
  • datatable
ServerEventYou listen to it

lg_admin:server:punished

A timed punishment was given.

What you receive

  • srcnumber | nil

    nil when the player is offline.

  • identifierstring
  • kindstring
  • minutesnumber
  • reasonstring
ServerEventYou listen to it

lg_admin:server:log

Every log line.

What you receive

  • categorystring
  • actionstring
  • actorNamestring
  • targetNamestring
  • datatable
ServerEventYou listen to it

lg_admin:server:societyChanged

Job money changed.

What you receive

  • jobstring
  • balancenumber
  • beforenumber

Client events

ClientEventYou listen to it

lg_admin:client:panelOpened

The admin panel opened - hide your HUD here.

What you receive

No data.

Example

Lua
AddEventHandler('lg_admin:client:panelOpened', function() exports.myhud:Hide() end)
ClientEventYou listen to it

lg_admin:client:panelClosed

The admin panel closed.

What you receive

No data.

ClientEventYou listen to it

lg_admin:client:toolChanged

A tool was turned on or off.

What you receive

  • toolstring
  • onboolean
  • modestringoptional

    Infinite ammo only: 'noreload' or 'reload'.

ClientEventYou listen to it

lg_admin:client:spectateChanged

Spectating started or ended.

What you receive

  • targetnumber | nil

    Server id, nil when it ended.

Server hooks

In server/hooks.lua (not encrypted):

HookWhen
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:

HookWhen
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