Progetto H — Riferimento API Documentazione & Scripting

Funzioni & API Esportate 1

PHChat.Commands.register

Server
PHChat.Commands.register(definition, handler)
Registra un comando chat con suggerimenti dinamici, validazione parametri e controllo gerarchico dei permessi.

Parametri & Opzioni

Parametro Tipo Stato Descrizione
definition.name string Obbligatorio Nome del comando (senza slash iniziale).
definition.help string Opzionale Descrizione mostrata nei suggerimenti di completamento.
definition.groups table Opzionale Gruppi di permessi autorizzati (es. config.groups.staff).
definition.params table[] Opzionale Array di parametri: { name = 'nome', help = '...', required = true/false }.
handler function(player, args, raw, context) Obbligatorio Funzione eseguita quando il player lancia il comando.

Valore di Ritorno

void — Nessun valore di ritorno.

Esempio d'Uso

Esempio Lua
PHChat.Commands.register({
    name = "heal",
    help = "Ripristina la salute al massimo.",
    params = { { name = "target", required = false } }
}, function(player, args, raw, context)
    local char = player:GetControlledCharacter()
    if char then char:SetHealth(100) end
    context.reply("Salute ripristinata!")
    return true
end)