Butcher Items

Butcher Items 1.1.0

Compatible API Versions
1.1.0
Sourcecode
https://github.com/BrunoJaegerK/butcheritems
Contributors
https://github.com/BrunoJaegerK

ButcherItems – Lightweight Entity Cleaner​

Keep your Nukkit server clean and reduce unnecessary entity accumulation!

ButcherItems is a lightweight entity cleanup plugin designed for Nukkit-based Minecraft Bedrock servers. It automatically removes unnecessary entities at configurable intervals, helping server administrators manage entity accumulation and maintain a cleaner server environment.

Unlike basic cleanup plugins, ButcherItems allows you to customize exactly what should be protected from removal, including specific entity types and entire worlds.

✨ Features​

  • Automatic Entity Cleanup: Automatically removes entities at configurable intervals.
  • Manual Cleanup: Execute cleanup whenever needed using /clearlag.
  • Entity Exclusions: Configure specific entity types that should never be removed.
  • World Exclusions: Protect entire worlds from automatic cleanup.
  • Hologram Protection: Automatically protects holograms created by PetteriM1 Holograms and Cloudburst Holograms.
  • Pet Protection: Includes automatic protection for LlamaPets entities.
  • Named Entity Protection: Configure whether entities with custom names should be removed.
  • Custom Announcements: Choose between chat messages, titles, and actionbar notifications.
  • Customizable Messages: Edit cleanup messages, prefixes, and notifications.
  • PlaceholderAPI Integration: Supports the %clearlag% placeholder when PlaceholderAPI is installed.
  • Java 17: Updated to use Java 17.

📥 Installation​

  1. Download the latest ButcherItems.jar.
  2. Place the JAR file inside your server's plugins folder.
  3. Restart your server.
  4. Edit the generated config.yml and messages.yml files to customize the plugin.

⚙️ Configuration​

config.yml​

Code:
Schedule: 300
Announcement: title
KillEntitiesWithNametags: true

ExcludedEntities:
- ZOMBIE
- CREEPER

ExcludedWorlds:
- lobby
- build

Announcements:
- 60
- 30
- 15
- 10
- 5
- 4
- 3
- 2
- 1
Configuration options:

  • Schedule: Time between cleanup cycles, in seconds.
  • Announcement: Notification type (chat, title, or actionbar).
  • KillEntitiesWithNametags: If true, named entities can be removed. Set to false to protect entities with custom names.
  • ExcludedEntities: Entity types that should never be removed.
  • ExcludedWorlds: Worlds that should be completely ignored by the cleanup system.
  • Announcements: Remaining seconds at which players receive notifications. Use [] to disable countdown announcements.

messages.yml​

Customize the plugin prefix, cleanup messages, titles, actionbar notifications, and singular/plural entity and time labels.

🛡️ Protected Entities​

ButcherItems automatically protects:

  • Players.
  • Paintings.
  • Boats and vehicles.
  • End Crystals.
  • Holograms from PetteriM1 Holograms.
  • Holograms from Cloudburst Holograms.
  • LlamaPets entities.

💻 Commands & Permissions​

CommandPermissionDescription
/clearlagbutcheritems.clearlagManually removes eligible entities.

🔌 Optional Integrations​

  • PlaceholderAPI: Enables the %clearlag% placeholder.
  • LlamaPets: Automatically protects pet entities.
  • PetteriM1 Holograms: Automatically protects holograms.
  • Cloudburst Holograms: Automatically protects holograms.
These integrations are optional. ButcherItems does not require them to operate.

🧩 Compatibility​

  • Nukkit-based servers.
  • Java 17 or newer.
Compatibility with individual Nukkit forks may depend on their API implementation.

🐛 Bug Reports & Suggestions​

Found a bug or have an idea for a new feature?

Please report it through the GitHub Issues page.

🔗 Source Code​

GitHub Repository – BrunoJaegerK/ButcherItems


Developed by BrunoJaegerK

If you like the plugin, please leave a 5-star review.
  • Like
Reactions: indra87g
Author
BrunoJaegerK
Downloads
938
Views
1,380
First release
Last update

Ratings

0.00 star(s) 0 ratings

More resources from BrunoJaegerK

Latest updates

  1. Update 1.1.0

    - Multiworld support - MultiMob support - Hologram support
  2. GitHub repository created

    I added the repository directly from GitHub; if you have any suggestions for improvements...
Back
Top