LSE MhBroom 方块人的扫帚（地图清理插件） 2022-03-12

一、概述：一款你无需编辑配置文件的地图清理插件，无需繁琐的配置，开箱即用，可搭配ScheduleCmd插件定时执行，亦可手动延时执行或立即执行。本插件已实装至本人自己的服务器中，大家可放心使用。

二、依赖：本插件必须依赖于LiteLoaderBDS 2.1.3。注意：版本不可低于2.1.3

三、使用方法：下载后将MhBroom.js文件移动至plugins文件夹下，启动服务器即可。【执行日志将保存至BDS根目录/logs文件夹中，文件名为与插件同名的.log文件，记录每次清理的结果】

四、指令：
1. /swp help 帮助指令，查看可执行命令列表，列表详细说明了该命令下有哪些子命令可执行。
2. /swp item [delay] 清理掉落物
3. /swp skt [delay] 清理骷髅
4. /swp any [delay] 清理所有生物(除玩家)
5. /swp zb [delay] 清理僵尸
6. /swp cp [delay] 清理苦力怕
7. /swp spd [delay] 清理蜘蛛
8. /swp zp [delay] 清理猪人

五、参数说明：
[delay] 表示延迟多久执行，为可选参数，即可填可不填，该参数接受一个正整数类型，单位为分钟。
示例一：/swp item 10 表示10分钟后执行清理掉落物任务。
示例二：/swp zp 表示立即清理猪人

注意：这里所说的清理，其实所指的就是'kill'指令，针对掉落物而言，会直接将其从地图中移除；而对于生物而言，会将其杀死，也就是说，该命令清理过的生物，会因为杀死后而正常掉落物品，若你不希望掉落物存在，则继续执行/swp item指令清理掉即可。
若你在执行过程中看到类似于：【ERROR][MhBroom] 清理猪人失败， [No targets matched selector]】这样的信息，则表示该清理目标不存在于该地图，你无需惊慌，该提示非程序报错信息，而是指令反馈信息。

六、搭配定时任务：
本插件也支持由yq提供的定时任务插件定时执行，在此之前，你需要先了解cron表达式语法，你可以参考：https://www.minebbs.com/resources/schedulecmd.2694/

示例一："swp item 30": "0 0 */3 * * ?"
该表达式的意思为：每隔3个小时执行一次清扫命令，并且延时30分钟后执行。也就是说，该命令会在每天的3：30会执行一次，接下来会在6：30执行、9：30执行依此类推。

swp指令在延时执行的过程中，将会在剩余10分钟、剩余5分钟以及剩余1分钟时各通知一次。在倒数10秒中时每秒通知一次，通知范围为在线所有玩家。

七、注意事项：若你的服务器为纯生存服务器，谨慎使用/swp any 命令，这将会杀死你家里的阿猫阿狗以及村民。（作者本人就不小心在自己的服务器中使用了该命令，导致服务器内成员好不容易繁殖出的村民统统死于非命）

八、一些截图：






九、关于：
联系方式：QQ：2285088054
若遇到问题，请及时反馈，本插件开源欢迎二开。转载请注明出处
GitHub：https://github.com/mihu915/MhBroom

十、题外话：
为什么会加入清理猪人的命令？因为作者的服务器是纯生存服务器，成员建造的猪人刷怪塔刷怪效率太高了，怪物堆叠严重，导致客户端以及服务端压力都很大，所以加入了清理猪人的指令，以防万一。