Creare il Tuo Primo Blocco

I blocchi sono i blocchi di costruzione di Minecraft (perdona il gioco di parole) - proprio come tutto il resto di Minecraft, sono memorizzati in registry.

Preparare la Tua Classe dei Blocchi

Se hai già completato la pagina Creare il Tuo Primo Oggetto, questo processo ti sembrerà molto familiare - dovrai creare un metodo che registri il tuo blocco, e l'oggetto ad esso associato.

Dovresti mettere questo metodo in una classe chiamata ModBlocks (o qualsiasi altro nome).

Mojang fa qualcosa di simile con i suoi blocchi vanilla; informati riguardo alla classe Blocks per sapere come fanno loro.

public class ModBlocks {
	public static Block register(Block block, String name, boolean shouldRegisterItem) {
		// Register the block and its item.
		ResourceLocation id = ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, name);

		// Sometimes, you may not want to register an item for the block.
		// Eg: if it's a technical block like `minecraft:air` or `minecraft:end_gateway`
		if (shouldRegisterItem) {
			BlockItem blockItem = new BlockItem(block, new Item.Properties());
			Registry.register(BuiltInRegistries.ITEM, id, blockItem);
		}

		return Registry.register(BuiltInRegistries.BLOCK, id, block);
	}

}

Proprio come per gli oggetti, dovrai assicurarti che la classe sia caricata, in modo che tutti gli attributi statici contenenti le istanze dei tuoi blocchi siano inizializzati.

Puoi fare questo creando un metodo fittizio initialize, che potrà essere richiamato nell'initializer della tua mod per avviare l'inizializzazione statica.

INFO

Se non sai cos'è l'inizializzazione statica, essa è il processo di inizializzazione degli attributi statici in una classe. Questo viene fatto quando la classe viene caricata dalla JVM, ed è fatto prima che qualsiasi istanza della classe venga creata.

public class ModBlocks {
    // ...

    public static void initialize() {}
}

public class ExampleModBlocks implements ModInitializer {
	@Override
	public void onInitialize() {
		ModBlocks.initialize();
	}
}

Creare e Registrare il Tuo Blocco

In maniera del tutto simile agli oggetti, i blocchi prendono la classe BlockBehaviour.Properties nel costruttore. La classe indica proprietà specifiche del blocco, come i suoi effetti sonori e il livello di estrazione.

Non tratteremo tutte le opzioni qui—puoi vedere la classe da solo per capirne le varie opzioni, che dovrebbero essere chiaramente comprensibili.

Per questo esempio, creeremo un blocco semplice, con le proprietà della terra ma con un materiale diverso.

TIP

Puoi anche usare BlockBehaviour.Properties.ofFullCopy(AbstractBlock block) per copiare le impostazioni di un blocco esistente, in questo caso avremmo potuto usare Blocks.DIRT per copiare le impostazioni della terra, ma per questo esempio useremo il costruttore.

public static final Block CONDENSED_DIRT = register(
		new Block(BlockBehaviour.Properties.of().sound(SoundType.GRASS)),
		"condensed_dirt",
		true
);

Per creare l'oggetto del blocco in automatico, possiamo passare true al parametro shouldRegisterItem del metodo register che abbiamo creato nel passaggio precedente.

Aggiungere il Tuo Blocco ad un Gruppo di Oggetti

Poiché il BlockItem viene creato e registrato in automatico, per aggiungerlo a un gruppo di oggetti devi usare il metodo Block.asItem() per ottenere l'istanza BlockItem.

Per questo esempio, useremo un gruppo di oggetti personalizzato, che abbiamo creato nella pagina Gruppi di Oggetti Personalizzati.

public static final Block CONDENSED_OAK_LOG = register(
		new RotatedPillarBlock(
				BlockBehaviour.Properties.of()
						.sound(SoundType.WOOD)
		), "condensed_oak_log", true
);
	ItemGroupEvents.modifyEntriesEvent(ModItems.CUSTOM_ITEM_GROUP_KEY).register((itemGroup) -> {
		itemGroup.accept(ModBlocks.CONDENSED_DIRT.asItem());
	});

Dovresti ora notare che il tuo blocco è nell'inventario in creativa, e può essere posizionato nel mondo!

Ci sono alcuni problemi tuttavia - il blocco non ha nome, non ha texture e non ha modello né per il blocco né per l'oggetto.

Aggiungere Traduzioni del Blocco

Per aggiungere una traduzione, devi creare una chiave di traduzione nel tuo file di traduzioni - assets/example-mod/lang/en_us.json.

Minecraft userà questa traduzione nell'inventario in creativa e in altri posti in cui il nome del blocco viene mostrato, come nel feedback dei comandi.

{
  "block.example-mod.condensed_dirt": "Condensed Dirt"
}

Per applicare le modifiche, puoi riavviare il gioco o costruire la tua mod e premere F3+T - e dovresti vedere che il blocco ha un nome nell'inventario in creative e in altri posti come nella schermata delle statistiche.

Modelli e Texture

Tutte le texture dei blocchi si trovano nella cartella assets/example-mod/textures/block - ti forniamo una texture di esempio del blocco di "Terra Condensata", che sei libero di usare.

Scarica Texture

Per fare in modo che la texture sia visibile nel gioco, devi creare un blocco e un modello di oggetto, presenti nelle posizioni appropriate al blocco di "Terra Condensata":

• assets/example-mod/models/block/condensed_dirt.json
• assets/example-mod/models/item/condensed_dirt.json

Il modello dell'oggetto è piuttosto semplice, basta che usi il modello del blocco come genitore - poiché la GUI supporta il rendering della maggior parte dei modelli dei blocchi:

{
  "parent": "example-mod:block/condensed_dirt"
}

Nel nostro caso, però, il modello del blocco deve avere come genitore il modello block/cube_all:

{
  "parent": "block/cube_all",
  "textures": {
    "all": "example-mod:block/condensed_dirt"
  }
}

Quando carichi il gioco, potresti notare che la texture è ancora mancante. Questo perché devi aggiungere la definizione degli stati del blocco.

Creare la Definizione degli Stati del Blocco

La definizione degli stati del blocco è usata dal gioco per capire quale modello renderizzare in base allo stato corrente del blocco.

Per il blocco di esempio, che non ha stati complessi, basta una sola voce nella definizione.

Questo file si dovrebbe trovare nella cartella assets/example-mod/blockstates, e il suo nome dovrebbe corrispondere all'ID del blocco che hai usato quando l'hai registrato nella classe ModBlocks. Per esempio, se l'ID è condensed_dirt, il file dovrebbe chiamarsi condensed_dirt.json.

{
  "variants": {
    "": { "model": "example-mod:block/condensed_dirt" }
  }
}

Gli stati dei blocchi sono piuttosto complessi, per cui li tratteremo in un'altra pagina: Stati dei Blocchi

Riavviando il gioco o ricaricando con F3+T per applicare le modifiche - dovresti poter vedere la texture del blocco nell'inventario e fisicamente nel mondo:

Aggiungere Drop al Blocco

Quando si rompe il blocco in sopravvivenza, potresti notare che il blocco non droppa - potresti volere questa funzionalità, ma per fare in modo che il blocco droppi come oggetto quando viene rotto devi implementarne la loot table - il file della loot table dovrebbe essere nella cartella data/example-mod/loot_table/blocks/.

INFO

Per comprendere le loot table nel profondo, fai riferimento alla pagina Minecraft Wiki - Loot Tables.

{
  "type": "minecraft:block",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "example-mod:condensed_dirt"
        }
      ],
      "conditions": [
        {
          "condition": "minecraft:survives_explosion"
        }
      ]
    }
  ]
}

Questa loot table fornisce un solo drop come oggetto del blocco quando viene rotto, o distrutto da un'esplosione.

Consigliare uno Strumento per la Raccolta

Potresti anche volere che il tuo blocco sia ottenibile solo con uno strumento specifico - per esempio, più veloce da ottenere con una pala.

Tutti i tag degli strumenti dovrebbero essere nella cartella data/minecraft/tags/block/mineable/ - e il nome del file dipende dal tipo di strumento usato, uno tra i seguenti:

• hoe.json
• axe.json
• pickaxe.json
• shovel.json

I contenuti del file sono piuttosto semplici - è una lista di oggetti da aggiungere al tag.

Questo esempio aggiunge il blocco "Terra Condensata" al tag shovel.

{
  "replace": false,
  "values": ["example-mod:condensed_dirt"]
}

Se desideri che uno strumento sia necessario per minare il blocco, dovrai aggiungere .requiresTool() alle impostazioni del tuo blocco, oltre che aggiungere il tag dello scavo appropriato.

Livelli di Scavo

Similmente, il tag del livello di scavo si trova nella cartella data/minecraft/tags/block/, e segue il seguente formato:

• needs_stone_tool.json - Almeno strumenti di pietra
• needs_iron_tool.json - Almeno strumenti di ferro
• needs_diamond_tool.json - Almeno strumenti di diamante

Il file ha lo stesso formato di quello per la raccolta - una lista di oggetti da aggiungere al tag.

Note Aggiuntive

Se stai aggiungendo più blocchi alla tua mod, potresti voler usare la Data Generation per automatizzare il processo di creazione dei modelli di blocchi e oggetti, delle definizioni degli stati del blocco, e delle loot table.