🧟 Sistema de Spawn de Mutantes DayZ v1.1

Um sistema avançado de spawn baseado em JSON para DayZ 1.28 que permite gerar zumbis, mutantes e animais em zonas configuráveis.

🖥️ Apenas no Lado do Servidor

Este mod funciona inteiramente no lado do servidor - os jogadores NÃO precisam baixar ou instalar nada. Basta instalar no seu servidor e ele funciona para todos os jogadores imediatamente.

✨ Funcionalidades

• ⚙️ Configuração Baseada em JSON - Edição fácil sem conhecimento de programação
• 🎯 Sistema de Tier Flexível - Categorize entidades por dificuldade ou tipo
• 🗺️ Zonas de Spawn Inteligentes - Ativação baseada em trigger com parâmetros configuráveis
• 🎲 Chances de Spawn - Controle a probabilidade de spawn (0-100%)
• 🗑️ Despawn Automático - Entidades desaparecem quando jogadores saem das zonas
• ⏰ Sistema de Cooldown - Previne respawn imediato
• 📏 Controle de Altura - Suporte para bunkers e prédios com múltiplos andares
• 🐛 Ferramentas de Debug - Comandos abrangentes de debug para teste
• 🚀 Auto-Inicialização - Funciona sem modificações no MissionServer

📁 Estrutura

$profile:MutantSpawnSystem/
├── 🗂️ Tiers.json          # Define categorias de entidades
└── 🗂️ Zones.json          # Configura zonas e pontos de spawn

⚙️ Configuração

Tiers.json - Categorias de Entidades

{
  "tiers": {
    "1": {
      "name": "Zumbis Básicos",
      "classnames": [
        "ZmbM_HunterOld_Autumn",
        "ZmbF_SurvivorNormal_Blue",
        "ZmbM_CitizenASkinny"
      ]
    },
    "2": {
      "name": "Zumbis Militares", 
      "classnames": [
        "ZmbM_SoldierNormal",
        "ZmbM_PatrolNormal_PautRev"
      ]
    },
    "3": {
      "name": "Vida Selvagem",
      "classnames": [
        "Animal_UrsusArctos",
        "Animal_CanisLupus_Grey"
      ]
    }
  }
}

Zones.json - Áreas de Spawn

{
  "globalSettings": {
    "systemEnabled": 1,
    "checkInterval": 15.0,
    "maxEntitiesPerZone": 20,
    "entityLifetime": 600,
    "minSpawnDistanceFromPlayer": 30.0
  },
  "zones": [
    {
      "name": "Zona_Exemplo",
      "enabled": 1,
      "position": "6560 15 2630",
      "triggerRadius": 100,
      "spawnChance": 0.75,
      "despawnOnExit": 1,
      "despawnDistance": 150,
      "respawnCooldown": 300,
      "spawnPoints": [
        {
          "position": "6555 15 2625",
          "radius": 1.5,
          "tierIds": [1, 2],
          "entities": 3,
          "useFixedHeight": 0
        }
      ]
    }
  ]
}

📋 Referência de Parâmetros

🔧 Configurações Globais

Parâmetro	Descrição	Padrão
systemEnabled	Ativa/desativa todo o sistema (1/0)	1
checkInterval	Intervalo de verificação de jogadores (segundos)	15.0
maxEntitiesPerZone	Máximo de entidades por zona	20
entityLifetime	Tempo de auto-despawn (segundos, 0=desativado)	600
minSpawnDistanceFromPlayer	Distância mínima dos jogadores ao spawnar	30.0

🗺️ Configuração de Zona

Parâmetro	Descrição	Padrão
name	Nome único da zona	-
enabled	Zona ativada/desativada (1/0)	1
position	Centro da zona "X Y Z"	-
triggerRadius	Raio de ativação ao redor do centro da zona	300.0
spawnChance	Probabilidade de spawn (0.0-1.0)	1.0
despawnOnExit	Despawn quando todos os jogadores saem da zona (1/0)	1
despawnDistance	Distância de despawn	400.0
respawnCooldown	Cooldown até o próximo spawn (segundos)	300.0

📍 Configuração de Ponto de Spawn

Parâmetro	Descrição	Padrão
position	Posição de spawn "X Y Z"	-
radius	Raio de spawn aleatório ao redor da posição	2.0
tierIds	IDs de tier disponíveis para este ponto	[]
entities	Número de entidades para spawnar aqui	1
useFixedHeight	Usar coordenada Y exata para bunkers/prédios (1/0)	0

🎯 Configuração de Tier

Parâmetro	Descrição
name	Designação do tier
classnames	Lista de classnames de entidades disponíveis

🎮 Comandos de Debug

O sistema fornece várias funções de debug via console do DayZ:

// 📊 Mostrar status do sistema
QuickStatus()
TestSpawnManagerStatus()

// 🔄 Recarregar configuração
QuickReload()
ReloadSpawnSystem()

// 🔁 Alternar sistema ligado/desligado
QuickToggle()
ToggleSpawnSystem()

// 🎯 Forçar spawn na zona mais próxima
QuickSpawn()
ForceSpawnInNearestZone()

// 🧹 Limpar todas as entidades spawnadas
QuickClear()
ClearAllSpawnedEntities()

// ℹ️ Informações gerais de debug
DebugSpawnSystem()

📈 Escalabilidade

• 🎯 Tiers: Ilimitados (apenas limitados pela memória do servidor)
• 🗺️ Zonas: Ilimitadas (desempenho depende do checkInterval)
• 📍 Pontos de Spawn: Ilimitados por zona (limitados por maxEntitiesPerZone)

Recomendado: Comece com 10-20 zonas e escale baseado no desempenho do servidor.

🚀 Vantagens

1. ⚙️ Configuração Fácil

• Nenhum conhecimento de programação necessário
• Formato JSON é fácil de entender
• Recarregamento em tempo de execução do servidor possível

2. 🚀 Performance Otimizada

• Verificações inteligentes apenas quando jogadores próximos
• Rotinas de limpeza automática
• Intervalos de verificação configuráveis

3. 🎯 Flexibilidade

• Suporta todos os tipos de entidades do DayZ (zumbis, animais, NPCs)
• Chances de spawn individuais por zona
• Diferentes combinações de tier por ponto de spawn

4. 🌍 Realismo

• Proteção de spawn previne spawns diretamente next to jogadores
• Despawn automático reduz impacto na performance
• Sistema de cooldown para tempos de respawn realistas

5. 🐛 Depuração & Manutenção

• Ferramentas abrangentes de debug
• Saída de logging detalhada
• Monitoramento de status ao vivo

🔧 Instalação

1. 📥 Instalar Mod - Coloque os arquivos do mod no seu servidor
2. 🚀 Iniciar Servidor - Sistema inicializa automaticamente
3. ⚙️ Configurar - Edite arquivos JSON em $profile:MutantSpawnSystem/
4. 🔄 Recarregar - Use QuickReload() para atualizações ao vivo

⚠️ Notas Importantes

🏢 Bunkers & Prédios

Para áreas subterrâneas ou prédios com múltiplos andares, defina "useFixedHeight": 1 para usar coordenadas Y exatas em vez da altura do terreno.

🎲 Chances de Spawn

• 0.0 = Nunca spawna
• 0.5 = 50% de chance
• 1.0 = Sempre spawna (padrão)

⚡ Ajuste de Performance

Para servidores com muitos jogadores:

• Aumente checkInterval (ex.: para 30.0)
• Reduza maxEntitiesPerZone
• Use valores menores de triggerRadius

🧟 Entidades Suportadas

Este sistema pode spawnar qualquer entidade viva no DayZ, incluindo:

• 🧟 Zumbis Vanilla: Todas as classes ZmbM_*, ZmbF_*
• 🐺 Animais Vanilla: Todas as classes Animal_*
• 🧪 Criaturas Modadas: Qualquer zumbi, mutante, animal ou NPC modado
• 👤 NPCs Customizados: Entidades tipo jogador ou IA customizada
• 🔬 Experimental: Até veículos com IA (uso avançado)

Funciona com QUALQUER mod - se está vivo e tem um classname, este sistema pode spawná-lo!

📂 Configuração de Exemplo

Baixe os arquivos de configuração completos de exemplo do repositório GitHub.

🔍 Solução de Problemas

❓ Problemas Comuns

Entidades não spawnando:

• Verifique se a zona está ativada
• Confirme as configurações de chance de spawn
• Certifique-se de que jogadores estão dentro do raio de trigger
• Verifique a saída de debug com QuickStatus()

Problemas de performance:

• Reduza checkInterval
• Diminua maxEntitiesPerZone
• Remova zonas não utilizadas
• Otimize a contagem de pontos de spawn

Problemas de spawn em bunkers:

• Sempre use "useFixedHeight": true para subterrâneos
• Teste primeiro as coordenadas exatas no jogo
• Verifique se a coordenada Y está acima do chão do bunker

📝 Créditos & Licença

Criado por: Exodus DayZ Forge
Suporte: Entre no nosso Discord para ajuda e atualizações

Este sistema é livre para uso e modificação. Se você adaptar ou redistribuir este código, por favor forneça os créditos apropriados ao criador original (MrNicerDicer).

---

Criado para DayZ 1.28 | Compatível com todos os mapas | Apenas no lado do servidor