Le particelle sono uno strumento potente. Possono aggiungere atmosfera a una bella scena, o aggiungere tensione durante una battaglia contro il boss. Aggiungiamone una!

Registrare una Particella Personalizzata

Aggiungeremo una nuova particella "sparkle" che mimerà il movimento di una particella di una barra dell'End.

Devi prima registrare un ParticleType nell'initializer della tua mod usando l'id della mod.

// This DefaultParticleType gets called when you want to use your particle in code.
public static final SimpleParticleType SPARKLE_PARTICLE = FabricParticleTypes.simple();

	// Register our custom particle type in the mod initializer.
	Registry.register(Registries.PARTICLE_TYPE, Identifier.of(MOD_ID, "sparkle_particle"), SPARKLE_PARTICLE);

La stringa "sparkle_particle" in minuscolo è il percorso JSON per la texture della particella. Dovrai successivamente creare un nuovo file JSON con lo stesso nome.

Registrazione Lato-Client

Dopo aver registrato la particella nell'initializer della tua mod, dovrai anche registrare la particella nell'initializer lato client.

// For this example, we will use the end rod particle behaviour.
ParticleFactoryRegistry.getInstance().register(FabricDocsReference.SPARKLE_PARTICLE, EndRodParticle.Factory::new);

In questo esempio, stiamo registrando la nostra particella dal lato client. Stiamo dando un po' di movimento alla particella usando la fabbrica della particella della barra dell'End. Questo vuol dire che la nostra particella si muoverà proprio come una particella di una barra dell'End.

TIP

You can see all the particle factories by looking at all the implementations of the ParticleFactory interface. This is helpful if you want to use another particle's behaviour for your own particle.

• Combinazione per IntelliJ: Ctrl+Alt+B
• Combinazione per Visual Studio Code: Ctrl+F12

Creare un File JSON e Aggiungere le Texture

Dovrai creare 2 cartelle all'interno della cartella resources/assets/mod-id/.

Percorso della Cartella	Spiegazione
/textures/particle	La cartella particle conterrà tutte le texture per tutte le tue particelle.
/particles	La cartella particles conterrà tutti i file json per tutte le tue particelle.

Per questo esempio, avremo una sola texture in textures/particle chiamata "sparkle_particle_texture.png".

Dopo, crea un nuovo file JSON in particles con lo stesso nome del percorso JSON che hai usato quando hai registrato il tuo ParticleType. Per questo esempio, dovremo creare sparkle_particle.json. Questo file è importante perché fa conoscere a Minecraft quali texture dovrebbe usare la nostra particella.

{
  "textures": ["fabric-docs-reference:sparkle_particle_texture"]
}

TIP

Puoi aggiungere altre texture al vettore textures per creare un animazione per la particella. La particella scorrerà attraverso le texture nel vettore, iniziando dalla prima.

Testare la Nuova Particella

Una volta completato il file JSON e salvato il tuo lavoro, puoi aprire Minecraft e testare tutto!

Puoi controllare se tutto ha funzionato scrivendo il comando seguente:

/particle fabric-docs-reference:sparkle_particle ~ ~1 ~

INFO

La particella comparirà all'interno del giocatore con questo comando. Probabilmente dovrai camminare all'indietro per vederla effettivamente.

In alternativa, puoi anche usare un blocco comandi per far apparire la particella usando lo stesso comando.