ItemClear

🧹 ItemClear

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

Minecraft Version

Java Version

License

📋 Features

- ⏰ Permission System - Removes items at configurable time intervals - ⚠️ Permission System - Warns players before item clear - 🎨 Permission System - All messages and timings configurable - 🔧 Permission System - Manual item clearing via command - 🌍 Permission System - Works in all worlds simultaneously - 🎯 Permission System - 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:

```yaml

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

```bash 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. Repeat: The plugin starts a timer based on the `clear-interval` 2. Repeat: A warning is sent `warning-time` seconds before the clear 3. Repeat: 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.

---

<p align="center">Made with ❤️ by zKinqJustinTW</p>