实体清理
「封禁无界，管理有序」
Youer 的实体清理功能可以定时自动清理世界中的掉落物和怪物，减少实体数量，降低服务器卡顿。也支持管理员手动触发清理。
快速开始
在 youer-config/youer.yml 中找到实体清理相关的设置，改成这样就能开启自动清理：
改好后重启服务器即可。也可以先用下面的命令手动清理一次试试：
清理开始前 30 秒，所有玩家屏幕下方会显示倒计时提示；清理完成后显示清理统计。
自动清理配置
所有设置在 youer.yml 里，共有两组配置（掉落物 / 怪物），每组四个选项：
| 配置项 | 默认值 | 说明 |
|---|---|---|
entity.clear.item.enable | false | 是否开启掉落物自动清理 |
entity.clear.item.time | 1800 | 掉落物清理间隔（秒）。1800 秒 = 30 分钟。 |
entity.clear.item.mode | whitelist | 清理模式：whitelist（白名单，默认）或 blacklist（黑名单） |
entity.clear.item.whitelist | [] | 掉落物列表，具体含义由 mode 决定（见下文） |
entity.clear.monster.enable | false | 是否开启怪物自动清理 |
entity.clear.monster.time | 1800 | 怪物清理间隔（秒） |
entity.clear.monster.mode | whitelist | 清理模式：whitelist（白名单，默认）或 blacklist（黑名单） |
entity.clear.monster.whitelist | [] | 怪物列表，具体含义由 mode 决定（见下文） |
白名单通常不需要手动编辑
youer.yml，可以用游戏内命令添加/移除，见 白名单添加与查看。
清理保护机制（列表与模式）
掉落物和怪物分别维护各自的列表，列表的具体含义由 mode 配置决定，共两种模式：
- 白名单模式（
whitelist，默认）：列表是保护列表——填在列表里的类型不会被清理，列表为空则清理所有；带!前缀的条目反而强制清理。 - 黑名单模式（
blacklist）：列表是清理列表——只清理列表中的类型，其余全部保护；带!前缀的条目反而受到保护。
掉落物与怪物可分别设置模式：
entity.clear.item.mode/entity.clear.monster.mode。
掉落物保护规则
满足以下任一条件的掉落物不会被清理：
| 条件 | 说明 |
|---|---|
| 物品类型在白名单中 | 按 minecraft:diamond（注册键）或 DIAMOND（名称）匹配 |
| 物品带有自定义模型数据 | custom_model_data 标签非 0（多为模组/资源包物品） |
| 物品带有 NBT 数据 | 持久化数据容器（PDC）非空，如附魔书、写了内容的书等 |
怪物保护规则
满足以下任一条件的怪物不会被清理：
| 条件 | 说明 |
|---|---|
| 实体类型在白名单中 | 按 minecraft:zombie 注册键匹配 |
| 怪物有自定义名称 | 例如用命名牌命名过的怪物 |
| 怪物是持久化实体 | 被设置成不会自然消失的实体（命令生成的、有特殊标签的） |
| 怪物带有 NBT 数据 | 持久化数据容器（PDC）非空 |
白名单匹配示例
命令
实体清理命令 /entityclear，权限节点 youer.command.entityclear。需要在 youer-config/commands.yml 中开启（见下文）。
| 命令 | 说明 |
|---|---|
/entityclear | 立即清理所有世界的掉落物和怪物 |
/entityclear item | 立即清理所有世界的掉落物 |
/entityclear entity | 立即清理所有世界的怪物 |
/entityclear all | 立即清理所有世界的掉落物和怪物（同无参数） |
/entityclear trash | 打开垃圾桶界面（所有玩家可用，无需权限） |
/entityclear add item | 打开界面放入物品，或直接输入物品 ID/通配符，加入掉落物保护列表 |
/entityclear add entity | 打开界面放入刷怪蛋，或直接输入实体 ID/通配符/黑名单，加入怪物保护列表 |
/entityclear show item | 打开界面查看掉落物保护列表，右键可移除 |
/entityclear show entity | 打开界面查看怪物保护列表，右键可移除 |
启用命令
在 youer-config/commands.yml 中开启：
修改后需要重启服务器生效。手动清理命令不依赖自动清理开关，随时可用。
白名单添加与查看
添加掉落物
打开一个 54 格的背包界面，把要保护的物品（如钻石）放进格子里，关闭界面即保存。支持一次放入多种物品。添加成功的物品类型会写入 youer.yml 的 entity.clear.item.whitelist，并立即生效。
也可以直接输入物品 ID（Tab 会自动补全）：
modid:* 通配符表示该模组的所有物品。
添加怪物
同上，但需要放入刷怪蛋（如僵尸刷怪蛋、末影龙刷怪蛋）。关闭界面后，该怪物类型会写入 entity.clear.monster.whitelist。
也可以直接输入实体 ID、通配符或黑名单（Tab 会自动补全）：
带 ! 前缀的条目为黑名单，优先级高于白名单等其他保护条件，被列入黑名单的实体将无条件被清理。
查看 / 移除
打开界面查看当前保护列表。右键点击某个条目即可将其从保护列表中移除。
提示消息
清理相关的提示文案通过语言文件配置（youer-config/lang/，随服务器语言自动切换），常用的键：
| 键 | 默认文案（zh_CN） | 说明 |
|---|---|---|
entityclear.item.warn | 掉落物将在 §c%s §f秒后被清理 | 掉落物清理倒计时（每秒刷新，最后 5 秒变红） |
entityclear.monster.warn | 怪物将在 §c%s §f秒后被清理 | 怪物清理倒计时 |
entityclear.item.done | 清理物品 §c%s §2组（§c%s§2个），用时 §c%s §2毫秒 | 掉落物清理统计（组数、物品数、耗时） |
entityclear.monster.done | 清理实体 §c%s §2个，用时 §c%s §2毫秒 | 怪物清理统计 |
所有提示都显示在玩家屏幕下方（ActionBar），不占用聊天栏。
常见问题
自动清理开启后，手动命令还能用吗？
能。/entityclear 手动命令独立于自动清理开关，随时可以执行。
清理间隔设为多少合适？
掉落物建议 600~1800 秒（10~30 分钟），怪物按服务器刷怪量调整。注意清理间隔要大于 30 秒（倒计时时长），否则倒计时会重叠。
白名单里的怪物会被清理吗？
不会。白名单是保护列表，添加进去的掉落物/怪物永远不会被自动或手动清理。
有名字的怪物会被清理吗？
不会。任何有自定义名称的怪物都被自动保护（无需加入白名单）。
不想被清理的掉落物怎么保护？
两种方式：/entityclear add item 加入白名单；或者让物品带 NBT 数据（如附魔物品、成书），系统会自动跳过。
清理时玩家会掉线吗？
不会。清理在主线程执行，通常只需要几毫秒，玩家几乎无感知。