ItemClear

🧹 ItemClear

A powerful Minecraft Spigot/Paper plugin that automatically removes items from the ground to optimize server performance.

📋 Features

• Automatic Item Clearing - Removes items at configurable time intervals
• Warning System - Warns players before item clear
• Fully Customizable - All messages and timings configurable
• Admin Command - Manual item clearing via command
• Multi-World Support - Works in all worlds simultaneously
• Performance Optimized - Minimal server load
• Permission System - Secure permission management

🚀 Installation

1. Download the latest version of ItemClear
2. Place the .jar file in your plugins folder
3. Restart the server or load the plugin with a plugin manager
4. Configure the plugin to your preferences in the config.yml

⚙️ Configuration

The config.yml is automatically created on first startup:

# Clear interval in seconds
clear-interval: 600

# Warning timer before the clear happens
warning-time: 60

# Message displayed when items are cleared
clear-message: '&6[ItemClear] &cAll items have been removed from the ground!'

# Warning displayed when items will be cleared
warning-message: '&6[ItemClear] &eAttention! All items will be removed from the ground in one minute!'

# Command messages
command-success-message: '&6[ItemClear] &aItem Clear was executed immediately!'
command-broadcast-message: '&6[ItemClear] &eAn admin has manually triggered the Item Clear!'
command-no-permission-message: '&6[ItemClear] &cYou do not have permission for this command!'
command-player-only-message: '&6[ItemClear] &cThis command can only be executed by players!'

🎨 Color Codes

The plugin supports Minecraft color codes with the & symbol:

🎮 Commands

🔐 Permissions

🛠️ Development

Requirements

Clone the Repo from Github https://github.com/zKinqJustin/ItemClear

• Java 21 or higher
• Maven 3.6+
• Paper API 1.21

Build

mvn clean package

The compiled .jar file can be found in the target folder.

Project Structure

ItemClear/
├── src/
│   └── main/
│       ├── java/
│       │   └── de/zkinqjustin/itemClear/
│       │       ├── ItemClear.java
│       │       └── commands/
│       │           └── ItemClearCommand.java
│       └── resources/
│           ├── plugin.yml
│           └── config.yml
├── pom.xml
└── README.md

📊 How It Works

1. Automatic Mode: The plugin starts a timer based on the clear-interval
2. Warning: A warning is sent warning-time seconds before the clear
3. Clearing: All items are removed from all worlds
4. Repeat: The process repeats automatically

🤝 Support

For questions or issues:

• Create an issue on GitHub
• Contact the developer: zKinqJustinTW

📝 Changelog

Version 1.0

• Initial Release
• Automatic Item Clearing
• Warning System
• Admin Command
• Fully Configurable

👨‍💻 Author

zKinqJustinTW

📄 License

This project is licensed under the MIT License.

---

Made with by zKinqJustinTW