MOD / Lua API

Tutorial de creación de MOD y API Lua

Aprende a crear un MOD, escribir scripts de configuración en Lua, ajustar los atributos de las criaturas y entender las reglas de prioridad y sandbox.

1. Inicio rápido

1.1 Crea una carpeta para el MOD

Crea una nueva carpeta dentro del directorio Mods/ del juego. El nombre de la carpeta será el nombre de tu MOD:

Plataforma	Ruta del directorio 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/          ← Directorio raíz de tu MOD
    ├── mod.json         ← Manifiesto del MOD (recomendado)
    └── CharacterAsset/  ← Coloca aquí los scripts Lua
        └── allo.txt     ← Configuración del Alosaurio

1.2 Crea mod.json (recomendado)

{
  "Name": "MyFirstMod",
  "Author": "Tu nombre",
  "Version": "1.0",
  "SupportedVersion": "0.6.*",
  "Priority": 0,
  "Description": "Mi primer MOD"
}

1.3 Escribe tu primer script Lua

Coloca el siguiente contenido en CharacterAsset/allo.txt:

-- Ajusta la salud y el daño del Alosaurio
CharacterAsset = {
    race    = "allo",       -- Etiqueta de raza (debe coincidir con una raza existente en el juego)
    health  = 30000.0,       -- Salud
    damage  = 350.0,         -- Daño base
    speed   = 30.0,          -- Velocidad de movimiento (km/h)
}

1.4 Activa el MOD en el juego

Inicia el juego y abre Gestión de MOD desde la pantalla de inicio de sesión.
Haz clic en Cargar MOD para buscar MODs locales.
Encuentra tu MOD y haz clic en Activar.
Haz clic en Guardar para salir del gestor de MOD.
Entra en un servidor y los valores modificados se aplicarán de inmediato.

2. Modificación de atributos de la criatura

La configuración de atributos permite ajustar los parámetros de las criaturas. Todos los campos compatibles deben escribirse dentro de la tabla CharacterAsset del script Lua. Cualquier campo omitido conservará el valor original del juego.

Configuración básica y de categoría

Campo	Descripción
`race`	Obligatorio. La etiqueta de raza que deseas modificar.
`name`	El nombre mostrado de la criatura.
`volume`	Clasificación del tamaño de la criatura de 0 a 5.
`habit`	Tipo de hábito de 0 a 5 (0 = terrestre, 1 = hidrófilo, 3 = acuático...).
`type`	Categoría de criatura de 0 a 5 (0 = carnívoro, 1 = herbívoro...).

Atributos de supervivencia y combate

Campo	Descripción
`health`	Límite máximo de salud.
`stamina`	Reserva máxima de stamina. Cuando se vacía, correr y los ataques pesados dejan de estar disponibles.
`hunger` / `water`	Reservas máximas de hambre y agua.
`attack` / `defend`	Daño base causado y defensa base del torso.
`pen` / `ten`	Nivel de penetración del ataque y nivel de tenacidad defensiva.

3. Modificaciones de habilidades y hitbox

3.1 Plantilla de configuración de habilidad

CharacterSkill = {
    bite = {
        Race        = "allo",   -- Etiqueta de raza obligatoria
        AttackName  = "Mordida",   -- Nombre del ataque
        AttackOrder = 1,         -- Índice de orden del ataque
        AttackType  = 0,         -- 0 = boca, 1 = cola, 2 = pisotón
        DamageMode  = 0,         -- 0 = objetivo único, 1 = AOE
        AttackRange = 1.5,       -- Radio de colisión (metros)
        Modify      = 1.5,       -- Multiplicador de daño
    }
}

3.2 Reemplazo de hitbox

Usa CharacterHitGroup para cambiar la vulnerabilidad de la cabeza del Alosaurio:

CharacterHitGroup = {
    head = {
        Race              = "allo",
        PartType          = 0,     -- 0 = cabeza
        PenetrationRate   = 0.6,   -- Multiplicador de penetración de armadura
        DamageMultiplier  = 1.5,   -- Multiplicador de daño recibido
    }
}

4. Avanzado: entorno y administración

Mecanismo de prioridad

Cuando varios MOD modifican el mismo campo de la misma raza, un valor mayor de Priority se ejecuta más tarde y por tanto prevalece. El valor predeterminado es 0.

Seguridad del sandbox de Lua

os, io: los comandos del sistema y la E/S de archivos están bloqueados.
dofile, package: la ejecución de archivos locales arbitrarios o bibliotecas dinámicas externas está bloqueada.

Administración del servidor

Los administradores pueden usar /modReload para recargar valores numéricos, habilidades y configuración de skins desde los archivos actuales del MOD. Agregar nuevas razas sigue requiriendo reiniciar.