洁厕女仆

洁厕女仆

一个可配置的Minecraft清理工具模组。

游戏机制

CleanMaid

CleanMaid 是一个轻量级的 Minecraft 服务端清理模组。如同一位尽职尽责的女仆,它按照你的配置清理掉落物和实体,减少实体堆积带来的服务器负载。

支持的版本

  • Minecraft 1.21.1
  • NeoForge 21.1.222
  • Java 21

主要功能

  • 定时自动清理掉落物和经验球
  • 清理前的警告与倒计时消息
  • 两级批量清理:维度级批处理 + 每个维度内的实体类型批处理
  • 物品黑名单/白名单与维度黑名单/白名单
  • 保护新掉落的物品、命名物品和玩家死亡掉落物
  • /cleanmaid 管理命令与快捷命令 /ccb
  • 可通过 actionbar / 聊天栏配置广播
  • 隐藏彩蛋与隐藏进度

安装

  1. 安装 Minecraft 1.21.1 服务器。
  2. 安装 NeoForge 21.1.222。
  3. 将发布页面中的主 Mod jar 放入服务器的 mods/ 目录。
  4. 启动服务器。配置文件将生成在 config/cleanmaid/ 中。

常用命令

所有命令默认需要权限等级 3。

/cleanmaid help
/cleanmaid clean
/ccb
/cleanmaid status
/cleanmaid reload
/cleanmaid set interval 60
/cleanmaid set enabled true
/cleanmaid set easter_egg false

黑名单与白名单:

/cleanmaid item blacklist add minecraft:dirt
/cleanmaid item blacklist remove minecraft:dirt
/cleanmaid item whitelist list
/cleanmaid dimension blacklist add minecraft:the_nether
/cleanmaid dimension whitelist add minecraft:overworld
/cleanmaid dimension whitelist list

定向清理:

/cleanmaid clean dimension minecraft:the_nether
/cleanmaid clean item minecraft:cobblestone
/cleanmaid clean entity minecraft:experience_orb
/cleanmaid clean force

配置文件

配置目录:

config/cleanmaid/

主要文件:

cleanmaid-server.toml
blacklist.toml
whitelist.toml

cleanmaid-server.toml 控制调度、目标实体、保护规则、显示位置、声音、权限以及彩蛋开关。

blacklist.toml 和 whitelist.toml 同时存储物品和维度:

{
  "items": [],
  "dimensions": []
}

黑名单与白名单规则

  • blacklist = 必须被清理
  • whitelist = 受保护,不会被清理
  • blacklist 的优先级高于 whitelist

默认物品:

  • blacklist:minecraft:cobblestone、minecraft:dirt
  • whitelist:minecraft:diamond、minecraft:netherite_ingot

构建

.\\gradlew.bat build

构建产物位于:

build/libs/