ClearItem - 智能、轻量级的物品与实体清理插件
ClearItem 是一款简洁、快速且支持多语言的 Bukkit、Spigot 和 Paper 服务器清理插件。它旨在通过自动移除掉落的物品来保持服务器世界的整洁,同时赋予服务器管理员完全的控制权,以决定清理哪些内容、何时进行清理、影响哪些世界以及谁可以使用每条命令。
ClearItem 专注于轻量化、配置简单,并且适合日常生存服务器使用。它包含自动清理、手动清理、警告消息、图形化管理菜单、玩家垃圾桶、PlaceholderAPI 支持、LuckPerms 支持、更新通知和多语言命令支持等功能。
支持的版本
ClearItem 基于 Java 8 兼容性构建,并使用 Bukkit/Spigot 1.16 API 作为其兼容基础。
支持的 Minecraft 服务器范围:
Minecraft 1.16.5 至最新的 1.21.x 服务器。
该插件适用于基于 Bukkit、Spigot 和 Paper 的服务器。
主要功能
轻量级掉落物品清理
ClearItem 会在可配置的时间间隔后自动移除地面上的掉落物品实体。这有助于减少实体堆积,提高世界整洁度,并可能减轻因过多掉落物品导致的性能压力。
正确的堆叠计数
ClearItem 计算实际的物品数量,而不仅仅是实体堆叠数。例如,一组 64 个钻石被计为 64 个被移除的物品,而不是 1 个被移除的实体。清理消息和分析报告显示更准确的数字。
可配置的清理间隔
服务器管理员可以选择自动清理运行的频率。间隔支持简单的时间格式,如秒、分钟、小时或原始秒数。
支持的间隔示例:
30s
5m
1h
300
清理前的警告消息
ClearItem 可以在清理发生前广播警告消息。警告时间可配置,允许玩家在清理开始前拾取重要物品。
示例警告时间:
60 seconds
30 seconds
10 seconds
5 seconds
手动清理命令
授权的工作人员可以随时使用 clear 命令手动启动清理。当某个世界的掉落物品过多,或者工作人员希望立即清理服务器时,这非常有用。
世界黑名单和白名单系统
ClearItem 可以控制受清理影响的世界。
黑名单模式 (BLACKLIST):
列出的世界将不会被清理。
白名单模式 (WHITLIST):
仅列出的世界将被清理。
这使得排除事件世界、农场世界、小游戏世界、管理员测试世界或其他任何特殊世界成为可能。
物品黑名单和白名单系统
ClearItem 包含一个 items.yml 过滤器文件。服务器管理员可以选择列出的材料是受到保护还是只有列出的材料应该被清理。
黑名单模式 (BLACKLIST):
在 items.yml 中列出的物品受到保护,不会被移除。
白名单模式 (WHITELIST):
仅在 items.yml 中列出的物品会被移除。
这对于保护贵重物品(如钻石、下界合金工具、稀有掉落物或自定义经济物品)非常有用。
ClearItem v1.2.0 新增功能
高级实体清理
ClearItem 不再局限于仅清理掉落物品。服务器管理员可以选择启用扩展清理以处理其他类型的实体。
可选的经验球清理
当在 config.yml 中启用时,ClearItem 可以移除经验球实体。这对于 XP 农场或玩家死亡产生过多经验球的服务器很有帮助。
可选敌对生物清理
当在 config.yml 中启用时,ClearItem 可以移除敌对生物。这有助于减少敌对生物堆积的世界中的实体压力。
可选无主载具清理
当在 config.yml 中启用时,ClearItem 可以移除空载和无乘客的载具。这包括未使用的船和矿车。
安全的默认行为
默认情况下,ClearItem 保留旧的专注行为,仅移除地面掉落物品。扩展清理必须在 config.yml 中手动启用。
扩展清理配置选项:
cleanup:
only-ground-items: true
remove-xp-orbs: false
remove-hostile-mobs: false
remove-unowned-vehicles: false
重要提示:
如果 cleanup.only-ground-items 为 true,ClearItem 仅移除掉落物品实体。
如果 cleanup.only-ground-items 为 false,则可以使用额外的清理开关。
图形化管理菜单
ClearItem v1.2.0 添加了游戏内图形化管理菜单。工作人员可以使用以下命令打开它:
/clearitem menu
权限:
clearitem.admin
管理菜单包括:
实时下次清理计时器
一键手动清理按钮
物品黑名单编辑器
简单的箱子风格界面
该菜单专为那些更喜欢在游戏内管理清理而不是手动编辑文件的工作人员设计。
GUI 中的实时清理计时器
管理菜单显示距离下一次自动清理的剩余时间。只要菜单打开,计时器就会刷新。
一键清理
管理员可以直接从 GUI 启动清理,而无需键入 clear 命令。
拖放式物品黑名单编辑器
管理员可以从 GUI 打开物品黑名单编辑器,并将物品类型放置到菜单中。当菜单关闭时,ClearItem 会将选定的物品材料保存到 items.yml 中。
这对于不想手动输入材料名称的服务器管理员来说,使黑名单管理变得容易得多。
玩家垃圾桶
ClearItem v1.2.0 添加了虚拟玩家垃圾桶。
命令:
/trash
/cop
/çöp
权限:
clearitem.command.trash
玩家可以打开虚拟垃圾桶库存并将不需要的物品放入其中。放入垃圾桶的物品将被永久删除。
这有助于减少库存混乱,并可以减少玩家将无用物品扔在地上的数量。
对于生存、天空岛、城镇、经济和阵营服务器,垃圾桶尤其有用,因为这些服务器的玩家经常收集不需要的方块、生物掉落物或农场物品。
TPS 紧急清理
ClearItem 包含 TPS 触发系统。如果启用,当服务器 TPS 低于配置的阈值时,插件可以运行紧急清理。
配置选项:
tps-trigger:
enabled: true
threshold: 16.0
check-interval-seconds: 30
cooldown-seconds: 180
该系统可在服务器因实体过多可能导致卡顿的时候自动作出反应。
冷却时间可防止紧急清理过于频繁地运行。
分析与清理报告
ClearItem 可将详细的清理报告写入控制台和分析日志文件。
分析数据可能包括:
清理模式
移除的物品数量
移除的实体数量
清理耗时
基于世界的移除数量
基于材质的移除数量
紧急清理时的当前 TPS
日志文件位置:
plugins/ClearItem/logs/analytics.log
这对于希望了解清理频率以及哪些世界产生最多可移除物品的服务器管理员非常有用。
更新检测器
ClearItem 可以检查官方新版本并通知服务器工作人员。
更新通知可发送至:
控制台
在线的管理员
加入时拥有 OP 权限的玩家
加入时拥有 clearitem.admin 权限的玩家
如果有新版本可用,ClearItem 会在授权的工作人员进入服务器后发送一条聊天消息。
配置选项:
updates:
enabled: true
notify-admins: true
notify-console: true
join-delay-seconds: 3
这有助于服务器管理员及时发现新插件版本,而无需手动不断查看下载页面。
多语言系统
ClearItem 内置了 16 种语言文件。
内置语言:
英语
土耳其语
西班牙语
德语
法语
意大利语
葡萄牙语
俄语
中文
日语
韩语
荷兰语
波兰语
阿拉伯语
印地语
印度尼西亚语
可以在 config.yml 中更改活动语言:
language:
active: en
语言文件存储在以下位置:
plugins/ClearItem/language/
服务器管理员可以直接编辑这些文件中的消息。
基于语言的子命令
主命令始终保持不变:
/clearitem
子命令会根据所选语言而变化。
英语示例:
/clearitem clear
/clearitem reload
/clearitem time
/clearitem status
/clearitem help
/clearitem menu
土耳其语示例:
/clearitem temizle
/clearitem yenile
/clearitem süre
/clearitem durum
/clearitem yardım
/clearitem menu
西班牙语示例:
/clearitem limpiar
/clearitem recargar
/clearitem tiempo
/clearitem estado
/clearitem ayuda
/clearitem menu
这允许玩家和工作人员使用与服务器语言匹配的命令,同时保持 /clearitem 的一致性。
LuckPerms 支持
如果安装了 LuckPerms,ClearItem 会自动检测它。
如果未安装 LuckPerms,ClearItem 将使用普通的 Bukkit 权限系统。
LuckPerms 支持对于为不同职员等级分配清理权限非常有用。
配置选项:
luckperms:
hook-check: true
权限
clearitem.admin
授予所有 ClearItem 管理命令和管理功能的访问权限。
clearitem.command.clear
允许使用 /clearitem clear 进行手动清理。
clearitem.command.reload
允许重新加载配置文件和语言文件。
clearitem.command.time
允许查看下一次清理的时间。
clearitem.command.status
允许查看插件状态和 LuckPerms 钩子状态。
clearitem.command.help
允许查看帮助菜单。
clearitem.command.trash
允许使用虚拟回收站,通过 /trash、/cop 或 /çöp 命令。
LuckPerms 示例
/lp group admin permission set clearitem.admin true
/lp group moderator permission set clearitem.command.clear true
/lp group moderator permission set clearitem.command.reload true
/lp group helper permission set clearitem.command.time true
/lp group helper permission set clearitem.command.status true
/lp group default permission set clearitem.command.trash true
PlaceholderAPI 支持
如果安装了 PlaceholderAPI,ClearItem 会自动与其挂钩。
可用的占位符:
%clearitem_next%
以可读格式显示下一次清理时间。
示例:
4 minutes 20 seconds
%clearitem_next_seconds%
以原始秒数显示下一次清理时间。
示例:
260
%clearitem_running%
显示清理是否正在运行。
示例:
true
false
%clearitem_language%
显示当前活动的语言代码。
示例:
en
tr
es
这些占位符可用于计分板、标签页列表、全息图、菜单或任何支持 PlaceholderAPI 的其他插件中。
命令
/clearitem clear
手动启动清理。
/clearitem reload
重新加载配置文件、语言文件和物品过滤器。
/clearitem time
显示距离下次自动清理的剩余时间。
/clearitem status
显示插件状态、下次清理时间和 LuckPerms 钩子状态。
/clearitem help
显示 ClearItem 命令帮助菜单。
/clearitem menu
打开图形化管理菜单。
/trash
打开玩家回收站。
/cop
备用回收站命令。
/çöp
土耳其语回收站命令别名。
/ci
/clearitem 的别名。
配置概览
默认语言:
language:
active: en
清理间隔:
cleanup:
interval: 5m
警告时间:
cleanup:
warnings:
- 60
- 30
- 10
- 5
仅掉落物品模式:
cleanup:
only-ground-items: true
扩展清理:
cleanup:
remove-xp-orbs: false
remove-hostile-mobs: false
remove-unowned-vehicles: false
世界过滤:
worlds:
mode: BLACKLIST
list: []
TPS 触发器:
tps-trigger:
enabled: true
threshold: 16.0
check-interval-seconds: 30
cooldown-seconds: 180
分析:
analytics:
enabled: true
log-file: true
更新检测器:
updates:
enabled: true
notify-admins: true
notify-console: true
join-delay-seconds: 3
性能
ClearItem 设计为轻量级插件。它不会在每个刻(tick)扫描服务器。正常的清理扫描仅在清理计时器归零或由授权用户手动启动清理时运行。
TPS 触发器使用可配置的检查间隔和冷却时间,因此紧急清理不会持续运行。
默认情况下,ClearItem 仅针对掉落的物品实体。经验球、敌对生物和空载具仅在服务器管理员明确启用扩展清理时才会被移除。
物品会在清理操作中被移除,且堆叠数量计算正确。这确保了最终清理消息的准确性,并防止误导性报告。
为什么使用 ClearItem?
ClearItem 适用于希望实现以下目标的服务器:
- 更整洁的世界
- 减少掉落物实体
- 可配置的自动清理功能
- 简单的管理员命令
- 易于使用的 GUI 管理菜单
- 玩家垃圾桶命令
- 按世界控制的清理功能
- 保护贵重物品
- 多语言命令支持
- LuckPerms 权限集成
- PlaceholderAPI 集成
- 向管理员发送更新通知
- 详细的分析报告
- Java 8 兼容性
- 广泛的 Minecraft 版本支持
简短描述
ClearItem 是一款轻量级多语言清理插件,具备自动物品清理、可选的 XP/生物/载具清理、GUI 管理工具、玩家垃圾桶、PlaceholderAPI 支持、LuckPerms 权限、世界过滤、物品过滤、TPS 紧急清理、分析功能以及更新通知等功能。
Discord
PideMann
如果您发现任何错误或需要支持,可以在此联系我。
ClearItem - Smart, Lightweight Item and Entity Cleanup
ClearItem is a clean, fast and multilingual cleanup plugin for Bukkit, Spigot and Paper based Minecraft servers. It is designed to keep server worlds cleaner by removing dropped items automatically, while still giving server owners full control over what gets cleaned, when cleanup happens, which worlds are affected and who can use each command.
ClearItem focuses on being lightweight, simple to configure and safe for everyday survival servers. It includes automatic cleanup, manual cleanup, warning messages, a graphical admin menu, a player trash bin, PlaceholderAPI support, LuckPerms support, update notifications and multilingual command support.
Supported Versions
ClearItem is built with Java 8 compatibility and uses the Bukkit/Spigot 1.16 API as its compatibility base.
Supported Minecraft server range:
Minecraft 1.16.5 up to modern 1.21.x servers.
The plugin is intended for Bukkit, Spigot and Paper based servers.
Main Features
Lightweight dropped-item cleanup
ClearItem automatically removes dropped ground item entities after a configurable interval. This helps reduce entity buildup, improves world cleanliness and can help reduce performance pressure caused by too many dropped items.
Correct stack counting
ClearItem counts actual item amounts, not just entity stacks. For example, a stack of 64 diamonds is counted as 64 removed items, not as 1 removed entity. Cleanup messages and analytics reports show more accurate numbers.
Configurable cleanup interval
Server owners can choose how often automatic cleanup runs. The interval supports simple time formats such as seconds, minutes, hours or raw seconds.
Supported interval examples:
30s
5m
1h
300
Warning messages before cleanup
ClearItem can broadcast warning messages before cleanup happens. Warning times are configurable, allowing players to pick up important items before the cleanup starts.
Example warning times:
60 seconds
30 seconds
10 seconds
5 seconds
Manual cleanup command
Authorized staff members can manually start cleanup at any time with the clear command. This is useful when a world has too many dropped items or when staff want to clean the server immediately.
World blacklist and whitelist system
ClearItem can control which worlds are affected by cleanup.
BLACKLIST mode:
Listed worlds will not be cleaned.
WHITELIST mode:
Only listed worlds will be cleaned.
This makes it possible to exclude event worlds, farm worlds, minigame worlds, admin test worlds or any other special world.
Item blacklist and whitelist system
ClearItem includes an items.yml filter file. Server owners can choose whether listed materials are protected or whether only listed materials should be cleaned.
BLACKLIST mode:
Items listed in items.yml are protected and will not be removed.
WHITELIST mode:
Only items listed in items.yml will be removed.
This is useful for protecting valuable items such as diamonds, netherite tools, rare drops or custom economy items.
New in ClearItem v1.2.0
Advanced entity cleanup
ClearItem is no longer limited to dropped item cleanup only. Server owners can optionally enable extended cleanup for additional entity types.
Optional XP orb cleanup
ClearItem can remove XP orb entities when enabled in config.yml. This can help servers where XP farms or player deaths create too many XP orbs.
Optional hostile mob cleanup
ClearItem can remove hostile mobs when enabled in config.yml. This can help reduce entity pressure in worlds where hostile mobs build up.
Optional unowned vehicle cleanup
ClearItem can remove empty and unoccupied vehicles when enabled in config.yml. This includes unused boats and minecarts that are not carrying passengers.
Safe default behavior
By default, ClearItem keeps the old focused behavior and only removes dropped ground items. Extended cleanup must be enabled manually in config.yml.
Extended cleanup config options:
cleanup:
only-ground-items: true
remove-xp-orbs: false
remove-hostile-mobs: false
remove-unowned-vehicles: false
Important:
If cleanup.only-ground-items is true, ClearItem only removes dropped item entities.
If cleanup.only-ground-items is false, the extra cleanup switches can be used.
Graphical admin menu
ClearItem v1.2.0 adds an in-game graphical admin menu. Staff can open it with:
/clearitem menu
Permission:
clearitem.admin
The admin menu includes:
Live next-cleanup timer
One-click manual cleanup button
Item blacklist editor
Simple chest-style interface
The menu is designed for staff members who prefer managing cleanup from inside the game instead of editing files manually.
Live cleanup timer in GUI
The admin menu shows the remaining time until the next automatic cleanup. The timer refreshes while the menu is open.
One-click cleanup
Admins can start cleanup directly from the GUI without typing the clear command.
Drag-and-drop item blacklist editor
Admins can open the item blacklist editor from the GUI and place item types into the menu. When the menu is closed, ClearItem saves the selected item materials into items.yml.
This makes blacklist management much easier for server owners who do not want to manually type material names.
Player trash bin
ClearItem v1.2.0 adds a virtual player trash bin.
Commands:
/trash
/cop
/çöp
Permission:
clearitem.command.trash
Players can open a virtual trash inventory and place unwanted items inside it. Items placed in the trash bin are permanently deleted.
This helps reduce inventory clutter and can reduce the number of useless items players throw onto the ground.
The trash bin is especially useful for survival, skyblock, towny, economy and faction servers where players frequently collect unwanted blocks, mob drops or farm items.
TPS emergency cleanup
ClearItem includes a TPS trigger system. If enabled, the plugin can run an emergency cleanup when server TPS drops below a configured threshold.
Config options:
tps-trigger:
enabled: true
threshold: 16.0
check-interval-seconds: 30
cooldown-seconds: 180
This system helps servers react automatically when too many entities may be contributing to lag.
The cooldown prevents emergency cleanup from running too often.
Analytics and cleanup reports
ClearItem can write detailed cleanup reports to the console and to an analytics log file.
Analytics can include:
Cleanup mode
Removed item amount
Removed entity count
Cleanup duration
World-based removal counts
Material-based removal counts
Current TPS for emergency cleanups
Log file location:
plugins/ClearItem/logs/analytics.log
This is useful for server owners who want to understand how much cleanup is happening and which worlds generate the most removable items.
Update checker
ClearItem can check for official new versions and notify server staff.
Update notifications can be sent to:
Console
Online admins
OP players when they join
Players with clearitem.admin when they join
If a new version is available, ClearItem sends a chat message to authorized staff after they enter the server.
Config options:
updates:
enabled: true
notify-admins: true
notify-console: true
join-delay-seconds: 3
This helps server owners notice new plugin versions without constantly checking the download page manually.
Multilingual system
ClearItem includes 16 built-in language files.
Built-in languages:
English
Turkish
Spanish
German
French
Italian
Portuguese
Russian
Chinese
Japanese
Korean
Dutch
Polish
Arabic
Hindi
Indonesian
The active language can be changed in config.yml:
language:
active: en
Language files are stored in:
plugins/ClearItem/language/
Server owners can edit messages directly from these files.
Language-based subcommands
The main command always stays the same:
/clearitem
Subcommands can change depending on the selected language.
English example:
/clearitem clear
/clearitem reload
/clearitem time
/clearitem status
/clearitem help
/clearitem menu
Turkish example:
/clearitem temizle
/clearitem yenile
/clearitem süre
/clearitem durum
/clearitem yardım
/clearitem menu
Spanish example:
/clearitem limpiar
/clearitem recargar
/clearitem tiempo
/clearitem estado
/clearitem ayuda
/clearitem menu
This allows players and staff to use commands that match the server language while keeping /clearitem consistent.
LuckPerms support
ClearItem automatically detects LuckPerms if it is installed.
If LuckPerms is not installed, ClearItem uses the normal Bukkit permission system.
LuckPerms support is useful for assigning cleanup permissions to different staff ranks.
Config option:
luckperms:
hook-check: true
Permissions
clearitem.admin
Gives access to every ClearItem admin command and admin feature.
clearitem.command.clear
Allows manual cleanup with /clearitem clear.
clearitem.command.reload
Allows reloading config and language files.
clearitem.command.time
Allows viewing the next cleanup time.
clearitem.command.status
Allows viewing plugin status and LuckPerms hook status.
clearitem.command.help
Allows viewing the help menu.
clearitem.command.trash
Allows using the virtual trash bin with /trash, /cop or /çöp.
LuckPerms examples
/lp group admin permission set clearitem.admin true
/lp group moderator permission set clearitem.command.clear true
/lp group moderator permission set clearitem.command.reload true
/lp group helper permission set clearitem.command.time true
/lp group helper permission set clearitem.command.status true
/lp group default permission set clearitem.command.trash true
PlaceholderAPI support
ClearItem automatically hooks into PlaceholderAPI if PlaceholderAPI is installed.
Available placeholders:
%clearitem_next%
Shows the next cleanup time in readable format.
Example:
4 minutes 20 seconds
%clearitem_next_seconds%
Shows the next cleanup time as raw seconds.
Example:
260
%clearitem_running%
Shows whether cleanup is currently running.
Example:
true
false
%clearitem_language%
Shows the active language code.
Example:
en
tr
es
These placeholders can be used in scoreboards, tab lists, holograms, menus or any other plugin that supports PlaceholderAPI.
Commands
/clearitem clear
Manually starts cleanup.
/clearitem reload
Reloads config, language files and item filters.
/clearitem time
Shows the remaining time until the next automatic cleanup.
/clearitem status
Shows plugin status, next cleanup time and LuckPerms hook status.
/clearitem help
Shows the ClearItem command help menu.
/clearitem menu
Opens the graphical admin menu.
/trash
Opens the player trash bin.
/cop
Alternative trash command.
/çöp
Turkish trash command alias.
/ci
Alias for /clearitem.
Configuration overview
Default language:
language:
active: en
Cleanup interval:
cleanup:
interval: 5m
Warning times:
cleanup:
warnings:
- 60
- 30
- 10
- 5
Dropped-item only mode:
cleanup:
only-ground-items: true
Extended cleanup:
cleanup:
remove-xp-orbs: false
remove-hostile-mobs: false
remove-unowned-vehicles: false
World filter:
worlds:
mode: BLACKLIST
list: []
TPS trigger:
tps-trigger:
enabled: true
threshold: 16.0
check-interval-seconds: 30
cooldown-seconds: 180
Analytics:
analytics:
enabled: true
log-file: true
Update checker:
updates:
enabled: true
notify-admins: true
notify-console: true
join-delay-seconds: 3
Performance
ClearItem is designed to be lightweight. It does not scan the server every tick. The normal cleanup scan runs only when the cleanup timer reaches zero or when an authorized user manually starts cleanup.
The TPS trigger uses a configurable check interval and cooldown, so emergency cleanup does not constantly run.
By default, ClearItem only targets dropped item entities. XP orbs, hostile mobs and empty vehicles are only removed if the server owner explicitly enables extended cleanup.
Items are removed during the cleanup operation, and stack amounts are counted correctly. This keeps the final cleanup message accurate and prevents misleading reports.
Why use ClearItem?
ClearItem is useful for servers that want:
Cleaner worlds
Fewer dropped item entities
Configurable automatic cleanup
Simple staff commands
An easy GUI admin menu
A player trash command
World-specific cleanup control
Protected valuable items
Multilingual command support
LuckPerms integration
PlaceholderAPI integration
Update notifications for staff
Detailed analytics reports
Java 8 compatibility
Wide Minecraft version support
Short description
ClearItem is a lightweight multilingual cleanup plugin with automatic item cleanup, optional XP/mob/vehicle cleanup, GUI admin tools, a player trash bin, PlaceholderAPI support, LuckPerms permissions, world filters, item filters, TPS emergency cleanup, analytics and update notifications.
Discord
PideMann
If you find any bugs or need support, you can contact me here.
评论 0
登录后参与评分
还没有评论,来抢沙发吧