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