Início › Documentação › Exports · origen_notify

Exports · origen_notify

Todos os exports estão registados com o nome de recurso origen_notify.

Exports do servidor

ShowNotification(pID, message, type, length)

Envia uma notificação pop-up a um jogador específico a partir do servidor.

lua
exports["origen_notify"]:ShowNotification(source, "Your vehicle has been impounded", "warning")
Parâmetro Tipo Descrição
pID number ID de servidor do jogador. Não pode ser nil.
message string Texto mostrado na notificação.
type string | nil Estilo da notificação. Valores aceites: "success", "warning", "error", "business". Deixa nil para o estilo por omissão.
length number | nil Duração em milissegundos. Por omissão 5000 se não for indicada.

Se pID for nil, o export imprime um erro na consola do servidor e termina sem fazer nada. Passa sempre um source de jogador válido.

Exports do cliente

ShowNotification(message, type, timeout)

Mostra uma notificação pop-up no ecrã do jogador local.

lua
exports["origen_notify"]:ShowNotification("You received $500", "success")
exports["origen_notify"]:ShowNotification("Low health", "warning", 8000)
Parâmetro Tipo Descrição
message string Texto mostrado na notificação.
type string | nil Estilo da notificação: "success", "warning", "error", "business" ou nil para o estilo por omissão.
timeout number | nil Duração em milissegundos. Por omissão 5000.

CreateHelp(key, text) → id

Mostra uma notificação de ajuda com uma tecla (estilo em baixo à esquerda). Devolve um ID único necessário para a atualizar ou remover mais tarde.

lua
local id = exports["origen_notify"]:CreateHelp("E", "Press to open the shop")
Parâmetro Tipo Descrição
key string Etiqueta da tecla mostrada na ajuda (por exemplo "E", "F", "G"). Obrigatório: devolve nil se for omitido.
text string Texto descritivo mostrado junto à tecla.

Devolve id (string): identificador único desta notificação.

UpdateHelp(id, key, text)

Atualiza a etiqueta da tecla e o texto de uma notificação de ajuda existente.

lua
exports["origen_notify"]:UpdateHelp(id, "G", "Press to close")
Parâmetro Tipo Descrição
id string ID devolvido por CreateHelp.
key string Nova etiqueta da tecla.
text string Novo texto descritivo.

RemoveHelp(id)

Remove uma notificação de ajuda através do seu ID.

lua
exports["origen_notify"]:RemoveHelp(id)
Parâmetro Tipo Descrição
id string ID devolvido por CreateHelp.

SetQueueMax(max)

Define o número máximo de notificações pop-up que podem ser mostradas em simultâneo na fila.

lua
exports["origen_notify"]:SetQueueMax(5)
Parâmetro Tipo Descrição
max number Máximo de notificações em simultâneo na fila.

StatusNotify(enabled)

Ativa ou desativa um modo de notificação de estado que pausa a fila até ser desligado. Usado internamente para evitar notificações sobrepostas durante as transições.

lua
exports["origen_notify"]:StatusNotify(true)  -- pause queue
exports["origen_notify"]:StatusNotify(false) -- resume queue
Parâmetro Tipo Descrição
enabled boolean true para pausar a fila de notificações, false para a retomar.