MCreator 游戏规则(Game Rule)类型详解:在 Number 与 Logic 之间做出正确选择

原创2026-10-16 19:59:491,880 阅读
文章标签:桌面应用游戏开发代码生成低代码开发工具模板引擎

MCreator 游戏规则(Game Rule)类型详解:在 Number 与 Logic 之间做出正确选择

导读

本文围绕 MCreator 中"游戏规则(Game Rule)"元素的 类型(Type) 字段展开,说明当你通过 MCreator 制作自定义游戏规则时,为什么必须先选定 Number(数字)或 Logic(逻辑)两种类型之一,以及它们各自对应什么游戏行为、在生成代码中如何体现。读完本文,你将能根据规则的设计意图(如"控制某数值的上限"还是"开启/关闭某项机制")准确选择类型,并理解类型选择背后从 UI 到代码生成的全链路实现。

游戏规则类型是什么

在 Minecraft 中,/gamerule 命令允许服务器管理员动态修改世界行为,例如 keepInventory、mobGriefing、randomTickSpeed 等。MCreator 的 Game Rule 元素正是用来创建这一类自定义游戏规则的。而每个游戏规则在定义时必须明确其取值形态,这就是文档中反复强调的"游戏规则类型(Spielregel-Typ)":

这是游戏规则的类型。你必须根据你的计划(plan)选择最佳类型。

MCreator 提供且仅提供两种类型(类型帮助文档):

类型 取值形态 文档原文说明
Number 只能被修改为一个数字(整数) "Number means the game rule can only be modified to be a number (integer)"
Logic 只能是布尔值(true 或 false) "Logic means the game rule can only be a boolean (true or false)"

这一字段在源码中直接约束了数据模型:GameRule.java 中的 type 字段通过 @LimitedOptions({ "Number", "Logic" }) 注解把可选值限定为这两个枚举选项,UI 端对应的下拉框也由该注解自动生成(见 GameRuleGUI.java)。

Number 类型:用整数衡量世界状态

选择 Number 表示该规则的值是一个整数(integer),游戏内只能通过 /gamerule 命令把它设置为某个整数值。它适合描述那些"有大小、可量化"的世界参数,例如:

  • 随机刻速度(randomTickSpeed)
  • 生物堆积上限(maxEntityCramming)
  • 睡觉跳过夜晚所需的玩家百分比
  • 出生点半径、下界传送门延迟等

MCreator 内置的数据列表 gamerules.yaml 完整收录了原版所有游戏规则及其类型,其中 type: number 的条目(如 RANDOM_TICK_SPEED、SPAWN_RADIUS、PLAYERS_SLEEPING_PERCENTAGE、SNOW_ACCUMULATION_HEIGHT、MAX_COMMAND_CHAIN_LENGTH、MAX_ENTITY_CRAMMING)都是典型的数值型规则,可作为选择类型时的参照。

选择 Number 类型后,MCreator 的默认值输入控件是一个数字微调器(JSpinner)。其取值域在数据模型中定义得非常宽:GameRule.java 中 defaultValueNumber 字段带有 @Numeric(init = 0, min = Integer.MIN_VALUE, max = Integer.MAX_VALUE, step = 1) 注解,即默认初始值为 0、步长为 1,理论上可填入 int 范围内的任意整数。

Logic 类型:用开关控制机制

选择 Logic 表示该规则的值只能是布尔值,即 true(开启)或 false(关闭)。它适合描述那些"二元开关"式的能力,例如:

  • 是否保留物品栏(keepInventory)
  • 生物是否破坏地形(mobGriefing)
  • 是否开启 PvP、是否生成怪物、是否刷新天气等

在 gamerules.yaml 中,type: logic 的条目占绝大多数,如 KEEP_INVENTORY、MOB_GRIEFING、PVP、DO_MOB_SPAWNING、DO_DAYLIGHT_CYCLE、DO_WEATHER_CYCLE、NATURAL_REGENERATION、FALL_DAMAGE、COMMAND_BLOCKS_WORK、SPAWN_MONSTERS 等,可以看出"布尔开关"是游戏规则最主流的形态。

选择 Logic 类型后,默认值输入控件变为一个只有 false / true 两个选项的下拉框(GameRuleGUI.java),选中后通过 Boolean.parseBoolean(...) 写入模型(GameRuleGUI.java)。

如何根据设计意图选择类型

结合文档提示"必须根据你的计划选择最佳类型",决策依据可以归纳为一条简单原则:

  1. 先想清楚这条规则想让玩家/管理员改什么。
  2. 如果答案是"改一个数量、程度、上限、速率"——选 Number(整数)。
  3. 如果答案是"开启或关闭某项机制/行为"——选 Logic(true/false)。

选错类型的直接后果是:游戏内无法对规则设置期望形态的值。例如把"伤害是否生效"做成 Number,玩家就只能把它改成整数而无法表达"开/关"语义;反之,把"随机刻速率"做成 Logic,则只能开启/关闭而无法精细调节。类型一旦发布,玩家在服务器中能进行的修改就被锁定在这一形态上,因此应在设计早期确定。

类型在源码与生成代码中的落地

类型选择并不只是 UI 上的一个下拉框,它会贯穿数据模型、代码生成两个层面,最终决定你的模组编译后生成什么样的 Java 代码。

数据模型层:GameRule.java 中 type、category、defaultValueLogic、defaultValueNumber 共同描述一条规则;其中 defaultValueLogic 与 defaultValueNumber 是并列存在的两个字段,真正生效的是哪一个,由 type 决定。

代码生成层:生成器模板 gamerules.java.ftl(NeoForge 1.21.1 生成器)中通过 <#if gamerule.type == "Number"> 分支生成完全不同的声明与注册代码:

  • Number 类型生成 GameRules.Key<GameRules.IntegerValue> 字段,并用 GameRules.IntegerValue.create(defaultValueNumber) 注册默认值;
  • Logic 类型生成 GameRules.Key<GameRules.BooleanValue> 字段,并用 GameRules.BooleanValue.create(defaultValueLogic) 注册默认值;

即:类型决定 Java 泛型键类型(IntegerValue vs BooleanValue),默认值则注入到对应的 Value 工厂方法中。同一套逻辑同样存在于 NeoForge 26.3 生成器(gamerules.java.ftl)中。

UI 交互层:GameRuleGUI.java 使用 CardLayout 将"逻辑默认值"与"数字默认值"两块面板做成卡片,当类型下拉框切换时调用 updateDefaultValueUI() 即时切换默认值输入控件,确保玩家只能输入与类型匹配的默认值,从源头避免数据不一致。

类型与默认值、命令行为的联动

文档 default_value.md 说明:默认值是规则在未被任何游戏内操作修改之前的取值。它必须与类型匹配:

  • Number 规则需要设定整数默认值(如 0);
  • Logic 规则需要设定布尔默认值(如 false)。

当规则发布到游戏中后,玩家可通过 /gamerule <规则名> <值> 修改;<值> 的合法形态完全取决于类型——整数规则必须传整数,布尔规则必须传 true/false。这与 Minecraft 原版对 GameRules.IntegerValue / GameRules.BooleanValue 的命令解析行为一致。

此外,规则名也会进入生成代码。根据 GameRuleGUI.java 中的逻辑,MCreator 1.21.11 及更高版本生成器会采用 camelCase 转 snake_case 的规则名(例如模组元素名 MyCoolRule 会变为 my_cool_rule),并统一小写;模板中使用 GameRules.register("规则名", ...) 完成注册(gamerules.java.ftl)。

版本迁移注意:boolean 与 Logic 的历史转换

在较早版本的 MCreator 工作区数据中,Logic 类型对应的元数据(metadata)曾以 boolean 命名。仓库中的转换器 BooleanGameRulesConverter.java 会在工作区升级到转换版本 21 时,将 type 元数据从 "boolean" 自动改写为 "logic",从而与新版 VariableTypeLoader.BuiltInTypes.LOGIC 保持一致。

这一点对实际使用的提示是:当你打开较老版本创建的、包含 Logic 类型游戏规则的工作区时,MCreator 会自动完成这一元数据迁移,无需手动干预;同时 GameRuleGUI.java 在保存时也会把游戏规则类型同步写入模组元素的元数据(Number 对应 NUMBER 变量类型、其余对应 LOGIC),供流程/变量体系按类型使用。

常见误区与最佳实践小结

  • 误区一:把"数值调节"做成 Logic。 若规则需要表达程度、速率、上限,必须选 Number;否则玩家只能开关而无法微调。
  • 误区二:把"机制开关"做成 Number。 若规则本质是允许/禁止某项行为,应选 Logic,保持 true/false 的清晰语义。
  • 实践一:参考原版同名规则。 MCreator 已内置完整的原版规则列表(gamerules.yaml),设计自定义规则前可先查证"这个维度原版用的是什么类型",保持体验一致。
  • 实践二:先定类型再填默认值。 UI 会随类型切换默认值输入控件,先确定类型可避免重复修改。
  • 实践三:理解类型是"永久契约"。 类型决定了玩家侧可用的命令取值形态,发布前请务必确认,以免造成规则不可用。

综上,MCreator 游戏规则元素的类型选择看似简单,实则由 @LimitedOptions 数据约束、CardLayout UI 切换、生成器模板的类型分支以及历史转换器共同保障。掌握 Number(整数衡量)与 Logic(布尔开关)的语义边界,即可在 GameRuleGUI 中一次配置到位,产出既符合直觉、又与原版 GameRules API 完美对接的自定义规则。

登录后查看全文
MCreator