标题指示
为了更好地区分标题、标题的附属关系和内容,手册内的标题都会由一个特定 emoji 绘文字符号开头:
🌙1级标题(不常用)
✨2级标题
💫3级标题
⭐4级标题或重要列表项目
[加粗文本] 小节标题分割
阅读文档前的提示
在阅读此服务器手册前,请明确:
- 手册中描述的内容适用于 Minecraft: Java Edition,或者特别标注的具体版本号;
- 有些内容会根据璃梦月夜服务器现状进行标注;
- 在未提及时,使用插件最初运行时的默认值进行解释;
- 服务器手册会尽可能还原插件行为,不同版本的行为可能不一致;
- 在缺失特定权限时,功能无法使用属于正常情况;
此服务器手册适用于璃梦月夜社区下的 Minecraft 服务器,对于璃梦月夜之外的服务器不做任何效用保证,如果需要更多帮助,可访问手册中提供的插件作者编写的文档链接。
如果遇到任何权限问题,请向你在游玩的服务器管理员联系。
若对手册内容描述存在疑问,欢迎通过邮箱或璃梦月夜社区网络联系创建人。
💫插件描述概要
插件页面会简要介绍此插件的作用,并标注测试版本号和 Minecraft 版本;逐个讲述面向玩家的指令及用法,使用率较高的会单独分类并前置;页面结尾会标注参考信息来源和作者提供的帮助页面,可进一步查找插件的详细信息。
💫指令的结构
在 Minecraft 中,指令始终以 / 斜线开始,然后通过 Enter 回车键运行。
指令用法拥有许多表达方式,不同作者对指令的编写风格各异,服务器手册注重于使用较为统一的表达方式解释指令。指令的结构都为以下形式:
- 完整指令由一段字符串构成;
- 指令是分段的,分段之间以空格分隔;
- 第1段就是指令名称,第2段及以后都称为这条指令的选项 (option),有时也会称为参数 (argument)。
以下是来自 WorldEdit 创世神插件的 //replace 指令用法;我们将其描述为一个通用的字符串(这称为“模板”),并注明每个选项的含义;然后按照实际需要选择一些选项并运行这条指令。
v v v
//replace [replace_from=air] <replace_as> [-m (mask)]
1 2 3
指令名称 | -- -- 选 项 -- -- |
Info
空格用于分隔与识别指令与选项,请避免在一个参数内部使用空格;如果必须使用空格,请使用英文双引号
" "括起。
选项的可选性
有些选项是在运行指令时必须写入的,有些是可以选择的,我们使用不同的括号来标记它们:
未被括起必填项,直接填入字面值;<必填>必须填入;[可选]可以省略;[可选=默认值]若方括号内的选项未被填入,使用默认值。(解释)用于解释选项值的含义;
选项的不同形式
不同的作者会为它们的插件设置不同的指令解析方式,选项的构成也有所不同:
- 纯值 (不可改变位置):
直接给出选项的值:
23,"never gonna"; - 纯键型:
- 短横线+字母:
-c,-g; - 双短横线+词组:
--recursive,--disabled-function;
- 短横线+字母:
- 键值型:
- 短横线+字母+空格分隔值:
-b (value); - 字母+冒号连接值:
t:30m;
- 短横线+字母+空格分隔值:
在上述 //replace 指令的第1、2个选项,它们就是纯值选项,不能改变它们的位置;
第3个选项 -m (mask) 是有前缀开头+空格分隔值的组合,第3个选项一般可以放在任意位置;我们将 -m 的部分称为键,它用来识别值的含义,例如“在线人数”;将 (mask) 的部分称为值,它用来设置值,例如 16。
类似 -m (mask) 的键值型选项应视为一个整体,键后输入空格并紧跟它的值。
服务器手册会尽可能清晰描述这些选项,不必记住它们的形式;随着使用次数增多,以后只需查看用法即可上手;
Warning
不要改变纯值选项的位置!这极大可能造成插件工作不如预期!
例如希望改变玩家 Yukaling 的游戏模式为创造模式,指令用法请查看 ⭐示例1 ;
/gamemode Yukaling creative ❌ 不能这样写! /gamemode creative Yukaling ✅ 这样才能正确工作!输入选项时请仔细检查指令用法;短横线型键值选项间需要空格,冒号型键值选项间通常不需要空格。
单个选项内部的分隔符
有些选项只接受一组固定值中的一个;而有些选项既接受字符串,又接受纯数;我们使用下面的分隔符分开它们:
/斜线:分隔选项的不同值类型;|竖线:分隔选项的固定值,使用时在其中选择一个。
关于这两个分隔符的实例,请参考页面末尾的示例指令用法,并结合选项提示理解。
Info
固定值一般只接受一个;若选项可以同时接受一组值,请添加
,英文逗号分隔值。能够接受一组值的选项在必要时会被特别注释。/co lookup radius:15 user:Yukaling,DuckQiao ✅ 正确 /co lookup radius:15 user:Yukaling DuckQiao ❌ 错误,运行失败 ^
💫指令书写示例
⭐示例1
此指令来自 Minecraft。
/gamemode <数字(0|1|2|3)|名称(survival|creative|adventure|spectator)> [玩家名/实体对象占位符(@a|@e|@n|@s)=@s]
指令效用
变更指定玩家或实体的游戏模式。
选项
- <必填> 要变更的目标游戏模式,必须是给出选项当中的一个:
- 生存模式:
0或survival - 创造模式:
1或creative - 冒险模式:
2或adventure - 旁观者模式:
3或spectator
- 生存模式:
- [可选] 作用的目标玩家或实体,必须是在线玩家或有效的占位符:
- 选择所有玩家:
@a - 选择所有实体:
@e - 离运行此指令时位置最近的玩家:
@n - [默认值] 玩家自己:
@s
- 选择所有玩家:
使用示例
将所有玩家的游戏模式更改为创造
/gamemode creative @a
⭐示例2
此指令来自 WorldEdit。
运行指令前必须先建立选区。
//replace [replace_from=air] <replace_as> [-m (mask)]
指令效用
将选区内的方块进行替换。
选项
- [可选]
replace_from要替换方块的目标,可以是方块数字ID或其内部英文标识符。如果不填写,将替换空气方块; - <必填>
replace_as替换后的方块; - [可选]
-m (mask)遮罩条件。满足遮罩条件的方块将不会被替换。
Info
在 Minecraft: JavaEdition 1.13 及以上版本,Mojang 已不支持在 Minecraft 原生指令中直接使用数字ID表示方块和物品,而必须使用英文。也许应该记住一些单词了?XD(用英文也确实好理解些,但是多了记住它的学习成本。不过可以记住各种新单词 :D)