Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AtlasEngineCa/ParticleEmitter
Library for drawing particle effects in Minecraft java edition using bedrock json files
https://github.com/AtlasEngineCa/ParticleEmitter
minecraft minecraft-java-edition minestom-library snowstorm
Last synced: 6 days ago
JSON representation
Library for drawing particle effects in Minecraft java edition using bedrock json files
- Host: GitHub
- URL: https://github.com/AtlasEngineCa/ParticleEmitter
- Owner: AtlasEngineCa
- License: apache-2.0
- Created: 2022-10-15T01:47:10.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-21T21:45:46.000Z (3 months ago)
- Last Synced: 2024-11-02T16:02:58.492Z (18 days ago)
- Topics: minecraft, minecraft-java-edition, minestom-library, snowstorm
- Language: Java
- Homepage:
- Size: 1.03 MB
- Stars: 49
- Watchers: 2
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-minestom - ParticleEmitter - Library for drawing particle effects with [Snowstorm](https://snowstorm.app/) (Libraries)
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![APACHE-2.0 License][license-shield]][license-url]
## About The Project
With this library, you can design particle animations with [snowstorm](https://snowstorm.app/) and draw them in a Minecraft world.
Currently only [Minestom](https://github.com/Minestom/Minestom) is supported.
## Getting Started
A full, runnable example server can be found in [here](https://github.com/WorldSeedGames/ParticleEmitter/blob/master/src/test/java/Demo.java)
Particle examples can be found [here](https://github.com/WorldSeedGames/ParticleEmitter/tree/master/src/test/resources/particles)
### Adding as a dependency
Add the following to your `build.gradle.kts` file:
```
repositories {
maven("https://reposilite.worldseed.online/public")
}
```
Add the library as a dependency
```
dependencies {
implementation("net.worldseed.particleemitter:ParticleEmitter:")
}
```
The lastest version number can be found [here](https://reposilite.worldseed.online/#/public/net/worldseed/particleemitter/ParticleEmitter)
### JAVA FLAGS
To execute the code you must add the java VM flag `--add-opens java.base/java.lang=ALL-UNNAMED`.
## Features
ParticleEmitter supports the following features
- Emitter lifetime expression, loop and once
- Emitter rate instant and steady
- Emitter shape box, disc, point and sphere
- Particle tinting (colour)
## Limitations
[Minecraft Query Language](https://github.com/hollow-cube/common/tree/main/modules/mql) (MQL) does not fully support Molang
- Variables do not work
- Functions do not work
Particle Restrictions
- Velocity only works on certain particles and acceleration don't work on any particles
- Custom particle textures don't work
- Curves have not been implemented
- Particle lifetimes have not been implemented
## Usage notes
### Particle amounts
You may notice in practice that only one particle gets spawned per `emitter.tick()`.
In some cases, this may be a problem as you may want to have more control over the amount of particles spawned for the same animation as demonstrated in the following video where the same animation is being played in 4 different positions with differing particle amounts:
https://github.com/user-attachments/assets/8fd4f277-eb8d-4a3e-b068-18533f72346a
This can be achieved by using a for loop around the `emitter.tick()` like so:
```java
Collection packets = new ArrayList<>();
for (int i = 0; i < amount; i++) {
packets.addAll(emitter.tick());
}
if (emitter.status() != EmitterLifetime.LifetimeState.DEAD) {
packets.forEach(packet -> {
instance.getPlayers().forEach(p -> p.sendPackets(packet));
});
}
```
However, this method will require each emitter to have a different `updatesPerSecond` parameter equal to `x*amount` for the animations to be synchronised and play at the same time with differing particle counts, otherwise the animation may speed up or slow down.
```java
List emitters = new ArrayList<>();
{
var emitter = ParticleParser.parse(Particle.DUST_COLOR_TRANSITION, 1000*amount, map);
emitters.add(emitter);
}
```
Sample code for how this can be done in practice can be found in the `src/test/java/ParticleManagerDemo.java` file, where the video demonstration above was created with these calls:
```java
ParticleManager.playParticle("rect.particle.json", new Vec(0, 45, 0), 1, instanceContainer, false);
ParticleManager.playParticle("rect.particle.json", new Vec(3, 45, 0), 2, instanceContainer, false);
ParticleManager.playParticle("rect.particle.json", new Vec(6, 45, 0), 3, instanceContainer, false);
ParticleManager.playParticle("rect.particle.json", new Vec(9, 45, 0), 4, instanceContainer, false);
```
### Playing a particle animation "once" over its lifetime
If you want to have an animation play just once over its lifetime, you will need to use a Timer that gets cancelled once the emitter state is "DEAD" (meaning the animation completed successfully). Here is how that would be done in practice:
```java
new Timer().schedule(new TimerTask() {
public void run() {
try {
for (var emitter : emitters) {
for (int i = 0; i < amount; i++) {
Collection packets = emitter.tick();
if (emitter.status() != EmitterLifetime.LifetimeState.DEAD) {
packets.forEach(packet -> {
instance.getPlayers().forEach(p -> p.sendPackets(packet));
});
} else {
emitter.reset();
// Cancel the timer so it doesn't keep looping
this.cancel();
}
}
}
} catch (InvocationTargetException | NoSuchMethodException | InstantiationException |
IllegalAccessException e) {
throw new RuntimeException(e);
}
}
}, 1, 1);
```
[contributors-shield]: https://img.shields.io/github/contributors/WorldSeedGames/ParticleEmitter.svg?style=for-the-badge
[contributors-url]: https://github.com/WorldSeedGames/ParticleEmitter/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/WorldSeedGames/ParticleEmitter.svg?style=for-the-badge
[forks-url]: https://github.com/othneildrew/Best-README-Template/network/members
[stars-shield]: https://img.shields.io/github/stars/WorldSeedGames/ParticleEmitter.svg?style=for-the-badge
[stars-url]: https://github.com/WorldSeedGames/ParticleEmitter/stargazers
[issues-shield]: https://img.shields.io/github/issues/WorldSeedGames/ParticleEmitter.svg?style=for-the-badge
[issues-url]: https://github.com/WorldSeedGames/ParticleEmitter/issues
[license-shield]: https://img.shields.io/github/license/WorldSeedGames/ParticleEmitter?style=for-the-badge
[license-url]: https://github.com/WorldSeedGames/ParticleEmitter/blob/master/LICENSE
