Mods: Best Mods & How to Install Guide

I mod aggiungono o modificano contenuti e comportamento in Mindustry — nuovi blocchi, oggetti, liquidi, unità, settori, pianeti e hook di scripting — permettendo gameplay, contenuti visivi e mappe creati dalla comunità. Questa pagina riassume come sono strutturati i mod, cosa includono comunemente, come accedervi o svilupparli e consigli pratici per usarli.

Cosa può contenere un mod

Nuovi blocchi (muri, torrette, fabbriche, blocchi energetici, nastri, blocchi a scopo speciale). Tipi di esempio mostrati negli esempi della comunità: muri personalizzati, piastrelle murarie e blocchi di difesa.
Nuovi oggetti e liquidi (risorse, combustibili, fluidi come liquidi personalizzati).
Nuovi tipi di proiettili/munizioni e mappature di munizioni per torrette (puoi aggiungere o copiare proiettili e assegnarli alle torrette).
Nuove unità e fabbriche di unità.
Nuovi pianeti, settori e generatori di settori (inclusi settori "nascosti" o creati dalla comunità che sostituiscono o aumentano i settori procedurali).
Risorse visive e layer di disegno per i blocchi (regioni, ombre, layer di disegno extra).
Scripting, handler e processor per comportamenti personalizzati, inclusa l'analisi di contenuti Java/JavaScript.
Override lato mod e comportamenti di blocchi collegati che inoltrano la gestione di oggetti, liquidi e energia ad altre tessere.

Pattern tecnici comuni e API

Estensione del contenuto: i mod comunemente estendono classi base per creare nuovo contenuto (es., estendere Wall per creare un muro personalizzato, o GenericCrafter per le fabbriche). Quando si crea contenuto il costruttore imposta nome, descrizioni e flag come solid.
Copiare e modificare contenuti esistenti: puoi copiare proiettili, tipi di munizioni o blocchi, modificare campi (danno, aspetto, requisiti) e registrarli, evitando modifiche agli originali.
Accettazione e gestione di oggetti/liquidi: i blocchi possono sovrascrivere acceptItem/handleItem e acceptLiquid/handleLiquid per delegare a tessere collegate o implementare logiche di instradamento personalizzate. I hook di potenza possono similmente delegare le chiamate addPower a tessere collegate.
Disegno e layer: i blocchi definiscono regioni e possono specificare layer di disegno extra (layer2) o regioni shadow personalizzate per l'aspetto visivo.
Visibilità di costruzione e requisiti: i blocchi includono buildVisibility, requirements, buildTime e size per controllare quando/come appaiono e come vengono costruiti.

Settori, pianeti e contenuto mappa

I mod possono aggiungere settori e pianeti completi. Le mappe di attacco "nascoste" create dalla comunità sono usate da alcune campagne moddate e sostituiscono settori generati proceduralmente nei seed; gli autori spesso aggiungono note su risorse e difese (per esempio, mappe con abbondanti Shock Mines, o difese finali con Plastanium/Muro di Fase).
I pianeti possono essere resi accessibili o visibili tramite flag della console durante i test (es., Planets..accessible = Planets..alwaysUnlocked = true).

Sviluppare mod: linguaggi e strumenti

Java e JavaScript sono supportati per creare mod. Il workflow del modder può usare Java per modifiche core o script in stile ContentParser per la creazione di contenuti in formato simile a JSON.
Asset essenziali del mod: definizioni per oggetti, liquidi, blocchi, unità, proiettili, pianeti/settori e bundle localizzati (nome/descrizione) sono tipici.
I principianti dovrebbero iniziare copiando e modificando contenuti d'esempio (muri, torrette, proiettili) piuttosto che reinventare da zero.
Aree utili da imparare per moddare: oggetti & liquidi, fabbriche (GenericCrafter), blocchi di produzione/elettrici, parti di disegno per torrette, effetti/suoni/status, unità/armi/abilità, pianeti/settori/generazione, e come trovare classi/campi nel codice del gioco.
Strumenti e flussi: molti modder passano tra Java e JavaScript (JavaJS) e usano tool della comunità (ACD, ContentParser) quando appropriato.

Installazione e accesso ai mod

Su Android, le release ufficiali e le build beta sono disponibili tramite Google Play (diventa tester beta per ottenere le build più recenti). Build di prova iOS sono distribuite tramite TestFlight.
Alcuni contenuti di mod o oggetti/pianeti nascosti possono essere sbloccati o resi visibili tramite la console per sviluppatori (premi F8) impostando i flag di visibilità del pianeta o dell'oggetto su true.
Contenuti official-mod: alcuni mod sono creati dallo/degli sviluppatore(i) e distribuiti come "official mods" all'interno della comunità; questi appaiono nelle liste dei mod ma si comportano come mod della comunità.

Esempi di frammenti e pattern

Assegnare un proiettile personalizzato alla tabella munizioni di una torre esistente (stile JavaScript):
- Esempio: Blocks.duo.ammoTypes.put(Items.pyratite, Blocks.hail.ammoTypes.get(Items.pyratite))
Copiare un proiettile e cambiare una proprietà:
- Pattern di esempio: bullet = Blocks.hail.ammoTypes.get(Items.graphite).copy(); bullet.damage = 200; Blocks.hail.ammoTypes.put(Items.titanium, bullet)
Una definizione minima di muro personalizzato (simile a JavaScript):
- Il pattern d'esempio mostra l'impostazione di region, health, category, size, requirements, buildTime, icons e description quando si estende Wall.

Buone pratiche e norme della comunità

Riutilizza e copia contenuti esistenti quando possibile per rimanere compatibile con il bilanciamento e l'aspetto del gioco.
Mantieni le chiavi di localizzazione nei Bundles (block.[name].name e block.[name].description) per supportare le traduzioni.
Testa nuovi settori e pianeti con i flag di visibilità della console prima di rilasciare.
Contribuisci tramite segnalazioni di problemi o pull request per bug se sai programmare in Java; unisciti ai canali della comunità per traduzioni, discussione e feedback.
Quando crei blocchi collegati complessi, assicurati che i metodi sovrascritti delegino correttamente le funzioni accept/handle e il routing della potenza alle tessere collegate per evitare catene di approvvigionamento rotte.

Dove vengono usati i mod

I mod alimentano mappe di sopravvivenza personalizzate, settori di attacco creati dalla comunità, nuovo contenuto di campagna e strumenti di qualità della vita per i creatori.
Alcuni mod ufficiali e della comunità sono impacchettati come componenti aggiuntivi e distribuiti tramite il browser dei mod o hosting esterni.

Questa guida copre le strutture e i flussi di lavoro comuni che incontrerai quando usi o crei mod per Mindustry: estensione dei contenuti, override di asset e comportamenti, aggiunte di settori/pianeti e passaggi pratici per testare e distribuire.