World Primer

模组

· 作者 masa

在世界创建、维度加载、玩家登录/登出/死亡以及其他一些事件发生时自动运行命令

0 本站下载 0 关注 更新于 3 年前

最新 0.6.0-dev.20200122.211517 · 1.12.2 · Forge

一键开服(送7天)

描述

World Primer 可以在某些“事件”发生时自动运行一组命令,例如:新世界首次创建时、加载世界时、加载维度时、玩家加入游戏时、退出游戏时、死亡或重生时。此外,还支持定时/周期性运行的命令。

配置

所有配置项也可以通过游戏内的配置菜单进行设置。

请阅读配置文件中的注释。 其中列出了所有可用的命令替换变量,以及大量其他信息。许多替换变量和命令前缀在不同模组版本之间有所变化,较新的模组版本提供了更多的配置项/事件类型和字符串替换功能。查看配置注释是获取特定模组版本正确信息的最佳方式。

注意: 配置文件中的所有命令都不应带有斜杠前缀!斜杠仅在使用聊天窗口或服务器控制台发送命令时需要,用于表明该消息不是聊天内容而是命令。一个显著的例外是 World Edit 命令,因为它们通常通过聊天使用双斜杠,所以在配置文件中应只保留单个斜杠。

命令配置

在各个事件下要运行的命令在以下配置选项中设置。

注意: 旧版模组尚未包含所有这些选项。

  • dimensionLoadingCommands - 每次加载维度时运行的命令
  • earlyWorldCreationCommands - 在世界初始创建时运行的命令,此时出生点区块尚未生成或加载。如果启用了维度加载追踪,则此操作甚至会在任何维度被加载/初始化之前发生。
  • earlyWorldLoadingCommands - 每次世界加载时(即服务器启动时)运行的命令。这些命令在服务器启动时、任何世界加载之前执行。
  • playerChangedDimensionEnterCommands - 当玩家进入另一个维度后(=之后)运行的命令。注意,这些命令不会在玩家加入游戏或死亡后重生时触发。
  • playerChangedDimensionLeaveCommands - 当玩家在切换维度过程中离开当前维度时运行的命令。注意: 这些命令将在玩家已经处于新维度后运行!注意: 这些命令不会在玩家离开游戏/服务器时触发。
  • playerDeathCommands - 玩家死亡时运行的命令
  • playerJoinCommands - 玩家加入(连接至)服务器时运行的命令
  • playerQuitCommands - 玩家从服务器断开连接时运行的命令
  • playerRespawnCommands - 玩家死亡后重生时运行的命令
  • postWorldCreationCommands - 在世界初始创建时运行的命令,此时出生点区块已生成并加载。
  • postWorldLoadingCommands - 每次世界加载时(即服务器启动时)运行的命令。这些命令在服务器启动且主世界出生点区块已加载后执行。
  • timedCommands - 基于世界刻/时间运行的命令。
    • 格式必须为:worldprimer-timed-command <time> <dimension> <command>,其中 <time> 是命令应执行的总世界时间(单位:刻)。
    • 时间前可以添加 % 符号使其周期性运行,间隔为该数值(本质上是取模运算)。
    • 对于周期性时间,还可以使用偏移量,如下所示:
      worldprimer-timed-command %1200-80 0 say Something happens in 4 seconds!
      worldprimer-timed-command %1200 0 say Something happens now!
      worldprimer-timed-command %1200+80 0 Say something happened 4 seconds ago!
      

在 Toggles 类别中还有单独的选项来启用或禁用上述所有功能。这些选项允许你临时禁用命令,而无需删除它们或将其注释掉。

其他配置

  • enableDebugLogging - 打印来自各种事件的日志消息,并打印任何尝试执行的命令,从而方便跟踪发生了什么以及何时发生
  • enableDimensionLoadTracking / enableDataTracking - 启用对维度加载次数、服务器启动次数、玩家加入次数、死亡次数等的追踪和保存。这是所有基于计数的命令前缀正常工作所必需的。

强烈建议在测试时使用 enableDebugLogging 日志选项!

命令前缀

有一些不同的命令前缀/过滤器,用于仅在特定情况下运行命令,例如在特定维度中,或仅在特定时间等。

worldprimer-dim-command

可以通过使用此命令前缀,使维度加载命令仅在特定维度加载时运行:

worldprimer-dim-command <dim id> <the actual command>

例如:

worldprimer-dim-command 1 say The End dimension has loaded!

如果你在 dimensionLoadingCommands 中放置不带前缀的命令,那么它将在任何维度加载时执行,例如:

say Some dimension has loaded!

worldprimer-dim-command-nth

自版本 0.3.0 起,还有另一种维度加载命令变体,可以在特定的维度加载次数上运行命令,或在给定值的任意倍数次加载时运行。

注意: 此变体需要启用 enableDimensionLoadTracking 选项!

这些命令的语法(在 0.6.0 及更高版本中)为:

worldprimer-dim-command-nth <load count> <dim id> <the actual command>

因此,要让命令仅在下界第一次加载时运行,你可以使用:

worldprimer-dim-command-nth 1 -1 say The Nether has loaded for the first time!

或者让末地第六次加载时运行:

worldprimer-dim-command-nth 6 1 say The End has loaded for the sixth time!

要在给定值的任意倍数上执行命令,请在值前加上 % 前缀:

worldprimer-dim-command-nth %5 1 say The End has loaded a multiple of 5 times!

注意/警告: 此前缀的参数顺序在模组版本之间发生了变化!该顺序在第一个 0.6.0-dev.* 版本中进行了更改。

在 0.5.0 及更早版本中,用法为:

worldprimer-dim-command-nth <dim id> <load count> <the actual command>

worldprimer-tracked-command-nth

这些前缀允许你限制例如玩家专属命令何时运行。

例如在 playerRespawnCommands 中:

worldprimer-tracked-command-nth 3 say The player {PLAYER_NAME} has respawned for the third time at {PLAYER_X}, {PLAYER_Y}, {PLAYER_Z}
worldprimer-tracked-command-nth %5 say The player {PLAYER_NAME} has respawned for some multiple of 5 times

命令字符串替换

从版本 0.4.0 开始,还支持将某些值(如维度 ID 或当前世界出生点坐标)替换到命令中。它们也支持对常数数值进行简单的加法和减法运算。

注意: 其中一些替换项在后续模组版本中已重命名!许多替换项也是在后续版本中添加的,因此如果你使用的是较旧版本,则可能无法使用所有这些替换项。请检查配置文件注释以查看你的模组版本可用的替换项!

可用的替换字符串(在模组版本 1.12.2-0.6.0-dev.20200122.211517 中)如下:

适用于所有命令:

  • {DIMENSION} - 维度 ID
  • {RAND:min,max} - 随机数,整数和双精度类型,例如 {RAND:5,15} 或 {RAND:1.2,3.9}(最大值不包含在内)
  • {SPAWN_X}, {SPAWN_Y}, {SPAWN_Z} - 维度出生点的 X、Y 和 Z 坐标
  • {SPAWN_POINT_X}, ... - 出生点 的 X 坐标,而不是可能的 出生坐标(例如在末地中)
  • {TIME_TICK} - 世界总时间(以刻为单位)
  • {TIME_TICK_DAY} - 世界白天时间(以刻为单位)
  • {TIME_Y} - 实际时间的年份(4 位数字:2017)
  • {TIME_M} - 实际时间的月份(2 位数字:03)
  • {TIME_D} - 实际时间的日期(2 位数字:04)
  • {TIME_H} - 实际时间的小时(2 位数字:09)
  • {TIME_I} - 实际时间的分钟(2 位数字:05)
  • {TIME_S} - 实际时间的秒数(2 位数字:07)
  • {TOP_Y:x,z} - 给定坐标处世界中最高方块的 Y 坐标(实际上是它上方的空气方块)。例如:{TOP_Y:-37,538}
  • {TOP_Y_RAND:x,z;x-range,z-range} - 围绕给定 x,z 位置的随机位置处世界中最高方块的 x y z 坐标(同样,实际上是它上方的空气方块)。例如:{TOP_Y_RAND:-37,538;32,32} 将是位于 x = -37, z = 538 周围 32 个方块内的随机位置处的最高方块。该替换项将被替换为类似 -49 72 544 的坐标字符串。

适用于玩家专属命令(如 playerJoinCommands):

  • {PLAYER_NAME} - 玩家名称
  • {PLAYER_X}, {PLAYER_Y}, {PLAYER_Z} - 玩家当前位置的 X、Y 和 Z 坐标
  • {PLAYER_BED_X}, {PLAYER_BED_Y}, {PLAYER_BED_Z} - 最后设置的(床)出生点
  • {PLAYER_BED_SPAWN_X}, {PLAYER_BED_SPAWN_Y}, {PLAYER_BED_SPAWN_Z} - 这些还会检查床是否存在,否则将回退到备用世界出生点。请注意,这将加载相应的区块以检查床的存在。

替换示例

因此,例如,你现在可以在 postWorldCreationCommands 中执行以下操作,使玩家在地下一个 5 x 5 x 3 的石砖房间中生成:

gameRule spawnRadius 0
setworldspawn {SPAWN_X} 7 {SPAWN_Z} (moves the world spawnpoint down to y = 7)
fill {SPAWN_X}-3 6 {SPAWN_Z}-3 {SPAWN_X}+3 10 {SPAWN_Z}+3 minecraft:cobblestone
fill {SPAWN_X}-2 7 {SPAWN_Z}-2 {SPAWN_X}+2 9 {SPAWN_Z}+2 minecraft:air

spawnRadius 0 游戏规则将“出生点模糊度”设置为 0,因此玩家将在世界出生点精确生成,而不会在距确切出生点一定半径(水平方向)内的表面上(在最高方块顶部)生成。换句话说,玩家将在小房间的中心生成,而不是随机出现在房间表面的某个位置。

fill 命令将在地下(或原始存在的位置)的石砖外壳(墙壁、地板和天花板)内创建一个 5x5x3 的空气房间。

内置命令

World Primer 提供了一些命令,包括“伪”命令和“实际”命令。“伪”命令仅能从配置文件中工作,并非实际注册的命令。

结构保存/放置命令

  • create-structure 命令可用于将给定区域保存为 MCEdit/Schematica 格式的 .schematic 文件或原版结构方块模板 .nbt 文件。
  • place-structure 命令可用于将结构放置/粘贴到世界中。
  • 文件存放在 config/worldprimer/structures/ 目录下。

提示: 自动补全功能应适用于所有内容。

  • create-structure 命令是在模组版本 1.12.2-0.6.0-dev.20180502.210326 中添加的
  • place-structure 命令是在模组版本 1.12.2-0.6.0-dev.20171010.003436 中添加的

create-structure 的命令格式

/worldprimer create-structure <x1> <y1> <z1> <x2> <y2> <z2> <schematic | vanilla> <name>

其中 schematic 或 vanilla 参数定义是创建为 MCEdit/Schematica .schematic 格式还是原版结构方块模板 .nbt 格式。

示例:

/worldprimer create-structure 123 64 123 180 90 180 vanilla my_structure
/worldprimer create-structure 123 64 123 180 90 180 schematic my_schematic

place-structure 的命令格式

/worldprimer place-structure <x> <y> <z> <name> [rotation: none | cw_90 | cw_180 | ccw_90] [mirror: none | left_right | front_back] [centered] [data-functions]
  • 如果不需要 rotation、mirror、centered 和 data-functions 参数,它们可以省略。但由于它们是位置参数,因此需要从左侧开始依次添加。
  • centered 参数会将结构(仅限水平方向)居中到给定的坐标。
  • data-functions 参数会使原理图中的任何 DATA 类型结构块的自定义数据标签名称(metadata 字符串标签)被解释为通过原版 /function 命令运行的函数。

示例:

/worldprimer place-structure 123 64 123 my_structure.nbt
/worldprimer place-structure 123 64 123 my_structure.nbt cw_90
/worldprimer place-structure 123 64 123 my_structure.nbt ccw_90 left_right
/worldprimer place-structure 123 64 123 my_structure.nbt none none centered

worldprimer-load-chunks(虚拟命令)

从版本 0.5.0 开始,内置了一个“虚拟”区块加载命令:

worldprimer-load-chunks <chunkXMin> <chunkZMin> <chunkXMax> <chunkZMax>

注意: 这不是一个实际注册的游戏内命令,因此无法通过聊天框或服务器控制台使用,仅当在配置文件中找到时会在内部使用。

它可以用于加载一系列区块,从而使其他命令能够正常工作。例如,原版的 /fill 和 /setblock 命令仅在已加载的区块中生效,因此可以在执行 /fill 或 /setblock 命令之前使用此命令来加载相关区块。这些区块会被立即标记为待卸载状态,因此它们不应一直保留到下一次世界保存发生(通常为每 45 秒,此时正常的“不应加载”区块会被卸载),而是在下一个游戏刻(tick)时卸载。

该“命令”的坐标是区块坐标(即方块坐标除以 16)。范围是包含两端的,即从最小值一直到最大值(含最大值)。

从版本 1.12.2-0.6.0-dev.20171117.213848 开始,还有另一种变体命令 worldprimer-load-blocks,它直接使用方块坐标而非区块坐标。 当然,加载的区域仍然会按区块对齐。

以下是在末地维度首次加载时于 0,0 处建造基岩箱子的示例。这些内容应添加到 dimensionLoadingCommands 中:

worldprimer-dim-command-nth 1 1 worldprimer-load-chunks -1 -1 0 0
worldprimer-dim-command-nth 1 1 fill 10 0 10 -10 7 -10 minecraft:bedrock
worldprimer-dim-command-nth 1 1 fill 9 1 9 -9 6 -9 minecraft:air
worldprimer-dim-command-nth 1 1 say Finished building your box!

/worldprimer spread-player

此命令添加于版本 1.12.2-0.6.0-dev.20190814.220944。 以下是可用选项的描述以及命令的工作原理:

/worldprimer spread-player [options] <playername1 playername2 ...>

该命令有两种位置搜索/选择模式:grid(网格)和 random(随机)。 如果提供了 grid 选项并指定了网格大小,则使用网格模式。 否则,将使用随机位置模式。

选项:

  • --find-surface=<true | false> - 如果为 true,则将 y 坐标设置为找到的 x/z 位置上的最高固体方块的顶部。
  • --grid=<integer> - 如果提供,则使用向外螺旋的网格搜索模式代替随机位置。该值为网格点之间的间隔。
  • --max-radius=<integer> - 距离 0, 0 的最大距离(每个轴单独计算,非绝对直线距离)
  • --min-separation=<integer> - 与之前散布的玩家位置以及同维度内当前在线玩家的最小距离
  • --new - 如果提供,则对于之前已经散布过的玩家再次运行此命令时,将生成一个新的位置,而不是将他们传送回原始的散布位置
  • --y=<integer> - 如果提供,则使用此固定的 y 高度
  • --y-offset=<integer> - 如果提供且 --find-surface=true,则此偏移量将加到地表 y 位置上。这允许例如将位置偏移至地下一定距离
  • --y-max=<integer> - 限制来自 --find-surface=true 情况下的(可能经过偏移的)y 位置上限
  • --y-min=<integer> - 限制来自 --find-surface=true 情况下的(可能经过偏移的)y 位置下限

示例:

/worldprimer spread-player --find-surface=true --min-separation=1024 --max-radius=10000 --new player_name

Discord

如果你有想法、问题或反馈,或者只是想闲聊,欢迎加入我们的 Discord 社区。 链接位于侧边栏。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源