Action Customization

MonoAdmin allows developers to override default behaviors for specific actions. This is useful for integrating with custom frameworks, anti-cheat systems, or specialized server logic.

These customizations are handled via the customizable/ directory within the monoAdmin resource.

---

Server-Side Customization

Server-side overrides are located in customizable/server.lua. These functions allow you to control what happens when a player is banned or kicked.

customizable/server.lua

local internalName = "Sevent"
CustomizableAction = CustomizableAction or {}
CustomizableAction[internalName] = {}
local intTable = CustomizableAction[internalName]

-- playerId, reason, duration in seconds; 0 = permanent
intTable.onPlayerPunishmentBan = function(player, reason, duration)
    -- Default behavior: DropPlayer(player, reason)
    DropPlayer(player, reason)
    return true, nil
end

intTable.onPlayerPunishmentKick = function(player, reason)
    -- Default behavior: DropPlayer(player, reason)
    DropPlayer(player, reason)
    return true, nil
end

Available Overrides

Function	Parameters	Description
onPlayerPunishmentBan	player, reason, duration	Triggered when a player is banned.
onPlayerPunishmentKick	player, reason	Triggered when a player is kicked.

---

Client-Side Customization

Client-side overrides are located in customizable/client.lua. These allow you to hook into actions like healing and reviving, which is essential if your server uses a custom ambulance or health system.

customizable/client.lua

local internalName = "events"
CustomizableAction = CustomizableAction or {}
CustomizableAction[internalName] = {}

local intTable = CustomizableAction[internalName]

intTable.revive = function()
    if Config.Framework == 'esx' then
        TriggerEvent('esx_ambulancejob:revive')
    else
        local ped = MonoAdmin.State.ped
        local coords = GetEntityCoords(ped)

        NetworkResurrectLocalPlayer(coords.x, coords.y, coords.z, GetEntityHeading(ped), true, false)
        SetEntityHealth(ped, GetEntityMaxHealth(ped))
        ClearPedBloodDamage(ped)
        ResetPedVisibleDamage(ped)
        ClearPedTasksImmediately(ped)
    end
    return true
end

intTable.heal = function()
    if Config.Framework == 'esx' then
        TriggerEvent('esx_ambulancejob:heal', 'big', true)
    else
        local ped = MonoAdmin.State.ped
        SetEntityHealth(ped, GetEntityMaxHealth(ped))
        SetPedArmour(ped, 100)
        ClearPedBloodDamage(ped)
        ResetPedVisibleDamage(ped)
    end
    return true
end

Available Overrides

Function	Description
revive	Overrides the behavior when an admin revives a player.
heal	Overrides the behavior when an admin heals a player.

---

Best Practices

1. Return Values: Ensure your functions return true (and nil for error if applicable) to signify a successful override.
2. Framework Checks: Use Config.Framework to tailor logic for ESX, QB-Core, or Standalone environments.
3. State Management: Access local player state via MonoAdmin.State.ped on the client side for optimized performance.