Modding

Dónde está la carpeta de mods

Abre Mods desde el menú principal. La ruta está escrita en la parte superior de la pantalla, con un botón al lado que abre la carpeta en tu administrador de archivos.

Está al lado de tus partidas guardadas, y es la misma carpeta ya sea que estés instalando el mod de otra persona o escribiendo el tuyo propio. No se lee nada mientras el juego se está ejecutando, por lo que no importa si el juego está abierto mientras mueves archivos.

Instalar un mod

A es una carpeta con mod.json en la parte superior. La mayoría de las descargas se encuentran en esa carpeta dentro de un zip.

Un mod que copias permanece desactivado hasta que tú lo dices. El juego rechaza ejecutables sin lugar a dudas, pero un paquete de datos aún puede cambiar precios, artículos y personas de formas que no solicitaste, y uno que aparece solo dentro de un juego que ya se está ejecutando es un problema que nadie quiere diagnosticar. Entonces el juego pregunta. Es un reinicio adicional la primera vez y nunca más para ese paquete.

No hay iniciador, no hay ningún archivo de orden de carga para editar y no hay nada que grabar. El orden de carga es un número dentro de cada paquete, elegido por su autor.

Empieza una partida nueva para un paquete que añada personas, lugares o misiones. Una partida guardada que ya está en curso conserva el mundo con el que fue creada. Los paquetes que solo cambian números, imágenes o color se ven en una partida ya iniciada. Los archivos de audio y fuentes se validan, pero ninguna superficie de paquete en ejecución los consume todavía.

¿Se ha cargado?

Mod, en el menú principal. Cada paquete encontrado va en una línea, con un estado de una palabra: cargado, deshabilitado, no válido, en conflicto, requiere otra modificación, ignorado.

Un mod también puede apagarse solo y dice por qué. El interruptor que colocas se aplica al paquete en el que lo colocas, no a su nombre en la carpeta. Los mods son elegidos por los autores y no hay nada que los coordine, por lo que dos mods no relacionados, ambos llamados northern_reach, son un accidente común y sin esto, el segundo heredaría el cambio del primero. Si el mod bajo una identificación no es el que había activado, la línea lo dice: este no es el mod que activó. Actualizar un mod existente preserva su cambio; borrarlo y copiar otro no.

Si eres el autor de un mod y ves esa línea en tu paquete, tienes una colisión de identificación con el mod de otra persona. Elija una identificación menos obvia.

Dos de esas palabras se refieren a un reinicio que usted debe, no al paquete. Activo: reiniciar para cargar significa que lo activaste y nadie lo ha leído todavía; Desactivado: reiniciar para descargar significa lo contrario y su contenido seguirá en el juego hasta que reinicies. Son palabras separadas a propósito: una pantalla que dice "Cargado" en el momento en que accionas un interruptor te enviaría a buscar en el mundo algo que aún no está ahí.

Cuando el estado no está "cargado", la línea siguiente te indica por qué, en el idioma en el que estás jugando y sin identificadores, no escribiste: qué archivo el juego se niega a ejecutar, qué paquete falta, qué versión quiere. A continuación, lo que hizo el contenido del paquete: cuántas entradas ingresaron, cuántas fueron rechazadas. Mostrar detalles abre el resto, es decir, los identificadores y la regla exacta que rompió cada récord rechazado.

Dos líneas comparten una palabra a propósito: Requiere otro mod Es el mismo problema para un jugador, ya sea que falte el paquete que necesita o tenga la versión incorrecta, y la línea a continuación dice cuál. Y cuando dos paquetes reclaman el mismo registro, el que tiene el load_order más alto escribe el último y gana, pero una adquisición que nadie declaró es un error, no una nota. Se informan ambas líneas, y la línea del perdedor nombra al ganador, y el ganador aún se calcula en lugar de dejarse al azar: un rechazo no tiene por qué ser también un lanzamiento de moneda. Cuando dos mods quieren lo mismo explica cómo declarar uno a propósito.

"Subido" todavía no significa que puedas verlo en el mundo. Para eso, lee los conteos debajo de la línea y Ahora encuéntralo en el juego te indica dónde aparece cada tipo de cosa.

Los recuentos siempre suman. Se aplican camas, se rechazan más, se reemplazan más por otro mod, se esperan más sus propias condiciones, y las dos últimas son nominadas en lugar de quedarse en un vacío. Un registro que otro paquete escribe en último lugar no se rechaza, porque no tiene nada de malo, y ni siquiera se aplica, porque eso no es lo que guardó el juego. Es la diferencia entre leer una línea y pasar una tarde buscando un error en un archivo que no tiene ninguno. Mostrar detalles indica qué registro y qué paquete lo tiene ahora.

Un número está al lado de esa suma en lugar de dentro: archivos que nadie ha leído. Un archivo cuya familia no está en content_types nunca se ha abierto, por lo que no hay ningún registro para contar y no hay forma de saber cuántos hay en él. Es un recuento de archivos, no de registros, y es exactamente por eso que no puede ser un sexto término: la suma comienza desde leer, y estos nunca han sido leídos.

Antes de pedir ayuda a alguien

Abra Mod y presione Copiar informe. Pega todo en tu mensaje y luego di lo que esperabas.

Texto simple, listo para un foro, un mensaje de Discord o un informe de error: la compilación en la que estás, la carpeta de mods, cada paquete con su versión, su orden de carga y estado, el motivo de cada rechazo, los recuentos para cada tipo de contenido y qué paquete ganó cada batalla.

the report the Mods screen copies

Bonemark mod report
game build: 0.0.0-dev
mods folder: C:/Users/you/AppData/Roaming/Godot/app_userdata/Bonemark/mods
packages: 2 found, 1 loaded

PACKAGES
  northern_reach  v0.1.0  order 100  active
    goods: 12 read, 12 applied, 0 rejected
  winter_roads  unreadable manifest
    - game_version must not be empty

CONTENT (1 families: 12 read, 12 applied, 0 rejected)
  goods: 12 read, 12 applied, 0 rejected

Nueve de cada diez veces la respuesta está en el bloque y nadie tiene que hacerte una sola pregunta primero. No lee nada fuera de la carpeta de mods, no cambia nada y no contiene información personal.

Está en inglés incluso cuando juegas en otro idioma. Esto es intencional: es posible que la persona que lo ayuda no lea el suyo, y todos los datos que contiene (identificaciones, versiones, recuentos) siguen siendo los mismos en todos los idiomas.

quitar uno

Elimina su carpeta y reinicia. La desinstalación está toda aquí.

Nada tuyo se elimina junto con él. Un guardado mantiene los identificadores que ya no puede resolver, los marca y devuelve cosas si se reinstala el paquete. Una sesión que no puede entender una partida guardada ni siquiera la sobrescribe: el archivo original permanece exactamente como estaba y es la diferencia entre una tarde perdida y un juego perdido. Guardados es el informe completo.

Si el juego deja de ejecutarse después de instalar algo, la salida no necesita el juego. Abre la carpeta de mods y quita lo último que agregaste. Los paquetes solo se pueden leer desde esa carpeta, por lo que una carpeta que no está ahí es un paquete que no se puede cargar y el siguiente arranque es el mismo que antes. No necesita un menú que funcione, una consola o un inicio para hacer esto.

Incluso el juego lo intenta por sí solo: Si el juego no comienza es un número limitado de intentos y luego regresa sin ningún paquete cargado, pero ese es el cinturón, y mover la carpeta son los tirantes.

Lo que puedes construir hoy

Ahora, sin pedir permiso a nadie: bienes y comerciantes, objetos, personas y sus posiciones, edificios y sus servicios, lugares del mapa, conversaciones, escenas, planes de misión, mapas dibujados en Tiled, imágenes y color, y todas sus palabras en siete idiomas. Los archivos de audio y fuentes se comprueban y se leen, pero sus superficies de paquete todavía no los consumen; la tabla de estados lo dice claramente en vez de llamarlos listos. Todas las familias son la lista medida, y su estado sale de la compilación, no de una promesa.

Todavía no, y Lo que aún no puedes hacer explica cada caso: la familia quests, audio de paquete, fuentes de paquete, conversiones totales empaquetadas y un paquete que sea una función en lugar de contenido.

Nunca, debido a la elección del proyecto: código. Sin scripts, sin escenas, sin archivos de recursos, nada para que se ejecute el juego. Esto es lo que hace que sea seguro descargar el mod de un extraño, y no es una fase por la que esté pasando el proyecto. Lo que un mod nunca puede hacer.

Tiempo para lo primero que puedes ver en el juego: Aproximadamente diez minutos, la mayor parte dedicados a buscar la carpeta. Un mod en diez minutos está completo y la espada al final es real.

Lo que no puedes hacer todavía y por qué

Está escrito aquí, cerca del principio, en vez de dejarlo para descubrirlo al final. Esto es lo que la compilación valida sin ponerlo todavía en una superficie de paquete para el jugador, además de lo que no es contenido de paquete.

Una mecánica que el juego nunca ha tenido es la cuarta fila con otro sombrero. La espada que golpea más fuerte es un número y es tuya; un arma que dispara un rayo necesita las reglas del rayo, y las reglas son códigos que alguien escribe y prueba.

¿Qué es un mod?

Una carpeta de archivos de texto. No escribes código. Escribes listas de cosas que quieres en el juego y el juego las lee cuando comienza.

La única regla de la que se sigue todo lo demás: puedes agregar y cambiar datos. No puedes hacer que el juego ejecute código. Eso es lo que hace que descargar un mod sea seguro: lo peor que puede hacer un mod de un extraño es ponerte una espada tonta.

34 familias están listas para usar hoy, entre ellas items, buildings, pois, npc_definitions, vendor_inventories, quest_plans, caravans y perks. Todas las familias forman la tabla completa con lo que hace cada una; Las familias, una por una ofrece sus campos y un registro para copiar.

Elige tu camino

Esta es la tabla de contenidos de toda la guía, donde se escribe cada tema, ya sea que lo estés desarrollando hoy o no. En la parte superior de la Parte 3 hay un segundo índice más corto: son los seis tutoriales, en el orden en que se complementan entre sí. Si estás aquí para hacer algo y no para buscar algo, ve directamente allí.

O lo que tienes en mente. Esta guía está organizada en el orden en que se realiza el trabajo (manifiesto, luego validación, luego contenido, luego informe), que es el orden que elegiría alguien que ya conoce el sistema. Los que no lo conocen están pensando quiero agregar un comerciante, y buscan la palabra comerciante:

Qué necesitas

Un editor que colorea JSON te muestra una coma faltante mientras todavía lo estás mirando, en lugar de que el juego te diga más tarde que el archivo era ilegible.

Python y la consola son opcionales. El juego basta: coloca el paquete, reinicia y abre Mods, que indica cada registro rechazado y el motivo. El checkout para autores es público. Quien quiera iterar más rápido o automatizar publicaciones puede clonar el checkout público de Bonemark y ejecutar las herramientas sin conexión en Herramientas sin conexión; los jugadores que instalan un paquete publicado no necesitan Python ni Godot. Ese mismo checkout público contiene el validador y las declaraciones del runtime, por lo que ambas secciones describen una sola cadena de herramientas. Las herramientas usan las mismas declaraciones que el juego — los esquemas de registros y el límite de seguridad tienen una única fuente —, así que responden antes, nunca de otra forma. Una consola de depuración ayuda a inspeccionar un paquete cargado, pero no hace falta para escribir uno.

Comienza con lo que quieres hacer

Todo lo que está debajo de esta línea está organizado en el orden en que se realiza el trabajo: cartel, luego archivos, luego familias, luego informes. Es el orden correcto para buscar algo y el orden incorrecto para empezar, porque nadie empieza con un manifiesto. Comienza con Quiero un comerciante.

Luego: elige la frase que se parezca a lo que estás intentando hacer.

Los seis tutoriales son un solo paquete, construido pieza por pieza: una vela de cera de abejas, el paquete que el jugador lleva consigo, el fabricante de cera que lo vende, la puerta de su tienda, el hoyo detrás de la curtiduría de donde proviene el sebo y, finalmente, una modificación de la vela que ya tenía el juego. Hazlos en orden y termina con un mod que alguien podría descargar. Consiga uno en el medio y funcionará por sí solo.

¿Dónde están los números del juego?

Cada tutorial aquí valora algo nuevo comparándolo con algo que el juego ya vende, porque un número sin nada al lado es una suposición, y una suposición en una economía que comercia entre ciudades no permanece donde la pones.

No puedes abrir los archivos del juego. Sus registros son activos de Godot dentro de la compilación empaquetada: un formato diferente al JSON que escribes, con category = 1 donde tu archivo dice "MANUFACTURED". No hay ninguna carpeta desde la que copiar y descomprimir una no es un flujo de trabajo que nadie deba documentar.

No lo necesitas. El catálogo publica el contenido del juego, generado a partir de esos mismos registros en cada compilación: 270 elementos con su categoría, peso, valor de la moneda y tamaño de la pila, 49 armas, 42 piezas de armadura, 37 ubicaciones. Es la referencia a la que está anclada esta guía, no puede apartarse del juego y el nombre del campo está impreso al lado de cada línea.

Una docena de valores que debes conocer antes de ponerle precio a algo:

Si tu nuevo objeto cuesta más que una armadura de placas, algo salió mal y el juego no te lo dirá: silenciosamente se convertirá en el cargamento más rentable del mundo y cada caravana lo transportará.

Una mercancía para vender

Tendrás un producto al que la economía sabe cómo ponerle precio, vinculado a la vela que el juego ya vende, listo para que un comerciante lo tenga.

Captura de pantalla: Aún no tomada. Este espacio permanece vacío hasta que haya uno real: un dibujo de cómo podría verse sería lo único de la página que no sea real.

Lea primero: Qué es un mod · Un mod en diez minutos · Nombres e ids

Copia de: la carpeta llamada chandlery, que ya está en tu carpeta de mods. El juego lo coloca ahí la primera vez que se inicia, lo apaga y es el resultado final de estos seis tutoriales: cada registro a continuación está ahí. También es el paquete que la línea de prueba del repositorio hace girar contra el cargador, por lo que no hay ningún registro aquí que el juego rechazaría. Actívelo para verlo funcionar, o copie la carpeta, cámbiele el nombre y hágala suya.

Dónde van los archivos:

where the files go

mods
└ chandlery
  ├ mod.json
  └ content
    └ economy
      └ goods
        └ goods.json

Empieza con la vela que ya tiene el juego. Se llama candle, cuesta 3, pesa 0.5, es MANUFACTURED y PRESERVED, y está hecha por el boticario. El tuyo es lo mismo hecho con cera mejor, así que guarda todas esas respuestas y cambia dos.

Antes de mod.json:

mod.json

{
  "id": "chandlery",
  "name": "The Chandlery",
  "version": "0.1.0",
  "game_version": "0.0.0-dev",
  "dependencies": [],
  "load_order": 100,
  "content_types": ["goods"],
  "overrides": [],
  "canon_safe": true
}

Entonces content/economy/goods/goods.json:

a goods record

[
  {
    "id": "chandlery:beeswax_candle",
    "display_name": "Beeswax Candle",
    "category": "MANUFACTURED",
    "decay_tier": "PRESERVED",
    "base_price": 9,
    "weight": 0.4,
    "production_class": "chandler",
    "daily_consumption_class": "household",
    "tags": ["light", "household"]
  }
]

Listo, ahora encuéntralo en el juego. Reinicia, abre Mod y la línea debajo de la tuya dice 1 entry added. Es todo lo que hace una mercancía por sí sola: tiene un precio, es comercializable y no está en el mostrador de nadie, porque nadie lo tiene todavía. No es un fracaso y es lo que confunde a todos alguna vez. Continúe con Un comerciante que lo almacena.

Si no se muestra: No apareció nada tiene los seis motivos en orden. El más común, con diferencia, es content_types: una familia que falta en esa línea significa que la carpeta nunca se abre, independientemente de lo que contenga. Luego Antes de pedir ayuda a alguien, que es un solo botón.

Un objeto para llevar

Tendrás lo que un jugador recoge, apila en su mochila y revende, junto con la mercancía que acabas de escribir.

Captura de pantalla: Aún no tomada.

Lea primero: Un bien para vender · Nombres e identificadores

Copiar de: chandlery/content/inventory/items/items.json a tu carpeta de mods.

Dónde van los archivos:

where the files go

mods
└ chandlery
  ├ mod.json
  └ content
    ├ economy
    │ └ goods
    │   └ goods.json
    └ inventory
      └ items
        └ items.json

Una mercancía y un objeto son dos mitades de una misma cosa. La mercancía es el punto de vista de la economía: qué produce una ciudad, qué transporta una caravana, cuánto vale. El objeto es el punto de vista del jugador: qué cabe en la mochila, qué se apila, qué se exhibe en una tienda. El trigo tiene una mercancía y no un objeto, porque nadie lleva consigo un saco de trigo. Las velas tienen ambos.

Agregue "items" a content_types en mod.json, luego escriba content/inventory/items/items.json:

a items record

[
  {
    "id": "chandlery:beeswax_candle_bundle",
    "display_name": "Bundle of Beeswax Candles",
    "category": "MATERIAL",
    "rarity": "COMMON",
    "weight": 0.4,
    "max_stack": 20,
    "base_value": 10,
    "sellable": true,
    "tags": ["light", "household"]
  }
]

Listo, ahora encuéntralo en el juego. Un elemento que nadie entrega se carga y se puede acceder a él desde la nada. En una compilación de depuración, item chandlery:beeswax_candle_bundle coloca uno en tu mochila de inmediato y es la prueba más rápida de que está cargado, pero ese comando no existe en el juego que la gente descarga, por lo que es un atajo para ti y nunca la respuesta para un jugador. La verdadera respuesta es el siguiente tutorial.

Si no se muestra: No apareció nada, entonces [Antes de pedir ayuda a alguien](#antes de-pedir ayuda a alguien).

Un comerciante que lo posee

Tendrás una mujer con un nombre parada en Old Seat con un mostrador, suministros que se reponen cada dos días y tus velas en el mostrador.

Captura de pantalla: Aún no tomada.

Lee primero: Un artículo para llevar · Ahora encuéntralo en el juego

Copia de: chandlery/content/narrative/npcs/npcs.json y chandlery/content/world/vendor_inventories/vendors.json.

Dónde van los archivos:

where the files go

mods
└ chandlery
  ├ mod.json
  └ content
    ├ economy
    │ └ goods
    ├ inventory
    │ └ items
    ├ narrative
    │ └ npcs
    │   └ npcs.json
    └ world
      └ vendor_inventories
        └ vendors.json

Este es aquel en el que dos familias tienen que ponerse de acuerdo. La persona lleva la identificación del banco, el banco lleva la identificación de la persona y cada fila del banco lleva la identificación de un objeto. Tres identificadores, y cada uno debe escribirse exactamente como lo escribió en el otro archivo. Es el error que cuesta una noche, y la pantalla Mods lo nombra: una línea que apunta a una identificación que nadie proporciona aparece como requiere otro mod que no está instalado.

Agregue "npc_definitions" y "vendor_inventories" a content_types.

a npc_definitions record

[
  {
    "id": "chandlery:hesta",
    "display_name": "Hesta the Chandler",
    "title": "Candle Seller",
    "short_bio": "She renders fat behind the tannery and sells what burns longest.",
    "voice_tone": "brisk",
    "faction": "NONE",
    "role": "NONE",
    "settlement_id": "old_seat",
    "is_vendor": true,
    "vendor_inventory_id": "chandlery:candle_stall",
    "price_multiplier": 1.0,
    "personality_tags": ["brisk", "practical"],
    "offers_quest_ids": []
  }
]

a vendor_inventories record

[
  {
    "id": "chandlery:candle_stall",
    "display_name": "Chandler's Stall",
    "npc_id": "chandlery:hesta",
    "global_price_multiplier": 1.0,
    "buyback_rate": 0.35,
    "entries": [
      {
        "item_id": "chandlery:beeswax_candle_bundle",
        "kind": "misc",
        "daily_stock": 6,
        "price_multiplier": 1.0,
        "restock_days": 2,
        "min_standing": 0
      }
    ]
  }
]

Listo, ahora encuéntralo en el juego. Reinicia, viaja a Old Seat, encuentra a Hesta, abre la pantalla de intercambio. Si el banco está vacío, aún no se ha repuesto: eso es restock_days, no es un error. La cadena se puede romper de tres maneras y las tres están en la pantalla Mod: los bienes que nadie tiene, el contador que apunta a una identificación de artículo que no existe, la persona que señala una identificación de contador que no existe.

Ella también puede hablar. Una dialogue_graph cuyo speaker es su identificación hace bromas cuando un jugador hace clic en ellas, y tu paquete no tiene que redefinir nada que el juego ya tenga para obtenerlas; consulta Tus conversaciones. Un archivo locales te ofrece todo esto en siete idiomas.

Si no aparece nada: primero verifique los tres identificadores entre sí, luego No apareció nada, luego [Antes de pedir ayuda a alguien](#antes de-pedir ayuda a alguien).

El servicio de un edificio.

Tendrás una puerta en un asentamiento con tu etiqueta y color, que se abre a un interior que el juego ya tiene.

Captura de pantalla: Aún no tomada.

Lea primero: Un comerciante que lo guarda · [Lo que un mod nunca puede hacer](#lo-que-un mod-nunca-puede-hacer)

Copia de: chandlery/content/world/buildings/buildings.json.

Dónde van los archivos:

where the files go

mods
└ chandlery
  └ content
    └ world
      └ buildings
        └ buildings.json

Estás recombinando, no construyendo. Un registro buildings agrega un nuevo servicio con una etiqueta, color de puerto y función de rutina, y puede reutilizar una extensión que el juego ya tiene al nombrarla. No se puede traer una extensión. Una extensión es una escena, una escena es código y un paquete que nombra una ruta res:// o .tscn se rechaza incluso antes de que se lea este registro. No es un vacío esperando a ser llenado: es la línea que hace que sea seguro instalar el mod de un extraño.

a buildings record

[
  {
    "id": "chandlery:chandlery",
    "label": "Chandlery",
    "role": "merchant",
    "color": { "r": 0.44, "g": 0.38, "b": 0.24 },
    "interior_service": "shop"
  }
]

Listo, ahora encuéntralo en el juego. Reinicia e ingresa un acuerdo que tenga tu servicio. Un registro sin settlement se carga y no se coloca en ninguna parte, lo cual es idéntico a un registro fallido: la pantalla Mod dirá 1 entry added y no encontrará nada. Lea la línea antes de buscar la puerta.

Si no aparece: No apareció nada · Antes de pedir ayuda a alguien.

Un lugar en el mapa

Tendrás un lugar en el mapa mundial con el que un jugador puede tropezar, con una descripción del mismo y su efecto en el estado de ánimo del grupo.

Captura de pantalla: Aún no tomada.

Lea primero: El servicio de construcción · Ahora encuéntrelo en el juego

Copia de: chandlery/content/world/pois/pois.json.

Dónde van los archivos:

where the files go

mods
└ chandlery
  └ content
    └ world
      └ pois
        └ pois.json

Las coordenadas son absolutas y el mundo se genera alrededor de lugares creados por los autores. El mapa mide 61 440 × 34 560 píxeles del mundo y Old Seat está exactamente en el centro, (30720, 17280), en todas las partidas. Las ciudades y aldeas creadas por los autores conservan sus nombres y posiciones. La seed cambia el terreno y los biomas a su alrededor, la escasez del año, la organización política y qué caminos merecen la pena. Así, un punto sigue siendo real y estable; lo que queda al lado cambia en cada partida. Dos formas honestas de usarlo: anclar un punto de interés cerca de un asentamiento creado por los autores, para que el jugador pase por allí; o elegir el vacío, porque un foso de renderizado que nadie ha visitado en años debe estar en ninguna parte en particular.

a pois record

[
  {
    "id": "chandlery:tallow_pit",
    "kind": "RUINS",
    "display_name": "The Tallow Pit",
    "description": "A rendering pit behind the tannery. The smell reaches the road.",
    "world_position": { "x": 5400.0, "y": 3000.0 },
    "discovery_radius": 2.0,
    "one_time_loot": false,
    "morale_modifier": -1,
    "awareness_modifier": 0.0
  }
]

Listo, ahora encuéntralo en el juego. Adelante. No hay un comando de teletransporte, ni en una versión de depuración ni en el exterior, así que elige las coordenadas hasta donde estés dispuesto a caminar mientras lo intentas.

Si no aparece: Probablemente te hayas quedado sin discovery_radius, o la ubicación está en algún lugar donde la semilla coincidente puso un océano. No apareció nada.

Cambiando lo que ya está ahí

Habrás cambiado un registro que el juego trajo consigo y lo habrás declarado, de modo que el cambio sea visible para el jugador y todos los demás mods.

Captura de pantalla: Aún no tomada.

Lee primero: Cambiar lo que ya tiene el juego · Cuando dos mods quieren lo mismo

Copia de: chandlery/content/economy/goods/goods.json, que agrega un registro y corrige uno del juego en el mismo archivo.

Adónde van los archivos: Ningún lugar nuevo. Un cambio en algo que el juego ya tiene se encuentra en la misma carpeta familiar en la que se encuentran tus registros: el archivo dice qué registro pretende y qué le está haciendo.

where the files go

mods
└ chandlery
  ├ mod.json          the change is declared here
  └ content
    └ economy
      └ goods
        └ goods.json  your record and the patch, in one file

Dos reglas antes del archivo. Un cambio en el registro de otra persona debe nombrarse en overrides dentro de mod.json; un registro que llega a una identificación que no declaraste se rechaza, por lo que nada puede reescribir de manera encubierta algo que el jugador no aceptó. Y patch, que cambia un campo y deja el resto solo, requiere "manifest_version": 2.

mod.json

{
  "id": "chandlery",
  "name": "The Chandlery",
  "version": "0.1.0",
  "game_version": "0.0.0-dev",
  "manifest_version": 2,
  "load_order": 100,
  "content_types": ["goods", "items", "npc_definitions", "vendor_inventories", "buildings", "pois"],
  "overrides": ["candle"],
  "canon_safe": true
}

a goods record

[
  {
    "op": "patch",
    "id": "candle",
    "changes": [
      { "op": "set", "field": "base_price", "value": 4 },
      { "op": "append_unique", "field": "tags", "value": "chandlery_touched" }
    ]
  }
]

Listo, ahora encuéntralo en el juego. La pantalla Mod nombra el registro que has adquirido. La pantalla del otro autor también hace esto, si lo hay: cuando dos paquetes escriben la misma identificación, la línea del perdedor ahora dice reemplazado: vela — 'chandlery' lo escribe al final, en lugar de mostrar silenciosamente una entrada menos de la que escribió. Quien tenga el load_order más alto escribe el último y gana.

Ganar no es lo mismo que tener permiso. Dos paquetes tomando un registro sin nombrar al otro en supersedes se reportan como undeclared_collision y la composición no está bien: el validador fuera de línea dice lo mismo y rechaza:

typed into the debug console

ERROR: conflict on goods:candle: ['early', 'late'] each supply the whole record
and none declares the others under `supersedes`

El ganador todavía está calculado, porque un rechazo no tiene por qué ser también un lanzamiento de moneda, sino que dos autores que lo deseaban tienen que decirlo. Cuando dos mods quieren lo mismo es esa conversación.

Si no aparece: la causa habitual es overrides — el id debe estar en esa lista, escrito exactamente, de lo contrario el registro se rechaza en lugar de aplicarse. Cuando dos mods quieren lo mismo · [No apareció nada](#no apareció nada).

Un mod en diez minutos

1. Crea una carpeta en tu carpeta de mods, con el nombre en minúsculas y guiones bajos: northern_reach. Todo sucede ahí dentro.

2. Escribe mod.json en la parte superior:

mod.json

{
  "id": "northern_reach",
  "name": "The Northern Reach",
  "version": "0.1.0",
  "game_version": "0.0.0-dev",
  "dependencies": [],
  "load_order": 100,
  "content_types": ["items"],
  "overrides": [],
  "canon_safe": true
}

id debe coincidir con el nombre de la carpeta. content_types enumera las familias que traes: una familia que falta en esa línea nunca se lee, sin importar lo que haya en la carpeta.

3. Crea las carpetas content/inventory/items y pon blades.json dentro:

a items record

[
  {
    "id": "northern_reach:frost_blade",
    "display_name_key": "northern_reach.item.frost_blade.name",
    "display_name": "Frost Blade",
    "category": "weapon",
    "base_value": 240,
    "weight": 3
  }
]

Los corchetes son una lista: agrega tantas espadas como quieras, separadas por comas. Se lee cada archivo .json en una carpeta familiar, así que divídalos como desee.

240 no es un número elegido para impresionar. En este juego, las armas de una mano varían de 50 a 300, por lo que una espada helada a 240 es una espada cara y no una espada legendaria, y un jugador puede permitírsela en el momento en que pueda permitirse las buenas que el herrero ya vende. Dónde están los números del juego es la tabla que hay que mirar antes de elegir cualquier número; un precio sin nada al lado es una hipótesis, y en una economía que comercia entre ciudades una hipótesis no permanece donde la pones.

4. Inicia el juego y abre Mods desde el menú principal. Su paquete obtiene exactamente un estado y ¿Se cargó? tiene los seis.

5. Lea la línea a continuación para saber qué se ha leído, aplicado y rechazado, con el motivo de cada rechazo. Mostrar detalles tiene identificadores.

6. Tu espada está en el juego. Todo lo que viene después es más de lo mismo.

Ahora encuéntralo en el juego.

El informe dice applied. Significa que el disco está cargado, y eso no es lo mismo que poder caminar delante de él. Aquí es donde toda guía se detiene y todo autor comienza a adivinar.

settlement_id nombra un lugar creado por los autores. Los ids de asentamiento son creados por los autores y estables: Durnwall, Thorngate, Valdmere, Grentham y las doce aldeas pueden recibir nombre. La seed cambia el terreno y los biomas a su alrededor, la escasez del año y la organización política, no el id. Si quieres que alguien encuentre sin falta a una persona, usa cualquier id de asentamiento creado por los autores y conserva su nombre en los datos de idioma de tu paquete.

Las coordenadas son absolutas y el mundo se genera alrededor de lugares creados por los autores. El mapa mide 61 440 × 34 560 píxeles del mundo y Old Seat está exactamente en el centro, (30720, 17280), en todas las partidas. Las ciudades y aldeas creadas por los autores conservan sus nombres y posiciones. La seed cambia el terreno y los biomas a su alrededor, la escasez del año, la organización política y qué caminos merecen la pena. Por eso una world_position de (6000, 2200) es un punto real y estable en el noroeste lejano del mapa, mientras que lo que queda cerca cambia en cada partida: puede ser un camino, un bosque o la nada. Dos formas honestas de usarlo:

• Aún en el centro. Un punto de interés a unos miles de píxeles de (30720, 17280) está cerca del asiento antiguo en cada juego, por lo que es un lugar que un jugador encontrará.
• Te refieres al vacío. Una ruina por la que nadie ha pasado durante cien años debe estar en cualquier lugar. Las coordenadas absolutas son exactamente las correctas para esto y la semilla decidirá qué vecinos tendrá.

Los comandos de consola que más tiempo ahorran. day [n] y hour [n] avanzan el tiempo, que es como ves un suministro sin experimentarlo. item <id> [count] y gold <amount> ponen las cosas en tus manos. flag, quest_start y faction_rep mueven el estado que una condición podría estar esperando. No existe un comando de teletransportación: para llegar a un lugar, viaja hasta allí.

mod.json, campo por campo

Una dependencia puede ser un objeto en lugar de un nombre: {"id": "some_mod", "version": "", "optional": true}.

Un valor que nombra otro paquete es una referencia entre modificaciones y la referencia debe ser una dependencia declarada. Si esa dependencia es opcional, asigne al campo un fallback; de lo contrario, el registro se omitirá cuando la dependencia esté ausente:

a goods record

[
  {
    "op": "add",
    "id": "northern_reach:alloy",
    "display_name": "Alloy",
    "linked_item_id": "absent_helper:ore",
    "fallback": { "linked_item_id": "iron_ore" }
  }
]

Dónde va cada archivo

where the files go

northern_reach/
  mod.json                  the label
  content/assets/images/
    images.json             your art
  content/inventory/items/
    blades.json             your first record
  content/narrative/quest_plans/
    the_long_winter.json    your quest

Nombres e identificaciones

Una identificación son letras minúsculas, dígitos y guiones bajos, y nada más. frost_blade, no Frost Blade, no frost-blade y no frost.blade. Ni siquiera lleva su propio separador, porque un separador dentro de un id es la carpeta que se filtra en el nombre: mueve el archivo y el id ya no concuerda con el disco. Los : anteriores son la única excepción y ambas mitades siguen la regla.

La parte antes de los dos puntos es la identificación de su paquete. Así es como dos mods pueden agregar un Frost Blade sin chocar.

Palabras que lee un jugador

El texto escrito dentro de un registro es texto en un solo idioma. En su lugar, señale una clave:

a locale CSV

northern_reach.item.frost_blade.name
northern_reach.item.frost_blade.description

Las claves están en minúsculas, unidas por puntos, con el espacio de nombres como identificadores. Incorpora palabras a la familia locales: un .csv bajo content/locale con una columna key y una columna de idioma. Las familias, una a una tiene la forma exacta.

También escriba el simple display_name al lado de la clave. Un registro que tiene sólo una frase tiene que ser reescrito a mano el día que lo traduces, y para entonces habrá cuatrocientas.

Las dos formas de hacer esto mal fallan de maneras muy diferentes, y solo una de ellas te dice eso. Una clave que no responde a nada aparece como la clave misma: northern_reach.item.frost_blade.name, en la pantalla, deliberadamente fea para que alguien la arregle, y contada como un agujero. Un registro que solo contiene texto y no contiene claves nunca aparece: funciona, en su idioma, para todos los jugadores en todos los idiomas. No se rechaza nada ni falta nada, por lo que nada lo informa y un jugador que lee en portugués lee en silencio tu italiano. Encuentras el primer error. El segundo encuentra a tus lectores.

Traduce un mod y serás traducido

El juego sale en siete idiomas, por lo que un paquete con inglés incluido en los registros se lee como inglés para seis séptimas partes de quienes lo instalan. Esto es lo que cuesta evitarlo, que es casi nada si lo haces el primer día y una reescritura si lo haces el cuatrocientos.

Los idiomas que hay

Siete, y esta tabla se lee desde la compilación en lugar de estar escrita a mano aquí, por lo que un idioma que llega o sale se mueve el mismo día:

Dos de los códigos tienen una segunda ortografía en circulación: pt-BR es la que usa una tienda digital y esta página, pt_BR es la que cumple el motor, y en el encabezado de una columna se aceptan ambos. Escriba el que copió.

Llevar palabras en más de un idioma.

Un CSV en content/locale, con key primero y una columna por idioma:

a locale CSV

key,en,it,de
northern_reach:GOOD_FROST_SALT,Frost Salt,Sale di Brina,Frostsalz
northern_reach:ITEM_FROST_BLADE_NAME,Frost Blade,Lama di Brina,Frostklinge

Cuando una clave no tiene respuesta en el idioma del jugador, el juego desciende por una escalera fija: el idioma del jugador, luego el idioma en el que su paquete dice haber sido escrito, luego el catálogo del juego y luego la clave misma. El último paso es feo a propósito: una clave sin resolver tiene que verse mal para que alguien la arregle. Una conversión total se salta el catálogo de juegos, porque Old Seat aparecer en un mundo ambientado en otro continente no es un pequeño descuido de la traducción, es el juego base el que brilla.

Escribe un texto que se pueda traducir.

• No hay oraciones construidas en partes. El orden de las palabras no es el mismo en todos los idiomas, por lo que un nombre ensamblado en tiempo de ejecución a partir de una columna de adjetivos y una columna de sustantivos produce Oro Cervo en italiano. Una entrada escrita para cada idioma, completa.
• El nombre de una persona nunca se traduce ni se flexiona. Aldric es Aldric en todos los idiomas. Lo que también significa que una clave no debe poner un nombre en una posición oblicua ("of {name}", "{name}'s") porque muchos idiomas rechazan los nombres propios y el juego no.
• No hay límite de caracteres y eso no es lo mismo que no tener límite. Ningún campo cuenta caracteres; lo que termina siendo espacio en la pantalla. El alemán es aproximadamente un tercio más largo que el inglés y es el idioma que rompe botones; el chino es mucho más bajo y casi nunca lo hace. Si prueba solo una traducción, pruebe con el alemán y coloque una etiqueta con la redacción más corta que aún sea correcta.

Alguien que traduzca tu paquete

Agrega una columna y le devuelve el archivo. El flujo de trabajo está todo aquí, y es por eso que el formato es CSV en lugar de algo más amigable para un programador: un traductor puede abrirlo en una hoja de cálculo y sus herramientas ya lo leen.

Dos cosas marcan la diferencia entre un paquete que se traduce y otro que no. Mantenga las claves estables: una clave renombrada es una traducción perdida y el traductor se entera cuando un jugador se entera. Y diga para qué sirve una línea: una clave llamada NR_MSG_01 obtiene una respuesta, mientras que northern_reach:VENDOR_HERB_GREETING recibe un saludo de vendedor de hierbas.

Si eres tú quien traduce el paquete de otra persona, te obligan las mismas reglas: las columnas son los idiomas que lleva el juego, las claves son sus claves y no las tuyas, y un nombre sigue siendo un nombre.

Cambiando lo que el juego ya tiene

part of mod.json

"overrides": ["iron_sword"]

overrides es una promesa. Un registro que llega a una identificación que no declaraste se rechaza, por lo que nunca puedes cambiar silenciosamente algo de lo que un jugador no sabía nada.

a goods record

[
  {
    "op": "patch",
    "id": "iron_ore",
    "changes": [
      { "op": "set", "field": "base_price", "value": 14 }
    ]
  }
]

Un parche nombra sus cambios uno a la vez:

• set: escribe value en field, lo que haya antes. Está escrito con field y value.
• unset: elimina field del registro, para que el lector vea el valor predeterminado de la familia. Está escrito con field.
• append_unique: agrega value a la lista en field si aún no está allí. Está escrito con field y value.
• remove_value: elimina cada aparición de value de la lista en field. Está escrito con field y value.

• Nombre un campo por ruta, nunca por ubicación. tags.0 se rechaza. La tercera etiqueta de hoy es la segunda después de cargar el mod de otra persona.
• Una ruta tiene hasta cuatro nombres en minúsculas unidos por puntos. Todo lo que contenga un operador se rechaza.
• append_unique es el que dos mods pueden compartir. Si ambos ponen en cola la misma etiqueta, no es un conflicto y no la duplica.

Sólo a veces

Un registro puede indicarle cuándo vale la pena. Agregue un when al lado del op, en un paquete con "manifest_version": 2:

a presentation_bindings record

{
  "op": "add",
  "id": "my_mod:snowy_cloak",
  "subject": "wool_cloak",
  "kind": "item",
  "slot": "icon",
  "cue": "my_mod:cloak_snowy",
  "when": { "season": { "is": "winter" } }
}

No hay operador ni nada que calcular. Todo lo que una condición puede decir está en estas dos tablas.

Máximo cuatro sujetos en un when, dos ensayos por sujeto. Dos ensayos sobre el mismo tema son un intervalo: { "day": { "at_least": 10, "at_most": 30 } }.

Qué familia toma qué. Cada familia toma los tres decididos al cargar. Solo presentation_bindings y effects toman los cuatro que se mueven mientras juegan, porque solo esos dos se reconstruyen cuando el mundo cambia. Se rechaza nominar a season en otro lugar y el mensaje dice qué temas realmente toma esa familia.

La razón son los rescates. Un registro que decide un elemento, una persona o una misión debe ser el mismo registro la próxima vez que se cargue, y una condición de movimiento es exactamente lo que le impide hacerlo.

Un aspecto de temporada va en el enlace, no en la imagen. Trae la imagen solo una vez, luego dos registros presentation_bindings para ella: uno con un when y otro sin él. images, audio y fonts rechazan un when sin discusión.

La retención no se rechaza. Una condición que no se cumple mantiene su registro y el informe de carga lo dice por su nombre:

what the game prints back

WITHHELD my_mod:snowy_cloak from my_mod: season is winter, and it is spring

Un paquete con cincuenta récords de temporada se conserva en cualquier momento en las tres cuartas partes. Es el paquete el que funciona.

Si se niega cualquier asociación de presentación condicional, el informe aún muestra la familia tal como se declaró e imprime bound=0 junto con cada fila WITHHELD; no informa incorrectamente que el paquete no tiene superficie de presentación. Si ningún enlace incondicional proporciona el mismo espacio, también imprime NO_APPLICABLE kind/subject/slot con la condición sin respuesta, lo que significa "nada se aplica en este estado mundial", no "el registro no era válido". Pruebe la condición en el host o en el carril de ejecución con el estado mundial correspondiente antes de asumir que la asociación ha sido rechazada.

Dos versiones de lo mismo. Trae dos registros add con el mismo id y diferentes condiciones. El que mantiene su condición es el que cobra. Si ambos se cumplen, el segundo se rechaza como duplicado, que es la forma en que se informan las condiciones superpuestas en lugar de resolverse mediante el orden del archivo.

quitar algo

remove significa descontinuado, no fuera de existencia. El historial se sigue resolviendo y queda marcado: ya no se ofrece nada nuevo, no se mantiene en stock, no se fabrica ni se genera por él, y todo lo que un jugador ya tiene y que le nombra sigue leyendo exactamente lo que siempre ha leído.

a goods record

{ "op": "remove", "id": "iron_ore" }

vendor_inventories es la única familia que quita el registro, y solo porque las reglas de guardado ya dicen que nadie señala esa línea.

Un remove no puede transportar un when. Se debe decidir una retirada que podría denominarse un rescate, de lo contrario una identificación se resuelve una noche y no la siguiente.

La eliminación es permanente para una composición. Se rechaza un patch, replace o un segundo remove posterior dirigido al ID retirado, incluso si una retirada de mercancías mantiene el registro antiguo resoluble mediante su eliminación permanente. Esto evita que el informe guardado indique "retirado" mientras que un paquete posterior hace que el registro se comporte nuevamente como se proporcionó. Agregue una nueva ID de espacio de nombres cuando necesite un nuevo registro; No confíe en la remoción seguida de una resurrección silenciosa.

Cuando dos mods quieren lo mismo

Ambos cargan. Cada cambio se compone antes de construir algo, por lo que el juego ve ambos.

Ganar y obtener permiso son dos cuestiones diferentes, y esa es la parte sorprendente. El juego siempre calcula qué paquete escribe en último lugar (dejarlo en manos del azar haría que incluso lanzar una moneda al aire fuera rechazado) y aun así marca el par como una colisión que nadie declaró. El validador fuera de línea rechaza el mismo par sin discusión, por lo que te enterarás antes que un jugador.

supersedes en tu manifiesto es tu forma de decir que lo hiciste a propósito. Nombra la identificación del otro paquete y el conflicto se convierte en declared_replacement: registrado, con motivo y ya no es un error.

Dale a tu paquete un load_order propio. Dos paquetes que comparten un número no se rechazan, y luego el ganador queda fuera del orden alfabético de la identificación del mod: un orden que ningún autor eligió y que ningún jugador puede leer en la pantalla.

Imágenes, sonido, escritura, color.

Traer un archivo y usarlo son dos pasos separados y necesitas ambos. Un archivo al que nada apunta se lee, se comprueba, se mide y nunca se muestra.

trae el archivo

Cada familia de recursos es un descriptor de archivo más los archivos que nombra. El descriptor debe tener el mismo nombre que su familia: images.json, audio.json, fonts.json.

where the files go

content/assets/images/
  images.json
  river_guard.png

a images record

[
  {
    "id": "northern_reach:river_guard",
    "file": "river_guard.png",
    "format": "png"
  }
]

Tres reglas que muerden:

• El encabezado se verifica antes de que algo lo decodifique. format es lo que es el archivo, no lo que afirma la extensión.
• Un nombre de file que contiene .. o ~, o que comienza con /, \, res:// o user://, se rechaza en el nombre.
• Una identificación que no se resuelve recibe un marcador de posición y una advertencia, nunca silencio.

apuesta por ello

En un registro que llevas, con un campo que toma tu identificación de imagen:

En cualquier cosa, incluido el contenido del juego base, con un registro presentation_bindings que nombre el tema, su tipo y su espacio:

a presentation_bindings record

[
  {
    "id": "northern_reach:iron_sword_icon",
    "subject": "iron_sword",
    "kind": "item",
    "slot": "icon",
    "cue": "northern_reach:river_guard",
    "alternative_key": "northern_reach_iron_sword_icon_alt"
  }
]

alternative_key es obligatorio cuando un slot lleva información: es la clave de idioma que dice lo mismo a un jugador que no puede recibir la imagen.

Sonido

role es un límite, no una etiqueta: cada uno tiene su propia duración máxima, su propio límite sobre cuántos jugadores juegan juntos y el cursor que busca un jugador.

Se rechaza un WAV comprimido: descodificarlo requiere un analizador, y el analizador es precisamente lo que estás evitando.

Escritos

covers nombra los idiomas para los que su fuente contiene glifos y la compilación se niega a instalarla para otros. Un personaje al que le falta un idioma no falla: dibuja cuadritos y en la pantalla se lee como una traducción a medio terminar, con el texto correcto y el fallo de la fuente.

fallback_font es obligatorio: nombre otra identificación de fuente propia o una familia del sistema (Segoe UI, Noto Sans). sizes es sobre lo que se calcula el caché de glifos.

Solo un carácter, nunca una colección: un .ttc contiene varios y cuál llega depende de un índice que el descriptor no puede llevar. Fuentes gratuitas con amplia cobertura: Google Fonts, Font Squirrel. Compruebe que la licencia le permita redistribuir el archivo; su paquete lo incluye.

Color

Tokens, nunca una escena, guión o ruta de recursos. Los nombres son los del juego: bg_deep, bg_mid, bg_button, bg_hover, border, border_hi, text, text_dim, accent, gold. Un nombre que esta compilación no conoce se menciona en el registro en lugar de permanecer allí como si estuviera aplicado.

a themes record

[
  {
    "id": "northern_reach:dusk",
    "tokens": {
      "bg_deep": { "kind": "colour", "value": "#12131a" },
      "text": { "kind": "colour", "value": "#e8e2d0" },
      "border": { "kind": "colour", "value": "#7f6ab0" }
    },
    "contrast_pairs": [
      { "text": "#e8e2d0", "background": "#12131a" }
    ]
  }
]

contrast_pairs se verifican en una proporción de 4,5 y por debajo de eso el tema se rechaza. El medidor WebAIM le indica la proporción de un par antes de usarlo.

Apague el paquete y la interfaz recuperará sus colores y escrituras.

Arte que sienta bien

La compilación comprueba que una imagen sea una imagen. No tiene nada que decir sobre si se ve bien, y en un mundo dibujado en grises, una espada brillante, alegre y de alta resolución no deja de estar equivocada al pasar todo escrutinio. Esto es lo que se sabe hoy.

La guía de estilo completa aún no está publicada. Lo que traerá: la paleta en sí, las dimensiones en las que se dibuja cada tipo de cosa y ejemplos paralelos de lo que entra al mundo y lo que sale de él. Vale la pena esperar en lugar de adivinar, porque el fallo que evita no es un archivo rechazado: es un paquete que se instala perfectamente y hace que el juego parezca dos juegos.

Mientras no exista, el método fiable es el que no necesita ningún documento: coloca tu imagen junto a la imagen del juego y míralos juntos.

Tus mapas

Dibujar en [mosaico] (https://www.mapeditor.org/), exportar a .tmj e indexar a content/world/maps/maps.json.

a maps record

[
  {
    "id": "northern_reach:river_bend",
    "file": "river_bend.tmj",
    "name_key": "NORTHERN_REACH_RIVER_BEND",
    "world_origin": [4096, 2560],
    "region_id": "northern_reach:lowlands"
  }
]

Un enlace que nombra contenido de otro paquete, o del juego base, hace que se rechace todo el diseño. modding_map_report nombra la disposición y la regla que la rechazó.

Tus misiones

Una misión es un conjunto de registros que sólo tienen sentido juntos, en content/narrative/quest_plans.

a quest_plans record

[
  {
    "kind": "arc",
    "id": "northern_reach:the_long_winter",
    "stages": ["northern_reach:bring_the_grain"]
  },
  {
    "kind": "quest",
    "id": "northern_reach:bring_the_grain",
    "name_key": "northern_reach.quest.bring_the_grain.name",
    "giver": "northern_reach:the_reeve",
    "in_arc": "northern_reach:the_long_winter",
    "objectives": ["northern_reach:gather_grain"],
    "rewards": [
      { "grant": "receive_coin", "coin": 250 }
    ]
  },
  {
    "kind": "objective",
    "id": "northern_reach:gather_grain",
    "quest": "northern_reach:bring_the_grain",
    "goal": "collect_item",
    "target": "northern_reach:winter_grain",
    "count": 40
  },
  {
    "kind": "ending",
    "id": "northern_reach:the_barns_are_full",
    "arc": "northern_reach:the_long_winter",
    "requires": ["northern_reach:bring_the_grain"]
  }
]

• Un plan es todo o nada. Un registro incorrecto y no se instala ninguno: la alternativa es un arco que se detiene a mitad de camino con el jugador sosteniendo la espada y no el título.
• Una recompensa es un grant, nunca un kind. kind dice cuál de los cuatro registros es. Una recompensa escrita con kind se lee muy bien y se rechaza.

Consulta el tuyo con modding_quest_plan_report.

Tus conversaciones

Una conversación son tres tipos de registros en content/narrative/dialogue: el dialogue_graph que le da nombre y dice en qué barra se abre, las barras dialogue_node que son las líneas y las opciones dialogue_option que están encima.

Tu línea es tu línea y nada la reescribe. Lo que un modelo local puede hacer es responder una pregunta que el jugador le escribe al personaje, manteniéndose dentro de lo que dice tu línea, y cuando no puede permanecer dentro, dice que no sabe. Es el jugador quien decide si esa superficie existe; Con el modelo apagado, el personaje dice tu frase y se detiene. La traducción de tu chiste proviene de los archivos de idioma, como todo lo que escribes.

El gráfico nombra speaker y el disparador está ahí. Cada personaje del juego le pregunta a esta familia qué conversaciones hay encima de ellos cuando se hace clic, para que puedas darle al herrero algo que decir sin redefinir al herrero.

a dialogue record

[
  {
    "kind": "dialogue_graph",
    "id": "northern_reach:gate_toll",
    "entry": "northern_reach:gate_open",
    "speaker": "gate_warden",
    "name_key": "TALK_PACK_GATE"
  },
  {
    "kind": "dialogue_node",
    "id": "northern_reach:gate_open",
    "graph": "northern_reach:gate_toll",
    "voice": "line",
    "speaker": "gate_warden",
    "line_key": "TALK_PACK_GATE_OPEN"
  }
]

Tú escribes la conversación, nunca las palabras: cada chiste es una clave de idioma, por lo que un mismo paquete se puede leer en todos los idiomas que tenga el jugador. Un paquete que contiene prosa es rechazado en el archivo en lugar de en la pantalla.

Un chiste y una elección pueden conllevar cada una de las condiciones, y una elección puede conllevar órdenes. Una condición decide si el objeto se muestra al jugador; una orden es lo que sucede cuando la recibe.

• Nunca se abre una conversación que nombra algo que esta compilación no puede hacer. No la opción que lo usa: la conversación completa, antes de su primera línea. Una discusión que se detiene en la tercera opción ya se ha llevado las monedas del jugador.
• Nada se mueve más de lo que hay. Pregunta primero con has_coin o has_item; un paquete que se olvida no puede poner al jugador en menos cuarenta monedas, porque nadie ha aceptado una deuda y ninguna pantalla la explica.
• Todo chiste necesita una salida. Un chiste al que un jugador puede llegar y del que no puede escapar se rechaza cuando se carga el gráfico.

Consulta el tuyo con modding_dialogue_report.

tus escenas

Una escena es el único tipo de contenido que le quita el control al jugador, por lo que también es la única con una regla final. Las escenas viven en content/narrative/scenes y cada una nombra un where, el lugar donde se juega. Entra en ese lugar y comienza la escena.

a scenes record

[
  {
    "id": "northern_reach:the_morning_after",
    "where": "northern_reach:waystation",
    "beats": [
      { "beat": "fade_in", "seconds": 1.5 },
      { "beat": "lock_player" },
      { "beat": "say", "actor": "gate_warden", "line_key": "SCENE_PACK_GREETING" },
      { "beat": "wait", "seconds": 1.0 },
      { "beat": "unlock_player" }
    ]
  }
]

• Una escena que elimina controles debe devolverlos. Una secuencia que termina sin unlock_player se rechaza, porque la alternativa es traer una habitación de la que el jugador solo puede salir cerrando el juego.
• Las líneas van en orden y se espera una línea de bloqueo. Esto es lo que hace que una escena sea una escena en lugar de una lista de cosas que suceden todas a la vez.

Consulta el tuyo con modding_scene_report.

Tus capturas de pantalla

El diseño de una pantalla te indica qué secciones van en qué panel de pantalla ya tiene el juego y en qué orden. Presenta las piezas que dibuja esta construcción; no puede agregar uno, porque una sección que nadie escribió no tiene nada que dibujar.

Las disposiciones se encuentran en content/ui/screens. Las familias, una a una tiene campos y un registro para copiar.

Consulta el tuyo con modding_screen_report.

No apareció nada

Lea primero el estado en la pantalla Mod. Casi todos los estados mencionan el problema abiertamente, al pie de la letra, y también lo hace el error más común de todos: el que alguna vez estuvo en la parte superior de esta lista.

La familia falta en content_types. Escribes goods.json, olvidas "goods" en la lista de manifiesto y la carpeta nunca se abre: no se rechaza nada porque no se ha leído nada. El paquete se carga vacío. Ahora la pantalla le indica qué archivo pasó y qué agregar:

what the game prints back

content/economy/goods/goods.json was not read — add "goods" to content_types in mod.json

El validador fuera de línea imprime la misma oración, por lo que los dos no pueden estar en desacuerdo. Sólo si la línea dice cargado y no nombra ningún archivo no leído, baja en esta lista. Está en orden de frecuencia con la que cada uno es el culpable.

Los informes nunca te hacen dudar. Un registro rechazado recibe un nombre, su problema y, por lo general, un código; consulte [Cada código de diagnóstico] (#cada-código-de-diagnóstico).

Apareció y está mal.

El caso más difícil, porque no se informa nada de nada. Dos cosas pasan todo escrutinio y aun así te dan un registro que no escribiste.

Un campo que omitiste no es un error: es un valor predeterminado. El esquema de cada familia te indica sin qué campos no se puede instalar un registro y, para casi todas las familias, esa lista es corta. goods requiere exactamente uno: id. Omita base_price y es 1. Omita weight y es 1.0. Omita category y el producto básico será una materia prima. Nada te alerta, porque no pasa nada: pediste un bien y lo obtuviste.

Incluso un valor que no está entre las opciones es un valor predeterminado. El lector pone todo en mayúsculas antes de buscar, por lo que manufactured y MANUFACTURED son el mismo valor y las mayúsculas nunca son el problema: no empieces a reescribir archivos por eso. El problema es MANUFACTURED_GOODS: no es miembro, por lo que pasa a ser RAW_MATERIAL. SLOW para un decay_tier se convierte en ETERNAL. El registro se instala, la pantalla dice aplicado y su vela tiene el precio y la caducidad de otra cosa.

Nada en el juego dice esto, porque no hay nada que decir: el campo se declara como una cadena y una cadena mal escrita sigue siendo una cadena. El validador es el único lugar al que puedes llevarlo, y ahora lo toma:

typed into the debug console

$ python tools/quality/validate_mod_data.py --root mods/northern_reach
WARN: northern_reach:goods:goods.json#1: category is "MANUFACTURED_GOODS",
  which is not one of RAW_MATERIAL, MANUFACTURED, CONSUMABLE, AMMUNITION,
  EQUIPMENT. It loads as RAW_MATERIAL.
  ERROR=0 WARN=1

Una advertencia y no un error, porque el registro realmente se carga y rechazarlo ahora rompería los paquetes que ya funcionan. --strict lo convierte en un error y es la razón por la que ejecuta --strict antes de publicar.

Un campo que omitiste permanece en silencio y no se puede tomar: omitir category y escribir RAW_MATERIAL son la misma solicitud. Entonces, las tablas de campo en [Las familias, una por una](#las-familias-una por una) marcan Obligatorio y dan la columna de valores como la forma que verifica el cargador. Cuando un registro se carga y se comporta como otra cosa, primero compare sus campos con esa tabla: lo que está buscando es un campo que no escribió o una palabra que el cargador no reconoció.

cada familia

Una carpeta y un informe por familia. La columna de estado se mide en función de la construcción, por lo que nunca es una promesa que el juego no cumple. Lo que es es solo la primera línea, por lo que la tabla sigue siendo algo por lo que puedes desplazarte con la vista; la descripción completa de cada familia, con sus campos y un registro a copiar, es su entrada en Las familias, una a una.

• Listo para usar: formulario publicado, el juego instala tus registros, hay un ejemplo y tus ID sobreviven después de guardar y recargar.
• Validado, nada lo consume todavía — el cargador lee y comprueba la familia, pero ninguna superficie de paquete para el jugador la consume. Los paquetes de audio y fuentes están en este nivel: un informe limpio no hace aparecer en el juego una señal silenciosa ni una fuente sin usar.
• Comprobado, aún no instalado: el juego reconoce a la familia y verifica tu archivo, y nada lo coloca en un juego en curso. Un paquete dirigido a él pasa todas las comprobaciones y no carga nada. Está en la página a propósito: la alternativa es que alguien pase una noche allí sin descubrir que no ha hecho nada malo.

Decidida en pleno, sin ningún familiar que los cargue, por lo que ningún cartel puede preguntarle:

Esto no es un desperdicio. Lo que un mod nunca puede hacer es esa lista.

Las familias, una por una

Cada familia que construye sabe lo que acepta y un registro que puede copiar.

• Los campos obligatorios son aquellos sin los cuales no se puede instalar un registro.
• La columna de valores es la forma que verifica el cargador, no una pista.
• Cuando una familia lo dice, un campo que la tabla no nombra se rechaza junto con el registro en el que se encuentra. Un error tipográfico en el nombre de un campo es un registro que no se carga y el informe familiar lo dice por nombre.

Cada entrada también dice qué sucede con una partida guardada el día que un jugador te desinstala:

Aquí no hay nada escrito a mano. Los campos provienen del esquema publicado de cada familia. Cada ejemplo es uno de los paquetes que la matriz de prueba del marco hace girar contra el cargador, lo vuelve a colocar bajo el espacio de nombres northern_reach y lo vuelve a verificar con su patrón cuando ingresa a esta página: un ejemplo que el juego rechazaría hace que la compilación falle.

El mundo y los lugares que contiene.

5 familias: buildings, caravans, maps, pois, world_generation.

buildings

Definiciones de edificios y servicios del asentamiento: denominación, color, función e interior reutilizado.

• Estado Listo para usar
• Viajó en El servicio de un edificio
• Carpeta content/world/buildings
• Registros enrutados para el campo id
• Informe modding_building_report
• Si un reproductor te desinstala substitute_placeholder. Un asentamiento con un agujero donde hubo un servicio es injugable; Se lee y recupera un edificio visiblemente desaparecido.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado buildings.json, o el nombre .json que quieras dentro de esa carpeta:

a buildings record, under content/world/buildings

[
  {
    "id": "northern_reach:guildhall",
    "label": "Guild Hall",
    "role": "reeve",
    "color": {
      "r": 0.4,
      "g": 0.34,
      "b": 0.26
    },
    "interior_service": "moot_hall"
  }
]

caravans

Rutas comerciales que recorre una caravana: de dónde sale, hacia dónde va, qué trae, qué tan bien escoltada y a qué velocidad va.

• Estado Listo para usar
• Carpeta content/logistics/caravans
• Registros enrutados para el campo id
• Informe modding_caravan_report
• Si un reproductor te desinstala preserve_inert_reference. Una ruta cuyo paquete ha desaparecido conserva su nombre y no lleva nada. Reemplazar un destino enviaría los bienes de un jugador a un lugar que nunca aceptó.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado caravans.json, o el nombre .json que quieras dentro de esa carpeta:

a caravans record, under content/logistics/caravans

[
  {
    "id": "northern_reach:salt_road_run",
    "display_name": "Salt Road Run",
    "origin_settlement_id": "valdmere",
    "destination_settlement_id": "old_seat",
    "cargo_type": "salt",
    "cargo_value": 240,
    "guard_strength": "light",
    "daily_progress": 0.08,
    "initial_spawn_offset_days": 3
  }
]

maps

Arreglos que dibuja un paquete en Tiled, nombrados por id: el archivo, dónde se encuentra en el mundo y la clave de idioma por la que se conoce. El índice es el registro; el arreglo al lado se lee como datos y nunca como un recurso, se normaliza en forma canónica, se compara con el kit publicado y se ensambla antes de colocar cualquier cosa. Un diseño rechazado no coloca nada en absoluto, porque la mitad del mapa es una región a la que el jugador ingresa sin forma de saber qué mitad ha llegado.

• Estado Listo para usar
• Carpeta content/world/maps
• Registros enrutados para el campo id
• Informe modding_map_report
• Si un reproductor te desinstala drop_optional_presentation. Ningún rescate menciona una disposición. Un guardado nombra el punto de interés que un diseño ha movido y ese registro conserva sus coordenadas, por lo que un mapa retirado cuesta el diseño y nunca el contenido. Dejarlo es lo que hace que el mundo vuelva a lo que dicen sus registros, en lugar de mantener una posición que ya nadie ofrece.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado maps.json, o el nombre .json que quieras dentro de esa carpeta:

a maps record, under content/world/maps

[
  {
    "id": "northern_reach:river_bend",
    "file": "river_bend.tmj",
    "name_key": "MAP_RIVER_BEND",
    "world_origin": [
      4096,
      2560
    ],
    "region_id": "northern_reach:lowlands"
  }
]

pois

Puntos de interés colocados por coordenadas en el mapa mundial escrito a mano.

• Estado Listo para usar
• Ruta a Un lugar en el mapa
• Carpeta content/world/pois
• Registros enrutados para el campo id
• Informe modding_poi_report
• Si un reproductor te desinstala preserve_inert_reference. Un lugar descubierto permanece descubierto. Las misiones y el historial de viajes apuntan a la identificación.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado pois.json, o el nombre .json que quieras dentro de esa carpeta:

a pois record, under content/world/pois

[
  {
    "id": "northern_reach:drowned_mile",
    "kind": "RUINS",
    "display_name": "The Drowned Mile",
    "description": "A stretch of road the river took back. The milestones still stand, chest deep.",
    "world_position": {
      "x": 0.0,
      "y": 0.0
    },
    "discovery_radius": 3.0,
    "one_time_loot": true,
    "morale_modifier": -1,
    "awareness_modifier": 0.05,
    "narrative_significance_key": "POI_DROWNED_MILE_LORE"
  }
]

world_generation

Perfiles de generación hechos únicamente de datos: opciones ponderadas de bioma y ubicación, propiedad del anfitrión.

• Estado Listo para usar
• Carpeta content/world/generation
• Registros enrutados para el campo id
• Informe nada suyo; modding_preflight_report se encarga de ello
• Si un reproductor te desinstala preserve_inert_reference. Un guardado registra la identificación del perfil elegido. Si falta su paquete, mantener e informar esa identificación es más seguro que reconstruir silenciosamente el juego con el mapa del juego base.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado profiles.json, o el nombre .json que quieras dentro de esa carpeta:

a world_generation record, under content/world/generation

[
  {
    "kind": "generation_profile",
    "id": "northern_reach:ashen_reach",
    "stream": "northern_reach:world_stream",
    "tables": {
      "biomes": [
        {
          "id": "plains",
          "weight": 60
        },
        {
          "id": "forest",
          "weight": 30
        },
        {
          "id": "hills",
          "weight": 10
        }
      ],
      "settlements": [
        {
          "id": "northern_reach:hamlet",
          "weight": 100
        }
      ],
      "buildings": [
        {
          "id": "northern_reach:longhouse",
          "weight": 100
        }
      ],
      "pois": [
        {
          "id": "northern_reach:standing_stone",
          "weight": 100
        }
      ]
    }
  }
]

Personas, familias y lo que pueden hacer

8 familias: enemy_archetypes, enemy_variants, group_archetypes, mercenary_templates, noble_houses, npc_definitions, perks, relationships.

enemy_archetypes

Tipos de enemigos que conoce el nivel estratégico: rango, qué variantes despliegan, dónde acampan, qué tamaño tiene la guarnición y con qué frecuencia atacan.

• Estado Listo para usar
• Carpeta content/threat/enemy_archetypes
• Registros enrutados para el campo id
• Informe modding_enemy_archetype_report
• Si un reproductor te desinstala preserve_inert_reference. Un campamento todavía indica lo que lo estableció. Reemplazar cambiaría silenciosamente lo que asedia un acuerdo; nombrando la ausencia que leemos.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado enemy_archetypes.json, o el nombre .json que quieras dentro de esa carpeta:

a enemy_archetypes record, under content/threat/enemy_archetypes

[
  {
    "id": "northern_reach:salt_reavers",
    "display_name": "Salt Reavers",
    "description": "Coastal raiders who winter inland and burn what they cannot carry.",
    "tier": 2,
    "corruption_chance": 0.1,
    "preferred_camp_biomes": [
      "marsh",
      "coast"
    ],
    "camp_count": 3,
    "garrison_min": 8,
    "garrison_max": 16,
    "aggression": 0.4,
    "raid_cooldown_days": 5,
    "sortie_size_min": 4,
    "sortie_size_max": 9,
    "target_preferences": [
      "caravan",
      "settlement"
    ],
    "camp_glyph": "tent"
  }
]

enemy_variants

Bloques de estadísticas para un tipo de cuerpo enemigo en el campo: clase, rango, los cinco atributos y los identificadores del arma, mano izquierda y escudo que lleva.

• Estado Listo para usar
• Carpeta content/combat/enemy_variants
• Registros enrutados para el campo id
• Informe modding_enemy_variant_report
• Si un reproductor te desinstala substitute_placeholder. No se puede luchar contra un cuerpo que ya está en el campo sin un bloque de estadísticas. Un reemplazo estable que posee el motor mantiene la batalla solucionable y la identificación original se conserva.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado enemy_variants.json, o el nombre .json que quieras dentro de esa carpeta:

a enemy_variants record, under content/combat/enemy_variants

[
  {
    "id": "northern_reach:salt_reaver_archer",
    "archetype_id": "northern_reach:salt_reavers",
    "display_name": "Salt Reaver Archer",
    "variant_class": "archer",
    "tier": 2,
    "strength": 3.0,
    "agility": 5.0,
    "constitution": 3.5,
    "aim": 6.0,
    "will": 2.5,
    "main_weapon_id": "short_bow",
    "ai_behavior": "keeps distance and gives ground rather than trade blows"
  }
]

group_archetypes

Parámetros de estrategia ajustables para un grupo que vive en el mapa mundial: radio de advertencia, preferencia de objetivo, número de miembros, umbrales de suministro y retirada.

• Estado Listo para usar
• Carpeta content/strategic/group_archetypes
• Registros enrutados para el campo id
• Informe modding_group_archetype_report
• Si un reproductor te desinstala substitute_placeholder. La inteligencia estratégica debe leer un umbral en alguna parte. Responde a un valor por defecto que posee el motor, que es el mismo al que ya recurre esta familia.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado group_archetypes.json, o el nombre .json que quieras dentro de esa carpeta:

a group_archetypes record, under content/strategic/group_archetypes

[
  {
    "id": "northern_reach:pilgrim_column",
    "display_name": "Pilgrim Column",
    "kind": "nomad",
    "faction_id": "",
    "target_preference": "wandering",
    "aggression": "avoid_player",
    "alarm_radius_px": 300.0,
    "night_aggression_multiplier": 0.5,
    "min_members": 6,
    "max_members": 14,
    "behavior_profile_mix": [
      "coward",
      "balanced"
    ],
    "provisions_max": 6,
    "retreat_hp_pct": 0.6
  }
]

mercenary_templates

Modelos de mercenarios contratables: nombre, clase, origen, salud y moral iniciales, costo de contratación y el día en que aparecen por primera vez.

• Estado Listo para usar
• Carpeta content/character/mercenaries
• Registros enrutados para el campo id
• Informe modding_mercenary_report
• Si un reproductor te desinstala preserve_inert_reference. Los mercenarios ya contratados viven en el rescate como una unidad; sólo la lista de la taberna pierde su plantilla. La identificación permanece nombrada, por lo que aún se puede leer el origen de lo orgánico.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado mercenaries.json, o el nombre .json que quieras dentro de esa carpeta:

a mercenary_templates record, under content/character/mercenaries

[
  {
    "id": "northern_reach:ditchwater_sapper",
    "display_name": "Ditchwater Sapper",
    "class_id": "skirmisher",
    "background": "Dug siege trenches for whoever was paying, and stopped asking which side it was.",
    "hp_max": 24,
    "morale_start": 70,
    "hire_cost": 180,
    "available_from_day": 6
  }
]

noble_houses

Datos iniciales de una casa noble: el señor, el heredero, qué asentamientos responden a la casa, y quién cuenta como rival o aliado.

• Estado Listo para usar
• Carpeta content/politics/noble_houses
• Registros enrutados para el campo id
• Informe modding_noble_house_report
• Si un reproductor te desinstala preserve_inert_reference. El respeto de un jugador por una casa queda registrado en su identificación. Reemplazar uno sería reescribir sin decir nada a aquellos que eran leales.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado noble_houses.json, o el nombre .json que quieras dentro de esa carpeta:

a noble_houses record, under content/politics/noble_houses

[
  {
    "id": "northern_reach:house_tidewatch",
    "display_name_key": "VALID_NOBLE_HOUSE_MOD_HOUSE_TIDEWATCH",
    "display_name": "House Tidewatch",
    "strength": "reduced",
    "alignment": "isolationist",
    "corruption_risk": "moderate",
    "is_minor": true,
    "lord_state": "ailing",
    "captain_initial_stance": "suspicious",
    "captain_initial_opinion": 35,
    "apex_ambition": 20,
    "apex_claim_legitimacy": 15,
    "house_power_base": 25,
    "lore_summary": "Kept the coast road open for two hundred years and was paid in salt for it."
  }
]

npc_definitions

Definiciones de NPC nombrados.

• Estado Listo para usar
• Entrado Un comerciante que lo posee
• Carpeta content/narrative/npcs
• Registros enrutados para el campo id
• Informe modding_npc_report
• Si un reproductor te desinstala preserve_inert_reference. No es lo mismo una persona con un nombre que el mundo recuerda que otra que nunca existió, y los informes apuntan al ello.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado npcs.json, o el nombre .json que quieras dentro de esa carpeta:

a npc_definitions record, under content/narrative/npcs

[
  {
    "id": "northern_reach:wandering_herbalist",
    "display_name": "Wandering Herbalist",
    "title": "Travelling Healer",
    "role": "NONE",
    "settlement_id": "old_seat",
    "is_vendor": true,
    "vendor_inventory_id": "northern_reach:herb_stall",
    "personality_tags": [
      "gentle",
      "secretive"
    ]
  }
]

perks

Privilegios declarativos: desencadenantes y efectos, sin ningún controlador escrito en código.

• Estado Listo para usar
• Carpeta content/character/perks
• Registros enrutados para el campo id
• Informe modding_perk_report
• Si un reproductor te desinstala preserve_inert_reference. Un personaje conserva lo que se ha ganado. Eliminar una función reescribe silenciosamente un edificio en el que el jugador pasó una partida.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado perks.json, o el nombre .json que quieras dentro de esa carpeta:

a perks record, under content/character/perks

[
  {
    "id": "northern_reach:stoneskin",
    "skill": "armour",
    "name_key": "PERK_STONESKIN",
    "description_key": "PERK_STONESKIN_DESC",
    "kind": "lateral",
    "side": "L",
    "col": 0,
    "row": 7,
    "level": 100,
    "parents": [],
    "icon": "northern_reach:stoneskin_icon"
  }
]

relationships

Patrones de pareja, políticas de relaciones acotadas, condiciones de reclutamiento y vínculos declarativos.

• Estado Listo para usar
• Carpeta content/companion/relationships
• Registros enrutados para el campo id
• Informe nada suyo; modding_preflight_report se encarga de ello
• Si un reproductor te desinstala preserve_inert_reference. La semilla de la relación de pareja permanece adherida a su identificación, por lo que eliminar un paquete no puede borrar silenciosamente la confianza, los rencores o el historial de abandonos.

Campos. Esta familia contiene más de un tipo de registro y cada tipo se compara con su propia lista. Un campo que esta tabla no nombra se rechaza junto con el registro.

Un registro con kind: bond:

Un registro con kind: companion_template:

Un registro con kind: recruit_terms:

Un registro con kind: relationship_policy:

En un archivo llamado relationships.json, o el nombre .json que quieras dentro de esa carpeta:

a relationships record, under content/companion/relationships

[
  {
    "id": "northern_reach:marsh_policy",
    "kind": "relationship_policy",
    "relation_kinds": [
      "comrade",
      "feud",
      "sworn"
    ],
    "bounds": {
      "floor": -100,
      "ceiling": 100
    },
    "bands": [
      {
        "name": "hostile",
        "from": -100,
        "to": -61
      },
      {
        "name": "cold",
        "from": -60,
        "to": -31
      },
      {
        "name": "wary",
        "from": -30,
        "to": -11
      },
      {
        "name": "neutral",
        "from": -10,
        "to": 10
      },
      {
        "name": "warm",
        "from": 11,
        "to": 40
      },
      {
        "name": "trusted",
        "from": 41,
        "to": 70
      },
      {
        "name": "devoted",
        "from": 71,
        "to": 100
      }
    ],
    "max_change_per_event": 12,
    "decay_per_day": 1
  },
  {
    "id": "northern_reach:hire_terms",
    "kind": "recruit_terms",
    "means": "hire",
    "cost": 240
  },
  {
    "id": "northern_reach:marsh_companion",
    "kind": "companion_template",
    "unit": "northern_reach:marsh_unit",
    "recruit": "northern_reach:hire_terms",
    "loyalty": "northern_reach:marsh_policy",
    "starting_regard": 8,
    "leave_below": -60
  }
]

Cosas, comercio y los números detrás de un choque

5 familias: combat_balance, goods, items, recipes, vendor_inventories.

combat_balance

Valores de equilibrio de combate acotados que ajustan los parámetros del solucionador existente sin agregar reglas, operaciones o mecánicas.

• Estado Listo para usar
• Carpeta content/combat/balance
• Registros enrutados para el campo id
• Informe modding_combat_balance_report
• Si un reproductor te desinstala substitute_placeholder. El saldo es una definición de datos en poder del anfitrión, no del inventario del jugador. Cuando su paquete está ausente el equilibrio canónico y estable responde, y la carga posterior no trae consigo una segunda forma de guardar los ajustes.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado balance.json, o el nombre .json que quieras dentro de esa carpeta:

a combat_balance record, under content/combat/balance

[
  {
    "id": "northern_reach:coastal_balance",
    "values": {
      "zone_penalty_head": 22,
      "crit_damage_mult": 1.75,
      "friendly_fire_redirect_chance": 0.2
    }
  }
]

goods

Bienes comercializables y sus propiedades económicas.

• Estado Listo para usar
• Viajó en [Un producto bueno para vender](#un producto bueno para vender)
• Carpeta content/economy/goods
• Registros enrutados para el campo id
• Informe modding_goods_report
• Si un reproductor te desinstala preserve_inert_reference. Una escort que nombra un bien que nadie suministra es honesta. Reemplazarla cambiaría silenciosamente lo que tiene un jugador.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado goods.json, o el nombre .json que quieras dentro de esa carpeta:

a goods record, under content/economy/goods

[
  {
    "id": "northern_reach:spiced_wine",
    "display_name": "Spiced Wine",
    "category": "consumable",
    "decay_tier": "preserved",
    "base_price": 12,
    "weight": 0.5,
    "tags": [
      "luxury",
      "drink"
    ]
  }
]

items

Artículos de inventario, incluidas armas y armaduras.

• Estado Listo para usar
• Entrado Un artículo para llevar
• Carpeta content/inventory/items
• Registros enrutados para el campo id
• Informe modding_items_report
• Si un reproductor te desinstala preserve_inert_reference. El repositorio sigue nombrando lo que había en él, y esa es la única razón por la que la reinstalación se lo devuelve.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado items.json, o el nombre .json que quieras dentro de esa carpeta:

a items record, under content/inventory/items

[
  {
    "id": "northern_reach:spiced_wine_bottle",
    "display_name": "Bottle of Spiced Wine",
    "category": "CONSUMABLE",
    "rarity": "UNCOMMON",
    "weight": 0.5,
    "max_stack": 10,
    "base_value": 14,
    "sellable": true,
    "tags": [
      "drink",
      "luxury"
    ]
  }
]

recipes

Recetas artesanales: qué se consume, qué sale de ellas, dónde se elabora, cuánto cuesta y qué probabilidades hay de que se eche a perder.

• Estado Listo para usar
• Carpeta content/economy/recipes
• Registros enrutados para el campo id
• Informe nada suyo; modding_preflight_report se encarga de ello
• Si un reproductor te desinstala preserve_inert_reference. Nada en un guardado nombra una receta: un guardado nombra el objeto que ha producido un proceso, y la familia de ese objeto es responsable de ello. Lo que una receta retirada deja atrás es una estación que ya no ofrece algo, que se informa en lugar de arreglarse, porque inventar una receta de reemplazo pondría en la mano del jugador un artículo que ningún paquete proporciona.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado recipes.json, o el nombre .json que quieras dentro de esa carpeta:

a recipes record, under content/economy/recipes

[
  {
    "id": "northern_reach:salt_cured_ration",
    "display_name_key": "VALID_RECIPE_MOD_SALT_CURED_RATION",
    "recipe_kind": "normal",
    "inputs": {
      "salt": 1,
      "dried_meat": 2
    },
    "output_item_id": "northern_reach:salt_cured_ration",
    "output_count": 3,
    "requires_service": "kitchen",
    "gold_cost": 4,
    "time_cost_minutes": 20,
    "success_chance": 0.95,
    "failure_policy": "lose_fuel",
    "quality_policy": "material_inputs",
    "legality": "legal"
  }
]

vendor_inventories

Mesas de suministros para comerciantes.

• Estado Listo para usar
• Entrado Un comerciante que lo posee
• Carpeta content/world/vendor_inventories
• Registros enrutados para el campo id
• Informe modding_vendor_inventory_report
• Si un reproductor te desinstala drop_optional_presentation. Las existencias se regeneran. Un comerciante con un estante vacío es un estado legible y la línea no apunta a nada más.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado vendors.json, o el nombre .json que quieras dentro de esa carpeta:

a vendor_inventories record, under content/world/vendor_inventories

[
  {
    "id": "northern_reach:herb_stall",
    "display_name": "Herbalist's Stall",
    "npc_id": "northern_reach:wandering_herbalist",
    "global_price_multiplier": 1.0,
    "buyback_rate": 0.4,
    "entries": [
      {
        "item_id": "northern_reach:spiced_wine_bottle",
        "kind": "consumable",
        "daily_stock": 3,
        "price_multiplier": 1.1,
        "restock_days": 2,
        "min_standing": 0
      }
    ]
  }
]

Historia, misiones y las palabras que lee un jugador.

9 familias: dialogue, locales, lore, mr_lines, progress, quest_metadata, quest_plans, quests, scenes.

dialogue

Conversaciones como registros: el gráfico, sus chistes y las elecciones que en él se encuentran. Tres tipos comparten la familia y kind dice cuál. Un paquete escribe la conversación, nunca las palabras (cada pulsación de tecla es una tecla de idioma) y cada condición y cada consecuencia es una verificación o comando que esta compilación ya ejecuta.

• Estado Listo para usar
• Carpeta content/narrative/dialogue
• Registros enrutados para el campo id
• Informe modding_dialogue_report
• Si un reproductor te desinstala preserve_inert_reference. Un guardado registra lo que ha hecho una conversación (una misión que se ha movido, un objeto que ha cambiado de manos, una verdad aprendida), nunca la conversación en sí, que termina en el momento en que escribes algo. Cuando el paquete desaparece, las consecuencias permanecen porque nunca fueron parte de la conversación y la conversación simplemente ya no se ofrece. Reemplazarlo pondría palabras en boca de un personaje que su autor nunca escribió.

Campos. Esta familia contiene más de un tipo de registro y cada tipo se compara con su propia lista. Un campo que esta tabla no nombra se rechaza junto con el registro.

Un registro con kind: dialogue_graph:

Un registro con kind: dialogue_node:

Un registro con kind: dialogue_node:

Un registro con kind: dialogue_node:

Un registro con kind: dialogue_option:

En un archivo llamado gate_toll.json, o el nombre .json que quieras dentro de esa carpeta:

a dialogue record, under content/narrative/dialogue

[
  {
    "kind": "dialogue_graph",
    "id": "northern_reach:gate_toll",
    "entry": "northern_reach:gate_open",
    "speaker": "gate_warden",
    "name_key": "TALK_PACK_GATE_TOLL_NAME",
    "description_key": "TALK_PACK_GATE_TOLL_DESC"
  },
  {
    "kind": "dialogue_node",
    "id": "northern_reach:gate_open",
    "graph": "northern_reach:gate_toll",
    "voice": "line",
    "speaker": "gate_warden",
    "line_key": "TALK_PACK_GATE_OPEN"
  },
  {
    "kind": "dialogue_option",
    "id": "northern_reach:opt_pay_the_toll",
    "node": "northern_reach:gate_open",
    "label_key": "TALK_PACK_OPT_PAY",
    "goto": "northern_reach:gate_paid",
    "commands": [
      {
        "step": "pay_coin",
        "coin": 25
      },
      {
        "step": "change_relation",
        "subject": "player",
        "target": "gate_warden",
        "delta": 4
      }
    ]
  }
]

El encuentro contiene 12 registros; Se muestran 3.

locales

Las palabras que lee un jugador, en CSV con una columna por idioma: las claves propias del paquete, y las del juego donde el paquete declara sobrescribir.

• Estado Listo para usar
• Carpeta content/locale
• Informe modding_locale_report
• Si un reproductor te desinstala preserve_inert_reference. Un guardado nombra el disco, nunca las palabras que lo dicen, por lo que un paquete retirado entre dos sesiones cuesta una traducción y nada. La clave se conserva y aparece, lo que se lee como una traducción faltante en lugar de contenido faltante.

Columnas. Una columna que esta tabla no nombra se rechaza con el registro.

En un archivo llamado words.csv. El nombre del archivo es la mitad de la dirección y la identificación de la línea es la otra mitad, por lo que dos archivos pueden contener la misma identificación de línea sin colisionar:

a locales file

key,en,it
word_pack:GOOD_FROST_SALT,Frost Salt,Sale di Brina

lore

Entradas del códice: lugares, personas, eventos, costumbres y cosas sobre las que el mundo cuenta historias. Una entrada cargada no es una entrada conocida.

• Estado Listo para usar
• Carpeta content/narrative/lore
• Registros enrutados para el campo id
• Informe modding_lore_report
• Si un reproductor te desinstala preserve_inert_reference. Una entrada del Códice que un jugador ha leído es algo que ha visto. Quitarlo borra parte de lo que sabe sobre un mundo en el que pasó un tiempo, y las misiones y otras entradas apuntan a la identificación.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado lore.json, o el nombre .json que quieras dentro de esa carpeta:

a lore record, under content/narrative/lore

[
  {
    "id": "northern_reach:the_drowned_causeway",
    "category": "place",
    "title_key": "STORY_PACK_DROWNED_CAUSEWAY_TITLE",
    "body_key": "STORY_PACK_DROWNED_CAUSEWAY_BODY",
    "era": "before_the_mark",
    "citation_key": "STORY_PACK_CAUSEWAY_CITATION"
  },
  {
    "id": "northern_reach:the_tide_watch",
    "category": "custom",
    "title_key": "STORY_PACK_TIDE_WATCH_TITLE",
    "body_key": "STORY_PACK_TIDE_WATCH_BODY",
    "relates_to": [
      "northern_reach:the_drowned_causeway"
    ]
  }
]

mr_lines

Líneas estructuradas de realismo medieval, enrutadas por identificación de archivo y línea en lugar de un campo de identificación en JSON.

• Estado Listo para usar
• Carpeta content/medieval_realism/structured
• Informe modding_mr_lines_report
• Si un reproductor te desinstala drop_optional_presentation. Un chiste de colores al que nada hace referencia. Quitarlo no cuesta nada y conservarlo mostraría una cadena vacía.

Columnas. Se permite una columna sin nombre en esta tabla y debe ser un valor simple en lugar de una lista u objeto.

Cada registro necesita al menos uno de public_line, public_label, public_summary_line.

Estos nombres son rechazados sin lugar a dudas, contengan lo que contengan: unsafe_example, unsafe_reason, audit_note, expected_block_reason, script, scene, resource_path. Algunas son las columnas de verificación con las que escriben quienes juegan y las otras son los nombres en forma de código que Lo que un mod nunca puede hacer rechaza por todas partes. Un registro que lo contiene es rechazado en lugar de ser borrado silenciosamente.

En un archivo llamado MR_L03_TAVERN_INN_LINES.csv. El nombre del archivo es la mitad de la dirección y la identificación de la línea es la otra mitad, por lo que dos archivos pueden contener la misma identificación de línea sin colisionar:

a mr_lines file

line_id,tavern_state,speaker_role,tone,public_line,mechanical_hint
northern_reach:tavern_extra_01,evening_rush,innkeeper,welcoming,"Warm bread and a clean cup if you've the coin for it, friend.",food_only

progress

Registros de progresión del jugador: objetivos, perfiles de dificultad seguros y perfiles de partido dentro de las reglas del anfitrión.

• Estado Listo para usar
• Carpeta content/player/progress
• Registros enrutados para el campo id
• Informe nada suyo; modding_preflight_report se encarga de ello
• Si un reproductor te desinstala preserve_inert_reference. Los logros obtenidos y los perfiles de coincidencia elegidos permanecen nombrados cuando su paquete está ausente; Quitarlos en silencio reescribiría la historia del jugador o el contrato del partido.

Campos. Esta familia contiene más de un tipo de registro y cada tipo se compara con su propia lista. Un campo que esta tabla no nombra se rechaza junto con el registro.

Un registro con kind: achievement:

Un registro con kind: difficulty_profile:

Un registro con kind: run_profile:

En un archivo llamado progress.json, o el nombre .json que quieras dentro de esa carpeta:

a progress record, under content/player/progress

[
  {
    "id": "northern_reach:hard_tide",
    "kind": "difficulty_profile",
    "name_key": "DIFF_HARD_TIDE",
    "description_key": "DIFF_HARD_TIDE_DESC",
    "modifiers": {
      "enemy_strength_percent": 140,
      "coin_gain_percent": 80
    },
    "permadeath": true
  },
  {
    "id": "northern_reach:tide_run",
    "kind": "run_profile",
    "name_key": "RUN_TIDE",
    "description_key": "RUN_TIDE_DESC",
    "difficulty": "northern_reach:hard_tide",
    "seed_stream": "tide"
  },
  {
    "id": "northern_reach:held_tide",
    "kind": "achievement",
    "name_key": "ACH_HELD_TIDE",
    "description_key": "ACH_HELD_TIDE_DESC",
    "condition": [
      {
        "when": "days_survived",
        "count": 30
      }
    ],
    "icon": "tower"
  }
]

quest_metadata

Registros de metadatos de Quest, indexados por quest_id en lugar de id.

• Estado Listo para usar
• Carpeta content/narrative/quest_metadata
• Registros enrutados para el campo quest_id
• Informe modding_quest_metadata_report
• Si un reproductor te desinstala preserve_inert_reference. Describe misiones que ya podrían reducirse a una lápida; Quitarlo los dejaría sin descripción en lugar de ausentes.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado quests.json, o el nombre .json que quieras dentro de esa carpeta:

a quest_metadata record, under content/narrative/quest_metadata

[
  {
    "quest_id": "northern_reach:tavern_errand",
    "world_reason": "settlement_shortage",
    "quest_role": "recovery",
    "difficulty_band": "standard",
    "urgency_band": "soon"
  }
]

quest_plans

Planes de misión como registros: los arcos, misiones, objetivos y finales que escribe un paquete y a partir de los cuales el juego construye sus propias misiones. El formulario de registro de una misión, junto a los recursos escritos a mano en lugar de en su lugar.

• Estado Listo para usar
• Carpeta content/narrative/quest_plans
• Registros enrutados para el campo id
• Informe modding_quest_plan_report
• Si un reproductor te desinstala preserve_inert_reference. Un plan construye las mismas misiones que ejecuta el juego, por lo que uno retirado deja el mismo agujero que dejaría la escritura a mano. El progreso es lo único que un jugador no puede reconstruir: una misión no resuelta se informa y nunca se completa o se cancela silenciosamente.

Campos. Esta familia contiene más de un tipo de registro y cada tipo se compara con su propia lista. Un campo que esta tabla no nombra se rechaza junto con el registro.

Un registro con kind: arc:

Un registro con kind: ending:

Un registro con kind: objective:

Un registro con kind: quest:

En un archivo llamado the_long_winter.json, o el nombre .json que quieras dentro de esa carpeta:

a quest_plans record, under content/narrative/quest_plans

[
  {
    "kind": "arc",
    "id": "northern_reach:the_long_winter",
    "name_key": "northern_reach.arc.the_long_winter.name",
    "stages": [
      "northern_reach:bring_the_grain"
    ]
  },
  {
    "kind": "quest",
    "id": "northern_reach:bring_the_grain",
    "name_key": "northern_reach.quest.bring_the_grain.name",
    "description_key": "northern_reach.quest.bring_the_grain.description",
    "giver": "northern_reach:the_reeve",
    "in_arc": "northern_reach:the_long_winter",
    "objectives": [
      "northern_reach:gather_grain",
      "northern_reach:pay_the_toll"
    ],
    "deadline_days": 30,
    "rewards": [
      {
        "grant": "receive_coin",
        "coin": 250
      },
      {
        "grant": "give_item",
        "item": "northern_reach:reeves_seal",
        "count": 1
      }
    ]
  },
  {
    "kind": "objective",
    "id": "northern_reach:gather_grain",
    "quest": "northern_reach:bring_the_grain",
    "goal": "collect_item",
    "target": "northern_reach:winter_grain",
    "count": 40,
    "name_key": "northern_reach.objective.gather_grain.name"
  }
]

El accesorio contiene 5 registros; Se muestran 3.

quests

Recursos de misión escritos a mano, cargados por ruta en lugar de interpretados como registros. Un paquete que quiere su propia misión escribe quest_plans.

• Estado Comprobado, aún no instalado
• Carpeta content/narrative/quests
• Informe nada suyo; modding_preflight_report se encarga de ello
• Si un reproductor te desinstala preserve_inert_reference. El progreso es lo único que un jugador no puede reconstruir. Una misión no resuelta se informa y nunca se completa o se cancela silenciosamente.

Esta familia se carga por ruta en lugar de leerse como un registro, y un paquete no puede transportar el archivo que desea; consulte [Lo que un mod nunca puede hacer] (#qué-un-mod-nunca-puede-hacer). En su lugar, escriba quest_plans.

scenes

Escenas escenificadas: la habitación, quién está en ella y las líneas que se desarrollan en orden. Es el único contenido que le quita el control al jugador, razón por la cual una secuencia que nunca llega a end se rechaza en lugar de reproducirse. Los chistes y los accesorios son nombres tomados de listas publicadas; Aquí no se cargan escenas de Godot, recursos ni guiones.

• Estado Listo para usar
• Carpeta content/narrative/scenes
• Registros enrutados para el campo id
• Informe modding_scene_report
• Si un reproductor te desinstala preserve_inert_reference. Un guardado registra lo que hizo una escena (un nombre elegido, una misión movida, una puerta abierta), nunca el hecho de que fue vista. Se juega y finaliza en una sola sesión, por lo que un paquete que sale cuesta la escena y nunca una consecuencia de haberlo visto. Reemplazarlo representaría algo que el autor nunca escribió bajo el nombre de algo que escribió.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado scenes.json, o el nombre .json que quieras dentro de esa carpeta:

a scenes record, under content/narrative/scenes

[
  {
    "id": "northern_reach:tollhouse_wake",
    "name_key": "STAGE_PACK_TOLLHOUSE_WAKE",
    "stage": {
      "room": [
        880,
        600
      ],
      "light": "candle",
      "props": [
        {
          "prop": "bed",
          "at": "bedside"
        },
        {
          "prop": "storage",
          "at": "east",
          "label_key": "STAGE_PACK_BELONGINGS"
        },
        {
          "prop": "light_marker",
          "at": "north",
          "light": "candle"
        },
        {
          "prop": "walkway",
          "at": "bedside",
          "to": "door"
        }
      ]
    },
    "cast": [
      {
        "actor": "northern_reach:tollkeeper",
        "name_key": "STAGE_PACK_TOLLKEEPER",
        "sprite": "default",
        "at": "bedside"
      }
    ],
    "beats": [
      {
        "beat": "lock_player"
      },
      {
        "beat": "fade_in",
        "seconds": 2.0
      },
      {
        "beat": "say",
        "actor": "northern_reach:tollkeeper",
        "line_key": "STAGE_PACK_WAKE_1"
      },
      {
        "beat": "wait",
        "seconds": 0.8
      },
      {
        "beat": "say",
        "actor": "northern_reach:tollkeeper",
        "line_key": "STAGE_PACK_WAKE_2"
      },
      {
        "beat": "play_cue",
        "cue": "northern_reach:door_latch"
      },
      {
        "beat": "walk_to",
        "actor": "northern_reach:tollkeeper",
        "anchor": "door"
      },
      {
        "beat": "remove_actor",
        "actor": "northern_reach:tollkeeper"
      },
      {
        "beat": "show_exit"
      },
      {
        "beat": "unlock_player"
      },
      {
        "beat": "end"
      }
    ]
  }
]

Como ves y oyes todo

7 familias: audio, effects, fonts, images, presentation_bindings, screens, themes.

audio

Sonidos que lleva un paquete, nombrados por id: música, ambiente, efectos y voz, cada uno apuntando a un archivo dentro de su propia carpeta y declarando el rol que lo delimita.

• Estado Validado, nada lo consume todavía
• Carpeta content/assets/audio
• Registros enrutados para el campo id
• Informe modding_audio_report
• Si un reproductor te desinstala preserve_inert_reference. Un guardado nombra el tema y nunca el sonido encima de él, por lo que un paquete retirado entre dos sesiones cuesta una atmósfera y nada. La referencia se conserva y se informa: silencio sin nada que decir por qué es precisamente el estado que esta familia desea evitar.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En el archivo audio.json, que es el único archivo a través del cual se lee esta carpeta:

a audio record, under content/assets/audio

[
  {
    "id": "northern_reach:hearth_hum",
    "file": "hearth_hum.wav",
    "codec": "wav",
    "role": "ambience",
    "duration_seconds": 0.25,
    "sha256": "23fc92432963f74bd638f38ea9d7ddb475853f022810bdc8b344269bf43d5830"
  }
]

effects

Clima, polvo, chispas y luces, compuestos a partir de los modelos que el presentador pone a disposición. Un paquete nombra un modelo y establece parámetros dentro de rangos declarados; no hay ningún campo, en ninguna parte, que contenga un sombreador, una escena o un guión, y eso es lo que permite que un paquete extraño solicite fuego sin poder solicitar un programa.

• Estado Listo para usar
• Carpeta content/assets/effects
• Registros enrutados para el campo id
• Informe modding_effect_report
• Si un reproductor te desinstala preserve_inert_reference. Nada en un guardado nombra un efecto. El aire vuelve a lo que dibuja el juego base cuando el paquete se va, lo que cuesta un aspecto y nada que el jugador posea.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado effects.json, o el nombre .json que quieras dentro de esa carpeta:

a effects record, under content/assets/effects

[
  {
    "id": "northern_reach:moor_drift",
    "template": "dust_drift",
    "parameters": {
      "amount": 64,
      "lifetime": 6,
      "scale": 2,
      "wind": 4,
      "colour": "#c8bfa8"
    },
    "priority": 40
  }
]

fonts

Tipos de letra que lleva un paquete, nombrados por id: el archivo, el tamaño en el que están dibujados y los idiomas cuyos glifos llevan. La portada, en cambio, pretende estar expuesta, porque un personaje al que le faltan los glifos de una lengua no falla: dibuja cuadritos y en la pantalla se lee como una traducción que alguien dejó a medio terminar.

• Estado Validado, nada lo consume todavía
• Carpeta content/assets/fonts
• Registros enrutados para el campo id
• Informe modding_font_report
• Si un reproductor te desinstala preserve_inert_reference. Nada en un guardado nombra a un personaje. La interfaz vuelve a la fuente del kit de herramientas cuando el paquete sale, que es la única que cualquier autor tenía que elegir.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En el archivo fonts.json, que es el único archivo a través del cual se lee esta carpeta:

a fonts record, under content/assets/fonts

[
  {
    "id": "northern_reach:plain",
    "file": "plain.ttf",
    "format": "ttf",
    "sizes": [
      12,
      16,
      24
    ],
    "oversampling": 1,
    "covers": [
      "en"
    ],
    "fallback_font": "Segoe UI",
    "sha256": "613b1d24f9f8b0365a94f01214155af8e87ca72aa6633befd5e0ee05b3dc4122"
  }
]

images

Imágenes que trae un paquete, nombradas por id: íconos, retratos y hojas de sprites, cada una apuntando a un archivo dentro de su propia carpeta.

• Estado Listo para usar
• Carpeta content/assets/images
• Registros enrutados para el campo id
• Informe modding_image_report
• Si un reproductor te desinstala preserve_inert_reference. Un guardado nombra objetos y personas, nunca una imagen de uno de ellos, por lo que una imagen que deja de resolverse cuesta un dibujo y no una cosa. La referencia se conserva y se informa: reemplazarla con arte de otro paquete le mostraría al jugador algo que ningún autor eligió, y eliminar la identificación silenciosamente haría que el ícono faltante pareciera un defecto de diseño.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En el archivo images.json, que es el único archivo a través del cual se lee esta carpeta:

a images record, under content/assets/images

[
  {
    "id": "northern_reach:salt_pouch",
    "file": "salt_pouch.png",
    "format": "png"
  }
]

presentation_bindings

Qué recurso del paquete ocupa qué espacio y en qué tema: el ícono de un objeto, el sprite de una unidad o mosaico, el estandarte de una facción, tanto para el contenido del paquete como para el del juego base.

• Estado Listo para usar
• Carpeta content/presentation/bindings
• Registros enrutados para el campo id
• Informe nada suyo; modding_preflight_report se encarga de ello
• Si un reproductor te desinstala preserve_inert_reference. Un guardado nombra al sujeto -el objeto, la persona, la pieza- y nunca qué imagen lo vistió, por lo que un enlace que deja de resolverse cuesta un dibujo y no una cosa. La referencia se conserva y se informa: el tema vuelve al arte que ya tenía la construcción, que es la única respuesta que ningún autor tuvo que elegir.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado bindings.json, o el nombre .json que quieras dentro de esa carpeta:

a presentation_bindings record, under content/presentation/bindings

[
  {
    "op": "add",
    "id": "northern_reach:cloak_icon",
    "subject": "wool_cloak",
    "kind": "item",
    "slot": "icon",
    "cue": "northern_reach:cloak_plain",
    "alternative_key": "item_wool_cloak_icon_alt"
  },
  {
    "op": "add",
    "id": "northern_reach:cloak_icon_winter",
    "subject": "wool_cloak",
    "kind": "item",
    "slot": "icon",
    "cue": "northern_reach:cloak_snowy",
    "alternative_key": "item_wool_cloak_icon_alt",
    "when": {
      "season": {
        "is": "winter"
      }
    }
  }
]

screens

Diseños de pantalla: qué secciones encajan en qué panel de pantalla ya tiene el juego y en qué orden. Tiene piezas que esta compilación dibuja y no puede agregar ninguna: una nueva pantalla necesitaría widgets, fuentes de datos y controladores de clics, que en conjunto son un lenguaje de programación.

• Estado Listo para usar
• Carpeta content/ui/screens
• Registros enrutados para el campo id
• Informe modding_screen_report
• Si un reproductor te desinstala preserve_inert_reference. Nada en un rescate menciona una disposición. Decide cómo se dibuja una página mientras se carga el paquete, y la página vuelve al diseño que esta compilación lleva consigo cuando se va: cuesta un aspecto y nada que posea el jugador.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado screens.json, o el nombre .json que quieras dentro de esa carpeta:

a screens record, under content/ui/screens

[
  {
    "id": "northern_reach:character_sheet",
    "screen": "character_sheet",
    "panels": {
      "header": [
        "header"
      ],
      "left": [
        "vitals",
        "combat"
      ],
      "middle": [
        "attributes",
        "skills"
      ],
      "right": [
        "service",
        "weight",
        "background"
      ]
    }
  }
]

themes

Paletas de interfaz como fichas: colores, tamaños y espacios con nombre, con pares cuyo contraste un jugador debe poder leer. Nunca una escena, guión o ruta de recursos.

• Estado Listo para usar
• Carpeta content/assets/themes
• Registros enrutados para el campo id
• Informe modding_theme_report
• Si un reproductor te desinstala preserve_inert_reference. Nada en un guardado nombra un tema. La interfaz vuelve a los colores del kit de herramientas cuando sale el paquete, que es la única paleta que cualquier autor ha tenido que elegir.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado themes.json, o el nombre .json que quieras dentro de esa carpeta:

a themes record, under content/assets/themes

[
  {
    "id": "northern_reach:dusk",
    "tokens": {
      "bg_deep": {
        "kind": "colour",
        "value": "#12131a"
      },
      "bg_panel": {
        "kind": "colour",
        "value": "#1b1c26"
      },
      "bg_panel_hi": {
        "kind": "colour",
        "value": "#262838"
      },
      "text": {
        "kind": "colour",
        "value": "#e8e2d0"
      },
      "text_bright": {
        "kind": "colour",
        "value": "#f4efe2"
      },
      "text_mute": {
        "kind": "colour",
        "value": "#6f6a80"
      },
      "border": {
        "kind": "colour",
        "value": "#7f6ab0"
      },
      "border_dark": {
        "kind": "colour",
        "value": "#14151c"
      },
      "border_soft": {
        "kind": "colour",
        "value": "#4a4560"
      },
      "danger": {
        "kind": "colour",
        "value": "#d4564b"
      },
      "success": {
        "kind": "colour",
        "value": "#7fc46a"
      },
      "warning": {
        "kind": "colour",
        "value": "#e0b13c"
      },
      "accent_player": {
        "kind": "colour",
        "value": "#6f97e8"
      },
      "accent_enemy": {
        "kind": "colour",
        "value": "#c94a4a"
      }
    },
    "contrast_pairs": [
      {
        "text": "#e8e2d0",
        "background": "#12131a"
      },
      {
        "text": "#f4efe2",
        "background": "#1b1c26"
      },
      {
        "text": "#e8e2d0",
        "background": "#262838"
      }
    ]
  }
]

¿Qué controla el jugador y qué observa?

3 familias: adaptive, input_bindings, settings.

adaptive

Perfiles que analizan cómo va un partido y sugieren un enfoque diferente. El resultado es un consejo y nunca un cambio: un perfil que pudiera actuar sería lo único que trae un paquete capaz de alterar una partida sin que el jugador o el invitado lo haya pedido, y en un diff quedaría exactamente como una tabla de ajustes. Las entradas son una lista publicada de agregados del juego, cada uno de los cuales es un recuento o promedio que el juego ya tiene sobre sí mismo.

• Estado Listo para usar
• Carpeta content/player/adaptive
• Registros enrutados para el campo id
• Informe modding_adaptive_report
• Si un reproductor te desinstala drop_optional_presentation. No guardar nombres de un perfil. Lo que ha tocado un perfil es un multiplicador recalculado por los mutadores activos cada vez que cambian, por lo que un paquete retirado deja de ser consultado y el juego vuelve exactamente a lo que el jugador había elegido. Nada se preserva, por lo tanto no hay nada que preservar.

Campos. Esta familia contiene más de un tipo de registro y cada tipo se compara con su propia lista. Un campo que esta tabla no nombra se rechaza junto con el registro.

Un registro con kind: adaptive_profile:

Un registro con kind: threshold_set:

En un archivo llamado adaptive.json, o el nombre .json que quieras dentro de esa carpeta:

a adaptive record, under content/player/adaptive

[
  {
    "kind": "adaptive_profile",
    "id": "northern_reach:hard_roads",
    "name_key": "ADAPTIVE_HARD_ROADS",
    "description_key": "ADAPTIVE_HARD_ROADS_BODY",
    "policy": "pace_encounters",
    "reads": [
      "battles_won_ratio",
      "days_survived",
      "party_size"
    ],
    "fallback_policy": "event_cadence",
    "confidence_floor_percent": 60,
    "sample_days": 14
  },
  {
    "kind": "threshold_set",
    "id": "northern_reach:hard_roads_lines",
    "profile": "northern_reach:hard_roads",
    "name_key": "ADAPTIVE_HARD_ROADS_LINES",
    "thresholds": [
      {
        "signal": "battles_won_ratio",
        "above": 80,
        "advise": "raise"
      },
      {
        "signal": "battles_won_ratio",
        "below": 35,
        "advise": "lower"
      },
      {
        "signal": "party_size",
        "below": 3,
        "advise": "lower"
      },
      {
        "signal": "days_survived",
        "above": 60,
        "advise": "hold"
      }
    ]
  }
]

input_bindings

Acciones propias de un paquete, con la clave que deseen. El jugador decide: una sugerencia que termina en una combinación que ya había asignado pierde, y la acción ocurre sin botón, porque un botón que silenciosamente hace otra cosa es peor que un botón que no hace nada.

• Estado Listo para usar
• Carpeta content/input
• Registros enrutados para el campo action_id
• Informe modding_input_report
• Si un reproductor te desinstala preserve_inert_reference. La reasignación de un jugador permanece almacenada bajo el ID de acción, por lo que al reinstalar el paquete se encuentra el botón donde lo colocaste. La acción en sí se elimina del mapa de comandos cuando el paquete sale, por lo que la pantalla de asignación nunca muestra algo que no responda a nada.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado bindings.json, o el nombre .json que quieras dentro de esa carpeta:

a input_bindings record, under content/input

[
  {
    "action_id": "northern_reach:call_scout",
    "label_key": "KEY_PACK_CALL_SCOUT",
    "context": "exploration",
    "suggested_keyboard": "f9"
  }
]

settings

Opciones que un jugador puede cambiar, declaradas en lugar de sorteadas. Un paquete dice cuál es la opción, qué valores puede tener y dónde reside el valor; el control lo construye el huésped. Nada que cruce este límite es un control o un script, y esa es la única razón por la que un menú de configuración puede mostrar las opciones de un extraño sin ejecutar su código.

• Estado Listo para usar
• Carpeta content/settings
• Registros enrutados para el campo key
• Informe modding_settings_report
• Si un reproductor te desinstala preserve_inert_reference. Un valor almacenado permanece bajo su clave, por lo que al reinstalar el paquete, el jugador elige dónde lo dejó. Lo que el paquete deja tras de sí es una línea en un perfil que nadie lee: no cuesta nada y preserva una elección que ha hecho el jugador.

Campos. Un campo al que esta tabla no nombra se rechaza con el registro.

En un archivo llamado settings.json, o el nombre .json que quieras dentro de esa carpeta:

a settings record, under content/settings

[
  {
    "key": "northern_reach:patrol_density",
    "type": "int",
    "default": 3,
    "minimum": 1,
    "maximum": 9,
    "scope": "campaign",
    "label_key": "OPTION_PACK_PATROL_DENSITY",
    "help_key": "OPTION_PACK_PATROL_DENSITY_HELP"
  },
  {
    "key": "northern_reach:show_road_names",
    "type": "bool",
    "default": true,
    "scope": "presentation",
    "label_key": "OPTION_PACK_SHOW_ROAD_NAMES"
  }
]

Atajos de consola

Estos son un atajo, no un paso. Todo lo que aparece a continuación tiene un lugar en la pantalla Mods, que es donde va la ruta normal y donde verá cualquiera que haya descargado su paquete. La consola es más rápida cuando estás iterando y ya está abierta, y solo existe en una versión de depuración: una copia publicada del juego no tiene consola, por lo que nada de lo que un autor de paquete necesita puede vivir aquí solo.

Comienza en modding_manifest_report: ¿el juego ve tu paquete y en qué estado? - luego modding_preflight_report para obtener un veredicto único sobre todo lo instalado. Luego el informe de la familia individual.

modding_reload vuelve a leer tus archivos sin reiniciar. Edita, cambia de ventana, escribe el comando y mira. Reconstruye lo que no está retenido — bindings, efectos e imágenes — y nombra cada familia que dejó intacta, porque una partida se apoya en los registros que una partida guardada puede nombrar:

what the game prints back

HELD BY THE RUN items: edited files are read on the next load

modding_reload all vuelve a leer todo y muestra una pantalla de presentación sin ningún juego en progreso. modding_condition_report imprime lo que el juego ahora puede responder para un when y lo que no puede.

Herramientas sin conexión

Estas herramientas son para autores y automatización de publicaciones. Se incluyen en el checkout público de Bonemark; los jugadores que instalan un mod publicado no necesitan Python ni Godot. Si escribes un mod, clona la versión correspondiente desde github.com/tallowgames/Bonemark, mantén tu paquete de trabajo fuera de la carpeta mods del jugador y ejecuta los comandos siguientes desde ese checkout. El juego sigue siendo la autoridad final del runtime.

Python 3.10 o posterior; Godot solo para el carril de ejecución. Mantenga su paquete fuera de la carpeta mods del reproductor e intente copiarlo.

a command line

python tools/modding/new_mod.py --list
python tools/modding/new_mod.py --id my_mod --family goods --family items

Escribe un paquete que pasa la validación incluso antes de que hayas escrito algo: un mod.json precompilado, un registro de trabajo para cada familia que solicitaste y un README con los siguientes dos comandos. Los registros provienen de dispositivos que la construcción ya verifica para esas familias, por lo que un motor de arranque que deja de funcionar provoca la misma verificación que hace que el dispositivo falle, en lugar de pudrirse dentro de un modelo. Se niega a escribir en una carpeta llamada mods.

a command line

python tools/quality/validate_mod_data.py --root "<mod-root>"
python tools/quality/validate_mod_data.py --strict --root "<mod-root>"

Verifique mod.json, carpetas familiares, identificaciones, esquemas, referencias, límites y cargas útiles bloqueadas. --strict convierte las advertencias en fallas.

Comparar la superficie de modificación con la versión

Cuando el juego cambie, compare la instantánea de la superficie archivada antes de actualizar un paquete. Contiene un resumen más campos y operaciones para cada familia pública, por lo que el resultado indica qué familia cambió y por qué:

a command line

python tools/quality/modding_surface_contract.py --json
python tools/quality/modding_surface_contract.py --before "<previous-build>/game/games/bonemark/modding/data/mod_surface_contract.json" --json

La diferencia es unchanged, additive o breaking. Los motivos del fallo son explícitos: field_removed, required_added, type_changed, default_changed, constraint_changed, operation_removed y root_changed, format_changed, id_field_changed, catalogue_changed, family_removed y contract_major_changed_without_new_id. Nombre de modificación compatible field_added, required_removed, operation_added o family_added. El comando sin --before también verifica la línea base almacenada. Si la superficie actual se ha movido, la auditoría falla hasta que un mantenedor examina los resúmenes exactos de antes y después en tools/quality/modding_surface_contract_changes.json; un cambio importante también debe registrar cada motivo, la decisión, la nota de migración y el revisor. La promoción de una instantánea revisada intencionalmente es explícita:

a command line

python tools/quality/modding_surface_contract.py --write-baseline

Esta es una verificación de lanzamiento/mantenedor; Los autores de mods solo necesitan la comparación --before, y los jugadores que instalan un paquete publicado no necesitan ejecutarlo.

a command line

python tools/modding/mod_test_host.py --root "<mod-root>" --repo-root "<framework-root>" --json

Lee el manifiesto, las dependencias, la compatibilidad y el orden de carga sin iniciar Godot y sin ejecutar ninguno de sus paquetes.

Nunca abre un archivo de contenido. Esta es la división del trabajo: el host responde estos paquetes se cargarán juntos, el validador responde este registro es correcto - pero eso significa que un paquete que el validador rechaza aún puede componerse limpiamente aquí. Medidos en catorce paquetes deliberadamente rotos, los dos no están de acuerdo en cada rechazo: el host presenta los catorce refused vacíos, incluido uno que lleva scripts/payload.sh que solo el validador encuentra. Marcar no es lo mismo que instalar de forma segura. Haga ambas cosas antes de publicar. Repita --root cuando el conjunto de prueba esté dividido en carpetas; Luego, el anfitrión compone el conjunto completo en un plan determinista.

a command line

python tools/modding/mod_test_matrix.py --repo-root "<framework-root>" --root "<mod-root>" --godot "<godot-exe>" --require-runtime --report "mod_test_matrix.json"

Ejecuta el validador, el host de prueba, el dispositivo de cada familia listo para usar y el carril de tiempo de ejecución de Godot. Elimina --require-runtime si no tienes Godot; el informe dirá entonces que la prueba de tiempo de ejecución se omitió, no se aprobó.

Para un conjunto compuesto, repita la opción:

a command line

python tools/modding/mod_test_matrix.py --repo-root "<framework-root>" --root "<mod-a>" --root "<mod-b>" --godot "<godot-exe>" --require-runtime

El informe mantiene un resultado por raíz y agrega composed_set para el conjunto completo. Este bloque es donde se demuestran los conflictos de paquetes, los ID duplicados y los errores de dependencia. Un paquete limpio por sí solo no es prueba de que el conjunto se cargará junto. El informe también incluye surface_contract, la versión actual del contrato familiar y el resumen de auditoría, por lo que una matriz no puede estar en verde mientras la instantánea de compatibilidad del repositorio esté desactualizada. Con --require-runtime, lea runtime.reachability.loaded_families y runtime.reachability.reachable_families. El primero dice que se han cargado los registros compuestos; el segundo sólo se llena cuando un camino real dirigido a los jugadores de la investigación Godot los ha consumido. runtime.reachability.observations mantiene el paquete, la familia, el ID de registro, la ruta y el estado de cada fila, mientras que unreachable enumera las filas cargadas que aún no tienen ninguna ruta. Una familia puede ser validada y puesta en escena pero aún así estar ausente de reachable_families: no es lo mismo "cargado" que "un jugador puede alcanzarlo".

Cada comando anterior se compara con las herramientas mismas a medida que se crea esta página: el script debe existir y cada opción debe ser de aceptación.

Cada código de diagnóstico

No lea esta lista en orden. Está aquí para que un código que encuentre en un informe sea una pregunta con una respuesta: una pequeña palabra en minúscula como asset_missing. Pegue uno en el cuadro de búsqueda en la parte superior de esta página.

Algunos códigos pertenecen a mecanismos a los que un paquete aún no puede llegar. Yo estoy aquí igual: un código que no puedes activar cuesta una línea que nunca leerás, y un código que falta cuesta una noche.