- 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
- Download the latest ButcherItems.jar.
- Place the JAR file inside your server's plugins folder.
- Restart your server.
- 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
- 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
| Command | Permission | Description |
|---|---|---|
| /clearlag | butcheritems.clearlag | Manually 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.
Compatibility
- Nukkit-based servers.
- Java 17 or newer.
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/ButcherItemsDeveloped by BrunoJaegerK
If you like the plugin, please leave a 5-star review.