命令
MzLib提供了一系列实用的命令,所有命令都以/mzlib或/mz开头
基本命令
test
测试MzLib的兼容性和功能
用法:/mzlib test [level]
参数:
-
level(可选):测试级别,可选值为0、1、20:快速测试(仅主要功能)1:标准测试2:完整测试(所有功能)
示例:
command
/mzlib test
/mzlib test 1
说明:
- 玩家执行时进行完整测试
- 控制台执行时进行主要测试
- 测试完成后会显示测试结果
lang
管理MzLib的语言设置和自定义翻译
用法:/mzlib lang <子命令>
子命令:
loadmc
重新加载Minecraft原版语言文件
用法:/mzlib lang loadmc
说明:从服务端重新加载所有原版语言文件
custom
管理自定义语言翻译
用法:/mzlib lang custom <language> [key] [operate] [value]
参数:
language:语言代码(如zh_cn、en_us)key(可选):翻译键名operate(可选):操作类型,set或removevalue(可选):翻译值(仅set操作需要)
示例:
command
/mzlib lang custom zh_cn
/mzlib lang custom zh_cn my.plugin.key
/mzlib lang custom zh_cn my.plugin.key set "我的自定义翻译"
/mzlib lang custom zh_cn my.plugin.key remove
说明:
- 不提供
key时,打开语言编辑器UI(仅玩家) - 提供
key但不提供operate时,打开该键的编辑器UI(仅玩家) - 使用
set设置翻译值 - 使用
remove删除翻译
iteminfo
查看手中物品的详细信息
用法:/mzlib iteminfo
说明:
- 显示玩家手中物品的NBT数据
- 需要玩家权限
- 输出物品的完整NBT结构
示例:
command
/mzlib iteminfo
give
给予玩家MzItem物品
用法:/mzlib give [player] <id> [data]
参数:
player(可选):目标玩家,不指定则给予自己id:物品ID(MzItem标识符)data(可选):物品的NBT数据
示例:
command
/mzlib give my:item
/mzlib give Steve my:item
/mzlib give my:item {display:{Name:"自定义名称"}}
说明:
- 需要玩家权限
- 不指定
player时给予自己 data参数为JSON格式的NBT数据
js
执行JavaScript代码
用法:/mzlib js <code>
参数:
code:要执行的JavaScript代码
示例:
command
/mzlib js "context.getSource().sendMessage(Text.literal('Hello World'))"
/mzlib js "1 + 1"
说明:
- 使用Rhino引擎执行JavaScript代码
- 代码中可以使用
context变量访问命令上下文 - 执行结果会显示在聊天栏
- 警告:此命令具有潜在安全风险,请谨慎使用
权限
所有命令都需要相应权限才能使用:
mzlib.command.mzlib.test:使用test命令mzlib.command.mzlib.lang:使用lang命令mzlib.command.mzlib.iteminfo:使用iteminfo命令mzlib.command.mzlib.give:使用give命令mzlib.command.mzlib.js:使用js命令
提示
- 所有命令都支持Tab补全
- 使用
/mzlib help查看命令帮助 - 某些命令可能需要玩家权限才能执行
- 建议在生产环境中限制
js命令的使用权限