Minefield

Descrição

O Minefield cria campos minados em áreas circulares definidas pelo servidor e avisa os jogadores ao entrar, permanecer e sair dessas áreas. As minas são distribuídas aleatoriamente no terreno e iniciam a ativação nativa do jogo após a criação.

A quantidade configurada é uma meta: água, obstáculos, limites do mapa e a distância mínima entre minas podem impedir que todas sejam criadas. As minas detonadas ou removidas não são repostas automaticamente.

Configuração

Configuração padrão

Minefield.json

{
    "m_Enable": 0,
    "m_Zones": [
        {
            "m_Name": "",
            "m_Position": {
                "m_X": 8228.21,
                "m_Y": 519.3,
                "m_Z": 9033.19,
                "m_R": 300.0
            },
            "m_Quantity": 10
        }
    ],
    "m_Messages": {
        "m_Enter": "You are in a minefield.",
        "m_Exit": "You just left a minefield."
    },
    "m_NotificationTime": 10,
    "m_NotificationDelay": 60,
    "m_NotificationInChat": 0
}

Opções

Opção	Tipo	Descrição
m_Enable	bool	Com 1, cria os campos minados e ativa os avisos; com 0, não cria minas nem avisos. A inicialização limpa as minas anteriores do módulo antes de verificar esta opção.
m_Zones	array<object>	Lista de até 64 áreas circulares. Com [], não cria campos. A soma de m_Quantity das áreas não pode ultrapassar 2000 minas.
m_Messages	object	Textos dos avisos de entrada, permanência e saída.
m_NotificationTime	int	Duração da notificação visual em segundos, de 1 a 300. Não controla a duração das mensagens no chat.
m_NotificationDelay	int	Intervalo em segundos entre lembretes dentro do campo, de 0 a 86400. Com 0, desativa os lembretes; os avisos de entrada e saída continuam imediatos.
m_NotificationInChat	bool	Com 1, envia os avisos pelo canal de mensagens do jogo do Chat; com 0, usa notificações visuais do Notification.

Uma configuração inválida impede a criação de todos os campos e gera um registro no log. Os limites são validados; valores fora do intervalo não são ajustados automaticamente.

m_Zones[]

Opção	Tipo	Descrição
m_Name	string	Nome da área usado nos registros de criação. Não é incluído automaticamente nas mensagens aos jogadores.
m_Position	object	Centro e raio da área, em metros. Ajuste as coordenadas ao mapa do servidor.
m_Quantity	int	Quantidade desejada de minas na área, de 1 a 500. O log informa quantas foram criadas em relação à quantidade solicitada.

As posições são sorteadas dentro do círculo, sobre a altura do terreno. Água, obstáculos e posições a menos de 2 metros de outra mina criada pelo módulo são rejeitados. A criação ocorre gradualmente, com um limite de tentativas por área; terreno inadequado pode resultar em menos minas que o solicitado.

Os avisos consideram as áreas sobrepostas como um único campo: passar de uma para outra sem sair do conjunto não repete a entrada nem produz uma saída intermediária. A faixa de detecção dos jogadores tem 500 metros de altura, centrada no terreno do centro da área.

m_Zones[].m_Position

Opção	Tipo	Descrição
m_X	float	Coordenada horizontal X do centro, maior ou igual a 0 e menor que o tamanho do mapa.
m_Y	float	Coordenada vertical mantida na configuração. A criação das minas e a altura do centro da área usam a superfície do terreno.
m_Z	float	Coordenada horizontal Z do centro, maior ou igual a 0 e menor que o tamanho do mapa.
m_R	float	Raio do campo em metros, maior que 0 e menor ou igual a 10000.

m_Messages

Opção	Tipo	Descrição
m_Enter	string	Texto enviado ao entrar no campo e repetido nos lembretes de permanência. Com "", desativa esses avisos.
m_Exit	string	Texto enviado ao sair do campo. Com "", desativa esse aviso.

Com m_NotificationInChat em 1, o Chat deve estar ativo e as preferências do jogador devem permitir mensagens do jogo. Com 0, os avisos usam o título MINEFIELD. Os lembretes cessam ao sair, morrer ou desconectar.

Comandos

/reload minefield

Recria os campos conforme a configuração atual por meio do módulo Comandos.

• Sintaxe: /reload minefield
• Argumentos: minefield identifica o módulo a recarregar.
• Permissão: command.reload ou root ao executar pelo chat.
• Exemplo: /reload minefield

A recarga remove os gatilhos e todas as minas do módulo existentes, inclusive as desarmadas, movidas ou recolhidas pelos jogadores. Em seguida, cria uma nova população se o módulo estiver ativo e a configuração for válida. Minas comuns do jogo não são removidas por essa limpeza. Desativar o módulo e recarregá-lo também remove suas minas existentes.