minetest_modding_book/_it/basics/getting_started.md

title	layout	root	idx	description	redirect_from
Per iniziare	default	../..	1.1	Impara come si crea la cartella di una mod, un file init.lua, mod.conf e altro.	/it/chapters/folders.html /it/basics/folders.html

Introduzione

Capire la struttura base della cartella di una mod è un requisito essenziale per creare mod.

• Cosa sono i giochi e le mod?
• Dove vengono salvate le mod?
• Cartella mod
• Dipendenze
  • mod.conf
  • depends.txt
• Pacchetti mod
• Esempio
  • Cartella mod
  • depends.txt
  • init.lua
  • mod.conf

Cosa sono i giochi e le mod?

Il punto forte di Minetest è l'abilità di sviluppare facilmente giochi senza il bisogno di crearti da zero il motore grafico, gli algoritmi voxel o tutta la parte network.

In Minetest, un gioco è una collezione di moduli che lavorano insieme per fornire il contenuto e il comportamento di un gioco. Un modulo, solitamente conosciuto come "mod" (femminile), è una collezione di script e risorse. È possibile creare un gioco usando semplicemente una mod, ma questo non accade spesso perché riduce la comodità di poter sostituire o calibrare alcune parti del gioco in maniera indipendente dalle altre.

È anche possibile distribuire le mod al di fuori di un gioco, nel qual caso sono sempre mod nel senso più tradizionale del termine: modifiche. Queste mod calibrano o espandono le proprietà di un gioco.

Sia le mod presenti in un gioco che quelle a sé stanti usano la stessa API.

Questo libro coprirà le parti principali della API di Minetest, ed è applicabile sia per gli sviluppatori che per i creatori di mod.

Dove vengono salvate le mod?

Ogni mod ha la sua cartella personale dove viene messo il suo codice in Lua, le sue texture, i suoi modelli e i suoi file audio. Minetest fa un check in più punti per le mod. Questi punti sono generalmente chiamati percorsi di caricamento mod (in inglese mod load paths).

Per un dato mondo/salvataggio, vengono controllati tre punti. Essi sono, in ordine:

1. Mod di gioco. Queste sono le mod che compongono il gioco che il mondo sta eseguendo. Es: minetest/games/minetest_game/mods/, /usr/share/minetest/games/minetest/
2. Mod globali. Il luogo dove le mod vengono quasi sempre installate. Se si è in dubbio, le si metta qui. Es: minetest/mods/
3. Mod del mondo. Il luogo dove mettere le mod che sono specifiche di un dato mondo. Es: minetest/worlds/world/worldmods/

Minetest controllerà questi punti nell'ordine sopraelencato. Se incontra una mod con lo stesso nome di una incontrata in precedenza, l'ultima verrà caricata al posto della prima. Questo significa che si può sovrascrivere le mod di gioco piazzando una mod con lo stesso nome nella cartella delle mod globali.

La posizione di ogni percorso di caricamento mod dipende da quale sistema operativo si sta usando, e come è stato installato Minetest.

• Windows:
  • Per le build portatili, per esempio da un file .zip, vai dove hai estratto lo zip e cerca le cartelle games, mods e worlds.
  • Per le build installate, per esempio da un setup.exe, guarda in C:\\Minetest o C:\\Games\Minetest.
• GNU/Linux:
  • Per le installazioni di sistema, guarda in ~/.minetest. Attenzione che ~ equivale alla cartella home dell'utente, e che i file e le cartelle che iniziano con un punto (.) sono nascosti di default.
  • Per le installazioni portatili, guarda nella cartella di build.
  • Per installazioni Flatpak, guarda in ~/.var/app/net.minetest.Minetest/.minetest/mods/.
• MacOS
  • Guarda in ~/Library/Application Support/minetest/. Attenzione che ~ equivale alla cartella home dell'utente, per esempio /Users/USERNAME/.

Cartella mod


Il nome mod è usato per riferirsi a una mod. Ogni mod dovrebbe avere un nome unico. I nomi mod possono includere lettere, numeri e trattini bassi. Un buon nome dovrebbe descrivere cosa fa la mod, e la cartella che contiene i componenti di una mod deve avere lo stesso nome del nome mod. Per scoprire se un nome mod è disponibile, prova a cercarlo su content.minetest.net.

mymod
├── init.lua (necessario) - Viene eseguito al lancio del gioco.
├── mod.conf (consigliato) - Contiene la descrizione e le dipendneze.
├── textures (opzionale)
│   └── ... qualsiasi texture o immagine
├── sounds (opzionale)
│   └── ... qualsiasi file audio
└── ... qualsiasi altro tipo di file o cartelle

Solo il file init.lua è necessario in una mod per eseguirla al lanciare un gioco; tuttavia, mod.conf è consigliato e altri componenti potrebbero essere richiesti a seconda della funzione della mod.

Dipendenze

Una dipendenza avviene quando una mod richiede che un'altra mod sia avviata prima di essa. Una mod potrebbe infatti richiedere il codice di quest'ultima, i suoi oggetti o altre risorse.

Ci sono due tipi di dipendenze: forti e opzionali. Entrambe richiedono che la mod richiesta venga caricata prima, con la differenza che se la dipendenza è forte e la mod non viene trovata, l'altra fallirà nel caricare, mentre se è opzionale, verranno semplicemente caricate meno feature.

Una dipendenza opzionale è utile se si vuole integrare opzionalmente un'altra mod; può abilitare contenuti extra se l'utente desidera usare entrambe le mod in contemporanea.

Le dipendenze vanno elencate in mod.conf.

mod.conf

Questo file è utilizzato per i metadati della mod, che includono il suo nome, la descrizione e altre informazioni. Per esempio:

name = lamiamod
description = Aggiunge X, Y, e Z.
depends = mod1, mod2
optional_depends = mod3

depends.txt

Per questioni di compatibilità con le versioni 0.4.x di Minetest, al posto di specificare le dipendenze solamente in mod.conf, c'è bisogno di fornire un file depends.txt nel quale vanno elencate tutte le dipendenze:

mod1
mod2
mod3?

Ogni nome mod occupa una riga, e i nomi mod seguiti da un punto di domanda indicano una dipendenza opzionale.

Pacchetti mod (mod pack)

Le mod possono essere raggruppate in pacchetti che permettono a più mod di essere confezionate e spostate insieme. Sono comodi se si vogliono fornire più mod al giocatore, ma non si vuole al tempo stesso fargliele scaricare una per una.

pacchettomod1
├── modpack.lua (necessario) - segnala che è un pacchetto mod
├── mod1
│   └── ... file mod
└── mymod (opzionale)
    └── ... file mod

Attenzione che un pacchetto mod non equivale a un gioco. I giochi hanno una propria struttura organizzativa che verrà spiegata nel loro apposito capitolo.

Esempio

Here is an example which puts all of this together:

Cartella mod

lamiamod
├── textures
│   └── lamiamod_nodo.png
├── depends.txt
├── init.lua
└── mod.conf

depends.txt

default

init.lua

print("Questo file parte al caricamento!")

minetest.register_node("mymod:nodo", {
    description = "Questo è un nodo",
    tiles = {"mymod_nodo.png"},
    groups = {cracky = 1}
})

mod.conf

name = lamiamod
descriptions = Aggiunge un nodo
depends = default

Questa mod ha il nome "lamiamod". Ha tre file di testo: init.lua, mod.conf e depends.txt.\ Lo script stampa un messaggio e poi registra un nodo – che sarà spiegato nel prossimo capitolo.\ C'è una sola dipendenza, la mod default, che si trova solitamente nel Minetest Game.\ C'è anche una texture in textures/ per il nodo.