AntiDamageParticles

Version: 1.0
Minecraft Version: 1.21.x
Authors: Forwynn
Dependencies: ProtocolLib (required)

Description

AntiDamageParticles is a lightweight Spigot plugin that completely removes the red damage indicator particles (those annoying floating hearts/dots when entities take damage).

This is especially useful for RPG, MMO, PvP, or any server where:

• Players deal very high damage numbers
• Large groups of mobs/players are fighting
• Damage particles cause noticeable client lag or visual clutter

By intercepting and blocking the DAMAGE_INDICATOR particle packets using ProtocolLib, the plugin prevents them from ever being sent to clients thus reducing lag and improving clarity without affecting actual damage mechanics.

Features

• Permanently blocks damage indicator particles (Particle.DAMAGE_INDICATOR)
• Extremely lightweight. It only listens to particle packets
• Works on Minecraft 1.21 and compatible versions

Requirements

• Server: Spigot / Paper 1.21 or newer
• Dependency: ProtocolLib (must be installed on the server)

Installation

1. Download the latest release (.jar file)
2. Place it in your server's plugins/ folder
3. Make sure ProtocolLib is also installed
4. Restart (or reload) the server

That's it! No config files, no commands, no permissions needed.

How It Works

The plugin uses ProtocolLib to intercept outgoing WORLD_PARTICLES packets (Play.Server.WORLD_PARTICLES).
When it detects a packet containing the DAMAGE_INDICATOR particle, the packet is cancelled before it reaches the client.

How to Compile

This plugin uses a standard Maven project structure.

Prerequisites

• Java 21+ (for Minecraft 1.21)
• Maven installed
• IDE recommended: IntelliJ IDEA (Community or Ultimate)

Steps

1. Clone / download the project

2. Make sure you have a valid pom.xml with at least these entries:

   <repositories>
       <repository>
           <id>spigot-repo</id>
           <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
       </repository>
   </repositories>
   
   <dependencies>
       <dependency>
           <groupId>org.spigotmc</groupId>
           <artifactId>spigot-api</artifactId>
           <version>1.21-R0.1-SNAPSHOT</version>
           <scope>provided</scope>
       </dependency>
       <dependency>
           <groupId>com.comphenix.protocol</groupId>
           <artifactId>ProtocolLib</artifactId>
           <version>5.4.0</version>
           <scope>provided</scope>
       </dependency>
   </dependencies>
   
   <build>
       <plugins>
           <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-compiler-plugin</artifactId>
               <version>3.13.0</version>
               <configuration>
                   <source>17</source>
                   <target>17</target>
               </configuration>
           </plugin>
       </plugins>
   </build>

3. Open the project in your IDE

4. Run Maven build:

   • IntelliJ: Maven -> Maven project name -> Right click -> Run Maven Build
   • Command line:

     mvn clean package

5. Find the compiled .jar in the target/ folder (e.g. AntiDamageParticles-1.0.jar)

Contributing

Feel free to open issues or pull requests if you'd like to add configurable particle blocking, support for more particle types, or performance improvements.

License

MIT License