ItemClear - Keep Your Server Tidy
What does ItemClear do?
ItemClear is a simple yet effective plugin designed to automatically remove dropped items from the ground at regular intervals. This helps to reduce server lag caused by excessive item entities and keeps your world clean.
Features:
- Automatically removes dropped items periodically.
- Configurable Timer: Set the interval (in seconds) between item clears in the config.yml.
- Warning Messages: Configure multiple warning messages to be broadcasted globally before items are cleared (e.g., 3 minutes, 1 minute, 30 seconds before). Messages support color codes (&) and placeholders (%time%, %seconds%).
- Item Exclusion: Specify a list of item types (e.g., DIAMOND, NETHERITE_SWORD) in the config.yml that should not be removed.
- Optimized Performance: The plugin only checks for items in currently loaded chunks, minimizing performance impact.
- Confirmation message after items have been cleared.
- Simple setup: Just drop it in your plugins folder!
Installation:
- Download the ItemClear.jar file.
- Place the JAR file into your server's /plugins directory.
- Restart or reload your server.
- Configure the plugin via the generated config.yml file in /plugins/ItemClear/.
Configuration (plugins/ItemClear/config.yml):
Here is the default configuration file with explanations:
Code (YAML):
# Configuration for the ItemClearPlugin
# Interval in seconds after which all dropped items will be removed
# Default: 300 (5 minutes)
cycleSeconds
: 300
# Warnings: Key is the number of seconds *before* the clear, value is the message.
# Placeholders: %time% (formatted time like "3 minutes and 0 seconds"), %seconds% (total seconds remaining)
# You can add or remove warning times.
warnings:
180
:
"&6&lAethelgard &8&l» &7All dropped items will be removed in &c%time% &7(&c%seconds% seconds&7)!"
# 3 minutes before
60
:
"&6&lAethelgard &8&l» &7All dropped items will be removed in &c%time% &7(&c%seconds% seconds&7)!"
# 1 minute before
30
:
"&6&lAethelgard &8&l» &eWarning! &7Items will be removed in &c%seconds% seconds!"
# 30 seconds before
10
:
"&6&lAethelgard &8&l» &eLast Warning! &7Items will be removed in &c%seconds% seconds!"
# 10 seconds before
# Message sent after the clear
# Default: "&6&lAethelgard &8&l» &cAll dropped items have been removed!"
msgClear
:
"&6&lAethelgard &8&l» &cAll dropped items have been removed!"
# List of Material names (see Bukkit Material Enum) that should NOT be removed.
# Example: NETHERITE_INGOT, DIAMOND_BLOCK
# Make sure to use the correct Material names from Bukkit/Spigot API.
excludedItems
:
[
]
# - DIAMOND
# - NETHERITE_SWORD
# - GOLD_INGOT
Commands & Permissions:
This plugin currently has no commands or specific permissions.
Support & Issues:
If you encounter any bugs or have suggestions, please use the discussion thread or report issues [Link zu deinem Issue Tracker, falls vorhanden, z.B. GitHub].