标题指示

为了更好地区分标题、标题的附属关系和内容,手册内的标题都会由一个特定 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]

指令效用

变更指定玩家或实体的游戏模式。

选项

  1. <必填> 要变更的目标游戏模式,必须是给出选项当中的一个:
    • 生存模式:0survival
    • 创造模式:1creative
    • 冒险模式:2adventure
    • 旁观者模式:3spectator
  2. [可选] 作用的目标玩家或实体,必须是在线玩家或有效的占位符:
    • 选择所有玩家:@a
    • 选择所有实体:@e
    • 离运行此指令时位置最近的玩家:@n
    • [默认值] 玩家自己:@s

使用示例

将所有玩家的游戏模式更改为创造

/gamemode creative @a

⭐示例2

此指令来自 WorldEdit。

运行指令前必须先建立选区。

//replace [replace_from=air] <replace_as> [-m (mask)]

指令效用

将选区内的方块进行替换。

选项

  1. [可选] replace_from 要替换方块的目标,可以是方块数字ID或其内部英文标识符。如果不填写,将替换空气方块;
  2. <必填> replace_as 替换后的方块;
  3. [可选] -m (mask) 遮罩条件。满足遮罩条件的方块将不会被替换。

Info

在 Minecraft: JavaEdition 1.13 及以上版本,Mojang 已不支持在 Minecraft 原生指令中直接使用数字ID表示方块和物品,而必须使用英文。也许应该记住一些单词了?XD(用英文也确实好理解些,但是多了记住它的学习成本。不过可以记住各种新单词 :D)