ML Particle Generator - Minecraft 1.20.4

Welcome to an exciting new way to experience Minecraft with the ML Particle Generator for Minecraft 1.20.4+! This innovative data pack, created by michaelslife, offers a range of features that will transform your gameplay by allowing for more dynamic and customizable particles in Minecraft.

Key Features and Benefits of ML Particle Generator

• Use items as particles, with the option to set the CustomModelData for a particle to use custom png files.
• Set emitter options like radius, direction, particle count, and more.
• Set visual options like item, scale, brightness, and more.
• Set behavior options like life span, speed, collision, gravity, rotation, and more.
• Set callback commands for events like particle emit, particle tick, and generator trigger.
• Set a trigger area for a player to start the particle generator when in range, and stop when out of range.

Note: The resource pack is only necessary if using the preset particles.

How to Install and Use ML Particle Generator

Follow these simple steps to install and start using the ML Particle Generator:

1. Unzip the MLParticle.zip file in your downloads folder.
2. Place the ml_particle and ml_ces folders into your Minecraft world's datapacks folder.
3. Place the resources.zip file into the main directory of your Minecraft world if you want to use the preset particles.

Editor Setup: First Steps

To be an editor for the Particle Generator System, follow these steps:

1. Run this function: /function ml_particle:editor
2. Once you receive the Particle Editor item, right-click it to create a particle generator at your location.
3. You can also right-click the Particle Editor item when close to an existing particle generator to bring up the main menu.
4. Once you are done editing a generator, click the [Enabled] option next to Location Icon in the main menu to turn off the visual icon for the generator. When the icon is disabled, you won't be able to move the generator around, but you can use your Particle Editor item when near the generator to bring up the menu again.

Generator Options

• Click the [Triggers] option to view the menu where you can enable/disable the trigger for a particle generator. When a player is in range of a trigger, it will start the generator.
• Click the [Presets] option to load various presets for the generator. These can be helpful to understand how the generator works with different settings.
• Click the [Commands] option to view the menu where you can get various commands to use that will perform different actions on the generator, such as start, stop, trigger, summon, or delete.

Emitter Menu: Controls how the generator will emit particles

• The Radius determines how far away from the generator's position a particle can be emitted at random.
• The Direction determines which direction a particle will face when emitted.
• The Max count is the maximum amount of active particles the generator can have at any given time.
• The Burst is how many particles will be emitted at one time.
• The Wait time is how long the generator will wait before emitting another particle.
• The Timer amount is how long the generator will run before it turns itself off.

Visual Menu: Controls what the particles will look like

• The Item Name and CMD values determine which item will be used for the particle.
• The Start and End Scale values determine the size of a particle over time.
• The Billboard option determines if and how the particle will face the player.
• The Brightness value determines how bright the particle will be. If set to Auto, the brightness is determined by the amount of light in the world at the generator's position.
• The Random 2D Rotation option is useful to create a random rotation on the Z axis for particles that always face the player.

Behavior Menu: Controls how the particles will behave

• The Life Span value determines how long the particle will live for.
• The Speed value determines how fast the particle will move, and the Damp value determines if it will slow down or speed up over time.
• The Collision value determines if the particles will collide with blocks in the world.
• The Gravity value determines how fast the particle will move downward, or upward if using a negative value.
• The Turn value determines how fast the particle will turn during its life span.
• The Emit and Tick commands are useful for setting a command that will run when each particle is emitted or on every tick while the particle is active.

Save/Load

• Use the [Save] option in the main menu to save the particle generator in order to summon it or load it on another generator. Once saved, click the [Commands] option in the main menu to view the summon commands.
• Use the [Load] option to get the command that will load the data from a saved generator.

Actions

There are various commands in the datapack that can be run on a particle generator to perform different actions. These include:

• Start: starts the generator
• Stop: stops the generator
• Trigger: triggers the generator once, which will stop when it reaches the Max count
• Trigger Reset: resets the trigger so it can be triggered again in case the amount of times has run out
• Trigger Disable: disables the trigger so that it cannot be triggered by a player
• Trigger Enable: enables the trigger so that a player can trigger it
• Load: loads a saved generator by name
• Delete: deletes a particle generator

Important Notes

• This datapack force loads the chunk at position 0 0.
• This datapack uses the MLCES datapack.
• This datapack sets the game rule commandBlockOutput to false
• To unload the datapack, run this function: /function ml_particle:system/unload
• Add the tag debug to yourself if you want to receive debug warnings or error messages for this datapack.

Don't miss out on the enhanced gameplay that ML Particle Generator offers. Download it today and take your Minecraft adventures to the next level!