MOD / Lua API

Tutorial de Criação de MOD e API Lua

Aprenda a criar um MOD, escrever scripts de configuração em Lua, ajustar atributos das criaturas e entender as regras de prioridade e sandbox.

1. Início Rápido

1.1 Crie uma pasta de MOD

Crie uma nova pasta dentro do diretório Mods/ do jogo. O nome da pasta será o nome do seu MOD:

Plataforma	Caminho do diretório Mods
Windows	`GameDirectory/MesozoicDawn_Data/StreamingAssets/Mods/`
Servidor Linux	`GameDirectory/MesozoicDawn_Data/StreamingAssets/Mods/`
Android	`InternalStorage/Android/data/com.../files/Mods/`
iOS	`AppSandbox/Documents/Mods/`

Mods/
└── MyFirstMod/          ← Diretório raiz do seu MOD
    ├── mod.json         ← Manifesto do MOD (recomendado)
    └── CharacterAsset/  ← Coloque os scripts Lua aqui
        └── allo.txt     ← Configuração do Alossauro

1.2 Crie mod.json (Recomendado)

{
  "Name": "MyFirstMod",
  "Author": "Seu Nome",
  "Version": "1.0",
  "SupportedVersion": "0.6.*",
  "Priority": 0,
  "Description": "Meu primeiro MOD"
}

1.3 Escreva seu primeiro script Lua

Coloque o conteúdo a seguir em CharacterAsset/allo.txt:

-- Ajusta a vida e o dano do Alossauro
CharacterAsset = {
    race    = "allo",       -- Tag da raça (deve corresponder a uma raça existente no jogo)
    health  = 30000.0,       -- Vida
    damage  = 350.0,         -- Dano base
    speed   = 30.0,          -- Velocidade de movimento (km/h)
}

1.4 Ative o MOD no jogo

Abra o jogo e acesse Gerenciamento de MOD na tela de login.
Clique em Carregar MOD para procurar MODs locais.
Encontre seu MOD e clique em Ativar.
Clique em Salvar para sair do gerenciador de MOD.
Entre em um servidor e os valores modificados entrarão em vigor imediatamente.

2. Modificação de atributos da criatura

A configuração de atributos permite ajustar os atributos das criaturas. Todos os campos compatíveis devem ser escritos na tabela CharacterAsset do script Lua. Qualquer campo omitido manterá o valor original do jogo.

Configurações básicas e de categoria

Campo	Descrição
`race`	Obrigatório. A tag da raça que você deseja modificar.
`name`	Nome exibido da criatura.
`volume`	Classificação de tamanho da criatura de 0 a 5.
`habit`	Tipo de hábito de 0 a 5 (0 = terrestre, 1 = hidrofílico, 3 = aquático...).
`type`	Categoria da criatura de 0 a 5 (0 = carnívoro, 1 = herbívoro...).

Atributos de sobrevivência e combate

Campo	Descrição
`health`	Limite máximo de vida.
`stamina`	Reserva máxima de stamina. Quando vazia, corrida e ataques pesados ficam indisponíveis.
`hunger` / `water`	Reservas máximas de fome e água.
`attack` / `defend`	Dano base causado e defesa básica do torso.
`pen` / `ten`	Nível de penetração de ataque e nível de tenacidade defensiva.

3. Habilidades e modificações de hitbox

3.1 Modelo de configuração de habilidade

CharacterSkill = {
    bite = {
        Race        = "allo",   -- Tag de raça obrigatória
        AttackName  = "Mordida",   -- Nome do ataque
        AttackOrder = 1,         -- Índice de ordem do ataque
        AttackType  = 0,         -- 0 = boca, 1 = cauda, 2 = pisoteio
        DamageMode  = 0,         -- 0 = alvo único, 1 = AOE
        AttackRange = 1.5,       -- Raio de colisão (metros)
        Modify      = 1.5,       -- Multiplicador de dano
    }
}

3.2 Substituição de hitbox

Use CharacterHitGroup para alterar a vulnerabilidade da cabeça do Alossauro:

CharacterHitGroup = {
    head = {
        Race              = "allo",
        PartType          = 0,     -- 0 = cabeça
        PenetrationRate   = 0.6,   -- Multiplicador de penetração de armadura
        DamageMultiplier  = 1.5,   -- Multiplicador de dano recebido
    }
}

4. Avançado: ambiente e gerenciamento

Mecanismo de prioridade

Quando vários MODs modificam o mesmo campo da mesma raça, um valor maior de Priority é executado depois e, portanto, prevalece. O valor padrão é 0.

Segurança do sandbox Lua

os, io: comandos de sistema e E/S de arquivos são bloqueados.
dofile, package: executar arquivos locais arbitrários ou bibliotecas dinâmicas externas é bloqueado.

Gerenciamento do servidor

Administradores podem usar /modReload para recarregar valores numéricos, habilidades e configurações de skins a partir dos arquivos atuais do MOD. Adicionar novas raças ainda exige reiniciar.