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 qualsivoglia contenuto.

• Cosa sono i giochi e le mod?
• Dove vengono salvate le mod?
• Cartella mod
• mod.conf
  • Dipendenze
• Pacchetti mod
• Esempio
  • Cartella mod
  • 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 crearsi da zero il motore grafico, gli algoritmi voxel o tutta la parte di rete.

In Minetest, un gioco è un insieme di moduli che lavorano fianco a fianco per fornire il contenuto e il comportamento di un gioco. Un modulo, solitamente conosciuto come "mod", è una collezione di script e risorse, e in teoria ne potrebbe bastare uno per creare un intero gioco. Tuttavia, questo non accade spesso, perché ridurrebbe la comodità di poter sostituire o calibrare alcune parti in maniera indipendente dalle altre.

È poi anche possibile distribuire singolarmente le varie mod, che diventano mod nel senso più tradizionale del termine: modifiche, per calibrano o espandere le proprietà di un gioco.

Indipendentemente da come le si voglia usare (specifiche per un gioco o come estensioni generiche) usano la stessa API.

Questo libro coprirà le parti principali dell'API di Minetest, ed è pensato sia per chi sviluppa il motore di gioco (Minetest, in C++) che per chi crea 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 esegue controlli in più posti e questi posti sono generalmente chiamati percorsi di caricamento mod (mod load paths).

Per un dato mondo/salvataggio, vengono controllati tre percorsi. 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 percorsi nell'ordine sopraelencato. In caso dovesse incontrare una mod con lo stesso nome di una incontrata in precedenza, l'ultima verrebbe caricata al posto della prima. Ciò significa, per esempio, che è possibile sovrascriverne una di gioco se ve n'è una omonima nelle globali.

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

• Windows:
  • Per le versioni portatili, per esempio da un file .zip, vai dove hai estratto lo zip e cerca le cartelle games, mods e worlds.
  • Per le versioni 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 e ognuna di esse dovrebbe averne uno unico. Questi possono includere lettere, numeri e trattini bassi, e un buon nome dovrebbe descrivere brevemente cosa fa la mod (è anche consigliato rinominare la cartella della mod con il nome di quest'ultima). Per scoprire se un nome è disponibile, prova a cercarlo su content.minetest.net.

lamiamod
├── 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 quando si avvia un gioco; tuttavia è consigliato anche mod.conf, e altri componenti potrebbero essere richiesti a seconda di quello che si vuole fare.

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

Dipendenze

Una dipendenza è quando (all'avvio) una o più mod vengono richieste da un'altra mod. I motivi sono vari: potrebbe per esempio aver bisogno di parti del loro codice, degli oggetti, o in generale di risorse che queste forniscono.

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 non verrà caricata, mentre se è opzionale, verranno semplicemente caricate meno funzionalità.

Le dipendenze sono specificate in un elenco separato da virgole in mod.conf.

depends = mod1, mod2
optional_depends = mod3

Pacchetti mod (mod pack)

Le mod possono essere raggruppate in pacchetti che permettono di confezionarne e spostarne più alla volta. Sono comodi se si vogliono fornire più mod a chi gioca, 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

Segue un esempio che mette insieme tutto ciò discusso finora:

Cartella mod

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

init.lua

print("Questo file parte all'avvio!")

core.register_node("lamiamod:nodo", {
    description = "Questo è un nodo",
    tiles = {"lamiamod_nodo.png"},
    groups = {cracky = 1}
})

mod.conf

name = lamiamod
descriptions = Aggiunge un nodo
depends = default

Questa mod ha come nome "lamiamod". Ha due file di testo: init.lua e mod.conf.\ 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 in Minetest Game.\ C'è anche una texture in textures/ per il nodo.