Messages

Descrição

O Messages permite configurar mensagens de boas-vindas, avisos de entrada e saída de jogadores e anúncios periódicos. Os textos podem incluir informações do servidor e ser exibidos no chat ou como notificações.

Configuração

Configuração padrão

Messages.json

{
    "m_Enable": 0,
    "m_Welcome": {
        "m_Message": "Welcome, %PlayerName%, to %ServerName%!",
        "m_Notification": 0,
        "m_NotificationTime": 5
    },
    "m_Connected": {
        "m_Message": "%PlayerName% joined the server.",
        "m_Notification": 0,
        "m_NotificationTime": 5
    },
    "m_Disconnected": {
        "m_Message": "%PlayerName% left the server.",
        "m_Notification": 0,
        "m_NotificationTime": 5
    },
    "m_Messages": [
        {
            "m_Message": "This server is using AC-Mod-Pack.",
            "m_Await": 60,
            "m_Interval": 600,
            "m_Notification": 0
        },
        {
            "m_Message": "There are %PlayersCount% players online now.",
            "m_Await": 30,
            "m_Interval": 300,
            "m_Notification": 1
        }
    ]
}

Opções

Opção	Tipo	Descrição
m_Enable	bool	Com 1, ativa as mensagens de eventos e os avisos periódicos; com 0, desativa ambos.
m_Welcome	object	Mensagem enviada somente ao jogador que acabou de entrar.
m_Connected	object	Aviso de entrada enviado aos demais jogadores conectados; não é enviado ao jogador que entrou.
m_Disconnected	object	Aviso de saída enviado aos jogadores que permanecem conectados.
m_Messages	array<object>	Lista de avisos periódicos enviados a todos os jogadores conectados. Cada entrada possui sua própria espera inicial e intervalo. Use [] para não agendar avisos periódicos.

m_Welcome, m_Connected e m_Disconnected

Os três objetos usam os campos abaixo. Em m_Message, %PlayerName% representa o jogador que entrou ou saiu, %ServerName% representa o nome do servidor e %PlayersCount% representa a quantidade de jogadores conectados no momento do envio.

Opção	Tipo	Descrição
m_Message	string	Texto do evento. Use "" para desativar apenas a mensagem desse evento.
m_Notification	bool	Com 0, envia o texto pelo chat; com 1, exibe uma notificação. O nome exibido como remetente ou título é Server.
m_NotificationTime	float	Duração da notificação, em segundos, quando m_Notification é 1. Valores menores ou iguais a 0 usam 5 segundos. Não altera mensagens enviadas pelo chat.

m_Messages[]

Cada objeto configura um aviso periódico independente. Em m_Message, são substituídos %ServerName% e %PlayersCount%; %PlayerName% não é substituído nesses avisos.

Opção	Tipo	Descrição
m_Message	string	Texto do aviso periódico enviado a todos os jogadores conectados.
m_Await	int	Espera inicial em segundos, contada a partir da inicialização do módulo. Após essa espera, o aviso é enviado pela primeira vez.
m_Interval	int	Intervalo em segundos entre os envios seguintes do mesmo aviso. Use um valor positivo; para desativar um aviso, remova sua entrada de m_Messages.
m_Notification	bool	Com 0, envia o aviso pelo chat; com 1, exibe uma notificação com duração de 5 segundos. O nome exibido como remetente ou título é Server.

Os tempos de m_Await e m_Interval são independentes: o intervalo só passa a contar depois do primeiro envio. Reiniciar ou recarregar o módulo reinicia as esperas iniciais dos avisos. O campo m_NotificationTime dos eventos não controla a duração das notificações periódicas.

O envio pelo chat exige o módulo Chat ativo e utiliza o canal de eventos, cuja exibição também depende das preferências do jogador. As notificações são exibidas pelo módulo Notification.