Modding

Dov'è la cartella dei mod

Apri Mod dal menu principale. Il percorso è scritto in cima alla schermata, con accanto un pulsante che apre la cartella nel tuo gestore di file.

Sta accanto ai tuoi salvataggi, ed è la stessa cartella sia che tu stia installando il mod di qualcun altro sia che ne stia scrivendo uno tuo. Niente viene letto mentre il gioco è in esecuzione, quindi non importa se il gioco è aperto mentre sposti i file.

Installarne uno

Un mod è una cartella con mod.json in cima. La maggior parte dei download è quella cartella dentro uno zip.

Un mod che hai copiato dentro resta spento finché non dici tu. Il gioco rifiuta gli eseguibili senza discutere, ma un pacchetto di dati può comunque cambiare prezzi, oggetti e persone in modi che non hai chiesto, e uno che spunta da solo dentro una partita già avviata è un problema che nessuno vuole diagnosticare. Perciò il gioco chiede. È un riavvio in più la prima volta, e mai più per quel pacchetto.

Non c'è un launcher, non c'è un file di load order da modificare e non c'è niente da registrare. L'ordine di caricamento è un numero dentro ogni pacchetto, scelto dal suo autore.

Inizia una nuova partita per un pacchetto che aggiunge persone, luoghi o quest. Un salvataggio già in corso conserva il mondo con cui è stato creato. I pacchetti che cambiano solo numeri, immagini o colori sono visibili in una partita già iniziata. I file audio e dei font vengono validati, ma nessuna superficie di pacchetto in esecuzione li consuma ancora.

Si è caricato?

Mod, nel menu principale. Ogni pacchetto trovato sta su una riga, con uno stato in una parola: caricato, disattivato, non valido, in conflitto, richiede un altro mod, ignorato.

Un mod può anche spegnersi da solo, e dice perché. L'interruttore che hai messo vale per il pacchetto su cui l'hai messo, non per il suo nome nella cartella. Gli id dei mod li scelgono gli autori e non c'è niente che li coordini, quindi due mod senza rapporto fra loro chiamati entrambi northern_reach sono un incidente ordinario — e senza questo il secondo erediterebbe l'interruttore del primo. Se il mod sotto un id non è quello che avevi acceso, la riga lo dice: questo non è il mod che hai acceso. Aggiornare un mod sul posto conserva il tuo interruttore; cancellarlo e copiarne un altro no.

Se sei l'autore di un mod e vedi quella riga sul tuo pacchetto, hai una collisione di id con il mod di qualcun altro. Scegli un id meno ovvio.

Due di quelle parole riguardano un riavvio che devi tu, non il pacchetto. Attivo — riavvia per caricare vuol dire che l'hai acceso e nessuno l'ha ancora letto; Spento — riavvia per scaricare vuol dire il contrario, e il suo contenuto è ancora nel gioco finché non riavvii. Sono parole separate di proposito: una schermata che dicesse «Caricato» nel momento in cui giri un interruttore ti manderebbe a cercare nel mondo qualcosa che non c'è ancora.

Quando lo stato non è «caricato», la riga sotto dice perché, nella lingua in cui stai giocando e senza identificatori che non hai scritto tu: quale file il gioco si rifiuta di eseguire, quale pacchetto manca, quale versione vuole. Sotto, che cosa ha fatto il contenuto del pacchetto: quante voci sono entrate, quante sono state rifiutate. Mostra i dettagli apre il resto, cioè gli id e la regola esatta che ogni record rifiutato ha infranto.

Due righe condividono una parola di proposito: Richiede un altro mod è lo stesso problema per un giocatore, sia che il pacchetto che serve manchi sia che sia della versione sbagliata, e la riga sotto dice quale dei due. E quando due pacchetti reclamano lo stesso record, quello con load_order più alto scrive per ultimo e vince — ma una presa di possesso che nessuno ha dichiarato è un errore, non una nota. Entrambe le righe vengono segnalate e la riga di chi perde nomina chi vince, e il vincitore viene comunque calcolato invece di essere lasciato al caso: un rifiuto non deve essere anche un lancio di moneta. Quando due mod vogliono la stessa cosa spiega come dichiararne una di proposito.

«Caricato» non vuol ancora dire che lo puoi vedere nel mondo. Per quello, leggi i conteggi sotto la riga, e Ora trovalo nel gioco dice dove spunta ogni tipo di cosa.

I conteggi tornano sempre. Letti è applicati, più rifiutati, più sostituiti da un altro mod, più in attesa delle proprie condizioni — e gli ultimi due sono nominati invece di restare un buco. Un record che un altro pacchetto scrive per ultimo non è rifiutato, perché non ha niente che non va, e non è nemmeno applicato, perché non è quello che il gioco ha tenuto. È la differenza fra leggere una riga e passare una serata a cercare un bug in un file che non ne ha. Mostra i dettagli dice quale record, e quale pacchetto ce l'ha adesso.

Un numero sta accanto a quella somma invece che dentro: i file che nessuno ha letto. Un file la cui famiglia non è in content_types non è mai stato aperto, quindi non c'è nessun record da mettere in conto e non c'è modo di sapere quanti ce ne siano dentro. È un conteggio di file, non di record, ed è esattamente per questo che non può essere un sesto termine: la somma parte da letti, e questi non sono mai stati letti.

Prima di chiedere aiuto a qualcuno

Apri Mod e premi Copia il resoconto. Incolla tutto quanto nel tuo messaggio, poi di' che cosa ti aspettavi.

Un testo semplice, pronto per un forum, un messaggio su Discord o una segnalazione di bug: la build su cui sei, la cartella dei mod, ogni pacchetto con la sua versione, il suo load order e il suo stato, la ragione dietro ogni rifiuto, i conteggi per ogni tipo di contenuto, e quale pacchetto ha vinto ogni scontro.

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

Nove volte su dieci la risposta è nel blocco e nessuno deve farti prima una sola domanda. Non legge niente al di fuori della cartella dei mod, non cambia niente e non contiene informazioni personali.

È in inglese anche quando stai giocando in un'altra lingua. È voluto: chi ti aiuta potrebbe non leggere la tua, e ogni fatto che contiene — id, versioni, conteggi — è comunque uguale in tutte le lingue.

Toglierne uno

Cancella la sua cartella e riavvia. La disinstallazione è tutta qui.

Niente di tuo viene cancellato insieme a lui. Un salvataggio conserva gli id che non riesce più a risolvere, li segnala, e restituisce le cose se il pacchetto viene reinstallato. Una sessione che non riesce a capire un salvataggio non lo sovrascrive nemmeno: il file originale resta esattamente com'era, ed è la differenza fra un pomeriggio perso e una partita persa. Salvataggi è il resoconto completo.

Se il gioco non parte più dopo che hai installato qualcosa, la via d'uscita non ha bisogno del gioco. Apri la cartella dei mod e sposta fuori l'ultima cosa che hai aggiunto. I pacchetti si leggono solo da quella cartella, quindi una cartella che non c'è è un pacchetto che non si può caricare, e l'avvio successivo è quello di prima. Non ti servono un menu, una console o un avvio funzionante per farlo.

Anche il gioco ci prova da solo — Se il gioco non parte è un numero limitato di tentativi e poi una via di rientro senza nessun pacchetto caricato — ma quella è la cintura, e spostare la cartella sono le bretelle.

Che cosa puoi costruire oggi

Ora, senza chiedere a nessuno: merci e mercanti che le vendono, oggetti, persone e dove si trovano, edifici e servizi al loro interno, luoghi sulla mappa, conversazioni, scene, piani delle quest, mappe disegnate in Tiled, immagini e colori, e tutte le loro parole in sette lingue. I file audio e dei font vengono controllati e letti, ma le loro superfici di pacchetto non li consumano ancora; la tabella dello stato lo dice chiaramente invece di chiamarli pronti. Tutte le famiglie sono l'elenco misurato, e lo stato deriva dalla build, non da una promessa.

Non ancora, e Cosa non puoi ancora fare spiega ogni caso: la famiglia quests, l'audio dei pacchetti, i font dei pacchetti, le total conversion impacchettate e un pacchetto che sia una funzionalità invece di contenuto.

Mai, per scelta di progetto: codice. Niente script, niente scene, niente file di risorsa, niente che il gioco debba eseguire. È questo che rende sicuro scaricare il mod di uno sconosciuto, e non è una fase che il progetto sta attraversando. Che cosa un mod non potrà mai fare.

Tempo per la prima cosa che puoi vedere nel gioco: circa dieci minuti, per lo più spesi a trovare la cartella. Un mod in dieci minuti è tutto il percorso, e la spada che c'è alla fine è vera.

Che cosa non puoi ancora fare, e perché

È scritto qui, vicino all'inizio, invece di lasciarlo scoprire alla fine. Queste sono le cose che la build valida senza inserirle per ora in una superficie di pacchetto rivolta al giocatore, oltre a ciò che non è affatto contenuto di un pacchetto.

Una meccanica che il gioco non ha mai avuto è la quarta riga con un altro cappello. Una spada che colpisce più forte è un numero ed è tua; un'arma che spara un raggio ha bisogno delle regole del raggio, e le regole sono codice che qualcuno scrive e prova.

Che cos'è un mod

Una cartella di file di testo. Non scrivi codice. Scrivi elenchi di cose che vuoi nel gioco, e il gioco li legge quando parte.

L'unica regola da cui discende tutto il resto: puoi aggiungere e cambiare dati. Non puoi far eseguire codice al gioco. È questo che rende sicuro scaricare un mod: il peggio che il mod di uno sconosciuto può fare è metterti in gioco una spada sciocca.

34 famiglie sono pronte all'uso oggi, tra cui items, buildings, pois, npc_definitions, vendor_inventories, quest_plans, caravans e perks. Tutte le famiglie sono la tabella completa con ciò che fa ciascuna; Le famiglie, una per una mostra per ognuna i campi e un record da copiare.

Scegli la tua strada

Questo è l'indice di tutta la guida — dove ogni argomento è scritto, che tu lo stia costruendo oggi o no. In cima alla Parte 3 c'è un secondo indice, più corto: quello è i sei tutorial, nell'ordine in cui si appoggiano l'uno sull'altro. Se sei qui per fare qualcosa e non per cercare qualcosa, vai dritto lì.

Oppure per la cosa che hai in testa. Questa guida è disposta nell'ordine in cui il lavoro succede — manifesto, poi convalida, poi contenuto, poi resoconti — che è l'ordine che sceglierebbe chi il sistema lo conosce già. Chi non lo conosce sta pensando voglio aggiungere un mercante, e cerca la parola mercante:

Che cosa ti serve

Un editor che colora il JSON ti mostra una virgola mancante mentre ci stai ancora guardando, invece di sentirti dire dopo dal gioco che il file era illeggibile.

Python e la console sono facoltativi. Il gioco è sufficiente: inserisci il pacchetto, riavvia e apri Mods, che indica ogni record rifiutato e il motivo. Il checkout per gli autori è pubblico. Chi vuole iterare più velocemente o automatizzare le pubblicazioni può clonare il checkout pubblico di Bonemark ed eseguire gli strumenti offline in Strumenti offline; ai giocatori che installano un pacchetto pubblicato non servono Python né Godot. Lo stesso checkout pubblico contiene il validator e le dichiarazioni del runtime, quindi le due sezioni descrivono una sola catena di strumenti. Gli strumenti usano le stesse dichiarazioni del gioco — gli schemi dei record e il confine di sicurezza hanno una sola fonte ciascuno — e danno quindi una risposta prima, mai diversa. Una console di debug è utile per ispezionare un pacchetto caricato, ma non serve per scriverne uno.

Parti da quello che vuoi fare

Tutto quello che sta sotto questa riga è disposto nell'ordine in cui succede il lavoro: manifesto, poi file, poi famiglie, poi resoconti. È l'ordine giusto per cercare qualcosa e quello sbagliato per cominciare, perché nessuno comincia da un manifesto. Si comincia da voglio un mercante.

Quindi: scegli la frase che assomiglia a quello che stai cercando di fare.

I sei tutorial sono un pacchetto solo, costruito un pezzo alla volta: una candela di cera d'api, il fascio che un giocatore porta con sé, la ceraiola che la vende, la porta della sua bottega, la fossa dietro la conceria da cui viene il sego, e infine una modifica alla candela che il gioco aveva già. Falli in ordine e finisci con un mod che qualcuno potrebbe scaricare. Prendine uno in mezzo e funziona da solo.

Dove sono i numeri del gioco

Ogni tutorial qui dà il prezzo a una cosa nuova confrontandola con qualcosa che il gioco vende già, perché un numero senza niente accanto è un'ipotesi, e un'ipotesi in un'economia che commercia fra città non resta dove l'hai messa.

Non puoi aprire i file del gioco. I suoi record sono risorse Godot dentro la build impacchettata — un formato diverso dal JSON che scrivi tu, con category = 1 dove il tuo file dice "MANUFACTURED". Non c'è nessuna cartella da cui copiare, e spacchettarne una non è un flusso di lavoro che qualcuno debba documentare.

Non ne hai bisogno. Il catalogo pubblica il contenuto del gioco, generato da quegli stessi record a ogni build: 270 oggetti con la loro categoria, il peso, il valore in monete e la dimensione della pila, 49 armi, 42 pezzi d'armatura, 37 luoghi. È il riferimento a cui questa guida si àncora, non può divergere dal gioco, e il nome del campo è stampato accanto a ogni riga.

Una dozzina di valori da conoscere prima di dare un prezzo a qualcosa:

Se la tua cosa nuova costa più di un'armatura di piastre, qualcosa è andato storto e il gioco non te lo dirà: diventerà in silenzio il carico più redditizio del mondo e ogni carovana lo porterà.

Una merce da vendere

Avrai una merce che l'economia sa come prezzare, ancorata alla candela che il gioco vende già, pronta perché un mercante la tenga.

Schermata: non ancora scattata. Questo spazio resta vuoto finché non ce ne sarà una vera: un disegno di come potrebbe apparire sarebbe l'unica cosa non vera della pagina.

Leggi prima: Che cos'è un mod · Un mod in dieci minuti · Nomi e id

Copia da: la cartella chiamata chandlery, che è già nella tua cartella dei mod. Il gioco ce la mette la prima volta che parte, spenta, ed è il risultato finito di questi sei tutorial: ogni record qui sotto è lì dentro. È anche il pacchetto che la corsia di prova del repository fa girare contro il caricatore, quindi qui non c'è nessun record che il gioco rifiuterebbe. Accendila per vederla funzionare, oppure copia la cartella, rinominala e falla tua.

Dove vanno i file:

where the files go

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

Parti dalla candela che il gioco ha già. Si chiama candle, costa 3, pesa 0,5, è MANUFACTURED e PRESERVED, e la fa l'apotecario. La tua è lo stesso oggetto fatto di cera migliore, quindi conserva tutte quelle risposte e ne cambia due.

Prima 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
}

Poi 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"]
  }
]

Fatto — ora trovala nel gioco. Riavvia, apri Mod, e la riga sotto la tua dice 1 entry added. È tutto quello che fa una merce da sola: ha un prezzo, è commerciabile, e non sta sul bancone di nessuno, perché ancora nessuno la tiene. Non è un fallimento ed è la cosa che confonde tutti una volta. Prosegui con Un mercante che lo tiene.

Se non compare: Non è comparso niente ha le sei ragioni in ordine. La più comune di gran lunga è content_types — una famiglia che manca da quella riga vuol dire che la cartella non viene mai aperta, qualunque cosa contenga. Poi Prima di chiedere aiuto a qualcuno, che è un pulsante solo.

Un oggetto da portare

Avrai la cosa che un giocatore raccoglie, impila nello zaino e rivende, accoppiata alla merce che hai appena scritto.

Schermata: non ancora scattata.

Leggi prima: Una merce da vendere · Nomi e id

Copia da: chandlery/content/inventory/items/items.json nella tua cartella dei mod.

Dove vanno i file:

where the files go

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

Una merce e un oggetto sono due metà della stessa cosa. La merce è il punto di vista dell'economia: che cosa produce una città, che cosa trasporta una carovana, quanto vale. L'oggetto è il punto di vista del giocatore: che cosa sta nello zaino, che cosa si impila, che cosa espone una bottega. Il grano ha una merce e nessun oggetto, perché nessuno si porta in giro un sacco di grano. Le candele hanno entrambi.

Aggiungi "items" a content_types in mod.json, poi scrivi 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"]
  }
]

Fatto — ora trovalo nel gioco. Un oggetto che nessuno consegna è caricato e raggiungibile da niente. In una build di debug item chandlery:beeswax_candle_bundle te ne mette subito uno nello zaino, ed è la prova più rapida che si è caricato — ma quel comando non esiste nel gioco che la gente scarica, quindi è una scorciatoia per te e mai la risposta per un giocatore. La risposta vera è il tutorial successivo.

Se non compare: Non è comparso niente, poi Prima di chiedere aiuto a qualcuno.

Un mercante che lo tiene

Avrai una donna con un nome in piedi a Old Seat con un banco, scorte che si rifanno ogni due giorni, e le tue candele sul bancone.

Schermata: non ancora scattata.

Leggi prima: Un oggetto da portare · Ora trovalo nel gioco

Copia da: chandlery/content/narrative/npcs/npcs.json e chandlery/content/world/vendor_inventories/vendors.json.

Dove vanno i file:

where the files go

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

Questo è quello in cui due famiglie devono mettersi d'accordo. La persona porta l'id del banco, il banco porta l'id della persona, e ogni riga del banco porta l'id di un oggetto. Tre id, e ognuno va scritto esattamente come l'hai scritto nell'altro file. È l'errore che costa una serata, e la schermata Mod lo nomina: una riga che punta a un id che nessuno fornisce viene elencata come richiede un altro mod che non è installato.

Aggiungi "npc_definitions" e "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
      }
    ]
  }
]

Fatto — ora trovalo nel gioco. Riavvia, viaggia fino a Old Seat, trova Hesta, apri la schermata di commercio. Se il banco è vuoto, non si è ancora rifornito: è restock_days, non un bug. La catena si può rompere in tre modi e tutti e tre stanno sulla schermata Mod: la merce che nessuno tiene, il banco che punta a un id di oggetto che non esiste, la persona che punta a un id di banco che non esiste.

Può anche parlare. Un dialogue_graph il cui speaker è il suo id le dà delle battute quando un giocatore le clicca sopra, e il tuo pacchetto non deve ridefinire niente che il gioco già possiede per ottenerle — vedi Conversazioni tue. Un file locales le dà tutto questo in sette lingue.

Se non compare: controlla prima i tre id l'uno contro l'altro, poi Non è comparso niente, poi Prima di chiedere aiuto a qualcuno.

Il servizio di un edificio

Avrai una porta in un insediamento con la tua etichetta e il tuo colore sopra, che si apre su un interno che il gioco ha già.

Schermata: non ancora scattata.

Leggi prima: Un mercante che lo tiene · Che cosa un mod non potrà mai fare

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

Dove vanno i file:

where the files go

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

Stai ricombinando, non costruendo. Un record buildings aggiunge un servizio nuovo con un'etichetta, un colore della porta e un ruolo di routine, e può riusare un interno che il gioco ha già nominandolo. Non può portare un interno. Un interno è una scena, una scena è codice, e un pacchetto che nomina un percorso res:// o un .tscn viene rifiutato prima ancora che questo record venga letto. Non è un buco in attesa di essere riempito: è la linea che rende sicuro installare il mod di uno sconosciuto.

a buildings record

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

Fatto — ora trovalo nel gioco. Riavvia ed entra in un insediamento che ha il tuo servizio. Un record senza settlement è caricato e collocato da nessuna parte, il che è identico a un record fallito: la schermata Mod dirà 1 entry added e tu non troverai niente. Leggi la riga prima di cercare la porta.

Se non compare: Non è comparso niente · Prima di chiedere aiuto a qualcuno.

Un luogo sulla mappa

Avrai un punto sulla mappa del mondo in cui un giocatore può imbattersi, con una descrizione sua e un suo effetto sull'umore della compagnia.

Schermata: non ancora scattata.

Leggi prima: Il servizio di un edificio · Ora trovalo nel gioco

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

Dove vanno i file:

where the files go

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

Le coordinate sono assolute e il mondo viene generato attorno a luoghi creati dagli autori. La mappa misura 61 440 × 34 560 pixel del mondo e Old Seat è esattamente al centro, (30720, 17280), in ogni partita. Le città e i villaggi creati dagli autori conservano nomi e posizioni. Il seed cambia il terreno e i biomi intorno a loro, la penuria dell'anno, l'assetto politico e le strade che vale la pena percorrere. Un punto resta quindi reale e stabile; ciò che gli sta accanto cambia a ogni partita. Due modi onesti di usarla: ancora un luogo d'interesse vicino a un insediamento creato dagli autori, così un giocatore ci passerà; oppure scegli il vuoto, perché una fossa di rendering che nessuno visita da anni deve essere da nessuna parte in particolare.

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
  }
]

Fatto — ora trovalo nel gioco. Vacci. Non esiste nessun comando di teletrasporto, né in una build di debug né fuori, quindi scegli coordinate fin dove sei disposto a camminare mentre provi.

Se non compare: probabilmente sei fuori dal discovery_radius, oppure la posizione è in un punto in cui il seme della partita ha messo un oceano. Non è comparso niente.

Cambiare quello che c'è già

Avrai cambiato un record che il gioco portava con sé — e l'avrai dichiarato, così il cambiamento è visibile al giocatore e a ogni altro mod.

Schermata: non ancora scattata.

Leggi prima: Cambiare quello che il gioco ha già · Quando due mod vogliono la stessa cosa

Copia da: chandlery/content/economy/goods/goods.json, che nello stesso file aggiunge un record e ne corregge uno del gioco.

Dove vanno i file: in nessun posto nuovo. Una modifica a qualcosa che il gioco ha già vive nella stessa cartella di famiglia in cui vivono i tuoi record: è il file a dire quale record intende e che cosa gli sta facendo.

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

Due regole prima del file. Una modifica al record di qualcun altro va nominata in overrides dentro mod.json — un record che atterra su un id che non hai dichiarato viene rifiutato, così niente può riscrivere di nascosto qualcosa che il giocatore non ha accettato. E patch, che cambia un campo e lascia stare il resto, richiede "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" }
    ]
  }
]

Fatto — ora trovalo nel gioco. La schermata Mod nomina il record di cui ti sei impossessato. Lo fa anche la schermata dell'altro autore, se c'è: quando due pacchetti scrivono lo stesso id, la riga di chi perde adesso dice replaced: candle — 'chandlery' writes it last, invece di mostrare in silenzio una voce in meno di quelle che aveva scritto. Chi ha il load_order più alto scrive per ultimo e vince.

Vincere non è la stessa cosa che avere il permesso. Due pacchetti che si impossessano di un record senza che nessuno dei due nomini l'altro in supersedes vengono segnalati come undeclared_collision e la composizione non è a posto: il validatore offline dice la stessa cosa e rifiuta:

typed into the debug console

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

Il vincitore viene comunque calcolato, perché un rifiuto non deve essere anche un lancio di moneta, ma due autori che lo volevano entrambi devono dirlo. Quando due mod vogliono la stessa cosa è quella conversazione.

Se non compare: la causa solita è overrides — l'id deve stare in quell'elenco, scritto esattamente, altrimenti il record viene rifiutato invece che applicato. Quando due mod vogliono la stessa cosa · Non è comparso niente.

Un mod in dieci minuti

1. Crea una cartella nella cartella dei mod, con il nome in minuscolo e trattini bassi: northern_reach. Tutto succede lì dentro.

2. Scrivi mod.json in cima:

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 deve coincidere con il nome della cartella. content_types elenca le famiglie che porti — una famiglia che manca da quella riga non viene mai letta, qualunque cosa ci sia nella cartella.

3. Crea le cartelle content/inventory/items e mettici dentro blades.json:

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
  }
]

Le parentesi quadre sono un elenco: aggiungi quante spade vuoi, separate da virgole. Ogni file .json in una cartella di famiglia viene letto, quindi dividili come preferisci.

240 non è un numero scelto per fare colpo. In questo gioco le armi a una mano vanno da 50 a 300, quindi una lama di brina a 240 è una spada cara e non una spada leggendaria, e un giocatore se la può permettere più o meno quando potrebbe permettersi quelle buone che il fabbro vende già. Dove sono i numeri del gioco è la tabella da guardare prima di scegliere qualunque numero; un prezzo senza niente accanto è un'ipotesi, e in un'economia che commercia fra città un'ipotesi non resta dove l'hai messa.

4. Avvia il gioco e apri Mod dal menu principale. Il tuo pacchetto riceve esattamente uno stato, e Si è caricato? li ha tutti e sei.

5. Leggi la riga sotto per sapere che cosa è stato letto, applicato e rifiutato, con la ragione di ogni rifiuto. Mostra i dettagli ha gli id.

6. La tua spada è nel gioco. Tutto quello che viene dopo è altro dello stesso.

Ora trovalo nel gioco

Il resoconto dice applied. Vuol dire che il record è caricato, e non è la stessa cosa che poterci camminare davanti. È qui che ogni guida si ferma e ogni autore comincia a tirare a indovinare.

settlement_id indica un luogo creato dagli autori. Gli id degli insediamenti sono creati dagli autori e stabili: Durnwall, Thorngate, Valdmere, Grentham e i dodici villaggi possono essere tutti nominati. Il seed cambia il terreno e i biomi intorno a loro, la penuria dell'anno e l'assetto politico, non l'id. Se vuoi che una persona incontri sicuramente il giocatore, usa un id di insediamento creato dagli autori e mantieni il nome nei dati locali del tuo pacchetto.

Le coordinate sono assolute e il mondo viene generato attorno a luoghi creati dagli autori. La mappa misura 61 440 × 34 560 pixel del mondo e Old Seat è esattamente al centro, (30720, 17280), in ogni partita. Le città e i villaggi creati dagli autori conservano nomi e posizioni. Il seed cambia il terreno e i biomi intorno a loro, la penuria dell'anno, l'assetto politico e le strade che vale la pena percorrere. Perciò una world_position di (6000, 2200) è un punto reale e stabile nel lontano nord-ovest della mappa, mentre ciò che gli sta vicino cambia a ogni partita: può essere una strada, una foresta o il nulla. Due modi onesti di usarla:

• Ancora al centro. Un punto d'interesse a qualche migliaio di pixel da (30720, 17280) è vicino a Old Seat in ogni partita, quindi è un posto che un giocatore troverà.
• Intendi il vuoto. Una rovina davanti a cui nessuno passa da cent'anni deve stare in un posto qualunque. Le coordinate assolute sono esattamente giuste per questo, e sarà il seme a decidere che vicini avrà.

I comandi di console che fanno risparmiare più tempo. day [n] e hour [n] fanno avanzare il tempo, ed è così che vedi un rifornimento senza viverlo. item <id> [count] e gold <amount> ti mettono le cose in mano. flag, quest_start e faction_rep muovono lo stato che una condizione potrebbe stare aspettando. Non c'è nessun comando di teletrasporto: per raggiungere un posto, viaggiaci.

mod.json, campo per campo

Una dipendenza può essere un oggetto invece di un nome: {"id": "some_mod", "version": "", "optional": true}.

Un valore che nomina un altro pacchetto è un riferimento fra mod, e il riferimento deve essere una dipendenza dichiarata. Se quella dipendenza è facoltativa, dài al campo un fallback, altrimenti il record viene saltato quando la dipendenza è assente:

a goods record

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

Dove va ciascun file

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

Nomi e id

Un id è lettere minuscole, cifre e trattini bassi, e nient'altro. frost_blade, non Frost Blade, non frost-blade e non frost.blade. Non porta nemmeno un separatore suo, perché un separatore dentro un id è la cartella che trapela nel nome: sposta il file e l'id non concorda più con il disco. I : qui sopra sono l'unica eccezione, ed entrambe le metà rispettano la regola.

La parte prima dei due punti è l'id del tuo pacchetto. È così che due mod possono aggiungere entrambi una Frost Blade senza scontrarsi.

Parole che un giocatore legge

Il testo scritto dentro un record è testo in una sola lingua. Punta invece a una chiave:

a locale CSV

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

Le chiavi sono minuscole, unite da punti, con lo spazio dei nomi come gli id. Porta le parole nella famiglia locales — un .csv sotto content/locale con una colonna key e una colonna per lingua. Le famiglie, una per una ha la forma esatta.

Scrivi accanto alla chiave anche il display_name semplice. Un record che ha solo una frase va riscritto a mano il giorno in cui lo traduci, e per allora ce ne saranno quattrocento.

I due modi di sbagliare questa cosa falliscono in modi molto diversi, e solo uno dei due te lo dice. Una chiave a cui non risponde niente compare come la chiave stessa — northern_reach.item.frost_blade.name, sullo schermo, deliberatamente brutta perché qualcuno la sistemi, e contata come un buco. Un record che porta solo testo e nessuna chiave non compare mai: funziona, nella tua lingua, per ogni giocatore in ogni lingua. Niente viene rifiutato e niente manca, quindi niente lo segnala, e un giocatore che legge in portoghese legge in silenzio il tuo italiano. Il primo errore lo trovi tu. Il secondo trova i tuoi lettori.

Tradurre un mod, ed essere tradotti

Il gioco esce in sette lingue, quindi un pacchetto con l'inglese cotto dentro i record si legge come inglese per sei settimi di chi lo installa. Questo è quello che costa evitarlo, cioè quasi niente se lo fai il primo giorno e una riscrittura se lo fai al quattrocentesimo.

Le lingue che ci sono

Sette, e questa tabella è letta dalla build invece che scritta a mano qui, così una lingua che arriva o se ne va la muove lo stesso giorno:

Due dei codici hanno una seconda grafia in circolazione — pt-BR è quella che usano una vetrina digitale e questa pagina, pt_BR è quella a cui si uniforma il motore — e in un'intestazione di colonna sono accettate entrambe. Scrivi quella che hai copiato.

Portare parole in più di una lingua

Un CSV sotto content/locale, con key per prima e una colonna per lingua:

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

Quando una chiave non ha risposta nella lingua del giocatore il gioco scende una scala fissa: la lingua del giocatore, poi la lingua in cui il tuo pacchetto dichiara di essere stato scritto, poi il catalogo del gioco, poi la chiave stessa. L'ultimo gradino è brutto di proposito: una chiave irrisolta deve sembrare sbagliata perché qualcuno la sistemi. Una conversione totale salta il catalogo del gioco, perché Old Seat che affiora in un mondo ambientato in un altro continente non è una piccola svista di traduzione, è il gioco base che traspare.

Scrivere testo che si possa tradurre

• Niente frasi costruite a pezzi. L'ordine delle parole non è lo stesso in tutte le lingue, quindi un nome montato a runtime da una colonna di aggettivi e una di sostantivi produce Oro Cervo in italiano. Una voce scritta per ogni lingua, completa.
• Il nome di una persona non si traduce mai e non si flette mai. Aldric è Aldric in tutte le lingue. Il che vuol dire anche che una chiave non deve mettere un nome in posizione obliqua — "of {name}", "{name}'s" — perché parecchie lingue declinano i nomi propri e il gioco no.
• Non c'è nessun limite di caratteri, e non è la stessa cosa che non avere limiti. Nessun campo conta i caratteri; quello che finisce è lo spazio sullo schermo. Il tedesco è circa un terzo più lungo dell'inglese ed è la lingua che rompe i pulsanti; il cinese è molto più corto e non lo fa quasi mai. Se provi una sola traduzione, prova il tedesco, e dài a un'etichetta la formulazione più corta che sia ancora quella giusta.

Qualcuno che traduce il tuo pacchetto

Aggiunge una colonna e ti rimanda il file. Il flusso di lavoro è tutto qui, ed è il motivo per cui il formato è CSV invece di qualcosa di più amichevole per un programmatore: un traduttore può aprirlo in un foglio di calcolo, e i suoi strumenti lo leggono già.

Due cose fanno la differenza fra un pacchetto che viene tradotto e uno che no. Tieni le chiavi stabili — una chiave rinominata è una traduzione persa, e il traduttore lo scopre quando lo scopre un giocatore. E di' a che cosa serve una riga: una chiave chiamata NR_MSG_01 riceve un'ipotesi, mentre northern_reach:VENDOR_HERB_GREETING riceve il saluto di una venditrice di erbe.

Se sei tu a tradurre il pacchetto di qualcun altro, ti legano le stesse regole: le colonne sono le lingue che il gioco porta, le chiavi sono le sue e non le tue, e un nome resta un nome.

Cambiare quello che il gioco ha già

part of mod.json

"overrides": ["iron_sword"]

overrides è una promessa. Un record che atterra su un id che non hai dichiarato viene rifiutato, quindi non puoi mai cambiare in silenzio qualcosa di cui un giocatore non sapeva niente.

a goods record

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

Una patch nomina le sue modifiche una alla volta:

• set — Scrive value in field, qualunque cosa ci fosse prima. Si scrive con field e value.
• unset — Toglie field dal record, così chi legge vede il valore predefinito della famiglia. Si scrive con field.
• append_unique — Aggiunge value all'elenco in field se non c'è già. Si scrive con field e value.
• remove_value — Toglie ogni occorrenza di value dall'elenco in field. Si scrive con field e value.

• Nomina un campo per percorso, mai per posizione. tags.0 viene rifiutato. La terza etichetta di oggi è la seconda etichetta dopo che si carica il mod di qualcun altro.
• Un percorso è fino a quattro nomi minuscoli uniti da punti. Qualunque cosa contenga un operatore viene rifiutata.
• append_unique è quella che due mod possono condividere. Se accodano tutti e due la stessa etichetta non è un conflitto e non la raddoppia.

Solo a volte

Un record può dire quando vale. Aggiungi un when accanto all'op, in un pacchetto 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" } }
}

Non c'è nessun operatore e niente da calcolare. Tutto quello che una condizione può dire sta in queste due tabelle.

Al massimo quattro soggetti in un when, due prove per soggetto. Due prove sullo stesso soggetto sono un intervallo: { "day": { "at_least": 10, "at_most": 30 } }.

Quale famiglia prende che cosa. Ogni famiglia prende i tre decisi al caricamento. Solo presentation_bindings ed effects prendono i quattro che si muovono mentre si gioca, perché solo quei due vengono ricostruiti quando il mondo cambia. Nominare season altrove viene rifiutato, e il messaggio dice quali soggetti quella famiglia prende davvero.

La ragione sono i salvataggi. Un record che decide un oggetto, una persona o una missione deve essere lo stesso record al caricamento successivo, e una condizione che si muove è esattamente quello che glielo impedisce.

Un aspetto stagionale va sul collegamento, non sull'immagine. Porta l'immagine una volta sola, poi due record presentation_bindings per lei: uno con un when, uno senza. images, audio e fonts rifiutano un when senza discutere.

Trattenuto non è rifiutato. Una condizione che non è soddisfatta trattiene il suo record e il resoconto di caricamento lo dice per nome:

what the game prints back

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

Un pacchetto con cinquanta record stagionali è trattenuto per tre quarti in qualunque momento. È il pacchetto che funziona.

Se ogni associazione di presentazione condizionale viene negata, il report mostra comunque la famiglia come dichiarata e stampa bound=0 insieme a ciascuna riga WITHHELD; non riporta erroneamente il pacchetto come privo di superficie di presentazione. Se nessuna associazione incondizionata fornisce lo stesso slot, stampa anche NO_APPLICABLE kind/subject/slot con la condizione senza risposta, che significa "non si applica nulla in questo stato mondiale", non "il record non era valido". Testare la condizione nell'host o nella corsia di runtime con lo stato mondiale corrispondente prima di presumere che l'associazione sia stata rifiutata.

Due versioni della stessa cosa. Porta due record add con lo stesso id e condizioni diverse. Quello la cui condizione regge è quello che si carica. Se reggono entrambe, il secondo viene rifiutato come duplicato — ed è così che condizioni sovrapposte vengono segnalate invece di essere risolte dall'ordine dei file.

Togliere qualcosa

remove vuol dire fuori produzione, non fuori dall'esistenza. Il record continua a risolversi ed è marcato: da lui non viene più offerto, tenuto in scorta, fabbricato o generato niente di nuovo, e tutto quello che un giocatore ha già e che lo nomina continua a leggere esattamente quello che ha sempre letto.

a goods record

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

vendor_inventories è l'unica famiglia che toglie il record, e solo perché le regole dei salvataggi dicono già che nessuno punta a quella riga.

Un remove non può portare un when. Un ritiro che un salvataggio potrebbe nominare deve essere deciso, altrimenti un id si risolve una sera e non quella dopo.

Una rimozione è definitiva per una composizione. Un successivo patch, replace o un secondo remove che prende di mira l'ID ritirato viene rifiutato, anche se un ritiro di merci mantiene il vecchio record risolvibile tramite la sua rimozione definitiva. Ciò impedisce al report di salvataggio di indicare "ritirato" mentre un pacchetto successivo fa sì che il record si comporti nuovamente come fornito. Aggiungi un nuovo ID dello spazio dei nomi quando hai bisogno di un nuovo record; non fare affidamento sulla rimozione seguita dalla resurrezione silenziosa.

Quando due mod vogliono la stessa cosa

Si caricano entrambi. Ogni modifica viene composta prima che si costruisca qualcosa, quindi il gioco li vede tutti e due.

Vincere e avere il permesso sono due domande diverse, ed è la parte che sorprende. Il gioco calcola sempre quale pacchetto scrive per ultimo — lasciarlo al caso renderebbe un rifiuto anche un lancio di moneta — e segnala comunque la coppia come una collisione che nessuno ha dichiarato. Il validatore offline rifiuta la stessa coppia senza discutere, così lo scopri prima di un giocatore.

supersedes nel tuo manifesto è il modo di dire che l'hai fatto apposta. Nomina l'id dell'altro pacchetto e lo scontro diventa declared_replacement: registrato, con la ragione, e non più un errore.

Dài al tuo pacchetto un load_order suo. Due pacchetti che condividono un numero non vengono rifiutati, e allora il vincitore cade dall'ordine alfabetico dell'id del mod: un ordine che non ha scelto nessuno dei due autori e che nessun giocatore può leggere sullo schermo.

Immagini, suono, scritte, colore

Portare un file e usarlo sono due passi separati e ti servono entrambi. Un file a cui non punta niente viene letto, controllato, misurato e mai mostrato.

Porta il file

Ogni famiglia di risorse è un file descrittore più i file che nomina. Il descrittore deve chiamarsi come la sua famiglia: 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"
  }
]

Tre regole che mordono:

• L'intestazione viene controllata prima che qualcosa lo decodifichi. format è quello che il file è, non quello che l'estensione dichiara.
• Un nome di file che contenga .. o ~, o che cominci con /, \, res:// o user://, viene rifiutato sul nome.
• Un id che non si risolve riceve un segnaposto e una segnalazione, mai silenzio.

Puntaci

Su un record che porti tu, con un campo che prende un id di immagine tuo:

Su qualunque cosa, contenuto del gioco base compreso, con un record presentation_bindings che nomina il soggetto, il suo tipo e lo slot:

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 è obbligatorio dove uno slot porta informazione: è la chiave di lingua che dice la stessa cosa a un giocatore che non può ricevere l'immagine.

Suono

role è un limite, non un'etichetta: ciascuno porta la propria durata massima, il proprio tetto su quanti ne suonano insieme, e il cursore che un giocatore va a cercare.

Un WAV compresso viene rifiutato: decodificarlo richiede un parser, e il parser è proprio la cosa che si sta evitando.

Scritte

covers nomina le lingue per cui il tuo carattere porta i glifi, e la build si rifiuta di installarlo per qualunque altra. Un carattere a cui manca una lingua non fallisce: disegna dei quadratini, e la schermata si legge come una traduzione lasciata a metà, con il testo giusto e la colpa del font.

fallback_font è obbligatorio: nomina un altro id di carattere tuo oppure una famiglia di sistema (Segoe UI, Noto Sans). sizes è ciò su cui viene calcolata la cache dei glifi.

Un carattere solo, mai una raccolta — un .ttc ne contiene parecchi e quale arrivi dipende da un indice che il descrittore non può portare. Caratteri gratuiti con ampia copertura: Google Fonts, Font Squirrel. Controlla che la licenza ti permetta di ridistribuire il file: è il tuo pacchetto a portarlo.

Colore

Gettoni, mai una scena, uno script o un percorso di risorsa. I nomi sono quelli del gioco: bg_deep, bg_mid, bg_button, bg_hover, border, border_hi, text, text_dim, accent, gold. Un nome che questa build non conosce viene nominato nel resoconto invece di restare lì a sembrare applicato.

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" }
    ]
  }
]

Le contrast_pairs sono controllate su un rapporto di 4,5 e sotto quello il tema viene rifiutato. Il misuratore di WebAIM ti dice il rapporto di una coppia prima che tu la porti.

Spegni il pacchetto e l'interfaccia si riprende i suoi colori e le sue scritte.

Arte che sta bene

La build controlla che un'immagine sia un'immagine. Non ha niente da dire su se sembri al posto giusto, e in un mondo disegnato in grigi una spada luminosa, allegra e ad alta risoluzione non smette di essere sbagliata per il fatto di superare ogni controllo. Questo è quello che si sa oggi.

La guida di stile completa non è ancora pubblicata. Che cosa porterà: la tavolozza stessa, le dimensioni a cui viene disegnato ogni tipo di cosa, ed esempi affiancati di che cosa sta dentro il mondo e che cosa ne esce fuori. Vale la pena aspettarla invece di tirare a indovinare, perché il fallimento che previene non è un file rifiutato: è un pacchetto che si installa alla perfezione e fa sembrare il gioco due giochi.

Finché non esiste, il metodo affidabile è quello che non ha bisogno di nessun documento: metti la tua immagine accanto a quella del gioco e guardale insieme.

Mappe tue

Disegna in Tiled, esporta in .tmj, e indicizzalo in 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 collegamento che nomina contenuto di un altro pacchetto — o del gioco base — fa rifiutare tutta la disposizione. modding_map_report nomina la disposizione e la regola che l'ha rifiutata.

Missioni tue

Una missione è un insieme di record che hanno senso solo insieme, in 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 piano è o tutto o niente. Un record sbagliato e non se ne installa nessuno: l'alternativa è un arco che si ferma a metà con il giocatore che ha in mano la spada e non il titolo.
• Una ricompensa è un grant, mai un kind. kind dice quale dei quattro record è questo. Una ricompensa scritta con kind si legge benissimo e viene rifiutata.

Controlla il tuo con modding_quest_plan_report.

Conversazioni tue

Una conversazione è tre tipi di record in content/narrative/dialogue: il dialogue_graph che la nomina e dice su quale battuta si apre, le battute dialogue_node che sono le righe, e le scelte dialogue_option che ci stanno sopra.

La tua battuta è la tua battuta, e niente la riscrive. Quello che un modello locale può fare è rispondere a una domanda che il giocatore scrive al personaggio, restando dentro quello che la tua battuta dice — e quando non riesce a restarci dentro, dice che non lo sa. È il giocatore a decidere se quella superficie esista del tutto; con il modello spento, il personaggio dice la tua frase e si ferma. La traduzione della tua battuta passa dai file di lingua, come tutto il resto che scrivi.

Il grafo nomina uno speaker, e l'innesco è tutto lì. Ogni personaggio del gioco chiede a questa famiglia quali conversazioni gli stiano sopra quando lo si clicca, quindi puoi dare al fabbro qualcosa da dire senza ridefinire il fabbro.

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"
  }
]

Tu scrivi la conversazione, mai le parole: ogni battuta è una chiave di lingua, così lo stesso pacchetto si legge in tutte le lingue che il giocatore ha. Un pacchetto che porta prosa viene rifiutato al file invece che allo schermo.

Una battuta e una scelta possono portare ciascuna delle condizioni, e una scelta può portare dei comandi. Una condizione decide se al giocatore la cosa venga mostrata del tutto; un comando è quello che succede quando la prende.

• Una conversazione che nomina qualcosa che questa build non sa fare non si apre mai. Non la scelta che lo usa: tutta la conversazione, prima della sua prima battuta. Un discorso che si ferma alla terza opzione ha già preso le monete del giocatore.
• Niente muove più di quanto ce ne sia. Chiedi prima con has_coin o has_item; un pacchetto che se ne dimentica non può mettere il giocatore a meno quaranta monete, perché nessuno ha accettato un debito e nessuna schermata ne spiega uno.
• Ogni battuta ha bisogno di una via d'uscita. Una battuta a cui un giocatore può arrivare e da cui non può andarsene viene rifiutata quando il grafo si carica.

Controlla il tuo con modding_dialogue_report.

Scene tue

Una scena è l'unico tipo di contenuto che toglie i comandi al giocatore, quindi è anche l'unico con una regola sul finire. Le scene vivono in content/narrative/scenes e ciascuna nomina un where, il posto in cui si gioca. Entra in quel posto e la scena parte.

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 scena che toglie i comandi deve restituirli. Una sequenza che finisce senza unlock_player viene rifiutata, perché l'alternativa è portare una stanza da cui il giocatore può uscire solo chiudendo il gioco.
• Le battute vanno in ordine e una battuta bloccante viene aspettata. È questo che fa di una scena una scena invece di un elenco di cose che succedono tutte insieme.

Controlla la tua con modding_scene_report.

Schermate tue

La disposizione di una schermata dice quali sezioni stiano in quale pannello di una schermata che il gioco ha già, e in che ordine. Dispone pezzi che questa build disegna; non può aggiungerne uno, perché una sezione che non ha scritto nessuno non ha niente da disegnare.

Le disposizioni vivono in content/ui/screens. Le famiglie, una per una ha i campi e un record da copiare.

Controlla la tua con modding_screen_report.

Non è comparso niente

Leggi prima lo stato sulla schermata Mod. Quasi tutti gli stati nominano il problema apertamente, sulla riga, e lo fa anche l'errore più comune di tutti: quello che una volta era il primo di questo elenco.

La famiglia che manca da content_types. Scrivi goods.json, ti dimentichi "goods" nell'elenco del manifesto, e la cartella non viene mai aperta: niente viene rifiutato, perché niente è stato letto. Il pacchetto si carica vuoto. Adesso la schermata dice davanti a quale file è passata e che cosa aggiungere:

what the game prints back

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

Il validatore offline stampa la stessa frase, così i due non possono essere in disaccordo. Solo se la riga dice caricato e non nomina nessun file non letto, scendi lungo questo elenco. È in ordine di quanto spesso ciascuno sia il colpevole.

I resoconti non tirano mai a indovinare. Un record rifiutato viene nominato, con che cosa aveva che non andava, e di solito con un codice — vedi Ogni codice diagnostico.

È comparso, ed è sbagliato

Il caso più difficile, perché non viene segnalato proprio niente. Due cose superano ogni controllo e ti danno comunque un record che non hai scritto.

Un campo che hai omesso non è un errore: è un valore predefinito. Lo schema di ogni famiglia dice senza quali campi un record non si può installare, e per quasi tutte le famiglie quell'elenco è corto. goods ne richiede esattamente uno: id. Ometti base_price ed è 1. Ometti weight ed è 1.0. Ometti category e la merce è una materia prima. Niente ti avvisa, perché non c'è niente che non va: hai chiesto una merce e ne hai avuta una.

Anche un valore che non è fra le scelte è un valore predefinito. Chi legge mette tutto in maiuscolo prima di cercare, quindi manufactured e MANUFACTURED sono lo stesso valore e le maiuscole non sono mai il problema: non metterti a riscrivere file per quello. Il problema è MANUFACTURED_GOODS: non è un membro, quindi diventa RAW_MATERIAL. SLOW per un decay_tier diventa ETERNAL. Il record si installa, la schermata dice applicato, e la tua candela ha il prezzo e la deperibilità di un'altra cosa.

Niente nel gioco lo dice, perché non c'è niente da dire: il campo è dichiarato come stringa e una stringa scritta male è comunque una stringa. Il validatore è l'unico posto in cui si può prendere, e adesso lo prende:

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

Un avviso e non un errore, perché il record si carica davvero e rifiutarlo adesso romperebbe pacchetti che già funzionano. --strict lo trasforma in un errore, ed è tutta la ragione per cui si esegue --strict prima di pubblicare.

Un campo che hai omesso resta muto, e quello non si può prendere: omettere category e scrivere RAW_MATERIAL sono la stessa richiesta. Perciò le tabelle dei campi in Le famiglie, una per una segnano Obbligatorio e danno la colonna dei valori come la forma che il caricatore controlla. Quando un record si carica e si comporta come qualcos'altro, confronta prima i tuoi campi con quella tabella: quello che stai cercando è un campo che non hai scritto, o una parola che il caricatore non ha riconosciuto.

Ogni famiglia

Una cartella e un resoconto per famiglia. La colonna dello stato è misurata sulla build, quindi non è mai una promessa che il gioco non mantiene. Che cos'è è solo la riga d'apertura, così che la tabella resti una cosa che si può scorrere con l'occhio; la descrizione completa di ogni famiglia, con i suoi campi e un record da copiare, è la sua voce in Le famiglie, una per una.

• Pronta all'uso — forma pubblicata, il gioco installa i tuoi record, esiste un esempio, e i tuoi id sopravvivono a un salvataggio e a un ricaricamento.
• Validato, non viene ancora consumato da nulla — il loader legge e controlla la famiglia, ma nessuna superficie di pacchetto rivolta al giocatore la consuma. I pacchetti audio e font sono in questo livello: un report pulito non fa comparire nel gioco un segnale muto o un font inutilizzato.
• Controllata, non ancora installata — il gioco riconosce la famiglia e controlla il tuo file, e niente lo mette dentro una partita in corso. Un pacchetto che la prende di mira supera ogni controllo e non carica niente. Sta nella pagina di proposito: l'alternativa è che qualcuno ci passi una serata senza mai scoprire di non aver sbagliato niente.

Decise per intero, senza nessuna famiglia che le porti, quindi nessun manifesto può chiederle:

Questi non sono rifiuti. Che cosa un mod non potrà mai fare è quell'elenco.

Le famiglie, una per una

Ogni famiglia che la build conosce, che cosa accetta, e un record che puoi copiare.

• I campi obbligatori sono quelli senza cui un record non si può installare.
• La colonna dei valori è la forma che il caricatore controlla, non un suggerimento.
• Dove una famiglia lo dice, un campo che la tabella non nomina viene rifiutato insieme al record in cui si trova. Un errore di battitura nel nome di un campo è un record che non si carica, e il resoconto della famiglia lo dice per nome.

Ogni voce dice anche che cosa succede a un salvataggio il giorno in cui un giocatore ti disinstalla:

Qui non c'è niente scritto a mano. I campi vengono dallo schema pubblicato di ogni famiglia. Ogni esempio è uno dei pacchetti che la matrice di prova del framework fa girare contro il caricatore, rimesso sotto lo spazio dei nomi northern_reach, e ricontrollato contro il suo schema mentre entra in questa pagina: un esempio che il gioco rifiuterebbe fa fallire la build.

Il mondo e i luoghi che contiene

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

buildings

Definizioni di edifici e di servizi dell'insediamento: etichetta, colore, ruolo e un interno riusato.

• Stato Pronta all'uso
• Percorsa in Il servizio di un edificio
• Cartella content/world/buildings
• Record indirizzati per il campo id
• Resoconto modding_building_report
• Se un giocatore ti disinstalla substitute_placeholder. Un insediamento con un buco dove c'era un servizio è ingiocabile; un edificio visibilmente mancante si legge e si recupera.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato buildings.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Rotte commerciali che una carovana percorre: da dove parte, dove sta andando, che cosa porta, quanto è ben scortata e quanto va veloce.

• Stato Pronta all'uso
• Cartella content/logistics/caravans
• Record indirizzati per il campo id
• Resoconto modding_caravan_report
• Se un giocatore ti disinstalla preserve_inert_reference. Una rotta il cui pacchetto è sparito conserva il nome e non porta niente. Sostituire una destinazione manderebbe le merci di un giocatore in un posto che non ha mai accettato.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato caravans.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Disposizioni che un pacchetto disegna in Tiled, nominate per id: il file, dove sta nel mondo, e la chiave di lingua con cui è conosciuta. L'indice è il record; la disposizione che gli sta accanto viene letta come dati e mai come risorsa, normalizzata in forma canonica, controllata contro il corredo pubblicato e assemblata prima che si collochi qualcosa. Una disposizione che viene rifiutata non colloca proprio niente, perché mezza mappa è una regione in cui il giocatore entra senza avere modo di sapere quale metà sia arrivata.

• Stato Pronta all'uso
• Cartella content/world/maps
• Record indirizzati per il campo id
• Resoconto modding_map_report
• Se un giocatore ti disinstalla drop_optional_presentation. Nessun salvataggio nomina una disposizione. Un salvataggio nomina il punto d'interesse che una disposizione ha spostato, e quel record conserva la propria coordinata, quindi una mappa ritirata costa la disposizione e mai il contenuto. Lasciarla cadere è quello che fa tornare il mondo a quello che dicono i suoi record, invece di tenere una posizione che nessuno fornisce più.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato maps.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Punti d'interesse collocati per coordinate sulla mappa del mondo scritta a mano.

• Stato Pronta all'uso
• Percorso in Un luogo sulla mappa
• Cartella content/world/pois
• Record indirizzati per il campo id
• Resoconto modding_poi_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un luogo scoperto resta scoperto. Missioni e cronologia dei viaggi puntano all'id.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato pois.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Profili di generazione fatti di soli dati: scelte pesate di bioma e di collocazione, possedute dall'ospite.

• Stato Pronta all'uso
• Cartella content/world/generation
• Record indirizzati per il campo id
• Resoconto nessuno suo; se ne occupa modding_preflight_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio registra l'id del profilo scelto. Se il suo pacchetto è assente, conservare e segnalare quell'id è più sicuro che ricostruire in silenzio la partita con la mappa del gioco base.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato profiles.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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
        }
      ]
    }
  }
]

Persone, casati e quello che sanno fare

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

enemy_archetypes

Tipi di nemico che il livello strategico conosce: grado, quali varianti schierano, dove si accampano, quanto è grande la guarnigione e ogni quanto fanno razzia.

• Stato Pronta all'uso
• Cartella content/threat/enemy_archetypes
• Record indirizzati per il campo id
• Resoconto modding_enemy_archetype_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un accampamento punta ancora a ciò che l'ha stabilito. Sostituire cambierebbe in silenzio che cosa sta assediando un insediamento; nominare l'assenza si legge.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato enemy_archetypes.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Blocchi di statistiche per un tipo di corpo nemico sul campo: classe, grado, i cinque attributi e gli id dell'arma, della mano secondaria e dello scudo che porta.

• Stato Pronta all'uso
• Cartella content/combat/enemy_variants
• Record indirizzati per il campo id
• Resoconto modding_enemy_variant_report
• Se un giocatore ti disinstalla substitute_placeholder. Un corpo già in campo senza blocco di statistiche non si può combattere. Un sostituto stabile posseduto dal motore tiene la battaglia risolvibile e l'id originale viene conservato accanto.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato enemy_variants.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Parametri di strategia regolabili per un gruppo che vive sulla mappa del mondo: raggio d'allarme, preferenza di bersaglio, numero di membri, soglie di rifornimento e di ritirata.

• Stato Pronta all'uso
• Cartella content/strategic/group_archetypes
• Record indirizzati per il campo id
• Resoconto modding_group_archetype_report
• Se un giocatore ti disinstalla substitute_placeholder. L'intelligenza strategica deve leggere una soglia da qualche parte. Risponde un valore predefinito posseduto dal motore, che è la stessa cosa su cui questa famiglia già ripiega.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato group_archetypes.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Modelli di mercenari assoldabili: nome, classe, provenienza, salute e morale iniziali, costo d'ingaggio e il giorno in cui compaiono per la prima volta.

• Stato Pronta all'uso
• Cartella content/character/mercenaries
• Record indirizzati per il campo id
• Resoconto modding_mercenary_report
• Se un giocatore ti disinstalla preserve_inert_reference. I mercenari già ingaggiati vivono nel salvataggio come unità; solo l'elenco della taverna perde il suo modello. L'id resta nominato, così l'origine dell'organico si legge ancora.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato mercenaries.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Dati iniziali di un casato nobiliare: il signore, l'erede, quali insediamenti rispondono al casato, e chi conta come rivale o alleato.

• Stato Pronta all'uso
• Cartella content/politics/noble_houses
• Record indirizzati per il campo id
• Resoconto modding_noble_house_report
• Se un giocatore ti disinstalla preserve_inert_reference. La considerazione di un giocatore verso un casato è registrata sul suo id. Sostituirne uno riscriverebbe senza dire niente a chi era leale.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato noble_houses.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Definizioni di NPC con un nome.

• Stato Pronta all'uso
• Percorso in Un mercante che lo tiene
• Cartella content/narrative/npcs
• Record indirizzati per il campo id
• Resoconto modding_npc_report
• Se un giocatore ti disinstalla preserve_inert_reference. Una persona con un nome che il mondo ricorda non è la stessa cosa di una che non è mai esistita, e i rapporti puntano all'id.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato npcs.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Privilegi dichiarativi: inneschi ed effetti, senza nessun gestore scritto in codice.

• Stato Pronta all'uso
• Cartella content/character/perks
• Record indirizzati per il campo id
• Resoconto modding_perk_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un personaggio conserva quello che si è guadagnato. Togliere un privilegio riscrive in silenzio una costruzione su cui il giocatore ha speso una partita.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato perks.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Modelli di compagni, politiche di rapporto delimitate, condizioni di reclutamento e legami dichiarativi.

• Stato Pronta all'uso
• Cartella content/companion/relationships
• Record indirizzati per il campo id
• Resoconto nessuno suo; se ne occupa modding_preflight_report
• Se un giocatore ti disinstalla preserve_inert_reference. Il seme del rapporto di un compagno resta attaccato al suo id, così togliere un pacchetto non può azzerare in silenzio fiducia, rancori o storia degli abbandoni.

Campi. Questa famiglia contiene più di un tipo di record, e ogni tipo viene controllato contro il proprio elenco. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Un record con kind: bond:

Un record con kind: companion_template:

Un record con kind: recruit_terms:

Un record con kind: relationship_policy:

In un file chiamato relationships.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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
  }
]

Cose, commercio e i numeri dietro uno scontro

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

combat_balance

Valori di bilanciamento del combattimento, delimitati, che regolano parametri del risolutore già esistenti senza aggiungere regole, operazioni o meccaniche.

• Stato Pronta all'uso
• Cartella content/combat/balance
• Record indirizzati per il campo id
• Resoconto modding_combat_balance_report
• Se un giocatore ti disinstalla substitute_placeholder. Il bilanciamento è dato di definizione posseduto dall'ospite, non inventario del giocatore. Quando il suo pacchetto è assente risponde il bilanciamento canonico e stabile, e il caricamento successivo non si porta dietro una seconda via di salvataggio delle regolazioni.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato balance.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Merci commerciabili e le loro proprietà economiche.

• Stato Pronta all'uso
• Percorsa in Una merce da vendere
• Cartella content/economy/goods
• Record indirizzati per il campo id
• Resoconto modding_goods_report
• Se un giocatore ti disinstalla preserve_inert_reference. Una scorta che nomina una merce che nessuno fornisce è onesta. Sostituirla cambierebbe in silenzio quello che un giocatore possiede.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato goods.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Oggetti d'inventario, armi e armature comprese.

• Stato Pronta all'uso
• Percorso in Un oggetto da portare
• Cartella content/inventory/items
• Record indirizzati per il campo id
• Resoconto modding_items_report
• Se un giocatore ti disinstalla preserve_inert_reference. Il deposito continua a nominare quello che c'era dentro, ed è l'unica ragione per cui reinstallare glielo restituisce.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato items.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Ricette di artigianato: che cosa si consuma, che cosa ne esce, dove si lavora, quanto costa e quanto è probabile che vada male.

• Stato Pronta all'uso
• Cartella content/economy/recipes
• Record indirizzati per il campo id
• Resoconto nessuno suo; se ne occupa modding_preflight_report
• Se un giocatore ti disinstalla preserve_inert_reference. Niente in un salvataggio nomina una ricetta: un salvataggio nomina l'oggetto che una lavorazione ha prodotto, e ne risponde la famiglia di quell'oggetto. Quello che una ricetta ritirata lascia è una postazione che non offre più qualcosa, il che viene segnalato invece che riparato, perché inventare una ricetta sostitutiva metterebbe in mano al giocatore un oggetto che nessun pacchetto fornisce.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato recipes.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Tabelle delle scorte dei mercanti.

• Stato Pronta all'uso
• Percorso in Un mercante che lo tiene
• Cartella content/world/vendor_inventories
• Record indirizzati per il campo id
• Resoconto modding_vendor_inventory_report
• Se un giocatore ti disinstalla drop_optional_presentation. Le scorte si rigenerano. Un mercante con lo scaffale vuoto è uno stato leggibile e alla riga non punta nient'altro.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato vendors.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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
      }
    ]
  }
]

Storia, missioni e le parole che un giocatore legge

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

dialogue

Conversazioni come record: il grafo, le sue battute e le scelte che ci stanno sopra. Tre tipi condividono la famiglia ed è kind a dire quale. Un pacchetto scrive la conversazione, mai le parole — ogni battuta è una chiave di lingua — e ogni condizione e ogni conseguenza sono un controllo o un comando che questa build già esegue.

• Stato Pronta all'uso
• Cartella content/narrative/dialogue
• Record indirizzati per il campo id
• Resoconto modding_dialogue_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio registra quello che una conversazione ha fatto — una missione che si è mossa, un oggetto che ha cambiato mano, una verità appresa — mai la conversazione stessa, che è finita nel momento in cui si scrive qualcosa. Quando il pacchetto se ne va, le conseguenze restano perché non sono mai state del dialogo, e la conversazione semplicemente non viene più offerta. Sostituirla metterebbe in bocca a un personaggio parole che il suo autore non ha mai scritto.

Campi. Questa famiglia contiene più di un tipo di record, e ogni tipo viene controllato contro il proprio elenco. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Un record con kind: dialogue_graph:

Un record con kind: dialogue_node:

Un record con kind: dialogue_node:

Un record con kind: dialogue_node:

Un record con kind: dialogue_option:

In un file chiamato gate_toll.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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
      }
    ]
  }
]

Il fixture contiene 12 record; ne sono mostrati 3.

locales

Le parole che un giocatore legge, in CSV con una colonna per lingua: le chiavi proprie del pacchetto, e quelle del gioco dove il pacchetto dichiara la sovrascrittura.

• Stato Pronta all'uso
• Cartella content/locale
• Resoconto modding_locale_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio nomina il record, mai le parole che lo dicono, quindi un pacchetto ritirato fra due sessioni costa una traduzione e non una cosa. La chiave viene conservata e si mostra, il che si legge come una traduzione mancante invece che come contenuto sparito.

Colonne. Una colonna che questa tabella non nomina viene rifiutata insieme al record.

In un file chiamato words.csv. Il nome del file è metà dell'indirizzo e l'id della riga è l'altra metà, quindi due file possono contenere lo stesso id di riga senza scontrarsi:

a locales file

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

lore

Voci del Codex: luoghi, persone, eventi, usanze e cose su cui un mondo racconta storie. Una voce caricata non è una voce conosciuta.

• Stato Pronta all'uso
• Cartella content/narrative/lore
• Record indirizzati per il campo id
• Resoconto modding_lore_report
• Se un giocatore ti disinstalla preserve_inert_reference. Una voce del Codex che un giocatore ha letto è qualcosa che ha visto. Toglierla cancella una parte di quello che sa di un mondo in cui ha passato del tempo, e missioni e altre voci puntano all'id.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato lore.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Righe strutturate di realismo medievale, indirizzate per file e id di riga invece che per un campo id nel JSON.

• Stato Pronta all'uso
• Cartella content/medieval_realism/structured
• Resoconto modding_mr_lines_report
• Se un giocatore ti disinstalla drop_optional_presentation. Una battuta di colore a cui non si riferisce niente. Toglierla non costa niente e tenerla mostrerebbe una stringa vuota.

Colonne. Una colonna che questa tabella non nomina è permessa, e deve essere un valore semplice invece di un elenco o di un oggetto.

Ogni record ha bisogno di almeno uno fra public_line, public_label, public_summary_line.

Questi nomi vengono rifiutati senza discutere, qualunque cosa contengano: unsafe_example, unsafe_reason, audit_note, expected_block_reason, script, scene, resource_path. Alcuni sono le colonne di verifica con cui scrive chi fa il gioco e gli altri sono i nomi a forma di codice che Che cosa un mod non potrà mai fare rifiuta ovunque. Un record che ne porta uno viene rifiutato invece di essere ripulito in silenzio.

In un file chiamato MR_L03_TAVERN_INN_LINES.csv. Il nome del file è metà dell'indirizzo e l'id della riga è l'altra metà, quindi due file possono contenere lo stesso id di riga senza scontrarsi:

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

Record di progressione del giocatore: obiettivi, profili di difficoltà sicuri e profili di partita entro le regole dell'ospite.

• Stato Pronta all'uso
• Cartella content/player/progress
• Record indirizzati per il campo id
• Resoconto nessuno suo; se ne occupa modding_preflight_report
• Se un giocatore ti disinstalla preserve_inert_reference. Gli obiettivi guadagnati e i profili di partita scelti restano nominati quando il loro pacchetto è assente; toglierli in silenzio riscriverebbe la storia del giocatore o il contratto della partita.

Campi. Questa famiglia contiene più di un tipo di record, e ogni tipo viene controllato contro il proprio elenco. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Un record con kind: achievement:

Un record con kind: difficulty_profile:

Un record con kind: run_profile:

In un file chiamato progress.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Record di metadati delle missioni, indicizzati per quest_id invece che per id.

• Stato Pronta all'uso
• Cartella content/narrative/quest_metadata
• Record indirizzati per il campo quest_id
• Resoconto modding_quest_metadata_report
• Se un giocatore ti disinstalla preserve_inert_reference. Descrive missioni che potrebbero a loro volta essere già ridotte a lapide; toglierlo le lascerebbe senza descrizione invece che assenti.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato quests.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Piani di missione come record: gli archi, le missioni, gli obiettivi e i finali che un pacchetto scrive e da cui il gioco costruisce missioni sue. La forma a record di una missione, accanto alle risorse scritte a mano invece che al loro posto.

• Stato Pronta all'uso
• Cartella content/narrative/quest_plans
• Record indirizzati per il campo id
• Resoconto modding_quest_plan_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un piano costruisce le stesse missioni che il gioco fa girare, quindi uno ritirato lascia lo stesso buco che lascerebbe una scritta a mano. Il progresso è l'unica cosa che un giocatore non può ricostruire: una missione che non si risolve viene segnalata e mai completata o cancellata in silenzio.

Campi. Questa famiglia contiene più di un tipo di record, e ogni tipo viene controllato contro il proprio elenco. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Un record con kind: arc:

Un record con kind: ending:

Un record con kind: objective:

Un record con kind: quest:

In un file chiamato the_long_winter.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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"
  }
]

Il fixture contiene 5 record; ne sono mostrati 3.

quests

Risorse di missione scritte a mano, caricate per percorso invece che interpretate come record. Un pacchetto che vuole una missione sua scrive quest_plans.

• Stato Controllata, non ancora installata
• Cartella content/narrative/quests
• Resoconto nessuno suo; se ne occupa modding_preflight_report
• Se un giocatore ti disinstalla preserve_inert_reference. Il progresso è l'unica cosa che un giocatore non può ricostruire. Una missione che non si risolve viene segnalata e mai completata o cancellata in silenzio.

Questa famiglia viene caricata per percorso invece che letta come record, e un pacchetto non può portare il file che vorrebbe; vedi Che cosa un mod non potrà mai fare. Scrivi invece quest_plans.

scenes

Scene messe in scena: la stanza, chi ci sta dentro e le battute che si svolgono in ordine. È l'unico contenuto che toglie i comandi al giocatore, ed è per questo che una sequenza che non arriva mai a end viene rifiutata invece che giocata. Battute e oggetti di scena sono nomi presi da elenchi pubblicati; qui non si carica nessuna scena Godot, nessuna risorsa e nessuno script.

• Stato Pronta all'uso
• Cartella content/narrative/scenes
• Record indirizzati per il campo id
• Resoconto modding_scene_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio registra quello che una scena ha fatto — un nome scelto, una missione mossa, una porta aperta — mai il fatto che sia stata guardata. Si gioca e finisce dentro una sola sessione, quindi un pacchetto che se ne va costa la scena e mai una conseguenza dell'averla vista. Sostituirla metterebbe in scena qualcosa che l'autore non ha mai scritto sotto il nome di qualcosa che ha scritto.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato scenes.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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"
      }
    ]
  }
]

Come si vede e si sente tutto quanto

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

audio

Suoni che un pacchetto porta, nominati per id: musica, ambiente, effetti e voce, ciascuno che punta a un file dentro la propria cartella e che dichiara il ruolo che lo delimita.

• Stato Validato, non viene ancora consumato da nulla
• Cartella content/assets/audio
• Record indirizzati per il campo id
• Resoconto modding_audio_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio nomina il soggetto e mai il suono che gli sta sopra, quindi un pacchetto ritirato fra due sessioni costa un'atmosfera e non una cosa. Il riferimento viene conservato e segnalato: il silenzio senza niente che ne dica il perché è proprio lo stato che questa famiglia esiste per evitare.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Nel file audio.json, che è l'unico file attraverso cui questa cartella viene letta:

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

Tempo atmosferico, polvere, scintille e luci, composti a partire dai modelli che l'ospite mette a disposizione. Un pacchetto nomina un modello e imposta parametri dentro intervalli dichiarati; non c'è nessun campo, da nessuna parte, che porti uno shader, una scena o uno script — ed è questo che permette al pacchetto di uno sconosciuto di chiedere del fuoco senza poter chiedere un programma.

• Stato Pronta all'uso
• Cartella content/assets/effects
• Record indirizzati per il campo id
• Resoconto modding_effect_report
• Se un giocatore ti disinstalla preserve_inert_reference. Niente in un salvataggio nomina un effetto. L'aria torna a quello che disegna il gioco base quando il pacchetto se ne va, il che costa un aspetto e niente di quello che un giocatore possiede.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato effects.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Caratteri tipografici che un pacchetto porta, nominati per id: il file, le dimensioni a cui vengono disegnati, e le lingue di cui portano i glifi. La copertura si dichiara invece di essere scoperta, perché un carattere a cui mancano i glifi di una lingua non fallisce: disegna dei quadratini, e la schermata si legge come una traduzione lasciata a metà da qualcuno.

• Stato Validato, non viene ancora consumato da nulla
• Cartella content/assets/fonts
• Record indirizzati per il campo id
• Resoconto modding_font_report
• Se un giocatore ti disinstalla preserve_inert_reference. Niente in un salvataggio nomina un carattere. L'interfaccia torna al carattere del toolkit quando il pacchetto se ne va, che è l'unico che nessun autore ha dovuto scegliere.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Nel file fonts.json, che è l'unico file attraverso cui questa cartella viene letta:

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

Immagini che un pacchetto porta, nominate per id: icone, ritratti e fogli di sprite, ciascuna che punta a un file dentro la propria cartella.

• Stato Pronta all'uso
• Cartella content/assets/images
• Record indirizzati per il campo id
• Resoconto modding_image_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio nomina oggetti e persone, mai l'immagine di uno di loro, quindi un'immagine che smette di risolversi costa un disegno e non una cosa. Il riferimento viene conservato e segnalato: sostituirlo con l'arte di un altro pacchetto mostrerebbe al giocatore qualcosa che nessun autore ha scelto, e togliere l'id in silenzio farebbe sembrare l'icona mancante un difetto di disegno.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Nel file images.json, che è l'unico file attraverso cui questa cartella viene letta:

a images record, under content/assets/images

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

presentation_bindings

Quale risorsa del pacchetto riempia quale slot su quale soggetto: l'icona su un oggetto, lo sprite su un'unità o un tassello, lo stendardo su una fazione, tanto per il contenuto del pacchetto quanto per quello del gioco base.

• Stato Pronta all'uso
• Cartella content/presentation/bindings
• Record indirizzati per il campo id
• Resoconto nessuno suo; se ne occupa modding_preflight_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un salvataggio nomina il soggetto — l'oggetto, la persona, il tassello — e mai quale immagine lo vestisse, quindi un collegamento che smette di risolversi costa un disegno e non una cosa. Il riferimento viene conservato e segnalato: il soggetto torna all'arte che la build aveva già, che è l'unica risposta che nessun autore ha dovuto scegliere.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato bindings.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Disposizioni di schermata: quali sezioni stiano in quale pannello di una schermata che il gioco ha già, e in che ordine. Dispone pezzi che questa build disegna e non può aggiungerne uno: una schermata nuova avrebbe bisogno di widget, sorgenti di dati e gestori di clic, che insieme sono un linguaggio di programmazione.

• Stato Pronta all'uso
• Cartella content/ui/screens
• Record indirizzati per il campo id
• Resoconto modding_screen_report
• Se un giocatore ti disinstalla preserve_inert_reference. Niente in un salvataggio nomina una disposizione. Decide come viene disegnata una pagina mentre il pacchetto è caricato, e la pagina torna alla disposizione che questa build porta con sé quando se ne va: costa un aspetto e niente di quello che un giocatore possiede.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato screens.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Tavolozze dell'interfaccia come gettoni: colori con un nome, dimensioni e spaziature, con le coppie il cui contrasto un giocatore deve poter leggere. Mai una scena, uno script o un percorso di risorsa.

• Stato Pronta all'uso
• Cartella content/assets/themes
• Record indirizzati per il campo id
• Resoconto modding_theme_report
• Se un giocatore ti disinstalla preserve_inert_reference. Niente in un salvataggio nomina un tema. L'interfaccia torna ai colori del toolkit quando il pacchetto se ne va, che è l'unica tavolozza che nessun autore ha dovuto scegliere.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato themes.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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"
      }
    ]
  }
]

Che cosa controlla il giocatore, e che cosa lo osserva

3 famiglie: adaptive, input_bindings, settings.

adaptive

Profili che guardano come sta andando una partita e ne suggeriscono un'impostazione diversa. Il risultato è un consiglio e mai un cambiamento: un profilo che potesse agire sarebbe l'unica cosa che un pacchetto porta capace di alterare una partita senza che il giocatore o l'ospite l'abbiano chiesto, e in un diff sembrerebbe esattamente una tabella di regolazioni. Gli ingressi sono un elenco pubblicato di aggregati di gioco, ciascuno un conteggio o una media che la partita già tiene su se stessa.

• Stato Pronta all'uso
• Cartella content/player/adaptive
• Record indirizzati per il campo id
• Resoconto modding_adaptive_report
• Se un giocatore ti disinstalla drop_optional_presentation. Nessun salvataggio nomina un profilo. Quello che un profilo ha toccato è un moltiplicatore ricalcolato dai mutatori attivi ogni volta che cambiano, quindi un pacchetto ritirato smette di essere consultato e la partita torna esattamente a quello che il giocatore aveva scelto. Non si conserva niente, quindi non c'è niente da preservare.

Campi. Questa famiglia contiene più di un tipo di record, e ogni tipo viene controllato contro il proprio elenco. Un campo che questa tabella non nomina viene rifiutato insieme al record.

Un record con kind: adaptive_profile:

Un record con kind: threshold_set:

In un file chiamato adaptive.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Azioni proprie di un pacchetto, con il tasto che vorrebbero. Decide il giocatore: un suggerimento che finisce su una combinazione che aveva già assegnato perde, e l'azione arriva senza tasto, perché un tasto che fa in silenzio un'altra cosa è peggio di un tasto che non fa niente.

• Stato Pronta all'uso
• Cartella content/input
• Record indirizzati per il campo action_id
• Resoconto modding_input_report
• Se un giocatore ti disinstalla preserve_inert_reference. La riassegnazione di un giocatore resta archiviata sotto l'id dell'azione, così reinstallare il pacchetto ritrova il tasto dove l'aveva messo. L'azione in sé viene tolta dalla mappa dei comandi quando il pacchetto se ne va, così la schermata delle assegnazioni non elenca mai qualcosa a cui non risponde niente.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato bindings.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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

Opzioni che un giocatore può cambiare, dichiarate invece che disegnate. Un pacchetto dice qual è l'opzione, che valori può avere e dove vive il valore; il controllo lo costruisce l'ospite. Niente di quello che attraversa questo confine è un Control o uno script, ed è l'unica ragione per cui un menu delle impostazioni può mostrare le opzioni di uno sconosciuto senza eseguirne il codice.

• Stato Pronta all'uso
• Cartella content/settings
• Record indirizzati per il campo key
• Resoconto modding_settings_report
• Se un giocatore ti disinstalla preserve_inert_reference. Un valore memorizzato resta sotto la sua chiave, così reinstallare il pacchetto ritrova la scelta del giocatore dove l'aveva lasciata. Quello che il pacchetto si lascia dietro è una riga in un profilo che nessuno legge: non costa niente e conserva una scelta che il giocatore ha fatto.

Campi. Un campo che questa tabella non nomina viene rifiutato insieme al record.

In un file chiamato settings.json, o con qualunque altro nome .json ti piaccia dentro quella cartella:

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"
  }
]

Scorciatoie da console

Queste sono una scorciatoia, non un passaggio. Tutto quello che c'è qui sotto ha un posto sulla schermata Mod, che è dove passa la strada normale e dove guarderà chi ha scaricato il tuo pacchetto. La console è più rapida quando stai iterando ed è già aperta, ed esiste solo in una build di debug: una copia pubblicata del gioco non ha nessuna console, quindi niente di ciò che serve all'autore di un pacchetto può vivere solo qui.

Comincia da modding_manifest_report — il gioco vede il tuo pacchetto, e in che stato? — poi modding_preflight_report per un verdetto unico su tutto quello che è installato. Poi il resoconto della singola famiglia.

modding_reload rilegge i tuoi file senza riavviare. Modifica, fai Alt-Tab, digita il comando e guarda. Ricostruisce ciò che nulla sta trattenendo — binding, effetti e immagini — e nomina ogni famiglia lasciata intatta, perché una partita poggia sui record che un salvataggio può nominare:

what the game prints back

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

modding_reload all rilegge tutto ed è per una schermata iniziale senza nessuna partita in corso. modding_condition_report stampa a che cosa il gioco sa rispondere adesso per un when, e a che cosa no.

Strumenti offline

Questi strumenti sono per autori e automazione delle pubblicazioni. Sono inclusi nel checkout pubblico di Bonemark; ai giocatori che installano un mod pubblicato non servono Python né Godot. Se scrivi un mod, clona la build corrispondente da github.com/tallowgames/Bonemark, tieni il pacchetto di lavoro fuori dalla cartella mods del giocatore ed esegui da questo checkout i comandi seguenti. Il gioco resta l'autorità finale del runtime.

Python 3.10 o più recente; Godot solo per la corsia di runtime. Tieni il tuo pacchetto fuori dalla cartella mods del giocatore e prova una copia.

a command line

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

Scrive un pacchetto che passa la convalida prima ancora che tu abbia scritto qualcosa: un mod.json già compilato, un record funzionante per ogni famiglia che hai chiesto, e un README con i due comandi successivi. I record vengono dai fixture che la build già controlla per quelle famiglie, quindi uno starter che smette di funzionare fa fallire lo stesso controllo che fa fallire il fixture, invece di marcire dentro un modello. Si rifiuta di scrivere dentro una cartella chiamata 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>"

Controlla mod.json, le cartelle di famiglia, gli id, gli schemi, i riferimenti, i limiti e i payload bloccati. --strict trasforma gli avvisi in fallimenti.

Confronta la superficie di modding con versione

Quando il gioco cambia, confronta l'istantanea della superficie archiviata prima di aggiornare un pacchetto. Contiene un digest più i campi e le operazioni per ogni famiglia pubblica, quindi il risultato indica quale famiglia è cambiata e perché:

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 differenza è unchanged, additive o breaking. I motivi di rottura sono espliciti: field_removed, required_added, type_changed, default_changed, constraint_changed, operation_removed e root_changed, format_changed, id_field_changed, catalogue_changed, family_removed e contract_major_changed_without_new_id. Nome modifiche compatibili field_added, required_removed, operation_added o family_added. Il comando senza --before controlla anche la baseline archiviata. Se la superficie corrente si è spostata, l'audit fallisce finché un manutentore non esamina gli esatti digest prima/dopo in tools/quality/modding_surface_contract_changes.json; una modifica di rottura deve inoltre registrare ogni motivo, la decisione, la nota di migrazione e il revisore. La promozione di uno snapshot intenzionalmente rivisto è esplicita:

a command line

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

Questo è un controllo del manutentore/rilascio; gli autori di mod necessitano solo del confronto --before e i giocatori che installano un pacchetto rilasciato non hanno bisogno di eseguirlo.

a command line

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

Legge il manifesto, le dipendenze, la compatibilità e l'ordine di caricamento senza avviare Godot e senza eseguire niente del tuo pacchetto.

Non apre mai un file di contenuto. Questa è la divisione del lavoro: l'host risponde questi pacchetti verranno caricati insieme, il validatore risponde questo record è corretto - ma significa che un pacchetto che il validatore rifiuta può comunque comporre in modo pulito qui. Misurati su quattordici pacchetti deliberatamente rotti, i due non sono d'accordo su ogni rifiuto: l'host li mette in scena tutti e quattordici, refused vuoti, compreso uno che trasporta scripts/payload.sh che solo il validatore trova. Comporre non equivale ad installare in sicurezza. Esegui entrambi prima di pubblicare. Ripeti --root quando il set di test è suddiviso in cartelle; l'host compone quindi l'insieme completo in un piano deterministico.

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"

Fa girare il validatore, l'host di prova, il fixture di ogni famiglia pronta all'uso e la corsia di runtime di Godot. Togli --require-runtime se non hai Godot; il resoconto dirà allora che la prova a runtime è stata saltata, non superata.

Per un insieme composto, ripetere l'opzione:

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

Il rapporto conserva un risultato per radice e aggiunge composed_set per il set completo. Questo blocco è il luogo in cui vengono dimostrati conflitti tra pacchetti, ID duplicati ed errori di dipendenza. Un pacchetto pulito da solo non è la prova che il set verrà caricato insieme. Il rapporto include anche surface_contract, l'attuale versione del contratto per famiglia e l'audit digest, quindi una matrice non può essere verde mentre l'istantanea di compatibilità del repository è obsoleta. Con --require-runtime, leggi runtime.reachability.loaded_families e runtime.reachability.reachable_families. Il primo dice che i record composti sono stati caricati; il secondo viene popolato solo quando un vero percorso rivolto ai giocatori nella sonda Godot li ha consumati. runtime.reachability.observations mantiene il pacchetto, la famiglia, l'ID record, il percorso e lo stato per ogni riga, mentre unreachable elenca le righe caricate che non hanno ancora alcun percorso. Una famiglia può essere convalidata e messa in scena ma essere ancora assente da reachable_families: "caricato" non è la stessa cosa di "un giocatore può raggiungerlo".

Ogni comando qui sopra viene controllato contro gli strumenti stessi mentre questa pagina viene costruita: lo script deve esistere e ogni opzione deve essere una che accetta.

Ogni codice diagnostico

Non leggere questo elenco in ordine. Sta qui perché un codice che incontri in un resoconto sia una domanda con una risposta — una parolina in minuscolo come asset_missing. Incollane uno nella casella di ricerca in cima a questa pagina.

Alcuni codici appartengono a meccanismi che un pacchetto non può ancora raggiungere. Sono qui lo stesso: un codice che non puoi far scattare costa una riga che non leggerai mai, e un codice che manca costa una serata.