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:

Code	Color	Code	Color
&0	Black	&8	Dark Gray
&1	Dark Blue	&9	Blue
&2	Dark Green	&a	Green
&3	Dark Aqua	&b	Aqua
&4	Dark Red	&c	Red
&5	Dark Purple	&d	Pink
&6	Gold	&e	Yellow
&7	Gray	&f	White

🎮 Commands

Command	Description	Permission	Aliases
/ic	Executes Item Clear immediately	itemclear.admin or OP	-

🔐 Permissions

Permission	Description	Default
itemclear.admin	Allows usage of the /ic command	OP

🛠️ 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