Skip to content

Conversation

@nicholasveronico
Copy link
Collaborator

This pull request updates the library to support new Minecraft particle effects introduced in version 1.21.10 and refactors code for improved clarity and consistency. The most important changes include adding support for new particles, updating the minimum supported Minecraft version, and introducing the new ColorParticleOption class, which was introduced in 1.20.5. This new class changes how coloured particles are encoded, now using ARGB values for certain particles that support setting brightness/alpha values.

Tested versions

  • 1.8.8 (<1.13)
  • 1.20.4 (<1.20.5)
  • 1.21.8 (>1.20.5)
  • 1.21.10 (>1.20.5)

New particle support

  • Added new particle effects: COPPER_FIRE_FLAME, FIREFLY, and TINTED_LEAVES to ParticleEffect, including documentation and version checks for each. [1] [2] [3] [4] [5] [6]
  • Updated SPELL_MOB and SPELL_MOB_AMBIENT to use the REGULAR_COLOR property and adjusted version checks for ambient particles. Note: SPELL_MOB_AMBIENT has been removed as of 1.20.5 and has been merged with entity_effect [1] [2]
  • Improved colour handling for particles, including the addition of an alpha parameter for colour brightness in ParticleBuilder.

Minecraft version support

  • Increased the minimum supported Minecraft version from 1.21.4 to 1.21.10 in gradle.properties.

Internal API extensions

  • Added new constants and reflection logic in ParticleConstants for ColorParticleOption class, methods, and constructors to support new colourable particle features. [1] [2] [3] [4] [5] [6]

@nicholasveronico nicholasveronico merged commit 0644867 into master Oct 27, 2025
2 checks passed
github-actions bot pushed a commit that referenced this pull request Oct 27, 2025
# [1.4.0](v1.3.2...v1.4.0) (2025-10-27)

### Features

* 1.21.5 - 1.21.10 support ([#8](#8)) ([0644867](0644867))
@github-actions
Copy link

🎉 This PR is included in version 1.4.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@GeorgeV220
Copy link
Owner

I can't thank you enough for maintaining this project!! You are awesome ^-^

@nicholasveronico
Copy link
Collaborator Author

I can't thank you enough for maintaining this project!! You are awesome ^-^

My pleasure!

@GeorgeV220 GeorgeV220 deleted the feat/1.21.5-10 branch December 14, 2025 07:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants