《前曲速时代》模组指南

制作第一个模组,了解它的结构,为游戏添加自己的科技、建筑和事件。

在参考资料中查找词语

1. 从哪里开始

本指南介绍 Pre-Warp Age 1.0.24 beta。为已发布的 1.0.23 版本制作模组时,请在版本选择器中选择对应指南。

模组保存在独立文件夹中。您可以在其中修改探索价格,创建科技,甚至添加整家公司。自己的文本、图像和声音也放在这里。无需用 C# 编程:模组规则写在 JSON 文本文件中。

从“第一个模组”开始:创建两个文件,在游戏中检查改动。随后在“事实语言基础”中了解记录各部分,再通过“实用示例”添加内容。指南末尾是详细参考资料。确定要做什么后,可以在那里查找具体规则。

游戏规则使用的语言名为 Nexus。它可以组合已有能力,例如让科技增加采掘量、解锁建筑或提供收入。如果引擎完全不支持您设想的机制,仅靠 JSON 模组无法实现,需要修改游戏本身。

模组可用于完整版电脑游戏,试玩版中不开放。启用模组或修改 Vanilla 文件后,将无法获得官方成就。

2. 第一个模组

先降低探索价格,将基础价格设为 1 矿物。只需两个文件,暂时不需要图像或翻译。如果想先试用现成版本,可以下载页面顶部的“快速探索”ZIP。

在主菜单中打开开始游戏 → 模组 → 模组文件夹。无论选中哪个模组,都会打开同一个 Modding 文件夹。打开其中的 Local,创建 quick-survey 文件夹,再在其中创建 Logic。结构应如下所示:

Modding/
  Local/
    quick-survey/
      modinfo.json
      Logic/
        Explore.json

第一个文件 quick-survey/modinfo.json 保存模组名称和版本。将下面整个代码块复制进去:

{
  "id": "quick-survey",
  "version": "1.0.0",
  "title": "快速探索",
  "description": "将探索的基础价格降至 1 矿物。"
}

第二个文件 quick-survey/Logic/Explore.json 修改价格,内容如下:

[
  ["Explore", "Cost.Minerals", 1]
]

内部这一行读作:“探索 Explore 的矿物基础价格等于 1”。最外层方括号把文件记录组成列表。目前只有一条,下面会说明如何添加更多记录。

  • 将两个文件都保存为 UTF-8 编码的 JSON。如果解压现成档案,确认 modinfo.json 直接位于 Modding/Local/quick-survey 下,没有再多套一层文件夹。
  • 返回模组界面,启用“快速探索”。关闭界面,游戏会重新读取文件并更新新游戏菜单。
  • 创建新游戏。选择“G 型恒星系”开局设定、“休闲”模式和“采掘者”公司。暂时跳过教学用的“太阳系”,因为教学限制可用行动。
  • 选择未探索天体,将鼠标移到探索行动上,检查提示价格。模组设置的基础价格为 1,距离附加费用和其他有效修正可能使最终价格升高或降低。

把 Explore.json 中的 1 改为 2。打开并关闭模组界面,创建新游戏,基础价格就会变为 2 矿物。准确比较时,请使用相同种子、开局设定、公司和天体。改变的是基础价格,与天体的距离不变。

已经开始的游戏继续使用旧数据,即使模组文件已改变。“重新开始”也保留当前游戏的数据集。检查修改时,必须从更新后的菜单创建新游戏。如果游戏报告文件错误,先修正,再次打开并关闭模组界面。

3. 事实语言基础

3.1. 主体、谓词和值

["Explore", "Cost.Minerals", 1]

来看熟悉的探索价格。它由三部分组成:Explore 是探索,Cost.Minerals 是矿物价格,1 是新基础价格。整行表示“在折扣和附加费用之前,探索花费 1 矿物”。这种三部分记录称为三元组。

  • 主体:描述的对象,这里是 Explore。
  • 谓词:设置的属性,这里是 Cost.Minerals。
  • 值:具体数量,这里是 1。相关资料有时也将第三部分称为三元组的客体。

主体和谓词始终写成字符串。值可以是数字、字符串或 true/false。字符串可能是文本、翻译键、选项名称或实体引用。含义取决于具体字段,而非引号。标识符区分大小写,Tech 和 tech 不是同一个词。

单条记录和整个文件不同。上面只展示一条记录。下面是包含此记录的完整 Logic/Explore.json,可以整体复制:

[
  ["Explore", "Cost.Minerals", 1]
]

现在再修改前哨站的基础价格。用下面内容替换同一文件,现在有两条记录:

[
  ["Explore", "Cost.Minerals", 1],
  ["Outpost", "Cost.Minerals", 8]
]

探索基础价格变为 1,前哨站变为 8。注意第一条记录末尾新增逗号,用来分隔第二条。第二条后没有逗号。最上面和最下面的方括号围住文件的整个记录列表。

后面的参考资料会出现短片段,仅含新增记录,不含文件其他内容。代码前会说明片段用途。完整文件则像上面两个例子一样整体展示。

Explore、Cost、Is 和 Tech 是游戏已有词。您可以为自己的科技选择 SurveyScience 等名称。新名称可以写在左侧描述对象,但不能随意当作谓词。自定义词语声明见“Predicate”。最初几个模组使用现有属性即可。

初次制作模组时,自定义名称建议使用拉丁字母,必要时加数字,例如 SurveyScience、MyMiner2。名称应唯一、不含空格且不与现有名称重复。点、下划线和冒号各有用途:点分隔定义的部分,下划线用于实例名称,冒号用于地图格子地址。独立定义名称中不要使用这些符号。翻译键也建议用拉丁字母,玩家看到的名称则写在中文词典中。

3.2. 定义、实例与继承

模组文件通常描述某类对象,例如科技、公司、建筑或星球,这称为定义。游戏过程中会根据定义创建具体对象,也就是实例。例如科技描述通用,但每个玩家拥有各自的研究状态。实例名称由游戏分配,无需把存档中 SurveyScience_0 这样的名称复制到模组。

[
  ["MyMiner", "Is", "CorpMiner"],
  ["MyMiner", "Name", "MyMinerName"]
]

此片段以现有 CorpMiner 为基础描述新公司 MyMiner。第一行赋予采掘者属性,第二行改名称。取得另一份定义的属性称为继承。未指定属性与 CorpMiner 一致,自身值(例如 Name)替换继承值。

现在从两家现有公司取得属性。在此独立例子中,MyHybrid 没有自己的 Name。完整 Logic/MyHybrid.json:

[
  ["MyHybrid", "Is", "CorpMiner"],
  ["MyHybrid", "Is", "CorpColonist"]
]

两个父定义的属性都会继承。不过两者都设置 Name,冲突时以列表第一个为准,因此这里与采掘者同名。交换两行,优先使用拓殖者 Name。若添加 MyHybrid 自己的 Name,它优先于两个父定义。

继承在创建游戏时准备。修改文件后请创建新游戏,运行时修改对象 Is 不会重新复制全部属性。继承链不能循环,不能让 MyMiner 继承 CorpMiner,同时 CorpMiner 又继承 MyMiner。

我们用 Is 取得父定义属性。独立字段 Type 有另一用途,它选择提示显示的类型名称。区别示例见“Type - 对象的类型名称”。仅替换 Type 不会继承父定义属性。

3.3. 复合谓词与子主体

点会出现在记录不同位置。先看属性中的点,再看描述对象名称中的点。这是不同用法。

熟悉的探索价格中,Cost 表示费用,Minerals 指定支付资源:

["Explore", "Cost.Minerals", 1]

Cost.Minerals 整体占据三元组第二位置。这是复合谓词,用点连接几个词描述一个属性。若用能源支付,属性名就是 Cost.Energy。这里的点说明描述的是哪种费用。

子主体可以把主体的一种行为与其他行为隔开。例如公司在信用点储备较高时获得一种加成,同时拥有不受储备影响的另一种加成。每种行为有自己的条件和效果,一部分条件不应启用或关闭相邻部分。因此子主体能描述同一主体在不同情况和状态下的行为。

来看写法。大亨公司 CorpMagnate 根据储备取得利息收入,写在 CorpMagnate.Interest 子主体中:CorpMagnate 是主体,Interest 是独立行为名称。Interest 由作者命名,这个词本身不会发放利息,也不设置条件。

先指定这部分收入根据什么数量计算。下面是公司定义的一条记录:

["CorpMagnate.Interest", "Per", "Credits"]

Per Credits 表示“按该公司玩家储备中的每个信用点”。此时尚未指定收入大小。这行只选择数量,不自行发放任何东西。

下一条记录指定收入大小:所选数量每单位每回合提供 0.03 信用点:

["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

Adds.Income.Credits 表示增加每回合信用点收入。两条记录合成利息规则,应作为定义的同一部分阅读:

["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

储备 100 时,这部分在其他修正前增加每回合 100 × 0.03 = 3 信用点收入。两行都属于 CorpMagnate.Interest。尚无条件,任何储备都计算利息。子主体不一定需要条件。

为教学修改规则:仅在储备至少 100 信用点时计息。将条件加入 Interest:

["CorpMagnate.Interest", "Requires.Has.Credits.Min", 100]

Requires.Has.Credits.Min 100 检查玩家是否至少有 100 信用点储备。储备 50 时这部分无收入,100 时为 3,200 时为 6。条件只针对 Interest 利息,而非全部公司能力。

再增加第二种行为:每回合固定支付 2 信用点。建立另一个子主体 Support:

["CorpMagnate.Support", "Adds.Income.Credits", 2]

Support 无条件,也不按每个信用点计算,而是固定 +2。Interest 的条件和 Per 不影响它。储备 50 时即使 Interest 关闭,Support 仍支付 2。储备 100 时两部分有效,3 点利息加 2 点固定支付,共增加每回合 5 信用点。全部记录如下:

["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03],
["CorpMagnate.Interest", "Requires.Has.Credits.Min", 100],
["CorpMagnate.Support", "Adds.Income.Credits", 2]

Interest 和 Support 是作者选择的名称。每部分含义由它的 Requires、Per 和 Adds 决定。请区分语言词语与作者名称。新增及替换现有部分的规则另见 Is。

比较点的位置:Cost.Minerals 中它在第二元素里,细化属性。CorpMagnate.Interest 中它在第一元素里,分隔公司名称和部分名称。通过点访问关联对象是另一用法,将在“条件来源与参数调整”通过所有者条件说明。任意串联熟悉词语不会产生新规则。

3.4. 角色、资源与效果

创建“科学探索”科技。先声明 SurveyScience 是科技。SurveyScience 是自定义名称,Tech 是游戏已有类别:

["SurveyScience", "Is", "Tech"]

Is Tech 赋予对象科技行为,可以研究它。拥有行为的类别称为角色。Building 是建筑,Event 是事件,Corporation 是公司。现有类别和定义列在 Is 条目中。

将科技加入玩家科技树:

["Player", "Has", "SurveyScience"]

Player Has SurveyScience 表示该科技属于玩家集合。创建游戏后会出现在科技树,但尚未完成研究。这里 Has 不发放加成。

设置加成本身:研究后每回合获得 1 科研点:

["SurveyScience", "Adds.Income.Science", 1]

Income.Science 是每回合科研点收入,Adds 增加指定数量。完成 SurveyScience 的玩家取得此增量。此前收入为 2 时,无其他变化则研究后为 3。把 1 改为 2,就得到每回合 +2。

为科技命名:

["SurveyScience", "Name", "SurveyScienceName"]

Name 指向文本键。游戏通过 SurveyScienceName 在 Text/zhCN.json 查找中文名称。下面将词典与完整 Logic 文件一起展示。SurveyScience 表示科技本身,SurveyScienceName 表示它的名称文本。

图像使用现有烧瓶图标:

["SurveyScience", "Icon", "flask"]

Icon flask 使用现成图像,不需要自己的 PNG。最后指定科技树第一层:

["SurveyScience", "Tier", 1]

Tier 决定节点位置。1 将它放在第一层,不设置价格,也不指定前置科技要求。

将记录组合起来。在第一个例子的模组中创建 Logic/Technology.json,完整内容如下:

[
  ["SurveyScience", "Is", "Tech"],
  ["SurveyScience", "Name", "SurveyScienceName"],
  ["SurveyScience", "Tier", 1],
  ["SurveyScience", "Icon", "flask"],
  ["SurveyScience", "Adds.Income.Science", 1],
  ["Player", "Has", "SurveyScience"]
]

在模组根目录创建 Text,再创建 zhCN.json。若文件已存在,将键加到现有词典,不能添加第二个外层对象。新文件完整内容如下:

{
  "SurveyScienceName": "科学探索"
}

打开并关闭模组界面,创建新游戏,打开科技窗口。在第一层找到“科学探索”。研究前科研点收入不变,研究后每回合增加 1。研究价格由原版 Research 设置决定,所以例子未指定。如果将 Adds.Income.Science 的 1 改为 2,重新读取模组并开新游戏,研究后就会每回合增加 2。

这里改变每回合收入。它与储备、单个工人产量的区别见 Income、Count 和 Production,各有独立示例。

下面建筑示例会出现不带 Adds 的 Income.Science。对建成建筑,它是建筑自身收入,计入所有者经济。科技则写 Adds.Income.Science,表示研究后增加玩家收入。两者用途不同,不能删去科技的 Adds 或给建筑加上 Adds,期望结果不变。

Logic 设置模组规则和初始数据。不要复制存档内容进去:当前储备、已抽卡牌、行动结果和其他游戏过程变化都由引擎保存。继续本局所需的内部记录不是模组设置。

4. 实用示例

下面是独立改动。选择需要的示例,将文件添加到第一个例子的模组。路径相对于模组文件夹。完整文件展示外层括号,单条记录标为片段。新对象名称集中在“示例文本”。数值仅用于教学,不是平衡建议。

4.1. 价格与平衡

将两种价格写在同一文件。用整个数组替换 Logic/Explore.json,无需新文件名:

[
  ["Explore", "Cost.Minerals", 1],
  ["Outpost", "Cost.Minerals", 8]
]

探索基础价格为 1 矿物,前哨站为 8 矿物。记录间有逗号,最后一条后没有。前哨站其他属性,包括要求和工期保留。最终价格仍受有效折扣及附加费用影响。在新游戏中检查探索或建造前哨站提示。

4.2. 公司

添加一家拥有采掘者能力、使用自己名称的公司。创建 Logic/Corporation.json:

[
  ["MyMiner", "Is", "CorpMiner"],
  ["MyMiner", "Name", "MyMinerName"],
  ["MyMiner", "Description", "MyMinerDesc"],
  ["MyMiner", "Order", 10]
]

MyMiner 是新定义的名称,CorpMiner 是现有采掘者定义。Is 继承能力和图像。Name、Description 替换名称与说明,Order 影响卡片列表位置。把“示例文本”的 MyMinerName 和 MyMinerDesc 加入 Text/zhCN.json。

通过模组界面重新读取,开始新游戏。公司中出现“我的采掘者”,原有“采掘者”也保留。新卡片应显示继承能力。若公司要有自己的能力组合,改用 Is Corporation,另行设置效果。

4.3. 科技

“角色、资源与效果”添加了无前置科技的 SurveyScience。现在将它设为现有 OutpostConstruction(前哨站建造)的后续科技。整体替换该例的 Logic/Technology.json:

[
  ["SurveyScience", "Is", "Tech"],
  ["SurveyScience", "Name", "SurveyScienceName"],
  ["SurveyScience", "Tier", 2],
  ["SurveyScience", "Icon", "flask"],
  ["SurveyScience", "Requires", "OutpostConstruction"],
  ["SurveyScience", "Adds.Income.Science", 1],
  ["Player", "Has", "SurveyScience"]
]

名称词典不变。Requires 禁止在 OutpostConstruction 完成前研究。Tier 2 将节点移到第二层,单独 Tier 不会创建此限制。重新读取模组并开新游戏,前置完成前“科学探索”不可研究,完成后即可研究。研究“科学探索”后科研点收入每回合增加 1。Tier 和 Order 决定位置,不决定研究价格。

4.4. 建筑

创建科学型前哨站。它遵守普通前哨站建造条件,但额外提供科研点。完整 Logic/Building.json:

[
  ["SurveyOutpost", "Is", "Outpost"],
  ["SurveyOutpost", "Name", "SurveyOutpostName"],
  ["SurveyOutpost", "Description", "SurveyOutpostDesc"],
  ["SurveyOutpost", "Income.Science", 1]
]

Is Outpost 继承建筑角色、科技及地点要求、价格、工期和维护。自己的 Income.Science 为建成建筑增加科研点收入。将“示例文本”的 SurveyOutpostName、SurveyOutpostDesc 加入 Text/zhCN.json。

新游戏中研究 OutpostConstruction,探索一个允许普通前哨站的适合岩质星球。选择它并找到“科学前哨站”建造行动,资源足够则建造。“休闲”模式立即建成,长时间任务模式需等完成。建成后每回合增加 1 科研点收入,能源维护与普通前哨站相同。能源耗尽可能妨碍建筑运行。

从零定义建筑时,Is Building 本身不够,还需指定地点、要求、费用和结果。这些见“Building、Project、Upgrade”。本例从 Outpost 取得信息。

4.5. 事件

创建一次性增加玩家矿物储备的事件,在第二回合检查。先设置数量,再安排时间,检查后加入随机抽取。请依次操作。

事件与矿物奖励

事件命名为 SurveyGift。先声明它是事件:

["SurveyGift", "Is", "Event"]

与科技一样,Is 指定角色。但 Event 是有结果的事件,而非可研究节点。设置结果:

["SurveyGift", "Adds.Minerals.Scaled", 1]

此行设置一次性矿物奖励。Scaled 使用所选模式的规模,1 是系数。本配方使用休闲模式,规模由人口和研究决定。玩家有 10 个工人、无已完成科技时,规模为 10,奖励为 10 × 1 = 10 矿物。忽略回合其他变化,储备 30 变为 40。

仅将系数 1 改为 2。同样条件下,事件增加 10 × 2 = 20 矿物。一次性奖励不会在随后回合自动重复。含科技的完整公式在本例末尾。

Name、Description、Icon 已在科技例子介绍。组合定义,得到完整 Logic/Event.json:

[
  ["SurveyGift", "Is", "Event"],
  ["SurveyGift", "Name", "SurveyGiftName"],
  ["SurveyGift", "Description", "SurveyGiftDesc"],
  ["SurveyGift", "Icon", "ore_iron"],
  ["SurveyGift", "Adds.Minerals.Scaled", 1]
]

把“示例文本”的 SurveyGiftName、SurveyGiftDesc 加入 Text/zhCN.json。事件已定义,但未安排触发时间,仅启用模组不会发奖励。

在指定回合触发

游戏事件从分组抽取。创建检查用分组 SurveyGiftCheck:

["SurveyGiftCheck", "Is", "Events"]

Events 是从中抽取事件的分组,前面的 Event 是事件本身。仅放入一张卡:

["SurveyGiftCheck", "Deck.SurveyGift", 1]

Deck.SurveyGift 放入一张 SurveyGift。无其他卡,所以抽取时必定选中它。安排抽取时间:

["SurveyGiftCheck", "Turn.Starts", 2]

Turn.Starts 2 表示本局第二回合,不是安装模组后等待两个回合。这三条构成完整 Logic/EventCheck.json:

[
  ["SurveyGiftCheck", "Is", "Events"],
  ["SurveyGiftCheck", "Deck.SurveyGift", 1],
  ["SurveyGiftCheck", "Turn.Starts", 2]
]

游戏通过 Is Events 找到分组,不需要额外关联。重新读取模组,以“休闲”开始新 G 型恒星系。结束第一回合,第二回合会出现“额外矿物”,储备增加奖励数量。10 个工人、无已完成科技、系数 1 时为 10 矿物。人口或研究数量不同,奖励改变。第三回合此检查组不再发奖励。

从多张卡中抽取

现在仅改变分组组成。使用原版事件 SuppliesScience,它一次性增加科研点。将其卡加入 EventCheck.json:

[
  ["SurveyGiftCheck", "Is", "Events"],
  ["SurveyGiftCheck", "Deck.SurveyGift", 1],
  ["SurveyGiftCheck", "Deck.SuppliesScience", 1],
  ["SurveyGiftCheck", "Turn.Starts", 2]
]

首次抽取选择两个事件之一:矿物奖励 SurveyGift 或科研点奖励 SuppliesScience。每种各一张,概率相等,不会同时触发两个事件。

仅将 Deck.SurveyGift 从 1 改为 2。卡组有两张 SurveyGift、一张 SuppliesScience,首次矿物事件概率为三分之二。矿物奖励数量不变,它由 Event.json 的 Adds.Minerals.Scaled 决定,与卡数无关。

普通游戏中,不再使用第二回合检查,而将 SurveyGift 加入现有 RandomEvents。独立完整 Logic/RandomGift.json:

[
  ["RandomEvents", "Deck.SurveyGift", 1]
]

将 EventCheck.json 移出 Logic,重新读取模组并开新游戏。保留 Event.json、RandomGift.json。SurveyGift 与其他事件参与正常随机抽取,不保证第二回合出现。事件定义和奖励不变。

研究如何影响矿物奖励数量

起初玩家没有已完成科技。现在检查研究后的变化,奖励记录不变:

["SurveyGift", "Adds.Minerals.Scaled", 1]

休闲模式启用 Rule.ScaledByPlayer:规模 = 人口 ×(1 + 已完成科技数量 × Rule.ScaledByPlayer.TechMod)。人口 100、十种已完成科技、系数 0.04 时,规模为 140;Scaled 1 发放 140 矿物。经典和硬核模式启用 Rule.ScaledByTurn,事件奖励与难度取决于回合,而非经济。规模在事件出现时固定。回合公式与设置见下方 Rule 参考。

奖励系数由作者设置,规模来源由游戏模式选择。要保证检查结果,请用只有一张 SurveyGift 的组。Adds.Minerals.Count 固定奖励用于行动及回答选项的结果,独立 Event 上仅写一行不会创建发矿物的事件。完整选项示例见 EventChoice。

4.6. 开局设定

制作自己的 G 型恒星系变体,先选现有基础:

["SurveySystem", "Is", "ScenarioG"]

SurveySystem 取得 ScenarioG 参数。但定义卡片与创建恒星是不同任务。实际地图中心需要自己记录:

["SurveySystem", "Orbit.Center", "ClassG"]

它选择黄色 ClassG。仅改为 ClassK,中心就生成橙色 K 型恒星。从 ScenarioG 继承的参数不会自动成为 ScenarioK 参数。

添加熟悉的卡片名称和描述,Order 决定列表位置。完整 Logic/Scenario.json:

[
  ["SurveySystem", "Is", "ScenarioG"],
  ["SurveySystem", "Name", "SurveySystemName"],
  ["SurveySystem", "Description", "SurveySystemDesc"],
  ["SurveySystem", "Orbit.Center", "ClassG"],
  ["SurveySystem", "Order", 10]
]

SurveySystem 是新开局设定。它继承 ScenarioG,Name 和 Description 设置自己的卡片文字。将 SurveySystemName、SurveySystemDesc 加入 Text/zhCN.json。重新读取后,新游戏开局设定中找到“我的黄色恒星”。选中后中心应为 G 型恒星。

比较两种修改:把自身 Orbit.Center 的 ClassG 改为 ClassK,会改变实际生成恒星。删除整个自身 Orbit.Center 则不同:说明仍可能从父定义读到 ClassG,但本例不会创建 G 型恒星。可用新开局设定应保留明确中心记录。

修改初始资源时注意部分继承。本例资源来自父定义 Start,自己的 SurveySystem.Start 将整体替换它,必须列出全部需要的初始储备,不能只写变化项。详见 Is。

最初开局设定建议以随机系统为基础。“太阳系”包含作者编排地图和教学,不能视为只改恒星名称的空白模板。

4.7. 示例文本

新名称需要 Text/zhCN.json。下面是本节全部示例的完整词典,可仅保留所选示例的键。已有词典请在括号内用逗号添加键,不能在结束括号后再加第二个词典。

{
  "SurveyScienceName": "科学探索",
  "MyMinerName": "我的采掘者",
  "MyMinerDesc": "以采掘者为基础的公司。",
  "SurveyOutpostName": "科学前哨站",
  "SurveyOutpostDesc": "额外提供科研点收入的前哨站。",
  "SurveyGiftName": "额外矿物",
  "SurveyGiftDesc": "此事件增加您的矿物储备。",
  "SurveySystemName": "我的黄色恒星",
  "SurveySystemDesc": "以黄色恒星为基础的开局设定。"
}

左侧为 Name 和 Description 使用的键,右侧为可见文字。可以保留键并改文字。重命名键时,也必须替换规则中指向它的全部引用。

5. 文件与安装

打开开始游戏 → 模组 → 模组文件夹。同一个 Modding 文件夹中包含以下目录链接:Vanilla 指向原版游戏文件,Local 指向您的本地模组,Workshop-<itemId> 指向每个已下载的 Steam 模组。这些是实际目录的链接,不是文件副本。将自己的模组文件夹放入 Local。

Modding/
  Vanilla/
  Local/
    quick-survey/
      modinfo.json
      Logic/
        Explore.json
      Text/          (需要翻译时)
      Art/           (需要图像时)
      Sounds/        (需要声音时)
      preview.png    (创意工坊预览图)
  Workshop-<itemId>/

modinfo.json 保存模组信息,Logic 保存规则改动。需要自己的文本、图像和声音时再加 Text、Art、Sounds。Logic 的 JSON 名称由您决定,游戏根据记录内部名称找对象。例如 Explore 的价格可写在 Explore.json 或 Prices.json。

JSON 使用 UTF-8。不保留注释或末尾元素后的逗号。检查扩展名,Explore.json.txt 是普通文本,不会作为规则载入。

Logic 中全部 JSON,包括子文件夹,按相对路径读取。例如 10-base.json 先于 20-prices.json。比较区分大小写,采用精确比较,不按界面语言字母排序。若顺序重要,用小写拉丁字母和数字前缀。同一字段重复写入时,晚文件可能替换早文件的值。文件内部记录顺序保留。

要查看原版游戏数据,打开开始游戏 → 模组 → 模组文件夹 → Vanilla。Logic 是规则,Text 是文本,Art 是图像,Sounds 是音效和音乐。JSON 用普通文本编辑器打开,PNG 用图像查看器,OGG 用播放器。

Logic 按主题划分:Corporations.json 公司、Techs.json 科技、Builds.json 建筑、Events.json 事件、Scenarios.json 开局设定、Map.json 星球。可作参考。自己的改动保存在模组,以免游戏更新覆盖。

Vanilla 用于阅读,不要编辑已安装游戏文件。将需要的记录放进自己的模组。改 Vanilla/Logic/Simulation.json 的价格时,将新价格写入 Modding/Local/quick-survey/Logic/Explore.json,如第一个模组。修改后打开并关闭模组界面,再开新游戏。 已下载的订阅会显示为 Workshop-<itemId> 目录,其中 itemId 是 Steam 创意工坊物品编号。这些文件由 Steam 更新。要制作自己的版本,请将订阅模组的文件夹复制到 Local,在 modinfo.json 中设置自己的 id,并删除原发布内容的 workshop 部分。应发布自己的本地副本,而不是编辑订阅文件。

5.1. modinfo.json 清单

此文件描述模组列表和创意工坊中的模组。完整范例在“第一个模组”。新模组使用自己的 id、title、description,版本可从 1.0.0 开始。

  • id:唯一标识,例如 quick-survey。以小写拉丁字母开头,后续可有小写拉丁字母、数字及连字符。更新保持不变。
  • version:三段数字版本。从 1.0.0 开始,内容更新时增大版本号。
  • title 和 description:玩家看到的名称与简短说明。

workshop 字段由外壳发布时生成。不要手填他人的 itemId 或 SteamID。vanilla 标识保留给原版。

5.2. 文本

修改或添加文本时创建 Text/zhCN.json。词典左侧是唯一键,右侧是可见文字。

{
  "MyMinerName": "我的采掘者",
  "MyMinerDesc": "一家探索地下资源的公司。"
}

Name 指向名称键,Description 指向说明键。下面记录关联 MyMiner 与 MyMinerName。中文下显示“我的采掘者”。MyMiner 表示公司,MyMinerName 帮助查找词典名称,两者不同。

["MyMiner", "Name", "MyMinerName"]

Text/zhCN.json 只需包含需要的键。替换现有文本时,从原版词典取对应键。写普通文字,不要 HTML 或颜色标签。原文有 {0}、{1} 时保留,游戏会替换为数值或名称。

每种语言独立文件,准确使用下方名称。文件名无连字符,例如 zhCN.json 而非 zh-CN.json。不必一次添加所有语言。

  • ruRU.json - 俄语
  • enUS.json - 英语
  • ukUA.json - 乌克兰语
  • deDE.json - 德语
  • frFR.json - 法语
  • esES.json - 西班牙语
  • itIT.json - 意大利语
  • ptBR.json - 巴西葡萄牙语
  • plPL.json - 波兰语
  • csCZ.json - 捷克语
  • roRO.json - 罗马尼亚语
  • trTR.json - 土耳其语
  • jaJP.json - 日语
  • koKR.json - 韩语
  • zhCN.json - 简体中文
  • zhTW.json - 繁体中文
  • arSA.json - 阿拉伯语
  • hiIN.json - 印地语
  • idID.json - 印度尼西亚语
  • thTH.json - 泰语
  • viVN.json - 越南语

游戏合并所选语言的原版与启用模组文本。晚模组的同键文本替换早模组。未翻译现有键时,保留游戏或其他模组译文。所选语言完全没有键时,查英语 enUS,仍无则显示键本身。新字符串建议加 Text/enUS.json。缺少英语不会自动用俄语替代。

5.3. 图像

PNG 位于 Art。替换用原文件名,例如 Art/logo.png 替换徽标,其他图像不变。子文件夹便于整理,但查图标依据不含扩展名的名称。

新图标可建 Art/Icons/my_survey.png,再写 ["MyMiner", "Icon", "my_survey"]。用透明背景 PNG 和唯一名称。不同子文件夹的两个 my_survey.png 不是独立图标。引擎不限 PNG 尺寸,普通图标可从 256 × 256 像素正方形开始。Icon 不写 .png。

根目录 preview.png 单独用于模组列表和创意工坊,不替换游戏内图标。

5.4. 音效与音乐

先替换一个行动音效。把 OGG 保存为模组 Sounds/FX/my_scan.ogg。完整 Logic/ExploreSound.json:

[
  ["Explore", "Sound", "my_scan"]
]

探索改用 my_scan.ogg,Sound 中不写 .ogg。名称应唯一,不同子文件夹的两个 my_scan.ogg 不是独立音效。若用原版音效名,也会替换其他使用此名的地方。

单独设置背景音乐。加 Sounds/Music/my_theme.ogg。仅一首的完整 Logic/Music.json:

[
  ["Simulation", "Music", "my_theme"]
]

Simulation 的 Music 是本局播放列表,这里仅 my_theme.ogg。Explore 的 Sound 只针对探索,Music 针对全局背景。音效变体及其他设置见“Sound 与 Music”。

Music 可有多首。用以下 Logic/Music.json 将整个列表换为游戏现有两首,不需额外 OGG。

{
  "set": [
    ["Simulation", "Music", "interstellar_waltz"],
    ["Simulation", "Music", "molten_core"]
  ]
}

两行属于同一对 Simulation + Music。set 按顺序一次性用全部指定值替换旧列表。整个新列表写在一个文件,分到两个文件时晚文件会替换早文件的列表。自己的曲目请改名称并加对应 OGG 到 Sounds。

6. 使用多个模组

模组只改明确指定内容。上例改变探索价格,其他规则保留。不要为一个价格复制整个原版文件。

两个模组改同一价格时,最后载入的值生效。必要时在 modinfo.json 加 order,越大越晚载入。requires 依赖、conflicts 不兼容项列出其他模组 id。第一个模组无需这些字段。

本地和创意工坊有相同 id 时使用本地文件夹。关闭模组后新游戏恢复原规则。从模组删去一行不会删除原版记录。

7. 创意工坊与存档

本地模组无需 Steam,可用文件夹或 ZIP 传递。创意工坊订阅后等待下载,再返回模组界面。订阅不覆盖工作文件夹。

发布时登录 Steam,打开模组界面,选择本地原创包。检查名称、说明、预览、version,再点“发布”。启动不会自动发布。首次发布将创意工坊信息存入 modinfo.json,更新验证作者 SteamID。

发布改动内容前手动增加 version,不能低于已发布版本。若 Steam 要求接受创意工坊协议,打开游戏提供链接。更新错误时保留 itemId,它关联现有发布,随意换号码不能修复。

存档记录已加载模组的有序 id 列表、版本和内容指纹。载入时,id 及其顺序必须一致。仅版本或指纹变化不会阻止载入,因此可以更新模组的平衡、文本、图像和行为。版本与指纹保留所用内容的来源信息。模组包格式和保存的数据结构仍必须受支持,不会自动在不同数据结构之间迁移。

切换模组和编辑文件不改写已开始的游戏。“重新开始”使用当前会话固定内容。检查新版本需刷新模组界面,从更新菜单创建新游戏。

8. 模组无法正常工作时

  • 模组不在列表:检查 modinfo.json 直接位于模组文件夹,JSON 正确且 id 独立。检查扩展名未变成 .json.txt。重新打开模组界面,阅读错误消息。
  • 游戏看不到修改:确认启用模组,关闭界面并创建新游戏,不要用旧游戏或“重新开始”。若有其他模组,检查载入顺序,晚包可能改同一价格或属性。
  • JSON 错误:打开指定文件,定位消息所指位置,检查括号、字符串引号、元素间逗号。每条规则记录必须恰好三个元素。
  • 未知谓词:检查第二部分。大小写与点后的所有词必须匹配参考资料的支持形式。自定义科技名称可放左侧,不因您创造名称就变成新属性。
  • 加成不生效:科技需有 Is Tech 和 Player Has,并在新游戏研究。条件加成应检查读取条件的对象及条件是否满足。改变每回合收入不意味着一次性奖励。
  • 数量与示例不同:先明确是储备、单个工人产量还是回合收入,再检查折扣、附加费用、工人分配和条件。基础价降低不保证最终提示相同数值。
  • 更新模组后无法载入存档。请按游戏提示核对模组 id 及顺序,确认所需模组包已加载,且模组包格式和存档数据结构仍受支持。

数据检查 PARTIAL 只表示验证器已实现规则中无错误,不证明任意词语组合被支持并有预期效果。最终应通过新游戏执行修改行动来检查。

帮助他人复现错误时,请提供模组文件夹、种子、开局设定、模式和公司。说明行动、预期与实际结果。附完整错误消息,文件名和位置有助于定位。

9. 文件的进阶功能

模组依赖其他模组或要删除原定义部分时看本节。第一个模组只需“第一个模组”的普通事实数组。

modinfo.json 可选字段

  • enabled:true 或 false,首次发现是否启用,默认 true。玩家后续选择单独保存。
  • order:整数,默认 0,越大越晚。相同时按 id 排序。
  • requires:必须启用并先载入的模组 id 数组,例如 ["my-library"]。无版本范围。
  • conflicts:不兼容 id 数组。若同时启用,排除冲突包,在界面说明原因。关闭一个再关闭界面以重新读取剩余组合。
  • titleKey、descriptionKey:Text 中模组名和说明翻译键。先当前语言,再英语,最后普通 title、description。
  • tags:创意工坊标签数组,例如 ["Corporation"],不增加游戏属性。

workshop 的 itemId、account、author 由游戏发布时填,描述发布与作者。新模组不要复制他人值。

替换、添加与删除记录

先看价格。原版已有探索信息,Logic/Explore.json 仅改矿物基础价格:

[
  ["Explore", "Cost.Minerals", 1]
]

Explore 的 Cost.Minerals 变为 1,名称、音效等保留。一个价格无需复制整个定义。

从模组删掉此行后,新游戏价格恢复原版。删除自己的修改不移除原始价格。真正删除属性需要 remove,下面介绍。

有些记录列出组成。例如 Has 加科技到玩家集合。下例假定 SurveyScience 已按 3.4 定义:

[
  ["Player", "Has", "SurveyScience"]
]

SurveyScience 加入现有科技,OutpostConstruction 等保留。普通数组 Is 和 Blocks 同样追加,精确重复记录不增加相同元素。

再看精确操作。set 设置属性完整的新值集合。只保留两首音乐的完整 Logic/Music.json:

{
  "set": [
    ["Simulation", "Music", "interstellar_waltz"],
    ["Simulation", "Music", "molten_core"]
  ]
}

set 后 Music 仅按顺序含这两首,未列出的旧曲目不在新列表。set 替换整个列表,不是追加行。

add 追加。保留 Music.json,新建稍后载入的 Logic/zz-more-music.json:

{
  "add": [
    ["Simulation", "Music", "interstellar_drift_1"]
  ]
}

现在三首为 interstellar_waltz、molten_core、interstellar_drift_1,前两首仍在。都是游戏现有音乐,无需额外 OGG。

下一个实验将 zz-more-music.json 移出 Logic,新建 Logic/zz-remove-music.json,仅删除 Music.json 的 molten_core:

{
  "remove": [
    ["Simulation", "Music", "molten_core"]
  ]
}

三元素 remove 删除精确记录,留下 interstellar_waltz。清空整个 Music 则只用两个元素:

{
  "remove": [
    ["Simulation", "Music"]
  ]
}

第二种结果为空列表。不要同时应用,两者是同一检查文件的不同内容。

delete 删除整个定义而非属性。若已按“公司”创建 MyMiner,要删除它,完整 Logic/zz-delete-corporation.json:

{
  "delete": ["MyMiner"]
}

新游戏没有 MyMiner 卡,其他公司保留。MyMiner 的各子部分也删除。zz 前缀让删除发生在声明 MyMiner 的文件之后。

了解单项操作后可组合。以下完整 Logic/Music.json 先清空再加一首:

{
  "remove": [
    ["Simulation", "Music"]
  ],
  "add": [
    ["Simulation", "Music", "interstellar_waltz"]
  ]
}

最终仅剩 interstellar_waltz。同一操作文件顺序始终 delete → remove → set → add,键在文本的位置不影响顺序。只应用列出的操作,其余可省略。

false 设置假值,不删除记录。删除用 remove,不用 false 或 null,三元组不允许 null。

实验依次进行,同时保留多个检查文件会共同修改音乐列表。改文件组合后,模组界面重新读取,再开新游戏。普通价格用最初数组更方便,需追加、精确删除或完整列表替换时再用操作对象。

10. 谓词参考

参考资料按关联、条件、效果、经济、事件、星球和呈现分组。页首有字母索引。每个条目说明支持形式和结果,代码旁注明完整文件或定义片段。本局状态字段单独标注,不需写入模组。

Is - 类别与继承

Is 描述对象是什么,先看新科技:

["SurveyScience", "Is", "Tech"]

SurveyScience 自定义,Tech 是现有科技类别,赋予科技行为。加入玩家树另见“角色、资源与效果”。

右侧也可指定现有具体定义,新对象取得其属性。完整 Logic/MyMiner.json 创建采掘者变体:

[
  ["MyMiner", "Is", "CorpMiner"],
  ["MyMiner", "Name", "MyMinerName"]
]

MyMiner 继承 CorpMiner 的公司角色、能力和图像,自身 Name 仅替换名称。词典 MyMinerName 用于可见名,完整词典见“公司”。改 CorpMiner 为 CorpColonist 就以拓殖者为基础,继承能力会变。

定义部分另有继承规则。3.3 介绍了 CorpMagnate.Interest 利息。创建带自己 Interest 的大亨变体,完整 Logic/MyMagnate.json:

[
  ["MyMagnate", "Is", "CorpMagnate"],
  ["MyMagnate", "Name", "MyMagnateName"],
  ["MyMagnate.Interest", "Adds.Income.Credits", 1]
]

在 Text/zhCN.json 加 MyMagnateName。新词典完整内容如下:

{
  "MyMagnateName": "我的大亨"
}

自己的 Interest 整体替换父部分,因此 Per Credits 不保留,新部分每回合固定收入 1 信用点。若想在利息外另加能力,用 ExtraIncome 等不同名称,父 Interest 就保留。开局设定 Start 同样适用。

Is 可使用的类别与定义

从对应组选择 Is 右侧名称。类别指定对象种类,具体定义提供现成属性基础。下列是 《前曲速时代》 主要选项。准确内容可阅读对应 Vanilla/Logic 文件,修改写入自己模组。

  • 自定义能力公司:Corporation。现有 CorpMiner 采掘者、CorpColonist 拓殖者、CorpMagnate 大亨、CorpTechnocrat 技术官僚,见 Corporations.json。
  • 可研究科技:Tech。继承现成加成可用 DeepExtraction、ResearchAutomation 等。全部见 Techs.json,完整名称在下方。
  • 建筑:Building,地表 SurfaceBuilding、轨道 Orbital。Builds.json 现成基础:SpaceStation、HQ、Metropolis、Outpost、Colony、City、DomeMegacity、GasExtractor、SkyExtractor、StellarFarm、DysonRing、WarpDrivePrototype。
  • 开局设定:Scenario。Scenarios.json:ScenarioK、ScenarioG、ScenarioF、ScenarioM、ScenarioA、ScenarioBrownDwarf。ScenarioSol 是教学太阳系,有自己的地图与教学。
  • 游戏模式:Rule。Modes.json 中现成模式:ModeMeditation - 休闲、ModeClassic - 经典、ModeHardcore - 硬核。内部标识 ModeMeditation 保持不变。
  • 资源:Resource。Simulation.json:Workers、Water、Minerals、Science、Energy、Credits、Approval。附加角色 Workforce 工人、Currency 货币、Stat 可显示指标。用途及组合见资源条目。
  • 星球:World,特征 Rocky 岩质、Icy 冰质类别(界面标签“寒冷”)、Earthlike 类地。现成岩质和冰质星球见下,定义在 Map.json。
  • 恒星:Star。Map.json:ClassK、ClassG、ClassF、ClassM、ClassA、Substellar、BrownDwarf。Sun 是 Solar.json 作者设置的太阳。
  • 巨行星:Giant。模型 HotJupiter、GasGiantSmall、IceGiantSmall、GasGiantMedium、IceGiantMedium、GasGiantLarge。小行星 Asteroid,模型 RockyAsteroid、IceAsteroid,见 Map.json。
  • 事件 Event、回答选项 EventChoice、条件能力 Trait、行动 Action。事件与选项示例在 Events.json,具体行动在 Simulation.json。单有角色不替代必要时间表、组成或行动结果。

Techs.json 的现有科技定义,可放 Is 右侧,也可放 Requires 中作研究条件:

  • OutpostConstruction, DeepExtraction, NuclearDrives, ResearchAutomation, AdvancedThermalInsulation, RegolithShielding, FrostTapping, FusionDrives, BlockchainGovernance, FusionWeapons.
  • CryoInsulation, RefractoryCeramics, ClosedBiosystems, CloudMining, StellarEnergy, MantleDrilling, QuantumComputing, QuantumInsulation, UltraCarbides, PlanetaryUrbanization.
  • DenseConstruction, SkyMining, CryoRefining, AntimatterDrives, AIManagement, AGI, SyntheticMaterials, Megaengineering, CoreExtraction, AdvancedGeoSurvey.
  • MindDigitization, ASI, WarpDrives, PostTechnologies, SpaceStations, AdvancedSpaceStations, ComplexSpaceStations.

Map.json 的现有星球模型。继承具体星球而非一般 World 类别时使用:

  • 微型:TinyRock、TinySulfuric、TinyIce、TinyCryogenic。
  • 小型:SmallLava、SmallRock、SmallIce、SmallCryogenic。
  • 标准:StandardLava、StandardChthonian、StandardHothouse、StandardOcean、StandardEarthlike、StandardAmmonia、StandardIce、StandardCryogenic。
  • 大型:LargeLava、LargeChthonian、LargeHothouse、LargeOcean、LargeAmmonia、LargeIce。

Is TinyRock 取得现成微型岩质星球,Is World 仅取一般星球基础。太阳系作者设置的行星卫星见 Solar.json。大小写敏感,TinyRock 和 tinyrock 是不同字符串。

Has - 组成与数量归属

Has 表示“拥有”,列出组成。例如玩家有科技集合,事件有回答选项。左侧是组成的拥有者,右侧是新增定义名。新 Has 追加,不用重新列全部科技。

["Player", "Has", "SurveyScience"]

此行把 SurveyScience 加进科技树,科技本身须已如教学例子定义。研究后获得加成。事件 Has 回答选项则加选择按钮。同一组成关系用于不同对象,不表示立即执行新增元素。

条件中检查资源储备是另一任务,Requires 会逐步说明。这里 Has 用于将科技加入玩家集合。

Adds - 数值增量

先增加科研点收入。以下补充 3.4 的 SurveyScience:

["SurveyScience", "Adds.Income.Science", 1]

研究后每回合科研点收入 +1。原来 2 时,无其他变化就成 3。未研究不生效。Adds 是增加,Income 是每回合收入,Science 是科研点。

要减少收入 1,只改同一记录数值:

["SurveyScience", "Adds.Income.Science", -1]

原收入 2 变 1。负增量减少同一量,仍是每回合收入变化,不是一次性科研点损失。

另一个任务是在玩家选择结果中一次性发矿物。EventChoice 完整例子“回收样本”通向 OGSamplesRecycled。可用片段修改奖励:

["OGSamplesRecycled", "Adds.Minerals.Count", 20]

选择“回收样本”增加 20 矿物储备,下一回合不因同次选择再发 20。Count 是储备量,Income.Science 是回合收入。结果连选项、选项连消息的写法见 EventChoice。单条奖励不创建消息按钮。

第三个任务是增加每工人采掘。现有科技 DeepExtraction 片段:

["DeepExtraction", "Adds.Production.Minerals", 0.2]

研究后每工人矿物采掘率 +0.2。其他修正前,1 变 1.2,三名分配工人产出 3.6 而非 3。无人分配时,此加成本身不产矿物。

同属性的多个增量在各自条件满足时相加。Target 限定接受者,Per 按另一数量每单位计算,示例见对应条目。

三种修改分别为一次性储备、回合收入、每工人采掘率。多个增量和乘数的组合见“效果求和、基础值与一次性发放”。新模组用明确 Adds.属性,不以旧数值 Target 或裸 Adds 作为范例。

条件与数值效果

先看三项独立任务:要求先研究另一科技,给已研究科技收入,再用乘数增加收入。下列条目逐一说明。

要求:ResearchAutomation、OutpostConstruction 为原版科技。完整 Logic/Requirement.json 把前哨站建造设为前置:

[
  ["ResearchAutomation", "Requires", "OutpostConstruction"]
]

Requires 意为需要。玩家先研究 OutpostConstruction,ResearchAutomation 才可研究。此行不奖励,也不自动完成研究。

增量:独立完整 Logic/Bonus.json 设 ResearchAutomation 加成:

[
  ["ResearchAutomation", "Adds.Income.Science", 2]
]

Adds 增加指定数,Income.Science 为每回合科研点收入。研究后 +2,之前无加成。此行替换现有科技的加成值,不是在旧值上再加一份。

乘数:CloudMining 是已有科技。完整 Logic/Multiplier.json 改其加成:

[
  ["CloudMining", "Multiplies.Income.Energy", 1.1]
]

Multiplies 表示相乘,研究后正能源收入乘 1.1,10 变 11,独立能源开支不增加。本例不需前两文件,三项分别检查。

以上为完整 Logic 文件。后面的短块可能只展示某个现有定义的变更行,前文会注明。如何向已有文件添加记录,见“主体、谓词和值”完整一行及两行例子。

Requires 与 Or - 要求

先设科技要求。完整 Logic/ResearchRequirement.json 修改已有 ResearchAutomation:

[
  ["ResearchAutomation", "Requires", "OutpostConstruction"]
]

左侧是想研究的科技,右侧是前置。须完成 OutpostConstruction 才能研究 ResearchAutomation,仅鼠标选择前置不够。

再独立设建造地点。下例仅为新 SurveyStation 的要求,不是完整建筑。两个 Is 指建筑和轨道结构,新增 Requires World:

["SurveyStation", "Is", "Building"],
["SurveyStation", "Is", "Orbital"],
["SurveyStation", "Requires", "World"]

World 为星球类别,地点须星球,不属于 World 的巨行星不符合。此处查建造地点,首例查知识,区别由右侧引用是地点类别还是科技决定。

允许另一地点巨行星,在三行后加:

["SurveyStation", "Requires.Or", "Giant"]

Or 是或,现在星球或巨行星皆可。不带 Or 的 Requires Giant 会要求同时 World 和 Giant,是另一条件。

最后组合:地点星球或巨行星,玩家需前哨站建造。全部要求如下,完整建筑还需名称图标价格,见 Building。

["SurveyStation", "Is", "Building"],
["SurveyStation", "Is", "Orbital"],
["SurveyStation", "Requires", "OutpostConstruction"],
["SurveyStation", "Requires", "World"],
["SurveyStation", "Requires.Or", "Giant"]

必须研究 OutpostConstruction,地点 World 或 Giant。Requires.Or 为同种要求添加替代,科技仍需完成。无 Or 两类地点都必需。Requires.Corporation 与其 Or 同样列允许公司。

按引用理解:科技查该玩家研究,星球类别查地点,升级上的建筑引用查玩家拥有的直接基地,特质查潜在接受者。Requires Homeworld 要求母星。仅在别处提名称不够。

两个普通地点要求可求类别交集,以下必须冰质星球:

["SurveyStation", "Requires", "World"],
["SurveyStation", "Requires", "Icy"]

两者都要,Requires.Or Icy 则任意 World 或 Icy。检查此版本请整体替换旧地点列表,不留 Requires.Or Giant。不要让同一定义同时是科技、升级基地、地点类别,造成引用歧义。

数值条件查具体值。给事件示例 SurveyGift 加以下,让奖励仅对至少有 10 矿物玩家可用:

["SurveyGift", "Requires.Has.Minerals.Min", 10]

Has.Minerals 读事件接受者储备,Min 10 为至少 10。9 假、10 和 11 真。奖励前检查,不支付或发矿物。

只允许 10 到 20(含边界),用两界:

["SurveyGift", "Requires.Has.Minerals.Min", 10],
["SurveyGift", "Requires.Has.Minerals.Max", 20]

10、20 满足,9、21 不满足。地点 Or 不取消独立数值边界。下面 F 为字段、V 为值、N 为阈值。

  • Requires.F = V 或 Requires.F.Equal = V:F 等于 V,多值只需包含 V。字段缺失不等于 false 或数字零。
  • Requires.F.More = N 严格大于,Less 严格小于,AtLeast 或 Min 至少,Max 至多。不带 Or 的范围两界都必需。
  • Requires.F.Any = V 匹配该字段的候选之一,Not 排除指定候选。简单概念替代优先用 Or。
  • Requires.Not = Category:对象不属于该类,且无该有效特质。Requires.Trait = TraitName 查有效特质。
  • Requires.Has.R.Min = N 查对象资源 R 储备,Requires.Owner.Has.R.Min 查所有者。星球采掘率用 Production.R,例如 Requires.Production.Minerals.More = 0 查正矿物生产,非玩家库存。
  • 有些比较可用另一数字路径作阈值。例如 Requires.Size.Less = Owner.Size 比自身尺寸与所有者尺寸,须真实 Owner 和其 Size。

后代自身地点要求替换继承地点要求及 Or,科技要求独立。同一列表不能表达两组独立“A 或 B”和“C 或 D”,或“科技 A 在星球、B 在小行星”,应拆建筑变体。行序和部分名不创建条件括号。

事件可在出现时一次计算阈值。HeadquartersQuest.Done 的四方案使用 Goal 完整任务框架。这里只把 Goal.Has HQ 替换为目标星球尺寸要求,不改变尺寸。假设发任务时尺寸 12.5、玩家经济规模 20,各方案互相替换。先要求增长 1.4 倍:

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Mult", 1.4]

Target.Size 读所选星球,Mult 用完整初值:12.5 × 1.4 = 17.5,下限向上取整为 18。17 不满足、18 满足,后续尺寸不改阈值。

另一方案给初值整数部分加数:

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Add", 3]

Add 用 12.5 整数部分 12 加 3,阈值 15 非 15.5。14 不满足、15 满足。Track 同样可要求发任务后再完成三次。

下一方案忽略初始尺寸,用经济规模:

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Scaled", 0.5]

规模 20 × 0.5 得阈值 10。初始 12.5 已超过,立即符合。Scaled 不表示增加一半尺寸。

再组合增量与规模:

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Add.Scaled", 0.5]

Add.Scaled 为初始整数 12 加 20 × 0.5 = 10,保存阈值 22。21 假、22 真。四方案设具体任务阈值,非不断重算价格。测试时仅用一行替换 Goal.Has HQ,保留其余框架。

阈值不随被查值增长。通常资源增长任务用 Goal.R。后缀仅在事件保存初始阈值的机制中有效,随意加条件不会创建机制。

Target - 接受者、地点与目标过滤

先选科技加成接受者。原版 RegolithShielding 增工作岗位,Target 限定星球。

先修改已经加入玩家科技树的现有科技 RegolithShielding。以下片段使研究完成后,自有岩质星球增加四个工作岗位。这是加成的加法部分:定义的其他效果仍然保留,最终容量还会考虑它们的乘数。World.Rocky 表示同时属于 World 和 Rocky 类别。

["RegolithShielding", "Target", "World.Rocky"],
["RegolithShielding", "Adds.Workplaces", 4]

研究前不变,之后作用适合自有星球,包括未来获得的。Target 不创建星球或替代研究。

再选事件地点。已有送水 SuppliesWater,先限制 World:

["SuppliesWater", "Target", "World"]

游戏找到适合星球并关联消息。World 尚非具体行星,存档已发生事件可能已引用选定天体。

再要求已探索:

["SuppliesWater", "Target.Explored", true]

检查该玩家知识,未探索不合格,World 限制仍在,两者都要。

另排除家园:

["SuppliesWater", "Target.Not", "Homeworld"]

Not 是排除,母星即使已探索也不合格。其他已探索星球仍可。合并三行:

已有 SuppliesWater 已有奖励、图像和 Supplies 归属,现改地点为家园外已探索星球,不立即触发。

["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Explored", true],
["SuppliesWater", "Target.Not", "Homeworld"]

事件另加岩质组成,用独立 Target.Is:

["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Is", "Rocky"]

选择岩质星球。不要照搬科技 World.Rocky 缩写,数值加成解释成两类别,事件则找完整该名类别。无 World.Rocky 定义就无地点。Event、Mission 同此选址规则。

独立过滤建造可用性,只留当前可建 HQ 的位置:

["SuppliesWater", "Target.Build", "HQ"]

不建造或奖励总部,只使用建筑当前要求。仅当全部条件都需满足时与前过滤组合。

Target.Has 查真实存在的指定关联物。不同字段条件同时生效。同字段 Or 提供替代,例如 Target.Has、Target.Has.Or。

数值能力 Target PlacedAt 反向选 PlacedAt 指向能力持有者的对象。Target Target.PlacedAt 选放在其目标上的对象,不是从建筑走向脚下星球。

事件结果 Parent 是调用消息,Parent.Target 是其天体。关联须存在,缺引用不随机补目标。过滤直接跟 Target,没有通用 Target.If。

偏好可先查岩石,再无则冰质。A、B 为自定义部分名,一般要求仍在。按 Order、同值按名称,选首个找到适合天体的部分:

["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Explored", true],
["SuppliesWater.A", "Order", 1],
["SuppliesWater.A", "Target.Is", "Rocky"],
["SuppliesWater.B", "Order", 2],
["SuppliesWater.B", "Target.Is", "Icy"]

积累任务可按探索缺口选天体。此 SuppliesWater 方案保留普通 Target 限制,先指定读何价格:

["SuppliesWater", "Target.Cost.Minerals.Count", "Explore"]

比较每候选当前 Explore 矿物价与玩家储备。价 50、库存 10、经济规模 20,则缺 40,折为 40 / 20 = 2 规模单位,不是下回合收入预测。

先设缺口下限:

["SuppliesWater", "Requires.Scaled.Min", 1.5]

2 合格,1 不合格,1.5 恰合格。再设上限排除太贵目标:

["SuppliesWater", "Requires.Scaled.Max", 2.5]

两界保留 1.5 至 2.5(含界),本体 2 保留、3 排除。一份定义仅允许一个这类来源,不自动相加不同资源价格。

Per - 每单位数量

Per 表示每单位。每储备信用点收入 0.03,储备 100 则每回合 3。Adds 指单位收入,Per 选择单位数,不是重复执行一百次而是算一个总收入。

大亨 CorpMagnate 已有利息,Interest 是定义部分,只看此能力。

Adds.Income.Credits 设每单位 0.03,Per Credits 指玩家储备信用点。依赖库存,非按钮次数:

["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

100 得 3、200 得 6。读取选择大亨玩家的储备,不消费它。

每尺寸单位乘数相似,已有 SizeScale 星球能力的独立片段:

["SizeScale", "Per", "Size"],
["SizeScale.Places", "Multiplies.Workplaces", 0.2]

Per Size 读星球尺寸,4 时乘数 0.8、5 时为 1,是 0.2 乘尺寸非幂。缺 Size 不贡献,已有 Size 零则乘数零,缺失与零不同。

资源读数可选精度。Per Credits 取储备整数部分,计小数只改为:

["CorpMagnate.Interest", "Per", "Credits.Count"]

100.5 参与而非 100,取整前收入 3.015。WorkersFree 则读空闲工人。Per 仅读取数量。

关联对象也可供量。建筑效果部分 Per PlacedAt.Size 读支撑星球尺寸,需真实 PlacedAt。Owner.Size 同样读所有者 Size。

公共 Per 适用于定义部分。SizeScale.Places 从父获得 Per Size,自身 Per 则替换父设置。不改 Requires 检查谁,Per 只选择计算数量。

Multiplies - 字段或能力强度乘数

Multiplies 相乘。收入 10 乘 1.1 得 11,即增加百分之十,非十单位。乘数在科技、公司或特质有效期间生效。

先仅改现有 CloudMining,不需再加入玩家科技树:

Income.Energy 表示每回合正能源流入。1.1 为乘数,研究后才启动。

["CloudMining", "Multiplies.Income.Energy", 1.1]

流入 10 变 11、20 变 22。建筑维护等独立支出不变。乘 1 不改,字段允许零时乘 0 归零。

独立公司例子,修改现有拓殖者 CorpColonist:

["CorpColonist", "Multiplies.Workplaces", 1.4]

拓殖者游戏中适合自有对象工作岗位乘 1.4,其他取整修正前 10 变 14。选择公司启用,非研究 CloudMining。

同字段乘数相乘,1.1 与 1.2 得 1.32。仅数值,不改 Name、Icon、true/false。Target 可限制接受者。

让收入乘数随人口变化,给 DeepExtraction 添加自定义 PopulationIncome 部分:

["DeepExtraction.PopulationIncome", "Per", "Workers"],
["DeepExtraction.PopulationIncome", "Adds.Multiplies.Income.Science", 0.1]

研究后 Per Workers 读玩家人口,Adds.Multiplies.Income.Science 从 1 加每工人 0.1。人口 4 得 1.4,科研点收入 2 变 2.8,人口 6 则 3.2(无其他流)。普通 Multiplies.Income.Science 0.1 配此 Per,四工人得 0.4。Adds 改变公式。

已有 NuclearDrives 将 RemotenessTrait 远距附加弱化至 80%。真实距离不改,原版已将家族关联 Distance:

["NuclearDrives", "Multiplies.RemotenessTrait", 0.8]

乘的是特质强度,非距离或单字段。增量 10 变 8。特质乘数 2 只弱化超出 1 的部分:1 + (2 - 1) × 0.8 = 1.8,不是 2 × 0.8。

同形式可改 Is 关联特质家族。家族名不要与被改数值字段同名,避免双义。重复科技每次完成再应用,增量相加、乘数相乘,详见 Tech。

效果求和、基础值与一次性发放

独立模组以采掘者测试收入,不派矿物工人,避免生产混入。先建完整 Logic/MineralIncome.json:

[
  ["Minerals", "Income", 10]
]

Minerals 自身每回合收入 10,是初始计算基础。无其他来源开支时每回合得 10,不是将库存替换为 10。

加入科技加成,整体替换文件:

[
  ["Minerals", "Income", 10],
  ["DeepExtraction", "Adds.Income.Minerals", 2]
]

研究 DeepExtraction 后基础 10 加 2 得 12,之前仅 10。模组替换其此加成旧值,不再累加旧值。它的每工人采掘加成保留,所以测试不派矿工。

引入另一科技乘数,再整体替换:

[
  ["Minerals", "Income", 10],
  ["DeepExtraction", "Adds.Income.Minerals", 2],
  ["CloudMining", "Multiplies.Income.Minerals", 1.5]
]

两科技完成后先相加再乘,(10 + 2) × 1.5 = 18。乘整个正和,不只 +2,JSON 行序不改变。仅 CloudMining 完成则 15。

独立增量先与基础相加,乘数彼此相乘。再有有效 1.2,则 18 变 21.6。库存可保存小数,指标取整见 Min、Max、Round。

此处基础是 Minerals 的 Income 10。某些属性另有 Base,其意义见各条目,不是每效果必填。计算后遵守数量边界及取整。

区分一次性奖励。事件配方 SurveyGift 中仅把 Logic/Event.json 奖励系数 1 改 2,保留其他行:

["SurveyGift", "Adds.Minerals.Scaled", 2]

经济规模 10 时一次发 20,库存 7 成 27,不改回合收入。用配方 EventCheck.json 的 SurveyGiftCheck 在第二回合触发。开提示或载入已存结果不再发 20。

科技 Adds.Income.Minerals 2 是研究后后续每回合 +2,SurveyGift Adds.Minerals.Scaled 2 是一次奖励、随规模变化。EventChoice 另讲固定 Adds.Minerals.Count。只看 Minerals 不知何时发,需整句和上下文。

“临时效果与 Blocks”讲事件限时收入,“Corporation、Rule、Scenario”讲一次初始资源,同用数值操作但时机不同。

建筑可供收入,SurveyOutpost Income.Science 1 是建成建筑自身收入,建成后有效。科技研究后、建筑出现后分别启用。地表工位数和空间站独立派工见 Workplaces、Production。

Has 特质可改自身或自有对象。Trait、Grants 解释为何建筑 Has 不等于全玩家星球加成。限时增量用事件期限,不手动恢复初值。

Per 选数量,Target 选接受者。改 Target 不自动让 Per 读新目标,Per Size 读能力持有者,读放置星球用支持的 PlacedAt.Size。

Adds、Multiplies 用于游戏支持的数值属性,不改名称、图标、引用、Is、Has、布尔。新名称配数字不自动声明数值属性。新材料先 Is Resource,见对应条目。

Change.R、WorkersFree、Build.Cost、Explore.Cost、Researching.Steps、Track 计数只读,Completed 由游戏写。可在支持条件中读,不用 Adds 重写。

折扣用 Cost、持续维护 Upkeep、交易价格数量 Price、Trade。Mission 参数经选项改,Progress 有自身操作。通用增量不替代各自规则。

Trait 与 Grants - 条件特质

特质把加成描述一次,可用于不同对象。先声明 ExtraCapacity 加两个工作岗位,Trait 已有、名称自定义。

此片段只描述不赋予:

["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Adds.Workplaces", 2]

Is 声明、Adds 设效果,只有定义不改星球。永久关联 TinyRock 还需:

["TinyRock", "Has", "ExtraCapacity"]

新游戏每个 TinyRock 加两个工作岗位,不创建工人。移除特质仅撤增量,不减原工位数。

改条件发放前删除 TinyRock Has,否则永久关联会无视新条件保留。保留特质定义。

家族先 Is Trait,变体 Is 指家族。有 Requires 的变体自动发给满足对象,失败移除。家族自身或无条件变体不自动发。永久用 Has,事件发放用 Marks。

["SmallWorldTrait", "Is", "Trait"],
["CompactWorld", "Is", "SmallWorldTrait"],
["CompactWorld", "Requires", "World"],
["CompactWorld", "Requires.Size.Max", 4],
["CompactWorld", "Multiplies.Cost.Build", 0.9]

CompactWorld 自动给尺寸至多四的星球 10% 建造折扣。SmallWorldTrait 家族、CompactWorld 变体,不同家族独立选择。

家族可关联已有属性,在属性标签提示显示变体。原版 ["Distance", "Has", "RemotenessTrait"] 将远距属性与特质家族描述关联,不是给每星球全体变体。条件仍决定选择。

独立 Grants 是另一办法。BigWorld 规则只给尺寸至少 10 星球 ExtraCapacity,替代永久 Has。想缩小时撤加成,不要并存。

["BigWorld", "Grants", "Size"],
["BigWorld", "Requires", "World"],
["BigWorld", "Requires.Size.Min", 10],
["BigWorld", "Has", "ExtraCapacity"],
["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Adds.Workplaces", 2]

Grants Size 关联已有尺寸,Requires World 限类别、Min 设阈值。规则 Has 列所发特质,别再给星球 Has。小于 10 撤加成,复查不重复增加,满足时一直 +2。

Grants 属性或家族属于独立发放规则,本身不是 Trait 家族变体。变体可有自身属性及 Has 额外特质。Adds、Multiplies 改数,Grants 只选有效能力。字符串 Adds 不声明分类。根 Requires 查接受者,独立数值部分的 Target、Requires 可再限。

改为随机,仅保留以上 BigWorld 再加权重 30,实验不要有其他随机 Grants Size:

["BigWorld", "Chance", 30]

适合尺寸 10 星球有 30% 获 ExtraCapacity,70% 无随机特质。结果保存,再开提示不重抽。

加同属性另一规则 BothWorlds,结果加一个工作岗位而非两个工作岗位:

["ExtraPlace", "Is", "Trait"],
["ExtraPlace", "Adds.Workplaces", 1],
["BothWorlds", "Grants", "Size"],
["BothWorlds", "Requires", "World"],
["BothWorlds", "Requires.Size.Min", 10],
["BothWorlds", "Has", "ExtraPlace"],
["BothWorlds", "Chance", 20]

适合权重总 50,30% ExtraCapacity、20% ExtraPlace、50% 无随机特质,不同时发两随机选择。

仅把第二权重 20 改 90:

["BothWorlds", "Chance", 90]

总和 120 超过 100,概率 30/120 = 25%、90/120 = 75%,无空结果。分母 max(100, 适合权重和)。Chance 非负,条件子部分可细化。不用 Adds.Weight、Adds.Chance。

确定发放与随机独立。下一比较从 BothWorlds 删 Chance,不是设零:

["BothWorlds", "Grants", "Size"],
["BothWorlds", "Requires", "World"],
["BothWorlds", "Requires.Size.Min", 10],
["BothWorlds", "Has", "ExtraPlace"]

所有适合星球保证 ExtraPlace,与 BigWorld 随机独立,保证一个工作岗位加 30% 再两个工作岗位。无 Chance 不同于 Chance 0。

Has 特质改谁?字段在持有者类别或 Is 祖先声明,就改自身。星球已有 Workplaces,因此其特质改自己工作岗位。

字段不在持有者类而属于其他类,数值能力可能沿 Owner 改自有对象。建筑 Has 不自动等于全玩家星球或脚下星球加成。局部特质可在建筑类声明 Workplaces 0,明确建筑自身接受。

Production.R 零也是已声明局部采掘率,可被加为正,不同于缺失。Target PlacedAt 反选放在持有者上的对象,不是从建筑向下走。详见 Target。

一个加成两种替代条件。以下整体替换旧 ExtraCapacity 效果,不保留早先随机 Grants 或永久 Has:

["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Requires", "World"],
["ExtraCapacity", "Adds.Workplaces", 2],
["ExtraCapacity.Small", "Requires.Size.Max", 4],
["ExtraCapacity.Big", "Requires.Size.Min", 10]

Small、Big 只有条件,作为公共 +2 替代:尺寸 3 经 Small +2,12 经 Big +2,6 无。根 World 始终必需,一部分多个条件须同时满足。

再给 Small 自己操作,这是不同加成模型,重新理解:

["ExtraCapacity.Small", "Adds.Workplaces", 1]

Small 成独立能力,尺寸 3 给自身 +1。Big 仍是公共 +2 的纯条件替代,尺寸 12 +2、6 无。一能力条件不关闭邻居。想保留原公共替代就不加独立操作。

条件来源与参数调整

星球得加成,条件可来自所有者,例如玩家至少 100 科研点时工位数 +2。Requires.Owner.Has.Science.Min 明确查所有者库存,接受者仍星球,其他工位数乘数正常应用。

给已有 World 关联自定义 WellFundedWorld,Owner 引玩家,在 Logic 数组加:

["World", "Has", "WellFundedWorld"],
["WellFundedWorld", "Is", "Trait"],
["WellFundedWorld", "Requires.Owner.Has.Science.Min", 100],
["WellFundedWorld", "Adds.Workplaces", 2]

99 科研点无加成,100 有,花至低于 100 又撤。删 Owner 则查星球自身科研点。特质跟当前库存,不是一次满足永久。保存初始事件阈值的 Requires、Goal 是另机制。

已有定义可能用 Adds.Source 指公共条件对象:直接 Owner、Parent、Target、PlacedAt 或已有对象名。不支持任意 Owner.Size 路径。引用无法解析仍查原对象,拼错不意味着始终假。

部分自身 Adds.Source 替换父设置,无独立 Source 谓词。当前限制:经 Adds.Source 的关联库存变化可能不更新现有加成,所有者条件请用直接 Requires.Owner.Has.Science.Min。

区分条件对象、Per 计算数量、Target 接受者。

RobotUprising 有 Progress,Cap 减目标星球建筑的工作岗位贡献。Target.PlacedAt 选放在事件目标上的建筑,不减星球基础。这里改能力系数,不创建事件时间表。

先指定已有 Cap 减谁:

["RobotUprising.Cap", "Target", "Target.PlacedAt"],
["RobotUprising.Cap", "Multiplies.Workplaces", 1]

Target.PlacedAt 找到起义目标星球上的建筑,乘 1 暂不变,贡献 8 仍 8,星球基础不参与。

按 Progress 调系数,此处 Target 特定指 Cap 本身,非星球建筑:

["RobotUprising.Cap.Adjustment", "Target", "RobotUprising.Cap"],
["RobotUprising.Cap.Adjustment", "Per", "Progress"],
["RobotUprising.Cap.Adjustment", "Adds.Multiplies.Workplaces", -0.2]

Progress 1 系数 0.8,贡献 8 变 6.4(取整前)。Progress 2 系数 0.6,贡献 4.8,星球基础保留。这是熟悉的乘数增量,接受者为已有持续数值能力参数,不允许任意字符串地址改字段。合并:

["RobotUprising.Cap", "Target", "Target.PlacedAt"],
["RobotUprising.Cap", "Multiplies.Workplaces", 1],
["RobotUprising.Cap.Adjustment", "Target", "RobotUprising.Cap"],
["RobotUprising.Cap.Adjustment", "Per", "Progress"],
["RobotUprising.Cap.Adjustment", "Adds.Multiplies.Workplaces", -0.2]

参数必须已存在持续数值操作,不用于一次奖励或随机参数。不要创建互调无限循环,也不让接受者类别和能力参数同名。普通加成只需直接 Adds.F、Multiplies.F、Per。

Min、Max 与 Round - 边界与取整

先设库存下限,允许现有 Minerals 最多一千债务:

["Minerals", "Count.Min", -1000]

可为 -200、-1000,不可更低。Count.Min 0 防负。这是数量边界,非条件检查或资源发放,自愿购买仍需支付能力。

独立设工人上限取整。Ceil 向上、Floor 向下,计算上限 3.2 分别得 4、3。向上:

["Workers", "Count.Max.Round", "Ceil"]

只影响计算的 Count.Max,不把所有工人数取整。明确规则替代继承,向下则同一行换 Floor。

两独立设置合并:

["Minerals", "Count.Min", -1000],
["Workers", "Count.Max.Round", "Ceil"]

Min、Max 依构造:Count.Min 限库存、Requires.F.Min 查至少、Random.Min 范围边、Goal.R.Min 任务最小增长。不是所有数值都支持任意限界,Weight.Max 不限质量,Icon 加 .Max 不变数值。

Adds.Round、Multiplies.Round 对一次变化量取整,非系数或剩余库存。Multiplies.Workers.Count 0.9 使 11 减 1.1,配 Floor 将 -1.1 向下到 -2,剩 9。无 Round 不强制最低扣减。Trade.Max 自带向上规则,不需 Trade.Max.Round。

经济、工人与资源

Resource、Stat 与 Currency - 资源角色

创建 Alloy 资源,先仅声明资源:

["Alloy", "Is", "Resource"]

Resource 赋数量规则,目前只描述,不发放或创建矿床。再关联玩家储备:

["Player", "Has", "Alloy"]

新游戏玩家获独立 Alloy 库存,无 Count 从零开始。设初值:

["Alloy", "Count", 10]

库存初值 10,非每回合产 10。另一个 Has Alloy 对象有独立储备。

另加 Stat 在指标面板显示:

["Alloy", "Is", "Stat"]

Stat 显示数值,不创建生产或把 Alloy 变货币。原版 Credits 另有 Currency:

["Credits", "Is", "Currency"]

只是原版示意,不添加第二货币。一套数据仅一个 Currency,Alloy 保持普通资源。

Resource 不一定 Stat,反之也如此。一局仅一个 Currency。Is Predicate 允许资源名作独立谓词,无它也可在 Cost、Production 后或作 Has 值,但不可单独占三元组中间。

A 方案玩家 10 合金,无生产矿床。Alloy 自定义,ore_iron 是已有图标:

["Alloy", "Is", "Resource"],
["Alloy", "Is", "Stat"],
["Alloy", "Is", "Predicate"],
["Alloy", "Icon", "ore_iron"],
["Alloy", "Count", 10],
["Player", "Has", "Alloy"]

Count 设初始库存,无则零。其他持有者 Has 创建独立库存。Is Resource 不自动启动生产、矿床、贸易。资源名无点,别把内置词再声明为自己谓词,只有支持构造中可作参数。

B 方案单独加入母星工人生产,先看新公司 Factory 部分的率:

["NewAlloyCorp.Factory", "Production.Alloy", 0.5]

每分配工人每回合半合金,二人 1、四人 2,无派工零。原料消耗按同一工人:

["NewAlloyCorp.Factory", "Cost.Minerals", 1]

每工人需 1 矿物,两人产 1 合金、耗 2 矿物。是每回合生产费用,非雇佣价。再指定位置并组合 B,代替 A,初始 Count 为 0 非 10。

NewAlloyCorp 继承采掘者。新游戏选择它,选家园并分二工。Factory 是公司部分,Target World.Homeworld 选自有母星。输入足够,每派工额外产 0.5 合金、耗 1 矿物。

两人额外产 1、耗 2,独立于星球普通流。原料不足只执行完整可支付单位。Price 允许以现有货币交易,天然矿床探索见资源生成。

完整数组存 Logic/Alloy.json。模组名称和 modinfo.json 按首例,资源公司词典加 Text/zhCN.json。

[
  ["Alloy", "Is", "Resource"],
  ["Alloy", "Is", "Stat"],
  ["Alloy", "Is", "Predicate"],
  ["Alloy", "Name", "AlloyName"],
  ["Alloy", "Icon", "ore_iron"],
  ["Alloy", "Count", 0],
  ["Alloy", "Price", 4],
  ["Player", "Has", "Alloy"],
  ["NewAlloyCorp", "Is", "CorpMiner"],
  ["NewAlloyCorp", "Name", "NewAlloyCorpName"],
  ["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
  ["NewAlloyCorp.Factory", "Production.Alloy", 0.5],
  ["NewAlloyCorp.Factory", "Cost.Minerals", 1]
]

B 方案 Text/zhCN.json:

{
  "AlloyName": "合金",
  "NewAlloyCorpName": "合金生产者"
}

选合金生产者,资源面板出现合金。未派工产零,母星派二人,检查收入与矿物支出,再结束回合。率 0.5 改 1,两人产 2 合金仍耗 2 矿物。

Is Resource 允许 Income.Alloy、Production.Alloy、Upkeep.Alloy、Cost.Alloy、Growth.Alloy、Alloy.Count,不需 Is Predicate。仅 Alloy 独占中间位置才需此声明。

Count - 数量与边界

Count 设储备量。前例 Alloy 初始 10 改 12:

["Alloy", "Count", 12]

新游戏玩家 Alloy 从 12 开始。定义存初值,各持有者独立可变库存,互不影响。开局设定 Start 奖励另加,例如 Water;本例开局设定不奖励 Alloy。

资源定义 Count 可小数,Count.Min/Max 限界,Resource 默认下限零。Requires.Has.Minerals.Min 查独立库存,Adds.Minerals.Count 一次改库存,不设星球产率。

["Water", "Count", 12],
["Minerals", "Count.Min", -1000],
["Credits", "Count.Max", 100000],
["Player", "Has", "Water"]

负下限允许被迫债务,不许没钱自愿购买。损失奖励遵守限界,消息显示实际变化。Count.Max 限量本身,持有者 R.Max 限资源容量,玩家 Workers.Max 限总人口,星球 Workplaces 限当地分配。

Count 也可描述独立非资源数量,含 Count 定义放 Has 以创建自有数量实例,不成为商品生产货币。别同时加入同一继承数量的两个无关定义造成歧义。

星球 Production.Minerals 是每工人每回合产出,玩家 Minerals.Count 是累积库存。改 Count 不创建生产派工。

旧简例可能用裸 Adds.Minerals,现有资源仍支持,但 Count 更明确。行动、开局设定初始或回答结果一次发放,持续科技单行不自动补库存。独立事件规模奖励见 Event、Events。

Workforce 与 FreeWorkers - 工人与分配

工人属于玩家共享池。10 人、星球分 3,剩闲 7,再分一剩 6。滑块仅改变现有人口就业。

Is Workforce 属唯一工人资源,共享数量属玩家。星球建筑任务分配占整数工人,不创第二人口。总库存小数保留但暂不能派。人口损失释放超额分配。

Workers 为现有人口,WorkersFree 为推导空闲数。原版结构如下,无需第二 Resource/Count:

["Workers", "Is", "Resource"],
["Workers", "Is", "Predicate"],
["Workers", "Is", "Workforce"],
["WorkersFree", "Is", "FreeWorkers"],
["WorkersFree", "Is", "Predicate"],
["WorkersFree", "Is", "Stat"]

WorkersFree 为人口整数部分减就业。普通贸易不占工人,Rule.TradeWorker 可改。此值只读,不需 Has、Resource、Count。给 DeepExtraction 加研究后空闲科研点收入:

["DeepExtraction.FreeScience", "Per", "WorkersFree"],
["DeepExtraction.FreeScience", "Adds.Income.Science", 1]

10 人分 3,增加每回合 7 科研点,基础 2 共 9。再派一人增量 6、共 8。已派工人生产独立计算。

Workplaces - 工作岗位

工作岗位限分配不生人口。星球基础 3 加前哨站 8,其他限制前为 11。

先设星球自身基础:

["World", "Workplaces", 3]

其他规则前为三个工作岗位,再加已完成前哨站:

["Outpost", "Adds.Workplaces", 8]

建成给星球加 8,共 11,不增人口。另加拓殖者乘数:

["CorpColonist", "Multiplies.Workplaces", 1.4]

只有选拓殖者时总和乘 1.4,11 × 1.4 = 15.4(取整前)。Control 等限制还可能降低可分配量,提示滑块同限。

World、Outpost、CorpColonist 均已有。Outpost 是 Building/SurfaceBuilding,必须实际建造且选对公司。

["World", "Workplaces", 3],
["Outpost", "Adds.Workplaces", 8],
["CorpColonist", "Multiplies.Workplaces", 1.4]

前哨站给星球加工作岗位不造人,地表建筑不各有滑块。无基础的乘数不产工作岗位。封锁控制工人最大量可进一步限制,多限取小。

建筑无自身 Workers 时工作岗位加星球,由星球派工。有自身 Workers 则独立分配,不再重复加星球。地表前哨站与独立空间站不能重复算同份贡献。

Production - 劳动产出

Production 是已派工产出,0.5 为每人每回合半产品。能力 Cost 是每就业工人输入,非工厂购买价。

看 Resource 的 B 方案母星合金,先只读完整定义中的率:

["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
["NewAlloyCorp.Factory", "Production.Alloy", 0.5]

作用自有母星,每工人额外 0.5,二人 1、四人 2,无派工零。Production 已计人,不再 Per Workers 重算。

再要求原料:

["NewAlloyCorp.Factory", "Cost.Minerals", 1]

每工人每回合成本,两人耗 2 矿物产 1 合金。产率改 1 则产 2 仍耗 2,成本按工人非合金。完整 B 如下,若 Resource 已添加勿重复:

[
  ["Alloy", "Is", "Resource"],
  ["Alloy", "Is", "Stat"],
  ["Alloy", "Is", "Predicate"],
  ["Alloy", "Name", "AlloyName"],
  ["Alloy", "Icon", "ore_iron"],
  ["Alloy", "Count", 0],
  ["Alloy", "Price", 4],
  ["Player", "Has", "Alloy"],
  ["NewAlloyCorp", "Is", "CorpMiner"],
  ["NewAlloyCorp", "Name", "NewAlloyCorpName"],
  ["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
  ["NewAlloyCorp.Factory", "Production.Alloy", 0.5],
  ["NewAlloyCorp.Factory", "Cost.Minerals", 1]
]

存 Logic/Alloy.json,词典见 Resource。选新公司、母星滑块派两工。原料够则额外产 1 合金耗 2 矿物,查提示及回合后库存。

Production.R = K 是声明资源每派工每回合产 K。星球上为采掘,工厂能力为额外生产。无工人零。Income 不需派工,Adds.R.Count 一次改库存。

能力 Cost 按工人非产品,加倍产率不加矿物费。星球 Production.R 指率,Production.R.Base 加基础贡献。

自有工人的建筑不同。MyLab 已按 Building 定义建成。两实验都设星球矿物率 2、建筑两工、无其他加成:

["MyLab", "Has", "Workers"],
["MyLab", "Workplaces", 2]

无自身 Production.Minerals,MyLab 用星球率 2,两工产 4。这是建筑工人,不重算星球人。星球明确基础会进入继承率。

给建筑自身率:

["MyLab", "Production.Minerals", 0.5]

自身 0.5 替换星球 2,两工产 1 非 5。零也是明确自身率,缺失与零不同。Adds.Production.R 和 Multiplies.Production.R 改率不派工,Production.R.Name、Production.R.Description、Production.R.Hide 控说明显示。

另一实验无建筑工人,删 MyLab Has Workers,星球保留两工:

["MyLab", "Is", "SurfaceBuilding"],
["MyLab", "Production.Minerals", 0.5]

现在不独立生产,0.5 加星球率 2,两星球工产 5 非 4。重新拥有 Workers 则分开,不同时保留加率和独立计算。不额外 Per 同一批人。

上述是来源有效时持续加成。另机制一次改现有率。已有 SuppliesMinerals 用明确目标变化替换一次矿物奖励,勿同时保留两效果:

["SuppliesMinerals", "Target.Adds.Production.Minerals", 1]

目标矿物率 2 一次变 3,改天体属性非临时玩家收入。事件仍需有效触发选址。

开局设定创建时可遍历现有资源。MyScenario 按开局设定条目继承 ScenarioG,初始调整仅降低严格大于 1 的率:

["MyScenario.Poor", "Target.Adds.Production.Resource", -1],
["MyScenario.Poor", "Requires.Production.Resource.More", 1]

原天体矿物 3、水 1、无科研点,改后矿物 2、水仍 1、无新科研点。Resource 遍历已有率,Requires 分别检查。短 Target.Adds.Resource 也遍历已有采掘但无此检查。持续 Adds.Production.Resource 不支持,需具体资源。

Production.R 来源的提示显示产出速率及适用加成。资源库存、每回合总流入与支出、上下限和预测,显示在资源库存自身的提示中。单个 Production.R 事实不会为来源创建相应库存。若产出速率受到修饰,提示会显示其基础值、实际生效的变化和最终值。

Income - 独立回合收入

Income 不需派工。已有 Science 的独立收入:

["Science", "Income", 2]

各 Science 持有者每回合得 2,无其他流,10 一回合 12,再一回合 14,无需派工。

Income.R 是对象自身每回合变化,可正负。资源定义用裸 Income,例如 Science 的 Income 2。任意对象裸 Income 不替代 Income.R。

Science 已属于玩家。首行独立收入,后两行改大亨利息,Interest 为部分,Per Credits 读该玩家钱,不需行星属性。

["Science", "Income", 2],
["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

Per Credits 用储备整数,收入乘数乘正流入。负自身 Income 不同于独立 Upkeep。假设库存 100、利息 0.03、乘数 1.1、无其他流:

  • A:玩家 Income.Credits -2,与利息 3 合为自身 +1,正结果乘 1.1,得每回合 +1.1。
  • B:没有负 Income,而玩家 Upkeep.Credits 2。收入 3 先乘 1.1 再减维护 2,得 +1.3。收入乘数不增加维护本身。

负 Income 属自身流的一项,Upkeep 是独立维护。按规则含义选择,非只看符号。各能力保留条件,移除一来源不移其他收入。

Upkeep - 回合维护

Upkeep 是持续维护,先看建成前哨站:

["Outpost", "Upkeep.Energy", 2]

每运行前哨站每回合要 2 能源。费用写正,Upkeep 已表示支出。一次建造价用 Cost,能源不足关闭前哨站。

Upkeep.R = N 要每回合 N 资源,非负无需负号。建筑功能依此费用,玩家为强制维护。Per Workers、Adds.Upkeep.Water 表每人费用。

人口耗水独立,已有 Player.WaterUpkeep 的 Per 读人口,Adds 设人均率。10 人 × 0.4 要 4 水(其他规则前),与固定建筑费比较:

["Outpost", "Upkeep.Energy", 2],
["Player.WaterUpkeep", "Per", "Workers"],
["Player.WaterUpkeep", "Adds.Upkeep.Water", 0.4]

已有 Starvation 响应缺水并定工人损失。Blocks Upkeep.Water 移除耗水本身,Blocks Starvation 只防“饥荒”损失。Hide 隐藏行仍保留费用后果。

Growth、Change 与 Threshold - 增长和积累

先看人口增长,已有 ModeHardcore 的 Natural 部分,Per 读取精确工人数量:

["ModeHardcore.Natural", "Per", "Workers.Count"],
["ModeHardcore.Natural", "Adds.Growth.Workers", 0.01]

选此模式,人口 100 每回合长 1(限界前),50 长半人并存共享库存。Growth 描述增长,非当前分配。

另一形式由一资源流增长另一资源。玩家科研点增长关联其自身矿物流:

["Player", "Growth.Science.Source", "Minerals"],
["Player", "Growth.Science.PerUnit", 0.1]

Source 指资源、PerUnit 系数。自身矿物流 10 得科研点增长 1(其他规则前)。二资源须归该玩家。不自动含来源交易,读自身流非完整回合结果。

ModeHardcore 已有可选,Natural 是增长部分。Per Workers.Count 读精确人口,100 × 0.01 得 1(限界前)。Source、PerUnit 属两个资源的持有者。

["ModeHardcore.Natural", "Per", "Workers.Count"],
["ModeHardcore.Natural", "Adds.Growth.Workers", 0.01]

Change.R 显示含贸易任务的净回合变化,只在条件或教学读,不写或 Adds 改。预测示完整需求,实际仅执行可支付工作,短缺时可不同。

积累 Nutrients 并兑换新工人,先声明资源、库存与流入:

["Nutrients", "Is", "Resource"],
["Nutrients", "Is", "Stat"],
["Nutrients", "Count", 0],
["Player", "Has", "Nutrients"],
["Player", "Income.Nutrients", 1]

新资源从零每回合增 1,两回合为 2,尚不生人。兑换需另两行:

["Player", "Threshold.Nutrients", 3],
["Player", "Threshold.Nutrients.Grows", "Workers"]

Threshold 为 3,Grows 指工人,达到 3 就花掉并加一人。余量保留,足够则重复,不超 Workers 上限。

每次跨越后阈值变 max(旧 + 1, floor(旧 × Increasing))。Increasing 默认 1,仍逐步 3、4、5。非价格或 Goal,需已声明 Resource、玩家库存及流。不用负积累余额新造惩罚,生命维持由 Shortage 管。

["Nutrients", "Is", "Resource"],
["Nutrients", "Is", "Stat"],
["Nutrients", "Count", 0],
["Player", "Has", "Nutrients"],
["Player", "Income.Nutrients", 1],
["Player", "Threshold.Nutrients", 3],
["Player", "Threshold.Nutrients.Grows", "Workers"],
["Player", "Threshold.Nutrients.Increasing", 1]

普通工人游戏无其他流或增长限制时,第三个此类回合加一人、清空 Nutrients,下一人要四。Name、Icon 照常设,翻译不改机制。

Price 与 Trade - 汇率与贸易

先设矿物基础价,Credits 为原版货币:

["Minerals", "Price", 1]

一矿物基价一信用点,不自行购买。购买另有公共系数:

["Trade", "Price.Buy", 1.2]

无个人折扣,一矿物价 1.2。卖出另系数:

["Trade", "Price.Sell", 0.8]

卖一矿物得 0.8。买卖差防止即时买回获利。另一资源 Price 设其基价。

实际贸易需界面订单。买二矿物每回合重复,价 1.2 需 2.4 信用点。数量与价独立,钱货不足仅执行可支付部分。

无 Price 不可交易,Price 0 仍可。Trade.Price.Sell/Buy 公共系数,玩家 Price.R、Price.R.Sell/Buy 细化特定商品。名 Buy、Sell 的资源在参数位仍是资源名。

限制单商品行数量,下计算假设钱货足够,库存限制稍后:

["Trade", "Count.Max", 4]

上限 4 不能每回合买 6,订单截为 4,价 1.2 共 4.8。改数量不改单价。

一个实际建成自有前哨站增加上限:

["Outpost", "Adds.Trade.Max", 3]

一站使 4 + 3 = 7,再设订单 6 可买 6 花 7.2。未建菜单项无加成,上限提高不必自动恢复曾截订单。

独立改大亨买率,不改量:

["CorpMagnate", "Adds.Trade.Price.Buy", -0.24]

买系数 1.2 变 0.96,矿物基价 1、无其他调整,六个花 5.76 非 7.2。这是汇率折扣,不是加三贸易容量。合并:

["Minerals", "Price", 1],
["Trade", "Price.Sell", 0.8],
["Trade", "Price.Buy", 1.2],
["Trade", "Count.Max", 4],
["Outpost", "Adds.Trade.Max", 3],
["CorpMagnate", "Adds.Trade.Price.Buy", -0.24]

实际价是基价 × 公共买卖系数 × 个人商品系数。玩家 Trade.Count.R 为回合订单,正买负卖零停。只改价不交易,界面设订单。

Trade Count.Max 限单行,Trade.Max 读它及个人贡献向上取整。无边界则不限制。订单为整数并截限,失去母星本身不禁交易。旧 Trade.R、Trade.Sell/Buy.Mult 不用。

最后看跨行支付。独立实验假设两商品基价 1,卖三买另一二,不是修改全游戏商品:

["Trade", "Price.Sell", 0.8],
["Trade", "Price.Buy", 1.2]

无个人调整,卖三得 2.4,先卖后买,即初始零也够买二。只够卖二则得 1.6,只买一完整单位,不是二,执行可支付部分。

Control - 可用工作岗位比例

Control.Here 限可用工作岗位比例,设 OccupiedSector:

["OccupiedSector", "Is", "Trait"],
["OccupiedSector", "Control.Here", 0.5]

获得特质只可用一半工作岗位,11 向下为 5。人不消失,仅缩派工。移除恢复,下面关联 TinyRock。

比例 0 到 1,多限制取最小并向下取整。零不能工作,1 全保留。特质上限制其持有者。

OccupiedSector 自定义,TinyRock 现有。Has 关联新天体,仅 Is Trait 不改变,需 Has 或事件 Marks。

["OccupiedSector", "Is", "Trait"],
["OccupiedSector", "Control.Here", 0.5],
["TinyRock", "Has", "OccupiedSector"]

Control.Rating 是独立 0 至 6 评分,非工作岗位比例,裸 Control 都不设。最后限制移除自动恢复工位数。

Approval 与 Expectations - 认可度与期望

先看董事会认可度,Approval 是现有资源,Count 设初始认可度:

["Approval", "Count", 3]

初始 3,到下限触发失败。是任务结果改变的库存,非完成任务次数。另设董事会期望:

["Approval", "Expectations", 1]

期望属于 Approval 数量,初始 1,决定下次评判严格程度。现有成功结果可提高:

["BoardPleased", "Approval.Judgment", 0.5]

期望 1 成功后 1.5,认可度奖励另算。失败:

["BoardDispleased", "Approval.Judgment", -1]

失败先按当前期望扣认可度,再期望减 1,最低 1。期望 2 则扣 2 认可度、期望成 1。四设置合并如下。

Approval 类似其他数量有初始和边界,玩家达到下限调用 Has 的 Defeat。Expectations 属 Approval,有限且至少 1,默认下限 1。

BoardPleased、BoardDispleased 是已有董事会结果。成功 Judgment 0.5 升期望,失败 -1 先按期望扣再降,成功支持奖励与 Judgment 独立。

["Approval", "Count", 3],
["Approval", "Expectations", 1],
["BoardPleased", "Approval.Judgment", 0.5],
["BoardDispleased", "Approval.Judgment", -1]

正 Judgment 提未来期望,负则先扣认可度再降期望,最低一。不同于 Adds.Approval.Count 直接改库存,Judgment 描述评判。持有者期望独立,Player 随意 Expectations 不替代资源数量属性。

TechLevel - 地点科技水平

先给“太阳系”作者地球数字水平:

["Earth", "TechLevel", 8]

描述水平 8,不研究玩家科技。Tier 是树位置,Level 是重复研究次数。再加可翻译标签。

TechLevel = N 为聚落或适合对象数字水平,单改不研究科技或自动解锁建筑集合。

Earth 只在太阳系,不在随机图创建。MyDigitalAge 自定义标签规则,至少 8。Text/zhCN.json 加 MyDigitalAgeName 为“数字时代”,只描述不奖励科技。

["Earth", "TechLevel", 8],
["MyDigitalAge", "Grants", "TechLevel"],
["MyDigitalAge", "Requires.TechLevel.Min", 8],
["MyDigitalAge", "TechLevel.Text", "MyDigitalAgeName"]

条件变体添加翻译标签,无标签显示数字,多有效标签列出。数字与描述后果分开。研究价用 Cost.Research,重复用 Repeatable、Level,非 TechLevel。

回合计算顺序与短缺

回合先产 4 矿物,再卖 2 得钱,贸易后付维护和任务分期。任一付款资源不足任务等待。可支付操作指真实资源足够的工作贸易部分。

公共顺序为全部资源流入、贸易、维护、过程、生命维持。卖出可用本回合生产,维护可用贸易。强制玩家费用先于可关闭消费者预留。一支付资源不足可阻整个任务步,不部分扣其他。劳动和贸易执行有资源支持的单位。

预测含全部计划流入减费用,即使暂时无法支付。负数警告短缺,不保证负库存,禁止债务不会发生。历史消息反映实际变化,不需重复收入费用层去补偿差异。

行动、建造与研究

Cost - 价格与规模

先看一行动的一资源价格。完整 Logic/ExplorePrice.json:

[
  ["Explore", "Cost.Minerals", 5]
]

矿物基础价 5,受本地折扣附加影响。是行动支付,非贸易 Price 或回合 Upkeep。价格不可负。

数据行动可同时要求两资源。Action 已创建的 ExchangeWater 先只设水:

["ExchangeWater", "Cost.Water", 20]

需 20 水,再加能源:

["ExchangeWater", "Cost.Energy", 5]

同时需 20 水和 5 能源,不是替代。数据行动和事件选项支持。现有 Build、Research、Explore、Colonize、GeoSurvey、Probe 只读一个直接付款资源,不能照搬。

重复价格可增长,仍属此行动:

["ExchangeWater", "Cost.Multiplies", 1.5]

首次需 20 水、5 能源,尝试后下一次 30、7.5(取整前),后续每次乘 1.5。不增加矿物奖励。游戏保存使用史,新事件卡从原价开始。Invest 百分比独立如下。

Invest 是现有实验投资选项,仅看矿物费,信用费保留。首实验只留 10% 矿物,删除先前编辑的固定或规模矿物项。

["Invest", "Cost.Minerals.Percent", 10]

提案发出时库存 100 则百分项 10,20 则 2,数值保存在提案,后来流入不自动加。正百分比计算不足一也至少一。信用点另付。

明确设最低三矿物:

["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]

初始 20 本为 2,下限提至 3。100 为 10 不变。下限不是额外支付,信用价保留。

再加固定五矿物:

["Invest", "Cost.Minerals", 5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]

库存 20 先 5 + 2 = 7,下限 3 不变。限制总和非各分项,信用仍另付。

替代方案用经济规模替换固定 5,保留百分比与下限:

["Invest", "Cost.Minerals.Scaled", 0.5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]

规模 20、库存 20,规模项 10、百分项 2,总 12。若还留固定 5 则 17,信用费保留。下方只组合交换与原百分 Invest,不需把全部实验并存。

Explore 存 Cost.Minerals。ExchangeWater 先用下条完整定义,Invest 已有。单独 Cost 不创建按钮。

Cost.R = N 要求声明资源,N 非负。显式零免费,缺失不总零,有些行动因此不可用。数据行动选项可多资源,现有六类行动仅一个直接费用资源。

组合交换同时水 20、能源 5,每次 1.5 倍,Invest 矿物百分比最低 3,作用已定义操作:

["ExchangeWater", "Cost.Water", 20],
["ExchangeWater", "Cost.Energy", 5],
["ExchangeWater", "Cost.Multiplies", 1.5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]
  • Cost.R.Scaled K:K × 事件经济规模。Percent N:发出时库存 N%,正百分比最低一。Min 限同资源固定、百分、规模项总和。
  • Cost.Target Parent:选项支付来源事件卡声明费用,须真实有价,不按选项名猜测。
  • Cost.R.PerTurn N:支持上下文的持续费。建筑持久维护用 Upkeep,Production 的 Cost 为每工人原料,非购买价。
  • Cost.R.PerValue K:含 Contains.Target 和声明增量的选项,每新增货物单位价格。无增量无效。
  • Cost.Multiplies K:下次行动或选项使用系数,实际持有者保留历史,新卡原价,不是一次收入乘数。

折扣通过乘数设置:Multiplies.Cost.Build 改变建造费用,Multiplies.Cost.Research 改变研究费用,Multiplies.Cost.Building 改变建筑费用,Multiplies.Cost.Outpost 改变前哨站费用,各自覆盖不同的购买集合。Cost.Build.Hot 和 Cost.Build.Distance 是分别表示高温与距离的费用轴。直接使用 Multiplies.Cost.Build.Distance 会乘以该轴的完整系数:系数 1.6 乘以 0.7 后变为 1.12。这不同于用 Multiplies.RemotenessTrait 减弱特质;相应公式和示例见 Multiplies 条目。价格乘数不会缩短持续时间。如果资源与行动同名,应根据记录描述的是用该资源支付的购买费用,还是该行动的费用加成来判断含义。

请在行动提示中核对修改后的费用,其中显示基础费用、实际生效的修饰,以及舍入和边界处理后的总费用。进行中的过程显示尚未支付的剩余费用,而非重新购买的完整价格。没有修饰时,不会重复显示相同的基础值和总值。最终费用已经包含显示的折扣,不要再次扣除。

Action - 数据定义的行动

创建水交换,先声明:

["ExchangeWater", "Is", "Action"]

名称新、Action 已有,目前不说明提供地点或结果。星球提供:

["World", "Able", "ExchangeWater"]

Able 允许选星球时提供按钮,再设费用与一次奖励:

["ExchangeWater", "Cost.Water", 5],
["ExchangeWater", "Adds.Minerals.Count", 3]

执行付 5 水、一次得 3 矿物,不改回合收入。定时模式任务完成后奖励,Processing.Duration 另设基时。再合名称图标。

片段加 Logic,Text/zhCN.json 加 ExchangeWaterName 为“交换水”。ore_iron 已有。若已有 Cost 例子,选择一种价格,别两文件意外并存。

新行动至少费用或非零一次奖励,单 Is Action 不明结果。Able 指哪里,Requires 指何时可点。公司限制用 Requires.Corporation,不用公司 Has 行动,地点提供、公司为条件。

["World", "Able", "ExchangeWater"],
["ExchangeWater", "Is", "Action"],
["ExchangeWater", "Name", "ExchangeWaterName"],
["ExchangeWater", "Icon", "ore_iron"],
["ExchangeWater", "Cost.Water", 5],
["ExchangeWater", "Adds.Minerals.Count", 3],
["ExchangeWater", "Processing.Duration", 1]

新游戏选星球找交换,执行后库存按边界减 5 水、加 3 矿物。Processing.Duration 为基础时间,模式可瞬时。不选星球也提供可改为 Player 提供。

Requires.Corporation CorpRobots 限机器人,Chance 可设失败风险默认零。Has 接失败结果并 Is Failure,失败也可能涨下价。

只让矿物奖励每尝试增长。先固定 5 水、奖 3,无其他重复系数,再加:

["ExchangeWater", "Adds.Minerals.Count.Multiplies", 2]

成功依次奖 3、6、12(边界前),仍各付 5 水。奖励增长不涨价,尝试后才推进,首次不先翻倍。

加第二资源区分单项与公共增长:

["ExchangeWater", "Adds.Energy.Count", 1]

矿物乘数下首次 3 矿物 1 能源,第二 6 矿物仍 1 能源,只点名矿物。

删单矿物乘数,换公共:

["ExchangeWater", "Adds.Multiplies", 2]

首次仍 3、1,第二 6、2,公共系数增长两者。只接受数,不支持此处 Random 范围。

区分尝试和成功。独立失败测试加失败结果及 100% 风险,只是教学:

["ExchangeWater", "Chance", 100],
["ExchangeWater", "Has", "ExchangeFailed"],
["ExchangeFailed", "Is", "Event"],
["ExchangeFailed", "Is", "Failure"],
["ExchangeWater", "Cost.Multiplies", 2]

首次付 5 失败无奖,第二仍需 10,潜在奖已 6、2,同风险又失败。如果使下一尝试成功则给该数量。价格奖励史都按尝试推进,不依成功。恢复固定交换应删所有实验行,别累积进配方。

Building、Project、Upgrade - 建造对象

先声明 MyLab 为建筑:

["MyLab", "Is", "Building"]

获得通用建造规则,未设地点费用结果。再指定地表实验室:

["MyLab", "Is", "SurfaceBuilding"]

SurfaceBuilding 地表,轨道则替换 Orbital。再加 Requires、Cost 的位置科技价格,建成收入维护,完整如下。

MyLab 新地表实验室,World 为星球,OutpostConstruction 前置。研究后用矿物建造,供科研点耗能源,不生工人。MyLabName 译“实验室”。

Requires 设置科技、地点类别、Upgrade 直接基地。玩家供科技检查,选天体供地点。World、Giant、Asteroid、Earthlike 等已声明类可作地点。

["MyLab", "Is", "Building"],
["MyLab", "Is", "SurfaceBuilding"],
["MyLab", "Name", "MyLabName"],
["MyLab", "Icon", "outpost"],
["MyLab", "Requires", "World"],
["MyLab", "Requires", "OutpostConstruction"],
["MyLab", "Cost.Minerals", 15],
["MyLab", "Duration", 2],
["MyLab", "Income.Science", 1],
["MyLab", "Upkeep.Energy", 1]

新游戏先研究再选星球建,价 15,建成每回合科研点 1、能源费 1。Duration 2 是基础建时,不是建筑寿命。模式影响时间,普通行动 Processing.Duration 不替代此 Duration。研究前可见但不可用,免费应明确零价。

Project 是另一建造项目结果,起点:

["MyProject", "Is", "Project"]

只是分类非完整项目,使用建造价格过程但不是 Building,建筑专属折扣未必影响。实验室仍 Building。

Unique 限同时建筑实例。SpaceStation 家族变体可分别提供。建造选项无需 Player Has MyLab,地点 Blocks 名或类别可即使 Or 通过仍禁建。

条件可读本地可用 Build、最低单资源价 Build.Cost,Explore.Cost 当前探索价,都是推导非价格设置。Target.Build HQ 查真能建处,别复制所有总部条件。

现有 HQ 总部、Metropolis 升级已带角色科技价格效果。下列只展示基地要求:

["Metropolis", "Is", "Upgrade"],
["Metropolis", "Requires", "HQ"]

需同地点玩家自己的已建 HQ,替换一个基地,非他人 HQ 或任意旧对象。普通 MyLab 无 Upgrade 不替换。

Tech、Researching 与 Repeatable - 研究

声明 MyStudy 科技,再加入玩家树,分别两行:

["MyStudy", "Is", "Tech"],
["Player", "Has", "MyStudy"]

Is 设角色,Has 给每玩家独立树,一人可研究另一未研究。加完成后才生效的奖励:

["MyStudy", "Adds.Income.Science", 1]

首次完成加每回合 1 科研点,重复需另设:

["MyStudy", "Repeatable", true]

第二级再加 1 共 2,研究第二级时第一级保留。下面合名称、图标、前置并保留重复。

MyStudy“实地研究”先需 OutpostConstruction,每级加 1。片段加 Logic,Text/zhCN.json 加 MyStudyName。

Is Tech、Player Has 创建每玩家独立实例。Requires 前置、Or 替代。Tier、Order 排版。持久 Adds、Multiplies 研究后含未来适合领地,不发一次奖。

["MyStudy", "Is", "Tech"],
["MyStudy", "Name", "MyStudyName"],
["MyStudy", "Icon", "flask"],
["MyStudy", "Tier", 2],
["MyStudy", "Requires", "OutpostConstruction"],
["MyStudy", "Adds.Income.Science", 1],
["MyStudy", "Repeatable", true],
["Player", "Has", "MyStudy"]

Researching 是实例 InProgress、Done 状态,无值表示首次未开始。别在定义 Done 模拟初始科技。Repeatable 布尔,自身 false 覆盖 true。Level 保存完成次数,重复中旧级保留,取消首次移状态、取消重复保旧级。

科技可无数值加成,具角色、Has、名称图标位置价格即可。唯一结果可解锁事件任务:被解锁卡 Requires.Researched 指科技。卡有 Name 则科技说明自动显示解锁事件及名称,无名嵌套卡组不独立列。无需假加成或复制解锁清单。

默认价来自 Research Cost.R,增长来自 Cost.Multiplies。每完成研究含重复,系数大于 1 则乘已取整基础。10、1.23 得 10、13、16、20,个人折扣后应用,不减下次基础。科技自身价和增长覆盖 Research。无增长或至多 1 不变,Tier 无关。

Rule.AccumulatedResearch true 等有效科研点全价后一次扣,取消保库存;普通 Research 立即付完。Researching.Steps 推导含自身与共享前置的最少研究数,勿手设。Then 关联研究后事件,非 Tech 一次奖励。

科技自身的 Description 在提示中解释这项科技。研究完成后显示的消息应放在通过 Has 关联的独立响应上。为现有 MyStudy 定义添加以下各行:

["MyStudy", "Description", "MyStudyHelp"],
["MyStudy", "Has", "MyStudyResearched"],
["MyStudyResearched", "Is", "TechResearched"],
["MyStudyResearched", "Description", "MyStudyCompleted"]

在模组的 Text 词典中添加 MyStudyHelp 和 MyStudyCompleted。前者在研究前解释科技,后者提供完成消息。TechResearched 是原版游戏的 Completed 响应,保留其标准外观和声音。MyStudyResearched 只是本例选择的响应名称,并非必须使用的命名后缀。它通过 Has 关联科技,并通过 Is 继承 Notifies Completed。这条消息不会再次发放科技加成。

解锁预览来自普通定义,无需另写效果说明。建筑显示“建成后”的结果;升级显示相对于直接基础等级的变化。解锁行动时显示已声明的增量和基础价格。如果科技改变具有统一基础价格的行动,提示会比较研究前后的价格;可重复科技则比较下一级后的价格。计算考虑玩家当前加成,但不包括具体星球的附加费用。没有具体购买对象时,建筑类别折扣或特质强度变化不能推导出适用于所有情况的统一价格。

Processing 与 Duration - 任务与期限

已定义 ExchangeWater 的基础时间设三回合:

["ExchangeWater", "Processing.Duration", 3]

定时模式创建任务完成后奖励,瞬时模式可能降零。Cost 独立支付。

现有任务给工作地加 Processing,下面只读本局示意,不写模组:

["Earth_0", "Processing", "Construction_0"],
["Construction_0", "Progress", 2]

Earth_0 有 Construction_0,已完成两步,不是两个新期限或建筑。Processing 连任务、Progress 完成工作、Duration 所需时间,其他游戏实例名不同。

定时 Progress 计完成步,已付款另存。工人任务可积资源阈值,经过回合不等完成工作,缺费等待。事件 Progress 冲突尺度另讲。

倒计时含义依持有者:建筑 Duration 建时不删成品,行动 Processing.Duration 任务时间,临时事件 Duration 消息效果寿命。

成功步骤付分期,固定 12 矿物三步各 4,两步付 8。第三任一资源缺则整步等待,不部分扣或出结果。工作付款存档,价格期限变化尊重已付,降价低于已付不退差。

取消移任务、释放工人,不退分期。未完成建造无建筑,未完成探索不揭示。积累研究等待全库存无分期,取消保库存。

别发明 Cancel.Refund 或 JSON 完成处理。Demolish 为成品拆除独立退款。普通事件 Duration 效果寿命,不是分期。已出发 Mission 自身飞行期限。

行动的 Processing.Duration 指基础回合数,未设置时默认 1。行动决定结果:建造创建、探索揭示、交换奖励。自造任务种类名不定义结果。

ExchangeWater 已有角色、费用奖励、World Able,Explore、NuclearDrives 已有,下面仅改已定义操作:

["ExchangeWater", "Processing.Duration", 3],
["Explore", "Processing.Duration", 1],
["NuclearDrives", "Adds.Explore.Duration", -1]

探索由基础、距家环数及 Explore.Duration 增量决定,向上取整最低一。折扣不缩期限。Multiplies.Action.Duration 0 关闭定时行动,之后建造探索按 Rule.ProgressTasks。这是现有执行模式,不把任意事件变任务。

活体 Processing 引任务,Progress 完成回合,任务资源数量实付。Processing.Accumulates 属已创建积累过程,别用状态替行动定义。工人任务按派工及可付单位,新任务名不生完成行为。

事件效果活实体裸 Duration 为回合寿命,缺失无限,出生回合不减。到期执行结果、移实体临时贡献。提前解决摧毁不算到期。Mission Duration 飞行、Expires 提案期限,Duration.Turn 为内部戳。

事件类别的期限也使用相同的数值操作。GameEvent 是 PreWarpAge 中已有的 Event 后代;董事会任务、机会、威胁和远征任务都继承此类别。休闲模式使用以下设置:

["ModeMeditation", "Multiplies.GameEvent.Duration", 1.5]

此类别事件的正期限变为 1.5 倍,向下取整且至少占一回合,因此 3 变为 4。Is 类别以及 BoardQuest.Duration、EventChoice.Duration 等按名称指定的修饰都会参与。这也适用于同时属于 Event 的已选选项自身效果。不属于 Event 的选项保留原有期限。Action.Duration 表示行动执行时间,不改变事件存续期,即使同一选项兼具两种角色也是如此。

乘数不会凭空创建期限,也不会将零期限变为正数。Mission 飞行计划在出生时计算并保存,启动和载入沿用此计划;Expires 仍是单独的接受提案期限。没有 GameEvent 类别的奖章和普通通知不会因此延长。Requires.Turn.More/Less 和世界 Turn.Max 仍是绝对回合条件,而非期限乘数。若所选结局的警告没有自己的 Duration,就显示距离世界 Turn.Max 的剩余时间。

Creates 与 Then - 结果与后续

完成工作可继续故事,建造选结局、研究开事件组。Then 关联已有结果与后续,Creates 指支持机制创建什么,单独不执行。

现有“曲速引擎原型机” WarpDrivePrototype 与结局组 WarpVictories:

["WarpDrivePrototype", "Then", "WarpVictories"]

仅完成原型才交结局组选可用结果,不自行建造或免价。普通后续遵守 Turn.Pause。

事件 Then.Now 立即继续,已有 TutorialContinue、Quests:

["WarpDrivePrototype", "Then", "WarpVictories"],
["TutorialContinue", "Then.Now", "Quests"]

原型真完成才选结局,Now 立即,普通 Then 遵守暂停。引用不将任意名称变事件。

Creates 用已有教学 Tut29,创建 TutorialAsteroid,Europa 为教学天体:

["Tut29", "Creates", "TutorialAsteroid"],
["Tut29", "Creates.Target", "Europa"]

太阳系教学到 Tut29 才出现小行星,不在其他开局设定开教学或载文件即创建。自定义步骤需 TutorialStep、组成、顺序、转换条件,见 Tutorial。

延续到共用 Events 牌组时,使用人类玩家及其周期修饰,与该牌组普通抽取一致。直接 Then 到具名事件时,仍由发起玩家接收。接收者的区别不改变 Turn.Pause 或 Then.Now 的含义。

Toggle - 指标政策选择

当前 《前曲速时代》 模组不支持 Is Toggle 与 Stat 政策切换。这些记录不接政策按钮,Stat 谓词还会载入失败。

研究后持续科研点收入用科技 Adds.Income.Science,完整接入见 Tech、Researching、Repeatable。它创建研究加成,不是两个政策间切换按钮。

事件、选项与任务

Events 与 Event - 分组与事件

创建一次发矿物事件并加随机组。下文界面消息称卡片,文件定义与本局具体发生不同。

["MySupply", "Is", "Event"],
["MySupply", "Adds.Minerals.Count.Scaled", 1]

Event 声明事件,Scaled 1 按所选模式的规模一次发放矿物。本参考中的 Scaled 价格、奖励、货物与任务共用 Rule 选择的基准:休闲按玩家经济,经典与硬核按回合。规模 11 时发放 11(库存边界前),加载定义不发放,须等事件发生。

加入现有 RandomEvents:

["RandomEvents", "Deck.MySupply", 1]

加一张卡,Events 组按 Turn 抽取。选中触发才发,不是启模组就发。Deck 纳入无需 Has,再加呈现。

Events 是组或嵌套卡组,Event 是事件。名称、描述、图标、地点、后果决定发资源、效果、选项、等待或任务。空 Event 不够。

Text/zhCN.json 添加 MySupplyName(“额外矿物”)与 MySupplyDescription 说明奖励,Deck 纳入不需 Has:

["MySupply", "Is", "Event"],
["MySupply", "Name", "MySupplyName"],
["MySupply", "Description", "MySupplyDescription"],
["MySupply", "Icon", "ore_iron"],
["MySupply", "Adds.Minerals.Count.Scaled", 1],
["RandomEvents", "Deck.MySupply", 1]

抽中才出现,Scaled 按规模。独立 Event 的固定 Adds.Minerals.Count 不同样发资源,下条给选项结果固定奖。Requires.Turn.Min 限出现回合,Requires.Researched 查科技,Target 另选地点。不可用卡返卡组。

可能保持打开的事件可禁同时第二张,例如现有彗星:

["CometMinerals", "Is", "Unique"]

玩家已有 CometMinerals 不再出第二,关闭后可再抽。永久不重复用另一角色:

["MySupply", "Is", "Once"]

Once 每局只一次,发后不再发,与同时窗口限制不同。不同事件互斥独立:

["MySupply", "Conflicts", "CometMinerals"]

Conflicts 是对称关系,无需再写反向事实。两侧都考虑 Is 继承,因此类别之间的关系也适用于其后代。检查只针对同一玩家,不涉及世界中的所有玩家。关系可以放在带 Requires 的条件分支中:条件针对玩家检查,世界事实通过 Simulation 指明。这是冲突条件,不是分别禁止两个事件出现。

["BadEvent", "Conflicts", "BadEvent"]

BadEvent 是 PreWarpAge 已有的威胁类别。这行已经在所有模式下禁止它们同时出现,包括同类事件重复。只要冲突事件卡或其预告仍存在,新卡就会被跳过并放回牌组。后续事件与选项结果不会再次被该筛选拦截,因此预告不会阻止自己的后续事件。Unique 则单独禁止某一具体事件重复。Events.Level、Held 和抽取计数是运行中的状态,不是模组设置。

教学暂停是另一边界,普通卡组不需:

Simulation Events.Hold true 暂停公共事件调度,组期限按经过回合顺延。定时卡与条件组分支都不执行,已有事件也不能通过子 Requires/Goal 提前解决,含 Progress 边界。

解除后状态变化重新检查分支。不要仅为禁某随机组用 Hold,改该组内容即可。

Hold 不停游戏时间。已有 Duration、Progress 步继续,到期可出结果,带 Has 的 Progress 步分支仍可立即后果。行动或后续明确创建事件也不自动禁止。

自制开局设定留缺失或 false,除非确实需要局部暂停。不要永远 true 又期待 Goal/Progress 提前解决。

Adds.Minerals.Count.Scaled 与短 Scaled 同为规模数量。旧 Adds.Minerals.Percent 不支持,货物库存比例用 Contains.Percent。固定 Count 奖见 EventChoice。

事件开始前的预告由两个独立设置决定:事件声明预告期限,所选模式允许预告。下列事实在已声明的 MyInstantMode 中启用预告,并为现有彗星添加五回合预告:

["MyInstantMode", "Rule.EventWarns", true],
["CometMinerals", "Warns.Turns", 5]

Warns.Turns 必须是有限的非负整数。设为零或关闭 Rule.EventWarns 时,事件直接开始,不经过预告。PreWarpAge 的经典与硬核模式启用预告,休闲模式关闭。设置通过普通 Is 继承;董事会任务从 BoardQuest 继承。对于嵌套牌组,应标记选出的事件,而非牌组本身。奖励为正或负、是否存在付费选项,都不会自动创建预告。

抽取时先出现带倒计时的预告。倒计时结束前,事件效果与任务目标不生效,选项不可用,也不阻止结束回合。随后事件以自己的完整期限开始。已经选好的目标保持不变;若目标消失或不再合格,预告取消,不更换目标,也不发奖励或罚款,时间表仍继续其暂停期。预告会占用 Unique 和 Conflicts 所检查的位置。存档保存倒计时与后续事件,不会重新抽取。

预告窗口自动从选项费用、资源目标,以及研究、建造或探索所需行动中收集资源名称。这只是准备提示,不保证一定需要支付,也不承诺固定数量。无需另设资源清单。Warns.Turns 应写在最初事件卡上;不要仅为重复延迟,又给它的结果和后续事件添加预告。

牌组周期可以用普通数值修饰改变。例如,休闲模式的以下替代设置只将 RandomEvents 的间隔变为 1.5 倍:

["ModeMeditation", "Multiplies.RandomEvents.Turn.Every", 1.5]

这是替换现有设置的示例,不是再叠加到 Modes.json 已有的 Multiplies.Turn.Every 1.5 上;同时存在的乘数按普通规则组合。通过 Is 继承的牌组类别也参与计算。修饰应用于每个新周期;整数周期的结果舍入到整回合,作者声明的小数周期仍保留小数。首次启动 Turn.Starts、暂停 Turn.Pause 和已经确定的 Turn.Next 不会被改写。载入不会重新抽取已安排的回合。

EventChoice、Failure 与选择结果

EventChoice 是窗口选项,玩家选择支付并触发 Event 结果,Failure 额外标失败。例如样本变矿物或临时科研点收入,二选一。

先看回收按钮片段,不是独立事件:

["OGSampleDilemma", "Has", "OGRecycleSamples"],
["OGRecycleSamples", "Is", "EventChoice"]

Has 连消息按钮,EventChoice 声明角色,尚无结果不发矿物。

指定唯一成功结果:

["OGRecycleSamples", "Has", "OGSamplesRecycled"],
["OGSamplesRecycled", "Is", "Event"],
["OGSamplesRecycled", "Adds.Minerals.Count", 8]

第二 Has 连按钮结果,选择一次加 8,库存 10 成 18(边界允许)。奖励属结果非按钮。选项可被多事件复用,作用于点击所在卡。

第二按钮用熟悉收入加期限:

["OGSampleResearch", "Is", "Event"],
["OGSampleResearch", "Adds.Income.Science", 2],
["OGSampleResearch", "Duration", 3]

触发后三个后续回合各 +2,随后仅此增量消失。永久 5 暂成 7,再回 5。Duration 属奖励结果。

成功结果 Is Event,失败另 Is Failure。先做无随机完整例,再讲风险。

数组存 Logic/Samples.json,词典 Text/zhCN.json,已有则加键保其他。启用新游戏等随机“地质样本”,第一项一次获得 8 矿物,第二项在之后三个回合每回合获得 2 科研点。

[
  ["OGSampleDilemma", "Is", "Event"],
  ["OGSampleDilemma", "Name", "OGSampleDilemmaName"],
  ["OGSampleDilemma", "Description", "OGSampleDilemmaDesc"],
  ["OGSampleDilemma", "Icon", "ore_iron"],
  ["OGSampleDilemma", "Has", "OGRecycleSamples"],
  ["OGSampleDilemma", "Has", "OGStudySamples"],
  ["RandomEvents", "Deck.OGSampleDilemma", 1],
  ["OGRecycleSamples", "Is", "EventChoice"],
  ["OGRecycleSamples", "Name", "OGRecycleSamplesName"],
  ["OGRecycleSamples", "Description", "OGRecycleSamplesDesc"],
  ["OGRecycleSamples", "Icon", "ore_iron"],
  ["OGRecycleSamples", "Order", 1],
  ["OGRecycleSamples", "Cost.Credits", 0],
  ["OGRecycleSamples", "Has", "OGSamplesRecycled"],
  ["OGSamplesRecycled", "Is", "Event"],
  ["OGSamplesRecycled", "Name", "OGSamplesRecycledName"],
  ["OGSamplesRecycled", "Description", "OGSamplesRecycledDesc"],
  ["OGSamplesRecycled", "Icon", "ore_iron"],
  ["OGSamplesRecycled", "Adds.Minerals.Count", 8],
  ["OGStudySamples", "Is", "EventChoice"],
  ["OGStudySamples", "Name", "OGStudySamplesName"],
  ["OGStudySamples", "Description", "OGStudySamplesDesc"],
  ["OGStudySamples", "Icon", "flask"],
  ["OGStudySamples", "Order", 2],
  ["OGStudySamples", "Cost.Credits", 0],
  ["OGStudySamples", "Has", "OGSampleResearch"],
  ["OGSampleResearch", "Is", "Event"],
  ["OGSampleResearch", "Name", "OGSampleResearchName"],
  ["OGSampleResearch", "Description", "OGSampleResearchDesc"],
  ["OGSampleResearch", "Icon", "flask"],
  ["OGSampleResearch", "Duration", 3],
  ["OGSampleResearch", "Adds.Income.Science", 2]
]

示例 Text/zhCN.json:

{
  "OGSampleDilemmaName": "地质样本",
  "OGSampleDilemmaDesc": "这些样本可以回收或研究。",
  "OGRecycleSamplesName": "回收样本",
  "OGRecycleSamplesDesc": "从收集的岩石中提取矿物。",
  "OGSamplesRecycledName": "样本已回收",
  "OGSamplesRecycledDesc": "原料已经入库。",
  "OGStudySamplesName": "研究样本",
  "OGStudySamplesDesc": "开展临时研究计划。",
  "OGSampleResearchName": "样本研究",
  "OGSampleResearchDesc": "样本支持当前研究。"
}

两者免费,Cost.Credits 0 明确零非一。仅选一个,首奖边界前恰 8,第二后三回合 +2 再仅撤自身。期限属临时结果,不属免费选项或提案。

奖励在 OGSamplesRecycled,非 OGRecycleSamples。选中触发固定奖。搬到空独立 Event 不同样发放,无选项事件用 Scaled。

选项 Requires 查玩家而非卡目标。不可用保持灰、不付款。派生选项别依赖继承 Requires,应明确条件。Order 排选项。

无 Duration 提案等待并阻结束回合。正期限可推迟至到期,但等待不发所选奖。有自身选择或持续效果的结果作为独立事件,继承允许原目标。

事件可先警告、等候后出结果,不需新角色:Is Event,自身 Has 指 Event 结果非按钮。Duration 等待,到期按风险选成功或 Failure。

无期限则出现即解决。防御选项提前移警告则延期结果不发生。不要把结果 Has 加样本提案根,否则改变时机与方式。

风险 RiskTest 是独立替代方案,不是简单二选一的必需扩展,含角色关联和随机组纳入。

先给未来卡唯一风险百分比:

["RiskTest", "Chance.Deck.25", 1]

Chance.Deck 在出生选失败百分比,唯一 25 卡即风险 25、成功 75,不是出现概率。

允许两个等卡数风险值:

["RiskTest", "Chance.Deck.25", 1],
["RiskTest", "Chance.Deck.50", 1]

具体卡出生得 25 或 50 并保留,非每显示重抽。完整按钮一成功两失败。

将失败分轻重,两者必须 Failure 且纳入按钮 Has:

["AttemptRiskTest", "Deck.RiskLostSmall", 1],
["AttemptRiskTest", "Deck.RiskLostLarge", 1]

此 Deck 只在已失败后选严重度。风险 25 则成功 75、各失败 12.5;风险 50 则成功 50、各失败 25。完整如下。

百分比 0 至 100,Chance.Deck 右侧卡数有限可小数,正余量参与,选中减 min(1, 余量),非正排除。

EventChoice Deck 是有限比例一次选择权重,正值可小数,不消耗普通卡组剩余卡。

["RiskTest", "Is", "Event"],
["RiskTest", "Name", "RiskTestName"],
["RiskTest", "Icon", "flask"],
["RiskTest", "Chance.Deck.25", 1],
["RiskTest", "Chance.Deck.50", 1],
["RiskTest", "Has", "AttemptRiskTest"],
["AttemptRiskTest", "Is", "EventChoice"],
["AttemptRiskTest", "Name", "AttemptRiskTestName"],
["AttemptRiskTest", "Cost.Credits", 0],
["AttemptRiskTest", "Has", "RiskWon"],
["AttemptRiskTest", "Has", "RiskLostSmall"],
["AttemptRiskTest", "Has", "RiskLostLarge"],
["AttemptRiskTest", "Deck.RiskLostSmall", 1],
["AttemptRiskTest", "Deck.RiskLostLarge", 1],
["RiskWon", "Is", "Event"],
["RiskWon", "Name", "RiskWonName"],
["RiskWon", "Adds.Science.Count", 5],
["RiskLostSmall", "Is", "Event"],
["RiskLostSmall", "Is", "Failure"],
["RiskLostSmall", "Name", "RiskLostSmallName"],
["RiskLostSmall", "Adds.Minerals.Count", -1],
["RiskLostLarge", "Is", "Event"],
["RiskLostLarge", "Is", "Failure"],
["RiskLostLarge", "Name", "RiskLostLargeName"],
["RiskLostLarge", "Adds.Minerals.Count", -5],
["RandomEvents", "Deck.RiskTest", 1]
  • 唯一成功 Has 无 Failure 则安全,卡片风险不凭空造失败结果。
  • 一成功一 Failure 用卡片成败风险,无风险不虚构失败。
  • 多 Failure 需选项 Deck,每成员也须 Has 且 Failure。此 Deck 不选成功结果。
  • 多成功 Has 不全执行,按 Order 再定义标识精确顺序取首个合格,非翻译 Name。建议一个成功或互斥条件。
  • Chance.Add 配 Chance.Target Parent.Part 改下述 Progress 分支概率,非 RiskTest 保存失败率。可调共享风险用 Mission、Risk,不用普通 Event 不支持的 Chance.Target Parent。

失败率属具体任务或风险卡,Has 连成败,选项 Deck 分失败权重,不是 JSON 执行顺序。Damage、Progress、货物、任务改进选项可能保留原卡,结果取决操作非名称。

在 Has 关系中,EventChoice 的角色优先于 Event:同时属于这两类的定义仍是选项按钮,而非另一个结果。如果所选选项创建自身的临时 Event 效果,效果卡会保留该选项作为效果、期限和历史的来源。事件 Has 中的普通 Action 是独立行动按钮;事件因此可以保留持续打开的窗口,但 Action 不会变为 EventChoice,也不会获得凭空添加的结果,其可用性和执行仍由行动自身负责。

临时效果与 Blocks

临时效果若干回合后移除,例如五回合多 20% 能源。Blocks 禁建筑、行动、增长或支持概念,期限与禁止独立。

先仅临时加成,自定义 MyEnergySeason:

["MyEnergySeason", "Is", "Event"],
["MyEnergySeason", "Multiplies.Income.Energy", 1.2],
["MyEnergySeason", "Duration", 5]

出现后五个后续回合 10 成 12,乘数移除后无其他变化恢复 10。如下加名称图标随机纳入,Text/zhCN.json MyEnergySeasonName 可译“能源季”。

独立禁止休闲任务惩罚,不需临时期限:

["ModeMeditation", "Blocks", "QuestPenalty"]

两定义已有,模式禁此惩罚,不改能源也不限五回合。下方只是合独立设置。

无 Duration 数值效果在消息关闭后继续,重复发放叠增量或乘数。有期限则到期仅移自身,保基础和其他。关闭消息不等到期。

["MyEnergySeason", "Is", "Event"],
["MyEnergySeason", "Name", "MyEnergySeasonName"],
["MyEnergySeason", "Icon", "energy"],
["MyEnergySeason", "Duration", 5],
["MyEnergySeason", "Multiplies.Income.Energy", 1.2],
["ModeMeditation", "Blocks", "QuestPenalty"],
["RandomEvents", "Deck.MyEnergySeason", 1]

所选公司 Blocks 为玩家禁概念或流,模式上为游戏规则,如 Growth.Workers 禁自然增长、Upkeep.Water 禁耗水。只用已声明类别支持字段,不自动覆盖一切间接相关项。

事件 Blocks World、Icy 选封锁地点类别,需正 Duration。出现选具体处,关闭消费者工作岗位,最后封锁移除恢复。不同于 Earthlike Blocks Outpost 禁当地建造。

封锁卡本身别混一次 Scaled 奖或 Target.Adds 天体变化,普通抽取会按一次变化处理而不启封锁。封锁后奖励放独立结果。

Resource - 探索资源选择

探索可能提供几资源,预显各产率,玩家选一种。选项 Resource 指星球采什么,不发库存。

WorkFocus 已有窗口、FocusMinerals 矿物选项。Parent.Target 是窗口所探索天体,完整关联:

Resource 指声明资源、非储备。选项需明确 Resource.Target,例如 Parent.Target。产量出生时抽保存显示,选后应用,不兼容不提供。

["WorkFocus", "Has", "FocusMinerals"],
["FocusMinerals", "Is", "EventChoice"],
["FocusMinerals", "Name", "Minerals"],
["FocusMinerals", "Resource", "Minerals"],
["FocusMinerals", "Resource.Target", "Parent.Target"]

多个兼容候选时 Explore 开窗口。卡组不兼容矿物则无此项,不强迫全星球矿物。新资源需声明、玩家储备、天体卡组及已接选项,完整冷冻矿例见资源生成。

Find - 发现与探测器调查

发现是已揭示天体上的未知对象或储藏,单独发牌,Probe 付费调查,结果为事件而非自动新资源库存。

MyCache 新发现、MyFinds 为 ScenarioG 卡组,Rocky 地点类别,SuppliesMinerals 已有事件奖励呈现。

先声明和调查价:

["MyCache", "Is", "Find"],
["MyCache", "Cost.Minerals", 5]

Probe 基础 5 矿物,最终受探索乘数。是调查费非奖励。

再设适合地点、结果:

["MyCache", "Target", "Rocky"],
["MyCache", "Deck.SuppliesMinerals", 1]

适用岩石体,付费触发 SuppliesMinerals 一次奖,数量由事件、不受 Find Cost。不同地点类别用独立部分各 Target、Deck,同上下文两个不同结果集有歧义。

最后分配给新揭示开局设定天体:

["MyFinds", "Deck.MyCache", 1],
["MyFinds", "Deck.None", 3],
["ScenarioG", "Has", "MyFinds"]

一发现三空卡,四适合体不放回得到一 MyCache、三无。别在活天体写 Find None,它表示已完成发牌。完整:

["MyCache", "Is", "Find"],
["MyCache", "Name", "MyCacheName"],
["MyCache", "Icon", "question"],
["MyCache", "Cost.Minerals", 5],
["MyCache", "Target", "Rocky"],
["MyCache", "Deck.SuppliesMinerals", 1],
["MyFinds", "Deck.MyCache", 1],
["MyFinds", "Deck.None", 3],
["ScenarioG", "Has", "MyFinds"]

首次揭示适合开局设定体发发现或 None,SuppliesMinerals 已有。目标为岩石,None 空卡。作者体无发现不要写 Find None,活体上它固定已发牌。

[BodyClass, Find, MyCache] 预设作者发现先于随机。Probe 按模式付探索修正价,移发现并在同体出结果。若结果增已选资源生产,资源须先确定,否则不可调查。结果卡组写发现在本身,不写天体 Find.MyCache.Deck。

Contains - 事件货物

货物在收取前属于活事件提案。例如彗星保存矿物数,成功收集才转库存。另一选项可增卡货物而不取或关闭。

先选现有 CometMinerals 货物,无需重复名称图选项:

["CometMinerals", "Contains", "Minerals"]

指矿物货物,不发库存。无单独数值则出现时按规模系数 1 计算并保存。

用库存比例,已有 Scaled 但 Percent 优先,实验不需先删它:

["CometMinerals", "Contains", "Minerals"],
["CometMinerals", "Contains.Percent", 10]

出现时库存 100,货 10,后来库存 200 仍货 10,出生固定。正货最低一,需声明资源。下一方案 Scaled 2.5 为规模乘数,必须省 Percent 否则它仍优先。

彗星 CometMinerals、收集 CometCollect、成功 CometReturn 都已有,货物链:

["CometMinerals", "Contains", "Minerals"],
["CometMinerals", "Contains.Scaled", 2.5],
["CometMinerals", "Has", "CometCollect"],
["CometCollect", "Has", "CometReturn"],
["CometReturn", "Contains.Target", "Parent"]

规模 10 货 25,出现保存。收前库存 100,成功转 25 成 125。出现本身不增库存,现有失败风险保留。

增货用另一现有链 SpaceFashion 吸引移民,Boost 付推广,独立于彗星:

["SpaceFashion", "Has", "SpaceFashionBoost"],
["SpaceFashionBoost", "Contains.Target", "Parent"],
["SpaceFashionBoost", "Contains.Percent", 5]

货为 SpaceFashion 声明 Workers,5 是玩家人口 5%,非已有货。人口 100 付点击加 5,货 10 变 15,玩家仍 100、窗保留。

点 Accept 后 AcceptDone 只有 Contains.Target Parent,取全 15,人口未变则到 115。同路径用于两操作:选项 Percent 增货,结果无数值则转保存货。推广 Scaled 也可按经济规模增量。

结果只有 Contains.Target Parent 时收取卡上全部已保存货物;选项使用同一路径并声明数量则加货、可重复且卡保留。不能混独立结果或掩盖重复的效果。Contains.Name 标签,Contains.Count.R 计算结果非声明。Cost.R.PerValue 可按新增单位付款。

Mission、Expires、Risk、Reward 与 Launched

任务先是提案,及时付启动费后飞行,到期按风险成败。成功给预先奖励,失败不自动退款。Expires 限推迟,Duration 为已启动飞行。

MyExpedition 是新的科学远征。Reward.Scaled 将所选模式的规模乘以奖励系数,并在发出提案时固定。此后人口增长或回合推进不会自动提高承诺的奖励。前两块放同一 Logic 数组,先提案再启动结果。

先决策时间,尚无启动按钮。Mission 原版已是 Event,不需再 Is Event。

["MyExpedition", "Is", "Mission"],
["MyExpedition", "Expires", 8]

Expires 8 可考虑八回合。10 出生,可在 10 至 17 接受,进入 18 未付就移除,不是飞行时间。

飞行另设:

["MyExpedition", "Duration", 4]

启动时重开四回合计时,12 启动 16 解决,剩余提案时间不影响。

失败无奖风险:

["MyExpedition", "Risk", 30]

30% 失败、70% 成功,保存具体提案,载入不重抽,失败不自动退费。

成功奖励:

["MyExpedition", "Reward", "Science"],
["MyExpedition", "Reward.Scaled", 2]

Reward 选科研点,Scaled 2 取出现规模两倍。规模 11 承诺 22,不随以后人口。完整公式如下。Risk、Reward、Expires、Launched 已通过 Predicate 声明,不重声明。合提案:

["MyExpedition", "Is", "Mission"],
["MyExpedition", "Name", "MyExpeditionName"],
["MyExpedition", "Expires", 8],
["MyExpedition", "Duration", 4],
["MyExpedition", "Risk", 30],
["MyExpedition", "Reward", "Science"],
["MyExpedition", "Reward.Scaled", 2]

提案还需要通过 Has 列出结果的启动选项;仅有 Duration、Risk 和 Reward 不会创建这些结果。Duration 和 Risk 使用普通 Random 机制,可给出固定数值、Min/Max 区间,或重复 .Random 事实列出允许的数值。随机选项和边界必须是 0 至 2147483647 的有限整数,Duration 至少为 1。区间需要两个边界,子定义可以继承缺少的边界。子定义自身的固定值会覆盖祖先的随机声明;同一定义上不要混用固定值与 Random。Step、Peak 和 PowerLaw 遵循 Random 条目的规则。抽取结果保存在提案上,读取或载入时不会重新抽取。Expires 支持普通 Random;Reward 指定已声明的资源,而非随机数值。

原版游戏的“冒险实验”初始失败风险只会是 40%、60% 或 80%。下面列出 ExperimentWarp 定义及各实验共用的投资选项;另外两项实验使用相同的三个值:

["ExperimentWarp", "Risk.Random", 40],
["ExperimentWarp", "Risk.Random", 60],
["ExperimentWarp", "Risk.Random", 80],
["Invest", "Adds.Risk", -20]

每次独立抽取时,列表中的各值概率相同。Adds.Risk −20 将风险降低 20 个百分点,而不是乘以 0.8:40 变为 20,两次付费投资后变为 0。实验已经声明 Risk.Min 0,因此风险最低为零;达到下限后不能继续投资,也不会扣费。费用及其增长仍由 Invest 定义。Deck 则按权重抽取卡牌且不放回;需要这种不同的分布时才使用它。

["MyExpedition", "Has", "LaunchMyExpedition"],
["LaunchMyExpedition", "Is", "EventChoice"],
["LaunchMyExpedition", "Name", "LaunchMyExpeditionName"],
["LaunchMyExpedition", "Cost.Minerals", 10],
["LaunchMyExpedition", "Has", "MyExpeditionSuccess"],
["LaunchMyExpedition", "Has", "MyExpeditionFailure"],
["MyExpeditionSuccess", "Is", "Event"],
["MyExpeditionSuccess", "Name", "MyExpeditionSuccessName"],
["MyExpeditionFailure", "Is", "Event"],
["MyExpeditionFailure", "Is", "Failure"],
["MyExpeditionFailure", "Name", "MyExpeditionFailureName"],
["RandomEvents", "Deck.MyExpedition", 1]

合起来为八回合提案,付款四回合飞行,再按保存风险选结果。成功自动付 Reward,不在成功结果 Adds 重复。名称用普通词典。

Reward Science、Reward.Scaled K 表示科研奖励,而非 Reward.Science 字段。提案出现时使用所选模式的规模:休闲模式按玩家,经典与硬核模式按回合。初始奖励为 max(1, floor(|K| × 规模)),K 默认 1。规模 11、Reward.Scaled 3 得 33 科研点。公式与设置见 Rule 条目。

出现而非启动返回时固定,后来人口研究贸易不自动改。明确付费改进 Adds.Reward.Count、Multiplies.Reward.Count 可改此卡保存值。

成功遵守当前科研点边界并报告实际值。失败无 Reward、不自动退启动费,退款罚款需自身结果事实。

出生 B、整数 Expires E,可接 B 至 B+E-1,进入 B+E 移未接。10 出生 Expires 6 可 10 至 15,16 消失。正小数到 B+ceil(E) 首次耗尽。未启动不抽启动结果、不扣费,另需到期故事则明确声明。

L 启动后以 D 取代剩提案时间,L+D 结果,启动回合不减首回合。目标删除转变由事件种类处理,非假定计时继续。清楚日历用整数。

与启动并列增加付费降风险按钮,编辑开卡、不创另次飞行,名称普通翻译:

["MyExpedition", "Has", "ReduceMyRisk"],
["MyExpedition", "Risk.Min", 10],
["ReduceMyRisk", "Is", "EventChoice"],
["ReduceMyRisk", "Name", "ReduceMyRiskName"],
["ReduceMyRisk", "Cost.Credits", 1],
["ReduceMyRisk", "Adds.Risk", -10]

30 一次到 20、二次 10,达到限按钮灰不收费,提案仍开未启动。Risk.Min 属任务,不是按钮 Requires。

替代实验保留费用和关联,用下列乘数替换 Adds.Risk −10:

["ReduceMyRisk", "Multiplies.Risk", 0.5]

30 到 15 再最低 10,非 7.5。风险精度 0.1 百分点,乘失败率,成功从 70 到 85 再 90。

下一替代改短飞行,保框架改翻译名,仅换操作(也可重命名按钮标识):

["ReduceMyRisk", "Multiplies.Duration", 0.5],
["MyExpedition", "Duration.Min", 1]

4 到 2 到 1,第三不可用不收费。改未来飞行而非 Expires。Duration 整数最低 1,Adds.Duration 可固定加减。

独立版本用奖励操作替换期限,实验勿都留:

["ReduceMyRisk", "Multiplies.Reward.Count", 2]

承诺 22 到 44 再 88(入账边界前)。改 Reward.Count,不改资源。奖励整单位,Adds.Reward.Count 可固定 +3 成 25。下限在任务 Reward.Count.Min,非 Reward.Min。只能真正改变参数时可付费改进。

Launched true 出生即启动,事件自身需 Duration、Has 结果,无 Expires 或启动按钮,可保改进。普通提案启动变过程并隐藏选择至解决。任务 Has 的 Notifies Started 设启动消息,加载不重抽风险奖励。

Risk.Show Success 显示 100 - 风险,不改投掷,只支持此 Show。Failure.Description 失败后果键,Visual Departure 支持出发效果。任务外 Multiplies.Risk 改现有卡概率,不创任务。Mission.Duration/Risk/Reward、卡 Reward.Count 是历史非初始参数。

独立研究解锁并独立定期派遣,替换 RandomEvents 纳入,保其他事实。科技故意无数值加成:

["MyCartography", "Is", "Tech"],
["MyCartography", "Name", "MyCartographyName"],
["MyCartography", "Icon", "flask"],
["MyCartography", "Tier", 1],
["MyCartography", "Cost.Science", 9],
["Player", "Has", "MyCartography"],
["MyDispatches", "Is", "Events"],
["MyDispatches", "Turn.Starts", 3],
["MyDispatches", "Turn.Every", 7],
["MyDispatches", "Deck.MyExpedition", 1],
["MyExpedition", "Requires.Researched", "MyCartography"],
["MyExpedition", "Target", "World"],
["MyExpedition", "Target.Is", "Rocky"],
["MyExpedition", "Target.Explored", true],
["MyExpedition", "Target.Not", "Homeworld"]

可继续游戏期间第 3、10、17 等回合检查,需研究科技、家园外已探索岩质星球。错过后研究不即发,等下次。Unique 禁同时提案,词典翻译科技名。

Progress - 工作进度与尺度

Progress 保存具体过程推进或状态变化,是 Processing 步和冲突尺度共享数值机制,冲突只是一个用途。

Processing 连任务,行动管支付完成;Progress 只存值不创建造奖励胜利。Duration 限时间,进度可升降不变。例如不满回合增、让步减、边界接结果。任务见 Processing。

分解 PressureTest,先初点和边界:

["PressureTest", "Progress", 2],
["PressureTest", "Progress.Min", 0],
["PressureTest", "Progress.Max", 5]

新卡从 2,可至 0、5 不越界,边界尚无奖,结果另设。

按钮降低开卡尺度:

["PressureRelief", "Progress.Target", "Parent"],
["PressureRelief", "Progress.Gain", -1]

Parent 为按钮所在卡,点击 2 到 1 再 0,本身不关闭。完整例下界解决,角色费用 Has 如下。

时间也可改变,设随机不利步:

["PressureTest.Drift", "Progress.Add", 1],
["PressureTest.Drift", "Chance", 30]

Drift 事件部分,后续每回合 30% 加 1,例如 2 到 3,失败仍 2。出生回合不步进,无 Chance 每回合加。

关联下界结果:

["PressureTest.Lower", "Requires.Progress", 0],
["PressureTest.Lower", "Has", "PressureWon"]

Lower 恰零触发 PressureWon,完整奖 5 科研点。此前零只数字,现在是成功。Upper 同样把 5 连失败,先做完整冲突再加保险。

这是独立对抗的完整示例,期限为 12 回合。Duration 决定截止时间,而非是否允许结束回合。具有 Progress 进度条的事件即使没有 Duration,也不会阻止结束回合。不选择 Relief,直接关闭窗口并结束回合,Drift 就会进行一次 30% 判定。

免费 Relief 减一,未解决保持。初始两点击零成功,下界奖科研点、上界丢矿物。即有期限也可提前解决,两界未达则到期根 Has 失败。

[
  ["PressureTest", "Is", "Event"],
  ["PressureTest", "Name", "PressureTestName"],
  ["PressureTest", "Icon", "flask"],
  ["PressureTest", "Duration", 12],
  ["PressureTest", "Progress", 2],
  ["PressureTest", "Progress.Min", 0],
  ["PressureTest", "Progress.Max", 5],
  ["PressureTest", "Has", "PressureRelief"],
  ["PressureTest", "Has", "PressureLost"],
  ["PressureTest.Drift", "Progress.Add", 1],
  ["PressureTest.Drift", "Chance", 30],
  ["PressureTest.Lower", "Requires.Progress", 0],
  ["PressureTest.Lower", "Has", "PressureWon"],
  ["PressureTest.Upper", "Requires.Progress", 5],
  ["PressureTest.Upper", "Has", "PressureLost"],
  ["PressureRelief", "Is", "EventChoice"],
  ["PressureRelief", "Name", "PressureReliefName"],
  ["PressureRelief", "Cost.Credits", 0],
  ["PressureRelief", "Progress.Target", "Parent"],
  ["PressureRelief", "Progress.Gain", -1],
  ["PressureWon", "Is", "Event"],
  ["PressureWon", "Name", "PressureWonName"],
  ["PressureWon", "Adds.Science.Count", 5],
  ["PressureLost", "Is", "Event"],
  ["PressureLost", "Is", "Failure"],
  ["PressureLost", "Name", "PressureLostName"],
  ["PressureLost", "Adds.Minerals.Count", -5],
  ["RandomEvents", "Deck.PressureTest", 1]
]

Progress N 初始化,Progress.Min 和 Progress.Max 限界,下限默认零,所有修改限内。Progress.Name 和 Progress.Hide 控标签显示。子部分的 Progress.Add 每回合修改尺度,Progress.Set 赋值,Chance 决定该步概率,无 Chance 则每回合必执行。

PressureRelief 立即降低自身事件卡的进度值,并保留事件卡。Progress.Set 配合 Progress.Target Parent 可设定精确值。步进分支先按 Order 排序,再按标识符的 ordinal 顺序排序。带 Chance 或 Chance.Deck 的随机分支是同一回合的备选项:第一个成功后,不再判定后续随机分支。没有概率的分支独立于该选择生效。第一个实际达到边界的分支会结束整个步进。出生回合不进行步进。

普通 Requires.Progress、Has 定解决,仅 Min/Max 不命名胜利。状态改变可期限前解决。

没有 Duration 时,带进度条的事件可以无限等待结局,仍由进度值和已声明分支决定完成。没有进度条也没有期限的普通必选事件,仍属于另一种阻止结束回合的情况。Progress.Turn 和 Progress.Fired 是存档中的内部事实,不是模组输入。数值机制与 Processing 任务共用,但进度条的事件结果不能代替任务付款和工作执行。

掌握基础后可同 Logic 数组加付费保险,非独立新事件。

控制 Drift 几率,每次付 1 信用点、减 10 百分点。卡留开、点击不步进,概率限 0 至 100,下界不可再减。

Chance.Target 仅 Parent.<部分名> 非任意地址,部分 Chance.Max 限正增量默认 100。改 Progress 分支概率,非无尺度 Event 全局风险。

["PressureTest", "Has", "PressureInsurance"],
["PressureInsurance", "Is", "EventChoice"],
["PressureInsurance", "Name", "PressureInsuranceName"],
["PressureInsurance", "Cost.Credits", 1],
["PressureInsurance", "Chance.Target", "Parent.Drift"],
["PressureInsurance", "Chance.Add", -10]

Goal - 任务目标

任务要求期限前达结果。Goal 检查,Event 及分支定义成功和超时。

HQ 已有总部。发任务前须真能建,科技地点无禁止,Target.Build HQ 检查。新玩家无建权暂收不到。

先看目标:选定处等自有建成 HQ,Target 已选,下面只查结果:

["HeadquartersQuest.Done", "Goal.Has", "HQ"],
["HeadquartersQuest.Done", "Has", "HeadquartersBuilt"]

目标星球自有成品才合格,在建、他人或别处 HQ 不算。满足即出 HeadquartersBuilt,完整例奖 8 科研点。Goal 不建造。

设等待期限及后备结果:

["HeadquartersQuest", "Duration", 12],
["HeadquartersQuest", "Has", "HeadquartersLate"]

允许 12 回合,到期 Done 未满足根 Has 触发 Late,此处损 3 矿物。成功可提前。完整文件及普通名称翻译:

[
  ["HeadquartersQuest", "Is", "Event"],
  ["HeadquartersQuest", "Name", "HeadquartersQuestName"],
  ["HeadquartersQuest", "Icon", "flask"],
  ["HeadquartersQuest", "Duration", 12],
  ["HeadquartersQuest", "Target", "World"],
  ["HeadquartersQuest", "Target.Explored", true],
  ["HeadquartersQuest", "Target.Build", "HQ"],
  ["HeadquartersQuest", "Has", "HeadquartersLate"],
  ["HeadquartersQuest.Done", "Goal.Has", "HQ"],
  ["HeadquartersQuest.Done", "Has", "HeadquartersBuilt"],
  ["HeadquartersBuilt", "Is", "Event"],
  ["HeadquartersBuilt", "Name", "HeadquartersBuiltName"],
  ["HeadquartersBuilt", "Adds.Science.Count", 8],
  ["HeadquartersLate", "Is", "Event"],
  ["HeadquartersLate", "Is", "Failure"],
  ["HeadquartersLate", "Name", "HeadquartersLateName"],
  ["HeadquartersLate", "Adds.Minerals.Count", -3],
  ["RandomEvents", "Deck.HeadquartersQuest", 1]
]

星球变化可提前解决,有 Duration 也如此。最终检查适合成功优先后备失败。多个合格子按完整名称精确顺序首个,可用 A、B 优先名且条件不重叠。

失去摧毁地点不把 Goal.Has 转玩家,未达最终失败。要失址专属结果需自身分支 Has,不凭空造结果。任务存在条件失败或游戏结束,清理不自动奖罚。

Goal.F 用 Requires 比较检查状态。目标缺失不替玩家,未声明地点选择时查任务所有者。HQ 必须卡选星球自有成品。

Goal.R = N 要发出后再增长,不是当前库存 N。Percent 基于初库存,Scaled 经济规模,Min 最小增长。阈值出生固定。

人口增长用另一 Done 目标替代 Goal.Has,不并加:

["HeadquartersQuest.Done", "Goal.Workers.Percent", 40]

发出时 20,需再 8 达 28,原有 20 不满足,阈值不随人口重算。

八不足可加最低增长:

["HeadquartersQuest.Done", "Goal.Workers.Percent", 40],
["HeadquartersQuest.Done", "Goal.Workers.Min", 15]

初始 20 要再 15 共 35。初 100,40% 高于下限,目标 140。期限结果组纳入保留。

主数量正,Min 可零且需同资源主值。分支阈值独立,Goal 描述成功,Requires 一般环境如失址。完整需 Event、期限、成败 Has、组纳入。裸 Goal、旧 Request、技术 Goal.*.Required 非作者形式。

任务奖励是普通 Event 结果,通过 Has 关联到成功分支;任务没有另一套 Reward 设置。窗口和提示会自动显示结果的一次性资源和永久修饰。例如,已声明的 HeadquartersBuilt 可以另加独立的工人百分比增量和永久折扣:

["HeadquartersBuilt.Growth", "Target", "Workers.Count"],
["HeadquartersBuilt.Growth", "Adds.Percent", 20],
["HeadquartersBuilt.Growth", "Adds.Percent.Min", 5],
["HeadquartersBuilt.Growth", "Adds.Round", "Floor"],
["HeadquartersBuilt", "Multiplies.Cost.Build", 0.9]

独立的 Growth 部分改变拥有者的工人库存,而不是任务目标星球。20% 先向下取整,再应用至少 5 名工人的下限。任务发出时人口为 20,就承诺增加 5;即使完成前人口变为 40,奖励仍为 5,而不是 8。数量在有效任务出生时固定,包括因条件暂不可用的结果,并随存档保存。一次性增加不会变成永久百分比效果,因此独立折扣写在另一主体上。Multiplies.Cost.Build 0.9 仍是结果的普通永久效果,不属于百分比快照。

结果的 Requires 条件和 Blocks 禁止项在发放奖励时检查。如果已达成目标,但该分支没有任何已声明结果可用,任务不会提前解决,而会在期限内继续等待。到期时仍按已声明的结局处理。不要为显示未来奖励而删除条件。董事会奖励中的认可度显示在其他资源和修饰之后。百分比资源、永久折扣和认可度不需要另写窗口代码。

玩家通过 Player Has 持有的事件若有自己的 Duration,就从出生时倒计时;Requires.Turn.More/Less 只限制可出现的回合范围。若没有自身期限,Requires.Turn.Less 的上限决定剩余窗口。这是两种不同的时间定义,不是应相加的两个值。奖章共用类别使预备目标与最终事件使用相同时间窗口;界面显示的目标名称不会代替条件来选择奖章。

Notifies - 反应与消息

Notifies 关联完成探索、任务缺费、工人损失等情况。行动资源 Has 列反应,反应 Notifies 指情况,Name、Icon 普通呈现,真实结果才触发。

Explore、ExploreDone 已有,以下是已有关联非新事件:

["Explore", "Has", "ExploreDone"],
["ExploreDone", "Notifies", "Completed"],
["ExploreDone", "Name", "ExploreDone"]

真完成探索才出消息,无需额外 Event,操作结果属 Explore。

Notifies Completed 为完成情况非翻译引用。反应可有 Name、Description、Icon、Color、Popup、Sound,普通通知无需 Notification 或 Event。Name、Has、Adds 单独不触发。

  • Completed 成功完成行动结果奖励,Started 启动任务,Unlocked 新能力可用。
  • Shortage 资源短缺及因果效果,Offline 消费者因短缺关闭,Stopped 任务暂停。
  • Destroyed 销毁,Spread 传播,Defeat 失败原因。
  • Casualties 实际工人损失,Withdrawn 分配释放。任意新情况不因 Notifies 就声明。

Shortage 也可施后果。替换缺水饥荒,自定义完整 Logic/WaterShortage.json 对象,remove 清旧、add 新,不需另先删 Has:

原版按 Workers 计 Upkeep.Water,回合将低于零时水到零、一次工人损失。恰零无缺口不损,缺口大小不倍罚。下回合按更小人口检查。生命维持调用,不需 Event。

{
  "remove": [
    ["Water", "Has", "Starvation"]
  ],
  "add": [
    ["Water", "Has", "MyWaterShortage"],
    ["MyWaterShortage", "Notifies", "Shortage"],
    ["MyWaterShortage", "Name", "MyWaterShortageName"],
    ["MyWaterShortage", "Icon", "cosmo_helmet_minus"],
    ["MyWaterShortage", "Multiplies.Workers.Count", 0.9],
    ["MyWaterShortage", "Multiplies.Round", "Floor"]
  ]
}

词典加 MyWaterShortageName(缺水)。人口 11 乘 0.9 变化 -1.1,Floor 向下至 -2,剩 9。Blocks MyWaterShortage 取消后果,Popup 缺失仅改呈现。

新生命维持资源不只 Has 反应,还需 Upkeep 配 Per S.Count 指支持数量 S。无此度量固定费不算。一反应恰改一个数量。

反应随包含行动资源继承。替换时 Blocks 可抑公共消息防重复。Shortage 属缺资源,如水 Has Starvation,改 Workers。隐藏仍施后果,普通 Event 仅要标题不需 Notifies。

Marks 与 Unmarks - 目标永久特质

占领星球状态可在消息关闭后保留,Marks 附加、Unmarks 解放时移除。有属性行为状态用 Trait,简单 Is 只类别。

已有机器人叛乱,先看占领状态:

["RobotHeldTrait", "Is", "Trait"],
["RobotHeldTrait", "Control.Here", 0]

取消可工作领土,定义本身不赋星球。

起义真实失败结果赋予:

["WorldLost", "Target", "Parent.Target"],
["WorldLost", "Marks", "RobotHeldTrait"]

WorldLost 沿 Parent.Target 取得原事件星球,给受影响玩家留下特质,原工作岗位不可用,关消息不撤。

夺回真实结果反向:

["RetakeDone", "Target", "Parent.Target"],
["RetakeDone", "Unmarks", "RobotHeldTrait"]

仅移此特质,其他限制仍在。已有事件任务启动链完整如下:

["RobotHeldTrait", "Is", "Trait"],
["RobotHeldTrait", "Control.Here", 0],
["WorldLost", "Target", "Parent.Target"],
["WorldLost", "Marks", "RobotHeldTrait"],
["RetakeDone", "Target", "Parent.Target"],
["RetakeDone", "Unmarks", "RobotHeldTrait"]

关闭卡不撤工限,夺回撤它保其他。自制链需声明 Event 结果、真实触发和传目标。任意名称 Marks 不占领任何人。

Marks Definition 在事件出生或结果解决时加明确目标,Unmarks 移除。普通类别成天体 Is 标签,Trait 为受影响玩家永久特质。事件结果需 Target 和已有定义。

地区损失禁当地工作直到明确夺回,卡消失不撤永久特质。一来源移除保留他人或其他来源。不需中间技术标签或猜名规则,临时数值用 Duration。

Turn - 回合与时间表

完成回合时间 +1,Events 按日历尝试抽卡。例如 Start 3、间隔 7 为 3、10、17。

Simulation Turn 保存回合,作者通常排组而不编辑它。新 MyEvents 先单次,后接已有矿物事件。

["MyEvents", "Is", "Events"],
["MyEvents", "Turn.Starts", 3]

普通游戏第三回合首次,无间隔就仅一次。无合格卡不在第四自动重试。

设间隔持续尝试:

["MyEvents", "Turn.Every", 7]

相隔七回合 3、10、17,不可用不会移至最近回合。接矿物并合时间表,Max、Then 稍后。

新独立组 MyEvents 复用 SuppliesMinerals(名称由 Supplies 翻译),不重复奖励:

["MyEvents", "Is", "Events"],
["MyEvents", "Turn.Starts", 3],
["MyEvents", "Turn.Every", 7],
["MyEvents", "Deck.SuppliesMinerals", 1]

初始游戏世界准备不抽,Starts 已到或早于初始回合时,首次机会为时间推进后普通检查。Starts 单次,Every 无 Starts 从下次组检查排首期限,不是创建即抽。首回合号重要就明确 Starts。

游戏自动发现定时 Is Events,无需第二 Events 指针或 Simulation 事件 Deck。组子 Requires、Deck 为条件分支非独立持续计时,无 Requires 分支无效。任意无消费者主体排程不执行。标准 Random 支持随机开始暂停,Turn.Next 为内部状态。

抽前先设下次时间。研究、冲突、活 Unique、无目标造成不可用的卡返回,不在同次重抽,尝试其他卡,全无则无消息但日历继续。

第三失败不第四重试,下次第十。期间研究探索不绕间隔。

无 Every 即使全无合格也不重复。Then 可经 Pause 再接,条件分支和反应目标各有上下文,不隐重试。教学暂停会平移期限,日历例假设无暂停。

Then 交接可重排组时钟,区别独立周期。

组 Turn.Pause 延迟 Then 非每个 Every。普通 Then 排当前 + Pause、不早于 Starts,替旧期限。严格超过 Max 删期限,不在 Max 补抽,等于可抽。

抽后 Every 从实际回合算。10 交接,Pause 3、Starts 20、Every 5,先 20 再 25、30;无 Starts 先 13。Now 绕 Pause 立即抽,再从当前算 Every。

初始 Starts 与后来交接重排同一时钟,两独立故事应声明两个组。

Simulation 或模式 Turn.Max 限游戏,Turn.Ending 指结局。试过最后回合则执行结局非普通计算。Requires.Turn.Max N 只检查 ≤ N,不设期限。

游戏选择、教学与结果

Corporation、Rule 与 Scenario - 所选定义

新游戏前选公司、模式、开局设定。公司给玩家能力,模式定付款等规则,开局设定定地图和初始条件,三者任务不同。

MyCorporation 是新采掘加成公司,MyScenario 继承黄星 ScenarioG 常规开局,工人全资源保留,ExtraStart 额外矿物。新名称加 Text/zhCN.json。

先公司声明能力,完整例子再加呈现:

["MyCorporation", "Is", "Corporation"],
["MyCorporation", "Adds.Production.Minerals", 0.2]

选后玩家矿物率 +0.2,原 1 每派工 1.2,不生工人或工作前发矿物。

独立创建额外初始库存开局设定:

["MyScenario", "Is", "ScenarioG"],
["MyScenario.ExtraStart", "Adds.Minerals.Count", 20]

继承地图全开局,ExtraStart 一次额外 20,原 M 成 M + 20。不同部分名保父 Start,完整卡如下。

所选公司存玩家,Rule、Scenario 存 Simulation。单 Default true 初始,玩家明确选择优先。Name、Icon、Description 描述卡,玩家公司自定义名称用 InputName,非改卡 Name。

["MyCorporation", "Is", "Corporation"],
["MyCorporation", "Name", "MyCorporationName"],
["MyCorporation", "Icon", "corp_miner"],
["MyCorporation", "Color", "orange"],
["MyCorporation", "Adds.Production.Minerals", 0.2],
["MyScenario", "Is", "ScenarioG"],
["MyScenario", "Name", "MyScenarioName"],
["MyScenario", "Icon", "star_yellow00"],
["MyScenario", "Difficulty", "DifficultyNormal"],
["MyScenario", "Orbit.Center", "ClassG"],
["MyScenario.ExtraStart", "Adds.Minerals.Count", 20]

公司需名称图标,若选项用 Color 则全部设。玩家建议名 InputName 属公司。初始科技可公司 Has,游戏行动属地点并 Requires.Corporation。开局设定需 Name、Icon、Difficulty、明确 Orbit.Center。

派生开局设定也明确中心,初始奖励一次应用玩家。Start 全设主组合,ExtraStart 独立添加继承组合。

无自己 Start 就保全部 ScenarioG.Start。普通自身字段覆盖父同字段,但哪怕一条 MyScenario.Start 也替换整个父 Start,不只一资源行,所以额外用 ExtraStart。

["MyYellowScenario", "Is", "ScenarioG"],
["MyYellowScenario", "Name", "MyYellowScenarioName"],
["MyYellowScenario", "Orbit.Center", "ClassG"],
["MyYellowScenario.ExtraStart", "Adds.Science.Count", 3]

通常开局保留,独立加三科研点。完全替换需自己 Start 列全组合。一条 Start 的 Adds.Minerals.Count 不保其他父行。部分与复合谓词仍不同,期限地点要求后果在新游戏检查。

模式需 Name、Icon、Description,普通效果用 Multiplies、Adds、Blocks、Has、期限。已有期限普通效果可表达就不造 Rule 开关。菜单选择创建游戏时成事实,不追溯改已开始游戏。

初始资源可以取决于所选公司。不改变普通 Start,另为采矿公司添加独立部分:

["MyScenario.MinerStart", "Requires.Corporation", "CorpMiner"],
["MyScenario.MinerStart.Grant", "Adds.Science.Count", 5]

只有 CorpMiner 玩家会在开局时额外获得 5 科研点,且只发放一次。父部分 MinerStart 的条件同样约束嵌套的 Grant。初始库存预览会考虑所选公司。切换选择、再次应用场景或载入存档不会重复发放初始资源。这是有条件的开局发放,不是每回合收入。

Rule.* - 支持的游戏与场景设置

Rule.* 为已有设置,模式上选后生效,Simulation 上通用。新模式需 Rule、Name、Description、Icon。随意 Rule 后新名字不造法律,支持项如下。

区分游戏世界与呈现场景。游戏规则 Simulation 或模式,视图读当前场景,地图菜单可不同,改菜单标签不必改本局地图。

行动付款例子:选择建造立即付全款而非分期的模式。

先新模式取消定时长度,MyInstantMode 尚草稿,完整卡如下:

["MyInstantMode", "Multiplies.Action.Duration", 0]

有效期限零,但自身不保证瞬建,通常 Rule.ProgressTasks true 会改用派工任务。

再关闭此执行方式:

["MyInstantMode", "Rule.ProgressTasks", false]

与零期限组合则建造探索立即付全价完成。价 12、库 20,立即出现且剩 8。正期限仍是分期定时任务,单 false 不归零。完整可选模式如下。

积累研究是独立模式 Rule.AccumulatedResearch,等全库存,不扣分期、不占工人。各路径用同有效价,已付款及取消保各自含义。

["MyInstantMode", "Is", "Rule"],
["MyInstantMode", "Name", "MyInstantModeName"],
["MyInstantMode", "Description", "MyInstantModeDescription"],
["MyInstantMode", "Icon", "gear"],
["MyInstantMode", "Multiplies.Action.Duration", 0],
["MyInstantMode", "Rule.ProgressTasks", false]
  • Rule.AccumulatedResearch:布尔默认 false,true 研究等有效全价库存,其他行动不转积累。
  • Rule.ProgressTasks:布尔缺失 true,时间期限检查后决定工人任务或瞬时付款,不替普通事件寿命。
  • Rule.TradeWorker:声明资源引用,每单位贸易订单占一单位。Workforce 则用空闲池,无规则不占工人。

另一个任务允许无工人游戏,加到已有模式,与速度无关:

["MyInstantMode", "Rule.ExtinctionEnds", false]

工人少于一不因灭绝结束,零人也可继续,但董事会或其他结局仍有。下面是事件与结局设置。规模来源影响新事件,不会重新计算已保存的提案、价格和任务门槛。

  • Rule.ScaledByPlayer true 选择经济规模;Rule.ScaledByTurn true 选择回合规模,不能同时启用。休闲按玩家,经典与硬核按回合。未选择时按玩家。Scaled 价格、奖励、货物和任务门槛共用同一基准,包括 Requires.Scaled.Min/Max。
  • Rule.ScaledByPlayer.TechMod:科技系数,缺省为 0.05。基准 = 人口 ×(1 + 已完成科技数量 × 系数)。原版游戏使用 0.04。同一科技的重复等级不会增加科技种类数。这不是产量乘数。
  • Rule.ScaledByTurn.ResMin、Rule.ScaledByTurn.ResMax 和 Rule.ScaledByTurn.TurnWin 定义基准 = ceil(ResMin + (ResMax − ResMin) × ((Turn − 1) / (TurnWin − 1))²)。ceil 表示向上取整。设置为 5、3000、120 时,第 1 回合基准为 5,第 120 回合为 3000,之后继续增长。人口与研究不影响它。通用 Scaled K 数量为 max(1, floor(|K| × 基准)),K = 0 时也至少为 1。一次性 Adds 增量还保留 K 的正负号:负 K 表示损失,K = 0 给出 0。规模在事件出现时保存,后续回合或经济变化不会改变它。
  • Rule.ExtinctionEnds:布尔缺失 true,false 只关闭工人少于一的灭绝失败,保其他。
  • Rule.SuppressNotifications:布尔默认 false,true 抑普通通知,不取消后果。
  • Rule.EventWarns:true/false,默认 false。允许带 Warns.Turns 的事件使用预告,但不会自动为每个事件添加警告。预告期限、目标和资源见 Events 与 Event 条目。
  • Rule.ScaledByPlayer 和 Rule.ScaledByTurn 接受 true/false;结合模式、继承和 Simulation 设置后,两者不能同时启用。模式中明确的 false 可以关闭世界规则。按回合计算规模需要全部三个参数:ResMin 和 ResMax 必须有限且非负,ResMax 不小于 ResMin,TurnWin 大于 1。TechMod 必须有限且非负。

开局可免费揭示家园附近,创建时应用:

["MyInstantMode", "Rule.StartExplore", 2]

半径 2 按轨道和卫星嵌套,非屏幕像素。缺失仅家园揭示,修改不重揭已有地图。生成设置如下。

  • Rule.StartExplore:初始免费揭示半径,缺失仅家园,距离含轨道卫星嵌套非像素。
  • Rule.FlankOrbit:环号,不近于阈值天体放水平弧,轨道仍圆,缺失无此限。
  • Rule.SatelliteMinSize:生成卫星典型 Size 下限,缺失 0 不截。用类别明确 Size 或范围中点。单位随模拟,《前曲速时代》 为领土,不能一律当公里。

最后独立显示地图天体名称,Simulation 为游戏世界设置拥有者:

["Simulation", "Rule.MapNames", true]

开启当前游戏场景标签,不改库存产量组成。独立菜单场景设置不替游戏世界。其他视图输入项如下,各有职责。

  • Rule.Language:可重复语言代码如 zhCN、enUS,无列表则全部已载入,代码非显示名称。
  • Rule.Zoom:初始帧可见轨道数,正整数,无正值自动内容概览。
  • Rule.Zoom.Target:Center 或 Home,显示系统中心或母星。多个 Center 优先,缺省 Center,配 Zoom。
  • Rule.MapNames:布尔默认 false,当前场景地图标签。
  • Rule.OrbitMotion:布尔默认 false,true 给所有轨道体视觉运动,即使无物理周期。false 不普遍停止物理动画。
  • Rule.OrbitPauseOnSelect:布尔默认 false,选中暂停轨道运动。
  • Rule.WorkersSlider:布尔默认 false,开启滑块和工人显示,不创建人口资源、分配或工作岗位。
  • Rule.GuiSkin:全局皮肤字符串,默认 steel,另支持 classic,非任意 CSS 路径或新组件声明。
  • Rule.NoSubMaps:布尔默认 false,非装饰模式禁子地图。Decorative 影响平面区域,但保径向独立系统伴星。

检查生成改动需新游戏,改卫星最小尺寸或位置不重建旧图。界面设置不改资源库存和条件含义。

Tutorial 与 TutorialStep - 引导教学

教学由选家园、派一工、结束回合等步骤组成。Tutorial 连开局设定集合,TutorialStep 声明指令、锚点、完成条件,不需新界面面板。

完整数组存 Logic/Training.json,词典 Text/zhCN.json。新游戏选“教学系统”和采掘者。SmallTutorial 自定义三步,Homeworld 已有母星引用。

先单看第一步,完整文件后接开局设定集合:

["SelectHome", "Is", "TutorialStep"],
["SelectHome", "Order", 1],
["SelectHome", "Text", "SelectHomeText"],
["SelectHome", "Target", "Homeworld"],
["SelectHome", "Tutorial.Awaits", "Select"]

Order 1 第一,Text 指令键、Target 母星、Tutorial.Awaits Select 等玩家选择。显示不等完成,选择后第二步。

第二步等具体工人数而非选择:

["StaffHome", "Target", "Homeworld"],
["StaffHome", "Tutorial.Awaits", "Workers.Count"],
["StaffHome", "Tutorial", 1],
["StaffHome", "Tutorial.Unlocks", "Workers.Count"]

Tutorial 1 此处恰一自有工人在家园,零或二不符。Unlocks 允许本步调整,工作岗位仍来自星球。第三步 Requires.Turn 等时间推进,仅 Unlocks EndTurn 不检查。

三步接继承 ScenarioG 地图的开局设定。集合 Has CorpMiner 限采掘者,其他公司不替换也不得教学。Options 始终允许,Workers.Count 仅第二步。

[
  ["TrainingScenario", "Is", "ScenarioG"],
  ["TrainingScenario", "Name", "TrainingScenarioName"],
  ["TrainingScenario", "Orbit.Center", "ClassG"],
  ["TrainingScenario", "Tutorial", "SmallTutorial"],
  ["SmallTutorial", "Has", "CorpMiner"],
  ["SmallTutorial", "Tutorial.Unlocks", "Options"],
  ["SmallTutorial", "Has", "SelectHome"],
  ["SmallTutorial", "Has", "StaffHome"],
  ["SmallTutorial", "Has", "PassTurn"],
  ["SelectHome", "Is", "TutorialStep"],
  ["SelectHome", "Order", 1],
  ["SelectHome", "Text", "SelectHomeText"],
  ["SelectHome", "Target", "Homeworld"],
  ["SelectHome", "Tutorial.Awaits", "Select"],
  ["StaffHome", "Is", "TutorialStep"],
  ["StaffHome", "Order", 2],
  ["StaffHome", "Text", "StaffHomeText"],
  ["StaffHome", "Target", "Homeworld"],
  ["StaffHome", "Tutorial.Awaits", "Workers.Count"],
  ["StaffHome", "Tutorial", 1],
  ["StaffHome", "Tutorial.Unlocks", "Workers.Count"],
  ["PassTurn", "Is", "TutorialStep"],
  ["PassTurn", "Order", 3],
  ["PassTurn", "Text", "PassTurnText"],
  ["PassTurn", "Target", "EndTurn"],
  ["PassTurn", "Requires.Turn.More", 1],
  ["PassTurn", "Tutorial.Unlocks", "EndTurn"]
]

完整词典如下,已有文件加内部键保旧翻译:

{
  "TrainingScenarioName": "教学系统",
  "SelectHomeText": "选择您的母星。",
  "StaffHomeText": "在母星留下一个工人。",
  "PassTurnText": "结束回合。"
}

场景上的 Tutorial = TutorialName 关联教程,教程通过 Has 列出步骤。每步需要 Is TutorialStep、唯一且有限的正数 Order(允许 1.5 等小数排序值),以及指向提示文本键的 Text。Target 决定锚点和检查对象。没有 Tutorial.Awaits 或 Requires 的叙述步骤等待点击提示。

以下为支持目标,锚点是指令附着的已有对象按钮:

Homeworld 或天体类解析地图实例,Action(Technologies、EndTurn)解析按钮,EventChoice 选项、资源 Stat 玩家指标、Tech 科技卡、Event 活卡、Building 建造选项。

自造名不创锚点。Trade 用目标资源识别订单。Workers.Count 在天体和滑块间切锚点,Build.Class 在天体和建造按钮间。Tutorial.Marks Panel 高亮现有面板不创建。

  • Awaits Select 目标被选,Deselect 关闭窗口选择,Tooltip 显示目标提示。
  • Explore 已探索,Research 已研究,Build.ClassName 目标上自有成品建筑。
  • Workers.Count 配 Tutorial N 为目标恰 N 自有工人,Trade 配 N 为目标资源订单恰 N。步骤 Tutorial 数值,开局设定则引用。
  • Awaits 事件名表示玩家有该类卡,Unaffordable 表目标选项不再可支付。
  • Requires.Turn 等查游戏世界,Creates 进入时生成事件,Creates.Target 指地点。
  • 步骤 Unlocks 额外许可行动字段类别,集合上始终许可。只按当前步,不累积之前权限。
  • Marks Panel 高亮锚点面板,Side Above、Below 定位置,未设客户端按空间。

集合 Has 可限选择轴如单公司,教学暂停随机时钟,可逆条件撤销可回上步。Tutorial.Step、Tutorial.Done 为状态,不是手动跳过设置。占位读实时 {Workers.Count}、{Change.Water}、{Cost}、{Damage}、{Target.Size}、{ClassName.Cost}、{ChoiceName.Shortfall},翻译勿手写数字。

步骤既可由教程直接 Has,也可通过教程的条件部分加入。例如,带 Requires.Corporation CorpTechnocrat 且 Has 指向某步骤的部分,只会为技术官僚加入该步骤。条件针对当前玩家检查,直接步骤与合格的条件步骤合并、去重后按 Order 排序。如果教程还要面向其他公司,必须移除完整示例中的 Has CorpMiner 限制;用 Has 选择某轴的成员,与用 Has 加入 TutorialStep,是两种不同职责。

Tutorial.Awaits 也可指定已声明的行动,例如 Cloning。它检查玩家真正的 Completed 行动结果,而非仅检查按下按钮。Target Cloning 指定该行动已有的锚点;{Cost} 和 {Gains} 读取其当前实际费用和结果,不在文本中写死数量。

TutorialDisable 关闭教程,不重启世界,也不标记为完整通关。当前事件、工人安排和贸易订单都会保留。教程结束后,其专用暂停也会结束,但单独声明的 Events.Hold 不会被解除。Tutorial.Step 保存当前步骤的引用,而不是 Order 数字;这是存档中的运行状态,不应写进 Logic 来跳过课程。

History 与 Statistics - 历史与统计

History 记录真结果如建成、货到、提案到期。Statistics 数行动与流入,前者文字后者数字,不互代。

改彗星真收货历史,现有 CometReturn:

["CometReturn", "History", "MyCargoReceivedHistory"]

词典 MyCargoReceivedHistory 若为“已收到彗星货物。”,成功收集后出现。不创建彗星或发货。

只记录本局首前哨站:

["Outpost", "History", "MyLabBuiltHistory"],
["Outpost", "History.OnlyFirst", true]

首次完成写、后同类不写,不禁止再建。再加移民提案到期文字:

["CometReturn", "History", "MyCargoReceivedHistory"],
["Outpost", "History", "MyLabBuiltHistory"],
["Outpost", "History.OnlyFirst", true],
["SpaceFashion.Ignored", "Requires.Duration", 0],
["SpaceFashion.Ignored", "History", "MyOfferIgnoredHistory"]

替换已有结果文字,不靠 History 创建事件。Text/zhCN.json:

{
  "MyCargoReceivedHistory": "已收到彗星货物。",
  "MyLabBuiltHistory": "在 {target} 建成 {subject}。",
  "MyOfferIgnoredHistory": "移民提案已到期。"
}

History 存 Text 键。History.OnlyFirst true 留本局该类首次完成,History.Independent true 开独立序列。Simulation History.Begin 指初始公司成立事件。{subject}、{target} 插入保存的事物名称和目标名称,天体消失也保留。

Ignored 到期加文字,不创建或给效果。关窗、移除、到期不同,同时匹配不同历史文字报错。无 History 完成结果用自身 Name 或主事件名,未完成提案不因名称入史。

统计独立在玩家开启:

["Player", "Statistics", true]

独立检查:初库存零、无此前收入,真奖 5 后库存和 Received 都 5。花 3 库剩 2、Received 仍 5。总收非余额,计数由真实收入触发,非模组设想要的总数。

Seconds、Loads、Explored、Built、Studied、Received、Mined、Bought、Sold 游戏更新。价格货币识别资源,不需 Statistics.Resource.R 列表。History.Entry/Turn/Source、Statistics.Run 是内部,非作者命令或刷进度。 缺失的 Statistics 计数器按零读取,包括在 Requires 中,且不会因此创建事实。但这不证明历史完整:玩家没有自己的 Statistics.Loads,不代表从未载入过存档。

History.Hide 可将技术性通知排除在公司历史之外,而不隐藏通知本身。现有 TradeShortage 定义由贸易资源不足通知共用。本例隐藏它们的历史记录,再为矿物不足通知明确恢复记录:

["TradeShortage", "History.Hide", true],
["TradeMineralsShortage", "History.Hide", false]

该设置属于来源定义,通过 Is 继承;最近的显式 false 覆盖祖先的 true。隐藏的来源不会创建新的历史记录,隐藏的技术性通知外观也不会覆盖已有故事。读取历史时还会排除旧存档中该来源的记录,但不会删除其事实。通知图标、弹窗、期限和游戏效果仍然有效。History.Hide 同时屏蔽显式 History 文本和默认使用的事件名称。

Completed 与 Track - 已确认结果

Track 计真实行动结果,如已建后拆的前哨站,不计未完成。游戏保存 Completed 及环境,Track 读取,不自行建造执行。

Completed 可指行动、创建、生产、人口或结局。Requires.Completed 读当前检查结果,Requires.Completed.Credits.Min 查完成时钱,即使后来花掉。Logic 不手造,必须真实。

Track 名动作或对象计含 Is 后代。自定义观察名简单、不与内置字段谓词操作符冲突,可直接在条件读,无需 Predicate。Requires 附结果条件,不重复 Track 已指定内容。

计前哨站完成,自定义 MyBuiltOutposts:

["MyBuiltOutposts", "Track", "Outpost"]

三次为 3,拆一个不减,计完成非存量,在建不计。不需 Player Has 或 Predicate。

探索可要不同地点,观察 Explore 并定键:

["MyExploredPlaces", "Track", "Explore"],
["MyExploredPlaces", "Track.Key", "Completed.Target"]

Completed.Target 保存天体标识,普通名读次数、.Unique 不同键。两结果同目标则 2、1,仅说明计数,不承诺重复探索。全图还需固定列表。

["MyBuiltOutposts", "Track", "Outpost"],
["MyExploredPlaces", "Track", "Explore"],
["MyExploredPlaces", "Track.Key", "Completed.Target"]

CensusTask 要三前哨站,放同一 Logic 数组,词典加 CensusTaskName、CensusWonName、CensusLateName。

先查整局三完成,未来分支:

["CensusOutposts", "Track", "Outpost"],
["CensusTask.Done", "Requires.CensusOutposts.Min", 3]

二失败三通过,发任务前也计,后代也计。完整例采用此版。

要发后新增三,替换条件别同时留:

["CensusTask.Done", "Requires.CensusOutposts.Min.Add", 3]

发时已有二,固定阈值 2 + 3 = 5,三四未完、五完,不跟增长计数移动。保整局观察但要求新工作。

["CensusWon", "Name", "CensusWonName"],
["CensusLate", "Name", "CensusLateName"],
["CensusOutposts", "Track", "Outpost"],
["CensusTask", "Is", "Event"],
["CensusTask", "Name", "CensusTaskName"],
["CensusTask", "Icon", "outpost"],
["CensusTask", "Duration", 20],
["CensusTask", "Has", "CensusLate"],
["CensusTask.Done", "Requires.CensusOutposts.Min", 3],
["CensusTask.Done", "Has", "CensusWon"],
["CensusWon", "Is", "Event"],
["CensusWon", "Adds.Science.Count", 10],
["CensusLate", "Is", "Event"],
["CensusLate", "Is", "Failure"],
["RandomEvents", "Deck.CensusTask", 1]

全图用 Track.Key Completed.Target 区分天体,Track.Required Owner.Explored.Required 对比开局必探索列表,Requires.ChartedBodies.Covers true 要覆盖整个非空列表。ChartedBodies.Unique 仅计不同天体数,不证明覆盖。

Explored.Required、Researching.Required 由开局生成固定实例列表,不是任意声明,不把类别名写在稳定实例标识位。自定义集合用普通条件或 Goal,无通用任意 Required 作者机制。

["ChartedBodies", "Track", "Explore"],
["ChartedBodies", "Track.Key", "Completed.Target"],
["ChartedBodies", "Track.Required", "Owner.Explored.Required"],
["CensusTask.Done", "Requires.ChartedBodies.Covers", true]

最后一行 CensusTask.Done Requires.ChartedBodies.Covers true 另加必须探索全部初始要求天体的条件。仅查三前哨就别加,ChartedBodies 声明可独立用于其他任务。

Required 引固定列表,.Covers 查全,普通名仍读匹配数,Count 不替列表。不支持任意 Sum、Streak、Max、Track.Operation。重读加载不重计,历史不全不能证明无违规。

  • 真实结果发布时可读数字 Turn、BirthTurn、Duration、Age、Mission.Risk、Amount、Workers、Rate、Distance。
  • From、In、Previous、Target、Corporation、Scenario、Mode、Resource 是完成上下文引用或集合,不是每结果都有。缺失非零或成功。
  • Completed.R 和 Completed.R.Count 保存结果发生时资源 R 的库存。Completed.R.Delta 保存与 HUD 显示相同的数值变化,包括饥荒损失,并舍入到小数点后两位。普通净流量为正时,饥荒预测仍可能为负;快照保存的是这项显示的损失。以回合数表示的非数值增长预测不是资源变化量。Requires.Completed.Science.Min 20 比较历史科研点库存,而非当前库存。
  • EpisodeClosed、HistoryComplete 指可靠性,EpisodeKey、Sequence、Batch、Run 是内部标识顺序,可读不许可 Logic 伪造证据。

真实确认带上下文时可限单事件片段。现有 SpaceFashionBoost 增某提案货并保存确认,观察:

["MyEpisodeBoosts", "Track", "SpaceFashionBoost"],
["MyEpisodeBoosts", "Track.Scope", "Episode"]

同操作整局对比:

["MyRunBoosts", "Track", "SpaceFashionBoost"],
["MyRunBoosts", "Track.Scope", "Run"]

首提案付两次、第二一次,在第二真实确认中 Run 读 3、Episode 读 1。前两属别卡,只有游戏传真实结果及片段引用才能比较,普通活任务没有上下文。

Track.Scope 允许 Run(默认整局)或 Episode(单卡)。Track.Key 指稳定结果键,观察名读匹配数量,名.Unique 读不同键数。例如 Requires.MyBuiltOutposts.Min 3 要求三个已完成前哨。Episode 只读该卡证据,不借之前卡总数。

范围限制不把 CensusTask 变本卡观察者。读取需真实完成检查,游戏提供 Completed.Evidence 和 EpisodeKey。

普通任务 Requires 无此证据,返回无值。禁止在模组中伪写 Completed.Evidence。新任务用 Run 配 .Add 或 Goal,Episode 仅适用于实际记录归属的结果。

已完成片段计数保至下证据批,证据本身为持久结果。

官方成就在可改 Vanilla 外,启用模组禁成就。勿复制 Achievement.Eligible、Completed.HistoryComplete、内部证据号或运行时 Track 计数到 Logic。条件可读真实结果的 Completed.From、Completed.Target、Completed.In、Completed.Age 和 Completed.R 库存,无证据不算成功。

自制任务通常只需 Goal、Requires、结果。可用真实历史统计行动,不加官方档案奖励,那是模组任务外独立系统。

GameOver 与 Victory - 游戏结束

Event 的 Is GameOver 结束,另 Victory 胜利。原型建成 Then 接结局组,奖励图标本身不结束。

WarpDrivePrototype 已有建造科技价格地点,MyPrototype 继承可建,Then 改接只含 MyWin 的 MyWinDeck。

先声明胜利,不含调用路径:

["MyWin", "Is", "Event"],
["MyWin", "Is", "GameOver"],
["MyWin", "Is", "Victory"]

真触发才胜利停止,GameOver 停、Victory 标结果。声明不在载模组时触发。

关联原型真完成:

["MyWinDeck", "Is", "Events"],
["MyWinDeck", "Deck.MyWin", 1],
["MyPrototype", "Then", "MyWinDeck"]

组仅 MyWin,建成通过 Then 胜利。继承原型费用要求,结果窗呈现独立。

["MyPrototype", "Is", "WarpDrivePrototype"],
["MyWin", "Is", "Event"],
["MyWin", "Is", "Victory"],
["MyWin", "Is", "GameOver"],
["MyWin", "Name", "MyWinName"],
["MyWin", "Icon", "godtech"],
["MyWinDeck", "Is", "Events"],
["MyWinDeck", "Deck.MyWin", 1],
["MyPrototype", "Then", "MyWinDeck"]

真完成后触发显示胜利,费用条件仍在,不免费不自动。词典译 MyWinName,再独立改呈现。

结果 Has 可提供继承 FinalMenu 的窗口文字,动作统计用共享菜单,自造按钮名不生命令。MyResultScreen 标题说明,MyExplorersMedal 奖励类别名图,词典加三键:

["MyWin", "Has", "MyResultScreen"],
["MyResultScreen", "Is", "FinalMenu"],
["MyResultScreen", "Name", "MyResultTitle"],
["MyResultScreen", "Description", "MyResultDescription"],
["MyWin", "Is", "MyExplorersMedal"],
["MyExplorersMedal", "Name", "MyExplorersMedalName"],
["MyExplorersMedal", "Icon", "award_gold"]

奖励定义 GameOver MyWin 关联通知奖励与结局,不创建奖励选择系统。普通模组结局 Event + GameOver,胜利再 Victory。按时间金银用两事件、互斥 Requires.Turn、同 Then 卡组,普通适用规则选择,无独立奖励语言,不加官方成就。

奖励的 GameOver 连结果,GameOver.Evacuation 指撤离模式。Simulation GameOver 保存停止原因,true 可无原因停、false 不停。GameOver.Continued、GameOver.Plaque 是结果窗状态,非作者规则开关。仅支持的无撤离期限完整版胜利可继续时间。

结果 Has 最多一个适用 FinalMenu,需 Name、Description,现有菜单 Has 提供动作统计。Completed 通知仅一次,关窗不重复声奖历史。胜利继续后失败可替原因再开窗。

词语与关联

本节汇集描述对象及关联的词语,例如 Owner 指定所有者,PlacedAt 指定建筑位置。示例基于原版定义,请在新游戏中检查。数值仅用于说明规则。

完整文件标明路径,例如 Logic/Orbit.json,可整体复制。短例子可能仅展示一条变更记录,前面说明它补充哪个定义。如何把记录添加到已有文件,见“主体、谓词和值”的两个完整例子。

大型独立开局设定示例应放在独立模组中逐个测试,因为可能改变通用 Player 规则。开始下个例子前关闭前一个模组。若有意合并改动,且 Text/zhCN.json 已存在,请把新键加到对象内部,不要整体替换旧词典。

Predicate - 自定义词语

假设想用数字记录矿石品质,将新属性命名为 OreGrade。先告诉游戏,这个名称可以当作谓词:

["OreGrade", "Is", "Predicate"]

OreGrade 是自定义名称,Is Predicate 声明自己的语言词语。此时尚未设置任何星球的品质。

现在让微型岩质星球的矿石品质为 2。完整 Logic/OreGrade.json 同时包含声明和值:

[
  ["OreGrade", "Is", "Predicate"],
  ["TinyRock", "OreGrade", 2]
]

TinyRock 是现成微型岩质星球定义。第二行表示“TinyRock 矿石品质为 2”。改为 5 会改变保存的评分,但不会自动增加采掘量。评分与收入的联系必须另设游戏规则。

选择未使用的简单名称,不含点和实例编号。第二个自定义词也需自己的 Is Predicate,此许可不继承。即使是资源词,只有 Is Resource 也不够。名称不能与内置谓词重复,不能同时表示不兼容的值类型。

Type - 对象类型名称

对象可有自己的名称“我的空间站”,下方提示类型为“勘探站”。第二行由 Type 选择。例如为 MyTypeMarker 设置:

["MyTypeMarker", "Type", "SurveyStation"]

游戏使用 SurveyStation 键的翻译作为类型行。它不是标记的新名称,Name 仍指定“我的空间站”。改变 Type 只改变类型名称,不改变 Icon 图像,也不取得所选类别的属性。

完整例子在地球创建标记,同时属于勘探站和研究站两类。Type 决定提示称哪种类型。My 开头的名称及 SurveyStation、ResearchStation 均为示例自定义。第一块存为 Logic/Type.json,第二块存为 Text/zhCN.json,再开始新“太阳系”游戏。

[
  ["SurveyStation", "Is", "Building"],
  ["ResearchStation", "Is", "Building"],
  ["MyTypeMarker", "Is", "SurveyStation"],
  ["MyTypeMarker", "Is", "ResearchStation"],
  ["MyTypeMarker", "Type", "SurveyStation"],
  ["MyTypeMarker", "Name", "MyTypeMarkerName"],
  ["MyTypeMarker", "Icon", "outpost"],
  ["MyTypeMarker", "PlacedAt", "Earth"],
  ["MyTypeMarker", "Owner", "Player"]
]
{
  "SurveyStation": "勘探站",
  "ResearchStation": "研究站",
  "MyTypeMarkerName": "我的空间站"
}

地球上出现前哨站图像对象,自身名称“我的空间站”,类型“勘探站”。只将 Type 改为 ResearchStation 并新开游戏,类型变为“研究站”,名称和图像不变。此行直接查 Type 值的翻译(SurveyStation、ResearchStation),而非所选类别的 Name。

地图天体有时可省略类型。简单岩质星球变体:

["MyRock", "Is", "TinyRock"]

在地图创建 MyRock 时,游戏可用最近的适合类别 TinyRock 作类型,无需额外 Type TinyRock。自动选择适用于已放入地图格子的天体,格子关联在本局称为 Cell。没有 Cell 的建筑(如上方 MyTypeMarker)读取显式 Type。

再加第二个独立类别。SurveyedRock 是自定义星球类别:

["SurveyedRock", "Is", "World"],
["MyRock", "Is", "TinyRock"],
["MyRock", "Is", "SurveyedRock"]

MyRock 现在有两个独立 Is 分支,互不细化,因此无法唯一推导类型。明确选择 TinyRock:

["MyRock", "Type", "TinyRock"]

类型行显示 TinyRock 翻译。两个 Is 都保留,Type 不删除 SurveyedRock。

另一个办法是只将 SurveyedRock 用作独立标签类别。此方案删去 MyRock 自身 Type,再添加类别标签:

["SurveyedRock", "Tag", "SurveyedRockTag"]

词典加入 SurveyedRockTag,文字“已勘探”。有 Tag 的类别不参与自动类型选择,因此地图 MyRock 又可推导类型 TinyRock,同时保留两个 Is。“已勘探”是独立类别标签,不替换类型。其他用法见 Tag。

“固定系统与 Plane 边界”的 MyFixedSun 只继承一般 Star。Type MyFixedSun 明确选自身定义而非 Star。该例词典因此同时有类型键 MyFixedSun、恒星名称键 MyFixedSunName。这是选择名称,不是再次创建恒星或复制属性。

Able - 可用行动

允许在微型岩质星球执行地质勘探,在 TinyRock 定义加一行:

["TinyRock", "Able", "GeoSurvey"]

读作“微型岩质星球允许地质勘探”。TinyRock、GeoSurvey 都已存在。岩质星球从 Rocky 继承此许可,所以这行重复现有规则,仅说明 Able,不产生第二个按钮。

Able 允许提供行动,不取消行动要求。例如地质勘探需 MantleDrilling,要求写在 GeoSurvey 本身:

["GeoSurvey", "Requires", "MantleDrilling"]

没有科技,单有 Able 不能勘探。还需已探索适合天体及支付资源。价格和结果属于行动定义,自定义行动见 Action。

对象通过 Is 继承 Able,有效特质也可提供许可。Has 把对象加入组成,Able 允许行动,用途不同。

Imports - 其他模拟的库

Imports 使用另一已安装模拟的定义,例如星球类别,为模组增加依赖。它读取数据,不安装缺失模拟、插件或可执行代码。普通 《前曲速时代》 模组无需导入,原版定义已经可用。

指定模拟名称或“模拟/文件”路径,不写 .json。下例仅适合安装有 StarGenerator 及 Worlds 文件的版本,《前曲速时代》 不保证附带它们。

["Simulation", "Imports", "StarGenerator/Worlds"]

游戏载入该模拟 Logic/Worlds.json 定义,再载入其自身导入。文件不存在时无法创建新游戏,载入器报错。被导入游戏的主场景设置不应替换 《前曲速时代》 场景。

用库之前确认当前版本有必要图像、翻译和规则。载入它的定义不会把 《前曲速时代》 变成另一模式。

Owner - 所有者

Owner 回答“对象属于谁”。假设 MyMarker 已在地球,将它交给玩家:

["MyMarker", "Owner", "Player"]

《前曲速时代》 只有一位玩家,所以 Player 唯一确定归属。这行指定所有者,地图出现标记还需另行指定位置。

下例在地球创建前哨站图像对象,交给唯一玩家。请在有 Earth 的新“太阳系”测试。MyMarker 自定义,Building、Player、outpost 已存在。

["MyMarker", "Is", "Building"],
["MyMarker", "Icon", "outpost"],
["MyMarker", "PlacedAt", "Earth"],
["MyMarker", "Owner", "Player"]

PlacedAt 在已有地球创建对象,Icon 提供图像,Owner 关联已创建玩家。没有 PlacedAt 不会在地图产生标记。普通建造由 Build 行动指定所有者。

Owner 可指定具体已有对象或定义。本例 Player 定义让游戏找到据此创建的玩家。多个玩家时,此引用不表示“当前”或“最近”。他人存档的 Player_0 编号不能解决歧义。

可以沿所有者检查其储备。例如 WellFundedWorld 特质在星球所有者科研点足够时提供加成,条件为:

["WellFundedWorld", "Requires.Owner.Has.Science.Min", 100]

Owner 从星球到玩家,Has.Science 到玩家的科研点,Min 100 为下限。无 Owner 则检查星球自身储备。完整定义和加成启用见“条件来源与参数调整”。

每位玩家各自获得科技需要 Player Has <科技>。一个 Owner Player 的共享对象不能替代分别创建实例。

Parent - 来源实体

小行星事件有 Bombard 炮击按钮。玩家点击后,小行星本身应受伤。从按钮通向所属事件的 Parent 就是“父对象”关系。

Bombard 是现有小行星炮击选项。按钮位于小行星事件卡上,其 Parent 指事件卡,因此下例把伤害接受者设为卡本身。

["Bombard", "Damage.Target", "Parent"]

此行已在炮击定义中,是读取已有机制的示例,不是独立攻击。改变炮击力度应改 Damage,单有 Parent 不能创建武器。

有时需要父对象的目标而非父对象本身。实验结果 NanobotsEscaped 使用 Parent.Target:

["NanobotsEscaped", "Transforms.Target", "Parent.Target"]

Parent 从结果到实验事件,Target 从事件到所选星球,因此转变的是实验星球而非消息。完整说明见 Transforms。

若真实链中还有父对象,Parent.Parent 连走两步。事件和结果出现时由游戏创建关系。定义部分名称及他人游戏编号都不能替代关联。Parent 也不是 Is 继承或 Owner 归属。

PlacedAt - 对象位置

PlacedAt 回答“对象在哪里”。将 MyMarker 放在地球:

["MyMarker", "PlacedAt", "Earth"]

新“太阳系”会在 Earth 创建标记。这是初始放置,玩家不点建造也不支付价格。需要玩家操作的普通建造使用 Build。

完整指定标记,在模组 Logic 文件添加以下行:Is Building 指角色,Icon 选择现成图像,Owner 指归属。

["MyMarker", "Is", "Building"],
["MyMarker", "Icon", "outpost"],
["MyMarker", "PlacedAt", "Earth"],
["MyMarker", "Owner", "Player"]

使用“太阳系”的 Earth。MyMarker 是新对象,Building 是角色,outpost 是现成图像。PlacedAt 放在地球,Owner 交给玩家。开局设定没有 Earth 时,既不创建地球,也不创建其标记。

PlacedAt 可覆盖多个位置。独立方案中,地图已有两个作者星球 MyHostA、MyHostB,都属于 MyMarkerHost,而 MyMarkerHost 本身不在地图。星球请按 Orbit 放置,然后设置:

["MyMarkerHost", "Is", "World"],
["MyHostA", "Is", "MyMarkerHost"],
["MyHostB", "Is", "MyMarkerHost"],
["MyMarker", "PlacedAt", "MyMarkerHost"]

找不到 MyMarkerHost 本身天体时,游戏查其后代,在两个已放置星球各建一个标记。一个 PlacedAt 不表示“随机选星球”。标记自身 Owner、Name、Icon 与上例一致。

仅改变地图组成,额外放置 MyMarkerHost 本身。例如太阳系另一方案中明确指定中心与环:

["MyMarkerHost", "Orbit.Center", "Sun"],
["MyMarkerHost", "Orbit", 3]

存在已放置的 MyMarkerHost 实例时,查找优先选它,不再用 MyHostA、MyHostB 作为后备。标记只出现在直接位置,而非全部三个星球。精确定义优先于后代。为分辨星球可加通常的 Name、Icon,这里仅展示位置变化。

位置必须已存在地图上。若指定未来星球但尚未创建,标记暂不出现:

["MyMarker", "PlacedAt", "MyLateHost"]

MyLateHost 创建并取得 Cell 后,延迟放置可创建标记。仅有 MyLateHost Is World 定义而无天体不够。这是地图创建时等待位置,不是持续在未来星球生产标记的工厂。重新执行可能重建对象,不要用来每次累积实例。

若需玩家拥有,另设 Owner。PlacedAt 不通过普通 Is 继承,新定义必须明确指定。通过 Build 建造时由行动指定位置和所有者。

地图与天体生成

Center - 场景中心

恒星系地图由中心天体周围的环组成。Center 指该天体,通常是恒星。地图与恒星分别描述:地图保存格子布局,恒星保存属性及环数。接入新游戏的完整例子见“固定系统与 Plane 边界”。

先直接指定中心。MyMap 是地图名,Sun 是已有太阳定义,Center 关联二者:

["MyMap", "Center", "Sun"]

它不设置环数。环属于恒星本身,另加八环,两行如下:

["MyMap", "Center", "Sun"],
["Sun", "Orbits", 8]

自定义地图 MyMap 以 Sun 为中心,Sun 有八环。这些行不添加开局设定菜单卡,仍需完整例子的 MyFixedSystem 等定义。

《前曲速时代》 通过开局设定选择中心恒星,例如新的 SurveySystem 使用 ClassG:

["SurveySystem", "Orbit.Center", "ClassG"]

开局设定选择优先于 Center.Deck。SurveySystem 完整菜单接入见“开局设定”示例。单独地图上的一条 Center 不创建开局设定卡。

生成器还可有伴星。下面范围允许零至两颗:

["MyMap", "Center.Companions.Min", 0],
["MyMap", "Center.Companions.Max", 2]

没有 Center.Companions.Max 不生成伴星。此范围可能为零、一或二。要偏好一颗,保留范围并加 Peak:

["MyMap", "Center.Companions.Min", 0],
["MyMap", "Center.Companions.Max", 2],
["MyMap", "Center.Companions.Peak", 1]

一颗成为更可能的值,但上限仍为二,Peak 不保证恰好一颗。

伴星紧凑系统的大小另行指定。这里为一至两环:

["MyMap", "Center.Companions.Reach.Min", 1],
["MyMap", "Center.Companions.Reach.Max", 2]

没有这两个设置,上限是三环。两例只描述生成,不为 《前曲速时代》 增加系统间跳转按钮。

Orbits - 环、区域与卫星

先指定恒星环数,ClassK 为八环:

["ClassK", "Orbits", 8]

这是放置行星的八个恒星系环,不指定各行星卫星数。

再设置行星卫星数。GasGiantMedium 的 Orbits 对应卫星,范围使不同巨行星可有不同数量:

["GasGiantMedium", "Orbits.Random.Min", 0],
["GasGiantMedium", "Orbits.Random.Max", 2]

新中型气态巨行星有零、一或两颗卫星。额外 Orbits.Random.Peak 偏好范围内某数。随机数字选择见 Random。

卫星组成与数量独立。Orbits.Deck 最后写卫星类别,例如允许 TinyRock:

["GasGiantMedium", "Orbits.Deck.TinyRock", 1]

1 是卡组 TinyRock 卡数,不替代两颗卫星上限。系统全部卫星的总限制在中心恒星的 Orbits.Moons.Min、Orbits.Moons.Max。

回到恒星环,环分配给气候区。ClassK 宜居区权重:

["ClassK", "Orbits.Habitable.Weight", 2]

它与其他区域权重比较。八环、四个区域权重各 2 时,每区两个位置。每区计算 Orbits × 区域权重 / 所有正权重之和,四舍五入为整数,恰好一半向上。各区分别取整后的总和有时不等于 Orbits。

后代上的权重作为增量。假设 ClassK 宜居权重如上为 2,添加自定义恒星:

["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Weight", 1]

MyStar 宜居区权重为 2 + 1 = 3,这是分环前权重,不保证三颗行星。只将增量改零:

["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Weight", 0]

仍为 2 + 0 = 2,零不会删除继承区域。无继承贡献时,零权重排除区域。修改权重后确认仍有母星位置。

确定位置数后,选择宜居区星球。以下两卡提供类地和海洋星球:

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]

两个位置会随机顺序发出两种,只有一个位置则仅其中一种。卡组继承不同,会整体替换。保留上方 ClassK 两卡,在 MyStar 仅写自己的:

["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Deck.StandardEarthlike", 1]

MyStar 宜居卡组现在只有 StandardEarthlike,不追加父定义的 StandardOcean。自己的卡组不是区域权重那样的增量。删除自身卡组行会恢复 ClassK 全部组成。

物理模型可用温度边界描述区域。例如宜居区下限:

["ClassK", "Orbits.Habitable.Temperature.Min", 240]

单位开尔文。使用温度边界时,为所有正权重区域设置。全系统内边界另设:

["ClassK", "Orbits.UltraHot.Temperature.Max", 4000]

将全系统内边界从默认 5000 K 改为 4000 K。此用途须用 UltraHot.Temperature.Max,其他区的 Max 不能替代。

没有温度边界时,区域按声明顺序从内到外。《前曲速时代》 使用 UltraHot、Hot、Habitable、Snow、Outer。自定义区域可放天体,但不自动获得现有气候区经济效果。Orbits.Seeded 及发牌结果保存已完成生成,不写入模组。

Orbit - 环上位置

以 TinyRock 为基础给地球添加 MyMoon 卫星,先指定环绕对象:

["MyMoon", "Orbit.Center", "Earth"]

Earth 是“太阳系”的现有地球,其他无 Earth 开局设定不会因此创建地球。新定义必须明确写 Orbit.Center,普通 Is 不继承它。

再选环。以下放在地球第一环:

["MyMoon", "Orbit", 1]

Orbit 接受整数环号,零是中心。第一环六格,未指精确格子时游戏选空格。

选最上方编号 0 格,用 Orbit.Index:

["MyMoon", "Orbit.Index", 0]

从顶部顺时针计数。第二环 12 格、第三环 18 格,即环号 × 6。过大索引循环绕回。合并卫星角色与三个设置:

["MyMoon", "Is", "TinyRock"],
["MyMoon", "Orbit.Center", "Earth"],
["MyMoon", "Orbit", 1],
["MyMoon", "Orbit.Index", 0]

MyMoon 出现在地球第一环顶部。所选开局设定无 Earth 时不创建它。

每回合运动独立于初始格子。给天体每回合一格步长:

["Simulation", "Orbit.Step", 1]

每回合移动一格。Orbit.Step 为零或缺失则关闭运动,初始 Orbit.Index 不是速度。

关闭放置时的装饰漂移,则用地图另一设置:

["MyMap", "Orbit.Static", true]

MyMap 是 Center 条目的地图。Orbit.Static 关闭装饰漂移,不取消 Simulation 的回合步长。Orbit.Zone 保存已生成天体区域。当前 《前曲速时代》 不支持 Orbit.Distance.Max、Orbit.Star.Type.Not 作为位置过滤,请勿用来禁放。固定位置用 Orbit.Center、Orbit、Orbit.Index。Distance 条目的物理 Distance.Max 是另一量,不是生成器限制。

OrbitFill - 填充小行星带

小行星带占同环多个格子。OrbitFill 指填充比例,不需逐块放石。MyBelt 为新带名,RockyAsteroid 为现成岩质小行星。请在定义了 Sun 的新“太阳系”测试。

中心和环用 Orbit.Center、Orbit。新增 OrbitFill 0.6 填充 60% 环格,组合如下:

["MyBelt", "Is", "RockyAsteroid"],
["MyBelt", "Orbit.Center", "Sun"],
["MyBelt", "Orbit", 4],
["MyBelt", "OrbitFill", 0.6]

新“太阳系”在太阳第四环填充约 60%,前提有足够空格。空间不足只占可用格。通常范围 0 到 1,1 会填满整个可用环。

要让全部石块代表资源和行动共享的同一带,再加:

["MyBelt", "OrbitFill.Lead", true]

现在有一个主要对象,其他石块是显示片段。选择任一片段打开共享资源,不各有独立储备。关联由游戏创建。

Trojans 与 TrojansOf - 特洛伊群

特洛伊群是行星轨道前后约 60° 的两组小天体。先使巨行星可能获得它们:

["Giant", "Trojans.Chance", 20]

每个新巨行星有 20% 概率获得 Trojans 特征。这仅决定是否有群,还没描述群的石块。

GiantTrojan 是基于 RockyAsteroid 的新类型。TrojansOf Giant 将其关联巨行星,连同概率如下:

["Giant", "Trojans.Chance", 20],
["GiantTrojan", "Is", "RockyAsteroid"],
["GiantTrojan", "TrojansOf", "Giant"]

部分巨行星同环前后出现 GiantTrojan 群,不会生成原本不存在的巨行星。作者系统可在 TrojansOf 指具体行星。写在新群类型,别写在通用 RockyAsteroid,否则影响所有这种小行星。TrojansOf.Seeded 标记放置完成,模组无需内部事实。

Plane - 矩形地图

Plane 描述六边形格组成的矩形区域。这是通用引擎功能,《前曲速时代》 尚无包含恒星和玩家母星的完整游戏示例,本条只解释格式。可玩自定义开局设定请用“固定系统与 Plane 边界”的环系统。用 Plane.Cols、Rows 替换 Orbit.Center 不会创建这样的开局设定。

先是地图尺寸。九列五行:

["MySector", "Plane.Cols", 9],
["MySector", "Plane.Rows", 5]

形成 9 × 5 六边形格场地。两者须为正整数。省略 Plane.Rows 时高等于宽,此例变 9 × 9。

接下来是填充空格的恒星卡组。给已有尺寸加入权重 4 的 ClassG:

["MySector", "Plane.Cols", 9],
["MySector", "Plane.Rows", 5],
["MySector", "Plane.Deck.ClassG", 4]

4 是 ClassG 卡权重,不是宽度或保证恒星数。先放声明的家园系统,再发牌填剩余格。这只描述几何和发牌,不接入 《前曲速时代》 新游戏或创建地图跳转。Plane.Homed、Scattered、ColonyMinted 标记已生成对象,不复制到模组。

Spawn - 玩家母星

Spawn 选母星,可指定天体或从适合星球中选择。它们必须真实存在地图。Earthlike 是类地类别,Homeworld 是具体玩家已选家园的引用。StandardOcean 不属于 Earthlike,不能替代类地开局。

预设母星用 Spawn。在“太阳系”可从已有地球开始:

["Player", "Spawn", "Earth"]

选具体定义,只适用于真实创建 Earth 的地图。单行 Spawn 不创建缺失行星。

随机地图在 Spawn.Random 指类别而非行星名:

["Player", "Spawn.Random", "Earthlike"]

从已生成地图随机选 Earthlike,Homeworld 随后引用家园。StandardOcean 非 Earthlike,仅有海洋星球不适合此开局。

false 关闭随机选择。例如另一个 Player 定义有显式 Spawn Earth,可取消继承随机选项:

["Player", "Spawn.Random", false]

Spawn.Random 接受类别名或 false,不接受 true、数字。两者同时存在时,显式 Spawn 优先。初始设置针对新游戏,改文件不移动现有玩家家园。

随机系统保证开局需至少创建一个 Earthlike。只有一个位置且组内还有 StandardOcean 时,再大权重也不保证家园。完整例子见“自定义恒星与保证母星”。Spawn.Lost、OriginKey 保存本局历史,不复制存档。

Grid 与 AutoSelect - 地图呈现

Grid 选择已有地图视图。保留 《前曲速时代》 通常天体呈现:

["Simulation", "Grid", "Decorative"]

改为 Hex 会显示六边形网格。改变外观而非环数,环数仍用 Orbits。矩形几何属于 Plane。

鼠标选择另设。地球已有 PlacedAt 的 MyMarker,要防止点击行星自动选中标记:

["MyMarker", "AutoSelect", false]

标记位置和归属不变,仅自动点击选择改变。无 AutoSelect 用通常行为。

同一 false 放地图结果不同,独立方案写 Simulation:

["Simulation", "AutoSelect", false]

点击选择格子而非天体。前例地图仍选天体,仅标记不截获点击。差别由记录接受者 Simulation 或 MyMarker 决定。

例如 MyMarker 已按 PlacedAt 放在行星。下例保留装饰视图,禁止标记截获点击。标记仍须单独放置,AutoSelect 不改归属或允许建造。

["Simulation", "Grid", "Decorative"],
["MyMarker", "AutoSelect", false]

同一位置多个对象时,可优先选玩家控制的:

["Simulation", "AutoSelect.Controllable", true]

优先级作用于自动选择,不赋予控制他人对象的权利。

Cell 与 OrbitSlot - 运行中星球的位置

Cell 保存已创建天体的格子,是本局内部关联。模组用 Orbit 指中心、环与位置,具体 Cell 地址由游戏写,避免依赖他人游戏编号。

Cell 引用具体场景格子,在放置时出现,不决定星球类别。OrbitSlot.* 保存生成天体的轨道槽计算信息。不要从某局复制地址和结果。固定位置用 Orbit、Orbit.Center、Orbit.Index,生成用 Orbits 或 Plane。

["MyMoon", "Is", "TinyRock"],
["MyMoon", "Orbit.Center", "Earth"],
["MyMoon", "Orbit", 1]

“太阳系”中添加地球岩石卫星,游戏在第一环放置并赋予 Cell,无需他人存档格子或实例编号。没有 Earth 的开局设定不创建地球。

随机选择

Seed - 游戏种子

种子是生成随机结果的数字。相同游戏和模组文件、种子、行动顺序可复现一局。测试模组时可在同样开局只改一个参数进行比较。规则改变后,相同种子不保证相同地图。

Simulation 的 Seed 为 0 到 2147483647 整数。菜单提供至 99999,文件允许完整范围。未选择时游戏随机分配。下例提供种子 42。

["Simulation", "Seed", 42]

玩家创建新游戏时可选其他种子,覆盖模组。Seed.Rng.<键> 供开发者测试单独随机结果,普通平衡修改不需要。

Random - 随机数字

让新 MyRock 星球尺寸在 1 至 3 之间,在新定义设置 Size.Random 两个边界:

["MyRock", "Is", "TinyRock"],
["MyRock", "Size.Random.Min", 1],
["MyRock", "Size.Random.Max", 3]

每个新 MyRock 获得范围内自己的数值。结果保存,再开提示不重抽。新类别要另放到地图或加入星球卡组才能看见。

边界须为数字,Min 不大于 Max。两者都需要,但可从父定义获得一项或两项。把 Size 换其他数值字段,会在其规则支持 Random 时随机选择该字段。

要精确离散为 1、2、3,加步长 1:

["MyRock", "Size.Random.Step", 1]

没有其他分布设置时,三个值等概率。步长须为正。无 Step 时,整数边界使随机数取整,这是另一种选择方式,不保证各整数概率相同。写 1.0 而非 1 不改变此规则。

要让约 2 的尺寸更常见,设置分布峰值:

["MyRock", "Size.Random.Peak", 2]

Peak 2 偏好 2 附近。Peak true 选范围中点,Peak false 保持均匀。Peak 与 Step 同用时,结果按步长取整。

大范围可用独立幂律分布。此独立 MyWeightedRock 例子中小尺寸更常见:

["MyWeightedRock", "Is", "TinyRock"],
["MyWeightedRock", "Size.Random.Min", 1],
["MyWeightedRock", "Size.Random.Max", 100],
["MyWeightedRock", "Size.Random.PowerLaw", 1]

正范围内,正 PowerLaw 偏好小数值,负值偏好大值,零均匀。密度与数值的负指数次幂成正比,指数 1 时,相同比率的区间等概率。PowerLaw 优先于 Peak,此例不要再加峰值。

也可列出值代替范围,例如只允许尺寸 1 或 3:

["MyListedRock", "Is", "TinyRock"],
["MyListedRock", "Size.Random", 1],
["MyListedRock", "Size.Random", 3]

两个值等概率,不能与该字段自己的 Min、Max 混合。

有些字段自带离散规则,例如回合期限仍为整数,小数范围不取消它。Min、Max 不允许无穷或非数字。把原始 MyRock 步长例子组合如下:

["MyRock", "Is", "TinyRock"],
["MyRock", "Size.Random.Min", 1],
["MyRock", "Size.Random.Max", 3],
["MyRock", "Size.Random.Step", 1]

新 MyRock 等概率取得 1、2、3。加入星球卡组或用 Orbit 放置才能看见。新定义固定 Size 且无自身范围时,会替换继承随机尺寸。Random.Prior、Drawn、Source 保存已完成选择,不写入模组。

Chance - 特征概率与结果几率

Chance 设置概率。先看星球特征:中型气态巨行星可能有特洛伊群,设 20%。

本例 Trojans 是“有特洛伊群”的特征,Chance 是取得它的概率,数值 0 到 100。

GasGiantMedium 为现有中型气态巨行星,仅改 Trojans 概率。群的放置见 Trojans、TrojansOf。事件风险改法见 EventChoice、Failure,那里 Chance.Target 指具体事件结果。

["GasGiantMedium", "Trojans.Chance", 20]

各新巨行星独立以 20% 获得特征,失败保存 false。不保证每五次恰好一次成功。特征已设定则不再抽取。

事件可将概率作为独立参数。例如 RobotUprising 的 Capture 从三种捕获几率中选一种:

["RobotUprising.Capture", "Chance.Deck.20", 1],
["RobotUprising.Capture", "Chance.Deck.30", 1],
["RobotUprising.Capture", "Chance.Deck.40", 1]

选择 20%、30% 或 40%。Chance.Deck 后是可能百分数,第三值 1 是卡数。Chance.Name 指参数标签,例如该起义 Capture 部分的 CaptureChance。

玩家还可改善同起义的另一参数:夺回已占区域的概率。已有 UprisingTroops 按钮:

["UprisingTroops", "Chance.Add", 15],
["UprisingTroops", "Chance.Target", "Parent.Retake"]

点击让父事件 Retake 增加 15 个百分点,例如 20% 到 35%。Chance.Target 必填,指定哪个几率改变。结果限制在零和 Chance.Max,默认上限 100%。Chance.Add 不可为零。这是事件参数操作,不是重新抽星球特征。

Changes - 选择一种类型

Changes 在预定义变体中选择一个,改变图像和属性并保留对象本身。所选变体成为 Type。完全换成另一类别天体用 Transforms,可能摧毁原建筑。

新微型星球 MyBody 有 SurveyVariant 外观,Changes 关联星球类别,变体 Icon 设置新图像:

["MyBody", "Is", "TinyRock"],
["SurveyVariant", "Changes", "MyBody"],
["SurveyVariant", "Changes.Chance", 100],
["SurveyVariant", "Icon", "earth"]

唯一变体权重 100,所以 MyBody 创建时选其作 Type,并获得 earth 图像。另用 Orbit 放置或加星球卡组才能看见,不改变其他行星类别。

允许跳过,只让部分星球获得变体。把权重改为 25:

["SurveyVariant", "Changes.Chance", 25]

没有其他适合变体时,首次 25% 选 SurveyVariant,75% 无变体。无显式权重默认 100。再改为两种外观之间选择:

["SurveyVariant", "Changes", "MyBody"],
["SurveyVariant", "Changes.Chance", 100],
["SurveyVariant", "Icon", "earth"],
["OtherVariant", "Changes", "MyBody"],
["OtherVariant", "Changes.Chance", 100],
["OtherVariant", "Icon", "ice"]

总权重 200,两者各一半,不是各保证 100%。一个 MyBody 取得一种外观,条件可排除变体。已选变体在条件满足期间保留。

要不放回抽外观,可给 MyBody Type.Deck 代替普通概率:

["MyBody", "Type.Deck.SurveyVariant", 1],
["MyBody", "Type.Deck.OtherVariant", 1]

卡组先于 Changes.Chance 权重选择,两种变体各一张。按下条 Deck 规则消耗。Type 成为所选变体名,属性应用于原对象。完全换天体用 Transforms。Changes 和 Type 卡组都不替代 Is 继承。

Deck - 不放回抽取

卡组不放回抽取,抽出的卡从集合消失,耗尽后恢复组成。例如两张不同星球卡抽两次必出两种,独立 Chance 则可能两次同种。Deck 描述卡,抽取时机由使用它的规则决定。

给 ClassK 宜居区各一张类地和海洋卡:

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]

原版 ClassK 此区两个位置,第一次随机,第二次取剩余,不会两张连续同种。耗尽后若机制请求再抽则恢复卡组。

可增加卡数。例如三张类地、一张海洋:

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 3],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]

首次类地概率为海洋的三倍。选类地后剩两张类地、一张海洋。区域两个位置仍仅两个星球,卡数不创建额外位置。

独立卡组直接以 Deck 开头,属于特定属性则在 Deck 前写属性。例如 Deck.Supplies 是随机事件卡,Orbits.Habitable.Deck.StandardOcean 是宜居区星球。使用卡组的规则决定抽取时机。

普通事件和天体卡组允许小数权重。例如:

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 0.5],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1.5]

首次权重比 0.5 对 1.5。选 StandardOcean 后减 1,剩 0.5、0.5。再选 StandardEarthlike 则减其全部 0.5,只剩海洋 0.5。小数权重不产生半个星球,耗尽后恢复。

零和负卡不参与,负值不删除继承卡,删除需补丁。Orbits 展示父卡组与子卡组:自身组成整体替换旧组成,不像区域权重相加。

资源卡描述采掘而非星球类别。例如 Deck.Energy.2.1 表示每工人能源产量 2.1,第三值是卡数。这种卡数量必须为非负整数,产量必须正。Deck.Energy 引用共享卡组,其内 Deck.Resource 指星球允许资源之一。完整例子见“新采掘资源与延迟探索”。不支持 Energy.Deck.* 顺序。

事件卡暂不满足条件会留在组中。游戏在 Deck.Pool、Deck.Drawn 保存剩余卡与抽取次数,不移入模组。

星球的尺寸、物理与描述属性

普通 《前曲速时代》 的尺寸、工作岗位和采掘使用游戏数值,不需要完整行星物理模型。模组也可不导入其他模拟就描述质量、气压、组成和自转。所需数据见“无需外部库的物理字段”。这些属性不自动创建新的殖民或采掘规则。游戏自行计算的值无需再固定重复。

Size - 领土或直径

尺寸决定天体在 《前曲速时代》 游戏尺度中的大小,并参与工位数计算。它不是公里。破坏可使尺寸降至声明阈值,随后天体消失或成为残骸。

微型岩质星球游戏尺寸设为 3:

["TinyRock", "Size", 3]

新 TinyRock 的游戏尺寸为 3,不是三公里。

区分下限与死亡,需要不带 World 的 CelestialBody 测试体 MySizeBody。普通星球已从 World 继承死亡规则,TinyRock 看不出区别。仅设尺寸和下限:

["MySizeBody", "Is", "CelestialBody"],
["MySizeBody", "Size", 3],
["MySizeBody", "Size.Min", 0]

创建后尺寸减少至零就停止。Min 本身不表示死亡,此版本无 Size.Dead。再加零死亡规则:

["MySizeBody", "Size.Dead", 0]

先应用 Size.Min,再检查 Size.Dead。尺寸零时 MySizeBody 现在死亡,改变的是死亡阈值,而非数字限制方式。

Size.Dead.Transforms 可在死亡后留残骸。普通 TinyRock 已从 World 得到下限、死亡和转变,以下明确重复以一起阅读:

["TinyRock", "Size", 3],
["TinyRock", "Size.Min", 0],
["TinyRock", "Size.Dead", 0],
["TinyRock", "Size.Dead.Transforms", "Debris"]

TinyRock 是现有微型岩质星球,Debris 是残骸。新星球尺寸 3,降为零时替换成残骸。Size.Max 是显示范围上限,不禁止一切尺寸增长。

物理描述可在天体、类别或 Simulation 设 Size.Measure Kilometers,Size 就是公里直径,计算相对面积 Size.Area,不应用游戏尺寸死亡阈值。但游戏能力仍可能以同一 Size 计算工位数。12742 直径不会自动换成普通 《前曲速时代》 领土尺度,因此必须另查经济,不适合单纯外观修改。

Weight、Density 与 Gravity - 质量、密度和重力

物理地球质量以 Weight、公斤表示:

["Earth", "Weight", 5.972e24]

5.972e24 表示 5.972 × 10²⁴ 公斤。字段叫 Weight,Mass 不能替代。Weight.Min、Weight.Max 若需要,是显示质量范围。

从质量计算密度和重力还需直径。此物理例子的 Size 单位为公里,添加地球直径 12742:

["Earth", "Size.Measure", "Kilometers"],
["Earth", "Size", 12742],
["Earth", "Weight", 5.972e24]

现在可算 Density(克/立方厘米)和 Gravity(地球 g),地球重力约 1。将游戏 Size 换公里也改变工位数规则读取的量,普通图像修改不需这样做。

也可已知直径和密度,计算质量。不单设 Weight,保留 Kilometers 的 Size 并写:

["Earth", "Density", 5.51]

密度为 5.51 克/立方厘米,配合直径算缺失质量。质量和密度也可算缺失直径。质量直径都已设时将决定密度,不要把三者设为相互矛盾独立数。极高质量的小天体可能被物理模型变为黑洞。

Distance - 距离与物理轨道

有两种距离。物理 Distance 是距恒星或行星的距离,用于加热和运动。Distance.Home 是按环算距玩家家园的偏远度,可改变行动价格,不要混用。

先设地球到太阳物理距离,默认公里,CentralBody 指参照对象:

["Earth", "Distance", 149597870.7],
["Earth", "Distance.CentralBody", "Sun"]

距 Sun 约 1.496 亿公里,不是游戏环号。Distance.Min、Distance.Max 可显示距离范围。

添加 Distance.OrbitalPeriod 描述公转周期:

["Earth", "Distance", 149597870.7],
["Earth", "Distance.CentralBody", "Sun"],
["Earth", "Distance.OrbitalPeriod", 8766]

8766 为小时。正周期允许装饰性公转,零或缺失则图像静止。设置不创建天体,使用已有 Earth、Sun。

轨道离心率另以百分比指定。用距离 100000 公里、10% 举例:

["MyOrbitBody", "Distance", 100000],
["MyOrbitBody", "Distance.Eccentricity", 10]

若未预设 Min、Max,则计算 Distance.Min 90000、Distance.Max 110000,即均距 ±10%。离心率零为圆轨道,此计算不另加 Min/Max。显式边界优先,不再按离心率重算。

地心距离标签可用地球半径。这是独立描述,不是物理模型的公里换算:

["MyGeocentricMoon", "Distance", 60],
["MyGeocentricMoon", "Distance.Measure", "Earths"]

显示 60 地球半径而非 60 公里。描述相同距离需作者自行除以地球半径,例如 382260 公里约为 60 × 6371 公里。但 Distance.Measure 只改标签,物理仍以公里读取 Distance。因此不要将此片段与加热、质量计算当作自动单位转换使用。

地心模型另有参考字段:Distance.Epicycle 是附加运动圆半径,Distance.Epicycle.Period 是小时周期。Distance.Eccentric 是主圆中心相对观察点偏移,Distance.Equant 是相对其看似匀速的点距。三距离都用 Distance.Measure 单位。《前曲速时代》 只显示描述,不构成完整地心地图,普通模组不需要。

偏远度另算。《前曲速时代》 原点与单位为:

["Simulation", "Distance.From", "Homeworld"],
["Simulation", "Distance.Home.Measure", "Orbits"]

原点是玩家母星,单位是环。游戏自行算 Distance.Home,卫星用其行星位置,不要给每类写结果。规则按单一母星设计,非多个独立家园。

Temperature - 温度

《前曲速时代》 的 Temperature 关联冷热游戏特征,物理模型则表示开尔文。含义由所用规则决定,不能把普通 《前曲速时代》 游戏数值当物理温度。

普通 《前曲速时代》 的 StandardEarthlike 初始游戏值为零:

["StandardEarthlike", "Temperature", 0]

不表示绝对零度,原版特质将游戏属性与轨道区关联。冷热附加规则仍是游戏规则。

物理描述可直接设地球开尔文:

["Earth", "Temperature", 288]

288 K 约 15 °C。游戏保存开尔文,显示摄氏度。无加热计算输入则保留显式值。完整独立物理星球见“无需外部库的物理字段”。

计算温度时,给恒星太阳光度 1,星球距恒星 149600000 公里及中心引用:

["MyWarmStar", "Luminosity", 1],
["MyWarmWorld", "Distance", 149600000],
["MyWarmWorld", "Distance.CentralBody", "MyWarmStar"]

创建此物理星球后,模型写 Temperature 278 K,约 4.85 °C。是无大气修正的简化恒星加热,不是地球气候预报。My 为自定义,放置见 Orbit 和完整物理例子。

把这个计算结果提高 10%,给相同三输入再加一行:

["MyWarmWorld", "Temperature.Modifier", 1.1]

278 × 1.1 = 305.8 K,约 32.65 °C。乘数作用于开尔文,非摄氏度。须为正,默认 1。

卫星中心是行星,但热源仍是恒星。给原先无 Modifier 的版本添加卫星:

["MyWarmMoon", "Distance", 100000],
["MyWarmMoon", "Distance.CentralBody", "MyWarmWorld"]

链从卫星到 MyWarmWorld,再到 MyWarmStar。加热用行星距恒星 149600000 公里,不是距行星 100000。无自身 Modifier 则同样 278 K。Temperature.Min、Max 描述范围,不代替距离光度。

Age - 年龄

Age 以年描述年龄,可作说明及特质条件。其他输入齐全时,地质和潮汐物理也读取恒星年龄。

太阳 46 亿岁:

["Sun", "Age", 4.6e9]

4.6e9 是 4600000000。Age 是已过去的年数,非回合期限,结束回合不自动增加年龄。

演化时间独立,例如主序结束年龄 Age.LifeSpan:

["Sun", "Age.LifeSpan", 1e10]

是自出生一百亿年,不是从当前回合再等一百亿年。Age.WhiteDwarfBirth 同样保存形成白矮星年龄。真正阶段转变需独立规则。年龄物理用途见 Geology、Rotation。

Luminosity 与 Metallicity - 光度与金属丰度

Luminosity 是相对太阳的辐射功率,太阳为 1:

["Sun", "Luminosity", 1]

用于物理行星加热及温度区位置。2 是太阳两倍功率,不是 Energy 资源产量。

Metallicity 是重元素相对含量,1 同为太阳水平,但描述组成而非辐射。两个独立属性:

["Sun", "Luminosity", 1],
["Sun", "Metallicity", 1]

Sun 得到太阳光度和金属丰度。普通 《前曲速时代》 恒星不必设置这些。无正 Luminosity 时,生成器只为区域布局用太阳值,不写成恒星属性。

Atmosphere - 大气与云

先设置空气性质,地球可呼吸大气:

["Earth", "Atmosphere", "Breathable"]

Breathable 为现有可呼吸标识,换 Suffocating 则不宜无防护呼吸。这是环境性质,不是资源储备。

压力与宜呼吸性分别设置。一个地球大气压:

["Earth", "Atmosphere.Pressure", 1]

2 是两个大气压。只有压力 1 不意味可呼吸,组成和性质另有事实。

组成在 Atmosphere.Gas 后写化学式,第三值为百分比:

["Earth", "Atmosphere.Gas.N2", 78],
["Earth", "Atmosphere.Gas.O2", 21]

显示 78% 氮、21% 氧,不自动凑到 100% 或归一化。组合性质、压力和组成:

["Earth", "Atmosphere", "Breathable"],
["Earth", "Atmosphere.Pressure", 1],
["Earth", "Atmosphere.Gas.N2", 78],
["Earth", "Atmosphere.Gas.O2", 21]

四记录都描述同一大气,分别回答能否呼吸、压力和气体。性质标签用 AtmosphereBreathable 一类键。

物理模型也可根据大气质量算压力。地球直径和重力条件下:

["Earth", "Atmosphere.Mass", 1]

这是一个地球大气质量,不是行星质量比例。无 Atmosphere.Pressure、直径 12742 公里、Gravity 1 时,得到 1 大气压。同星球 Atmosphere.Mass 2 得 2 大气压。显式 Atmosphere.Pressure 优先,检查质量计算时应删去。

云图像独立于物理计算:

["Earth", "Atmosphere.Clouds", "clouds_up"]

clouds_up 是图像家族,游戏为已创建星球选定并保存具体变体。云不产收入,本身不代表可呼吸。

窒息有毒大气需两种性质,不保留 Breathable:

["Earth", "Atmosphere", "Suffocating"],
["Earth", "Atmosphere", "Toxic"]

只看大气宜居贡献,不含水和气候。独立测试星球以 Habitability 0 开启计算,仅设可呼吸空气与压力 1:

["MyAirWorld", "Habitability", 0],
["MyAirWorld", "Atmosphere", "Breathable"],
["MyAirWorld", "Atmosphere.Pressure", 1]

无 Hydrography、Temperature 时其他项零,Habitability.Human 得 4。独立方案中用以下两性质替换 Breathable,不与它并存:

["MyAirWorld", "Habitability", 0],
["MyAirWorld", "Atmosphere", "Suffocating"],
["MyAirWorld", "Atmosphere", "Toxic"]

此隔离组合 Human 为 -1,窒息有毒空气有惩罚。Toxic 也可用 MildToxic、HighlyToxic、LethalToxic。再加性质:

["MyAirWorld", "Atmosphere", "Corrosive"]

Suffocating + Toxic + Corrosive 让 Human 从 -1 变 -2。Corrosive 加重此组合惩罚。另案仅有 Corrosive、无 Breathable、Suffocating、Toxic 时,大气贡献为 0 而非 -2。数值 Atmosphere.Toxic 是独立作者评分,不替代字符串性质。各方案互相替换,不要全部堆在文件。

可呼吸大气识别不利性质 ChlorineFluorine、SulfurCompounds、NitrogenCompounds、OrganicToxins、LowOxygen、Pollutants、HighCarbonDioxide、HighOxygen、InertGases。自定义名称不会自动受罚。环境评分见 Habitability,不收发游戏资源。

Hydrography - 地表及地下物质

指定地球表面主要物质为水,用 H2O:

["Earth", "Hydrography", "H2O"]

只选物质,还未设水量,也未产生可采 Water 资源。

再指定水覆盖 71% 地表:

["Earth", "Hydrography.Surface", 71]

Surface 为所选物质总覆盖百分比。区分液固还需温度,完整 Earth 片段加 288 K:

["Earth", "Hydrography", "H2O"],
["Earth", "Hydrography.Surface", 71],
["Earth", "Temperature", 288]

补充“太阳系”Earth,水覆盖 71%、温度 288 K。游戏计算 Hydrography.SurfaceLiquid、SurfaceSolid。已有总 Surface 就不用固定计算后的各相。地下比例独立,此描述水不成为可采 Water。

第二种物质有自己的字段,例如甲烷覆盖 5%:

["Earth", "Hydrography.Type2", "CH4"],
["Earth", "Hydrography.Type2.Surface", 5]

水与甲烷独立描述。第二物质结果为 Hydrography.Type2.SurfaceLiquid、SurfaceSolid,第三用 Type3。地下比例为同路径的 SubsurfaceLiquid、SubsurfaceSolid,显示取决于界面能力。

相态模型识别水 H2O、硫 S、二氧化硫 SO2、氨 NH3、甲烷 CH4、氮 N2、二氧化碳 CO2、硫酸 H2SO4,不猜测任意新名称熔沸点。

Life - 生命迹象与概率

Life 描述生命及可能支持生命的环境。“可能有复杂化学”或“概率 100%”不创建生物、人口或工人。生命存在与概率评估是不同事实。

先命名生命类型,Life 写词典键:

["Earth", "Life", "MyLifeType"]

MyLifeType 应显示“碳基生命”,词典在末尾。这是名称,不是生命数量。

描述概率另设:

["Earth", "Life.Probability", 100]

是信息评估 100%,不是随机投掷或生成人口。随机 true/false 用 Life.Chance,仅要描述概率时别替代 Probability。

独立环境特征如复杂化学用 true/false。合并名称、评估和特征:

["Earth", "Life", "MyLifeType"],
["Earth", "Life.Probability", 100],
["Earth", "Life.ComplexChemistry", true]

ComplexChemistry true 表示复杂化学。Life.SubsurfaceOcean、HydrothermalVents、MethaneCycle、Organics 同样各为独立特征,不从 Probability 推导。名称和概率都不产工人或收入。

MyLifeType 是自定义名称键。加进 Text/zhCN.json 显示“碳基生命”,无文件则完整保存词典。本例针对“太阳系”已有 Earth。

{
  "MyLifeType": "碳基生命"
}

Geology - 地质活动

地质描述内部及地表过程:火山、地壳运动、间歇泉、加热。可以用有无描述观察,也可用作者评分,但数值不表示火山百分比。

只记录地球地壳运动和火山存在,用 true:

["Earth", "Geology.Tectonics", true],
["Earth", "Geology.Volcanism", true]

地球获得两特征。Geology.Cryovolcanism、Geysers 同样接受 true/false。整体地质文字可在 Geology 填翻译键。

自定义模型可用数值评价构造运动:

["Earth", "Geology.Tectonics", 40]

40 是作者尺度分数,不是百分之四十。前例 true 不等于数值 1。把分数变为“弱”“强”类别需有条件的独立特质。

内部加热可计算,需要星球重力和恒星年龄。下列输入足够,星球放置见 Orbit 或完整物理例子:

["MyHeatStar", "Age", 5e9],
["MyHeatWorld", "Gravity", 1],
["MyHeatWorld", "Distance.CentralBody", "MyHeatStar"]

重力 1、恒星 50 亿年,无自身 Geology.InternalHeat 时算得 8:1 / 5 × 40。结果取整且上限 100。这是 InternalHeat 分数,不是度数。数值本身不自动出现“强加热”文字,标签需 Requires 特质。

检查必要输入。另一方案保留恒星关联,但不设正重力:

["MyHeatStar", "Age", 5e9],
["MyHeatWorld", "Gravity", 0],
["MyHeatWorld", "Distance.CentralBody", "MyHeatStar"]

此隔离方案不计算 InternalHeat。无结果不等于零加热。若其他数据算出正 Gravity,输入又足够。已有 Geology.InternalHeat 不被自动覆盖。

卫星沿行星查年龄。MyHeatMoon 到前例 MyHeatWorld,再到 MyHeatStar:

["MyHeatMoon", "Gravity", 1],
["MyHeatMoon", "Distance.CentralBody", "MyHeatWorld"]

中间行星无 Age 时找到恒星 5e9,Gravity 1 同样算 8,无需单独卫星年龄。

Geology.TidalHeating 是另一计算,使用吸引中心质量及天体物理参数。先看无离心率:

["MyTidalCenter", "Weight", 5.972e24],
["MyTidalMoon", "Distance.CentralBody", "MyTidalCenter"],
["MyTidalMoon", "Size.Measure", "Kilometers"],
["MyTidalMoon", "Size", 1000],
["MyTidalMoon", "Weight", 1e22],
["MyTidalMoon", "Distance", 100000],
["MyTidalMoon", "Distance.OrbitalPeriod", 24],
["MyTidalMoon", "Distance.Eccentricity", 0]

首行中心质量,其余卫星直径 1000 公里、质量 1e22 公斤、距离 100000 公里、周期 24 小时。离心率 0 是圆轨道。正输入齐全但模型依赖离心率,TidalHeating 算零。这与缺输入的无结果不同,例如删中心正质量会阻止计算。

正离心率以百分比写,可产生非零加热,结果依赖全部参数,上限 500,小于 1 写零。分数不是度数或火山概率,自动活动标签仍需独立特质。

MagneticField - 磁场

此处磁场是描述属性。数字可表示作者尺度强度,文本类别如“强”。《前曲速时代》 无统一内置评分尺度,单个事实不会自动采掘或保护人口。

先仅设“强”文字类别,用 MagneticField.Type 翻译键:

["Earth", "MagneticField.Type", "MagneticFieldStrong"]

已有 Earth 显示词典 MagneticFieldStrong 对应“强”,尚未设数值强度。

需要数值评分时,不带 Type:

["Earth", "MagneticField", 40]

40 是作者尺度最终分数,不自动获得“强”标签,关联类别需另有规则。不能把 MagneticFieldStrong 键替代 MagneticField 数字。两者本身都不保护人口或产资源。

Rotation - 自转

Rotation 描述绕自身轴转动,不是游戏轨道公转。周期为每转小时数。潮汐锁定时始终同一面朝向中心,自转与公转周期相同。

先设地球一周自转时间:

["Earth", "Rotation", 23.93]

单位小时,此处 23.93。轴倾角独立,以度为单位:

["Earth", "Rotation", 23.93],
["Earth", "Rotation.AxialTilt", 23.44]

描述显示 23.93 小时和 23.44°,都不自动改变绕恒星装饰公转速度。

逆行另设特征:

["Earth", "Rotation.Retrograde", true]

false 表示无逆行特征。潮汐锁定独立。设公转 24 小时、原自转 12 并开启锁定:

["MyLockedWorld", "Rotation", 12],
["MyLockedWorld", "Distance.OrbitalPeriod", 24],
["MyLockedWorld", "Rotation.TidallyLocked", true]

创建后 Rotation 变 24,与公转一致,即一面始终朝中心。12 不保留为另一独立周期。无正 Distance.OrbitalPeriod 就没有可赋给 Rotation 的数。

太阳日是光源在天空位置重复的时间,不总等于相对静止空间转一周。相同两周期不带锁定:

["MyDayWorld", "Rotation", 12],
["MyDayWorld", "Distance.OrbitalPeriod", 24]

模型写 Rotation.SolarDay 24 小时:|12 × 24 / (24 - 12)| = 24,自转仍 12。两者均 24 时分母零,不写有限太阳日。上面的锁定正使两者相同。

累计潮汐效应 Rotation.TidalEffect 还需物理尺寸质量。输入归属如下:

["MySpinStar", "Age", 5e9],
["MySpinStar", "Weight", 1.989e30],
["MySpinWorld", "Rotation", 12],
["MySpinWorld", "Size.Measure", "Kilometers"],
["MySpinWorld", "Size", 12742],
["MySpinWorld", "Weight", 5.972e24],
["MySpinWorld", "Distance", 149597870.7],
["MySpinWorld", "Distance.CentralBody", "MySpinStar"]

年龄与首个质量属于恒星,第二质量和直径属于星球。算得 TidalEffect 约 0.000262,低于锁定阈值 50,不出现 TidallyLocked,Rotation 保持 12 小时。效应分数不是小时或减速百分比,提示不一定另行显示。

删除中心质量且不从其他物理数据取得,则不计算,这不是计算零。卫星先到行星,再沿 Distance.CentralBody 到恒星查年龄,如 Geology。分数达到 50 时赋予锁定特征。恒星引起的效应仅对直径至少 2000 公里天体应用此规则。图像自转和游戏环运动另设。

Rings - 天体光环

Rings 添加可见天体环,例如巨行星冰环。它是图像和说明,不成为独立可采小行星带,也不扩大领土。

给中型气态巨行星选择现成明亮环:

["GasGiantMedium", "Rings", "RingsBright"]

RingsBright 用 ringsbright_down.png、ringsbright_up.png 两层。其他现成项为 RingsFaint、RingsModerate、RingsProminent。

图像尺寸独立,加比例 1.05:

["GasGiantMedium", "Rings", "RingsBright"],
["GasGiantMedium", "Rings.Scale", 1.05]

图像放大 1.05 倍,无 Rings.Scale 默认 1,必须正。不改 Size 和工位数。自己的 MyRings 需名称翻译、myrings_down.png、myrings_up.png,准备方法见“新图像、背景和音效的确切文件”。

Habitability 与 Affinity - 星球适宜度

Habitability 评价人类物理环境:可呼吸、液态水、适宜温度。是信息分数,不是移民数或开局母星决定。Affinity 是作者规则定义的另一吸引力评分。

先准备大气、水、温度,各字段有专门条目。Earth 已设输入时,另开启人类适宜计算:

["Earth", "Habitability", 0]

零是允许计算的初始值,不是“无法居住”的评分。结果另存 Habitability.Human。组合输入:

["Earth", "Atmosphere", "Breathable"],
["Earth", "Atmosphere.Pressure", 1],
["Earth", "Hydrography", "H2O"],
["Earth", "Hydrography.Surface", 71],
["Earth", "Temperature", 288],
["Earth", "Habitability", 0]

补充“太阳系”Earth。1 大气压可呼吸空气、71% 水、288 K 得 Habitability.Human 8。缺失输入不凭空添加贡献。分数不创建 Workers、Income,也不替代母星选择 Earthlike。Affinity 也不能仅靠零,需计算及分类规则。

Economy 与 Civilized - 有人星球的描述

Economy 用收入和总规模描述有人星球的经济。信息数值不发 Credits,也不启动生产。真实资源流入用 Income.<资源>。

先写地球参考收入:

["Earth", "Economy.Income", 100]

100 是作者模型单位,不是每回合 100 Credits,货币周期不自动指定。实际收入需 Income.Credits 能力。

第二参考值是总规模,添加 Economy.Volume:

["Earth", "Economy.Income", 100],
["Earth", "Economy.Volume", 1000]

正 Workers 的有人地球显示收入 100、规模 1000。无工人仍保存数据但不显示该文本。工人通过通常游戏方式分配,Economy 片段不创建他们,应在人口和分工后检查。Economy.Wealth 汇总作者富裕特质。Civilized 只是描述特征,不自行创建人口。

Health 与 Damage - 耐久与伤害

Health 是耐久,伤害降低它,耗尽则销毁实际对象。Damage 是伤害量。单个数字不创建攻击,需已有机制执行,如小行星炮击选项。

为已经创建的对象设六点耐久:

["MyMarker", "Health", 6]

已有机制伤害两点则剩四。Health 不大于零时连同依赖对象销毁。Health.Max 保存原最大值用于显示。此行不创建 MyMarker,须先按 PlacedAt 等方式放置。

修改现有 Bombard 小行星炮击为两点伤害,保留 Parent 目标:

["Bombard", "Damage", 2],
["Bombard", "Damage.Target", "Parent"]

Bombard 位于小行星事件卡,Parent 指卡本身。改 Damage 强化已有炮击至两点,保留价格按钮,不创建新武器。先用目标 Health,没有则用 Size(《前曲速时代》 小行星如此)。Health.Max 伴随原耐久,不自动替代小行星尺寸。

小行星碰撞是另一上下文。给已有 AsteroidEvent 设每单位尺寸伤害:

["AsteroidEvent", "Damage", 2],
["AsteroidEvent", "Per", "Size"]

已有碰撞机制处理尺寸 3 时,伤害 2 × 3 = 6,接受者由落点决定。此处不加 Damage.Target Parent,那是 Bombard 回答伤害父小行星事件的路径。本记录不安排碰撞时间或创建小行星,保留现有事件规则。

自己的实际实体可有 Health 6,但须先由其机制创建。EventChoice 伤害要求显式 Damage.Target 为 Parent 或 Parent.<字段>。一个 Health/Damage 事实不会创建通用舰船战斗或新“攻击”按钮。

Transforms - 天体转变

Transforms 用新天体替换旧天体,例如灾难后成残骸或感染星球。不是改名换图,位置保留,旧建筑摧毁,新类别决定后续属性。

现有实验 TestNanobots 的失败 NanobotsEscaped 需创建 Modified 星球,Transforms 指结果类别:

["NanobotsEscaped", "Transforms", "Modified"]

回答“变成什么”,尚未指定哪个天体。目标另设:

["NanobotsEscaped", "Transforms.Target", "Parent.Target"]

Parent 从结果到实验事件,事件 Target 到所选星球,该星球被替换。关联结果与实验并保留旧尺寸:

["TestNanobots", "Has", "NanobotsEscaped"],
["NanobotsEscaped", "Transforms", "Modified"],
["NanobotsEscaped", "Transforms.Target", "Parent.Target"],
["Modified", "Size.From", "Parent"]

片段重复原版部分定义。TestNanobots 已有 Event、Rocky 目标及 NanobotsEscaped 结果。若触发则所选星球替换 Modified。Transforms.Target 的值 Parent.Target 从结果读取:Parent 指结果所属事件,其 Target 指星球。Modified 的 Size.From Parent 中 Parent 则是被替换旧天体,保留其尺寸,无此行则用新类尺寸。自定义转变需事件、目标、已关联结果和新天体定义。

位置和轨道关系保留,旧天体建筑毁灭。新类 <名称>.From Parent 明确保留旧属性。Transforms.Effect(如 swarm)选择已有视觉效果,不执行新脚本。

Spread 与 Spreads - 连锁转变

让感染星球把邻居变成同类。先声明独立 MySpread 能力,需 Trait 以关联星球、Spread 以传播两种角色:

["MySpread", "Is", "Trait"],
["MySpread", "Is", "Spread"]

能力定义尚未赋予星球,不会感染。直接在星球设 Spread 而无独立特质不能创建此能力。

设每回合触发概率 10%:

["MySpread", "Chance", 10]

每个拥有该能力的星球每回合进行一次判定,并不保证十回合后感染成功。概率必须大于 0 且不超过 100。除固定值外,普通 Random 还支持 Chance.Random.Min/Max 区间,或重复 Chance.Random 事实列出数值。尝试以下变体时,请用这两行替换原来的 Chance 10 行,不要同时保留两种形式:

["MySpread", "Chance.Random", 5],
["MySpread", "Chance.Random", 15]

每个新星球独立选择 5% 或 15% 的概率,两者等概率。这是该星球保存的能力概率,每回合或载入时不会重新选择。每回合仍按此概率另行判定,并不保证感染成功。列表中的所有值及区间边界必须位于 (0, 100],允许小数。下方完整示例仍使用固定的 10%。

选择 World 类别为允许目标:

["MySpread", "Target", "World"]

成功时选最近适合星球,同距随机。排除自身和同类已感染星球。无目标不发生,额外 Target 条件可缩小范围。

将能力关联感染星球类:

["MySpreadWorld", "Has", "MySpread"]

每个 MySpreadWorld 获得能力。邻居感染后变 MySpreadWorld、失去旧建筑且获得能力,下回合开始传播,来源保持原位,构成连锁。游戏结束后停止。Spreads、Spreads.Turn 的概率及已处理回合由游戏填写。

完整例子在“太阳系”第四环加入“机械群”,每回合 10% 转变最近 World。地球也符合,务必独立新游戏检查。第一块存 Logic/Spread.json。

[
  ["MySpreadWorld", "Is", "World"],
  ["MySpreadWorld", "Name", "MySpreadWorldName"],
  ["MySpreadWorld", "Icon", "nanobot"],
  ["MySpreadWorld", "Size", 3],
  ["MySpreadWorld", "Orbit.Center", "Sun"],
  ["MySpreadWorld", "Orbit", 4],
  ["MySpreadWorld", "Has", "MySpread"],
  ["MySpread", "Is", "Trait"],
  ["MySpread", "Is", "Spread"],
  ["MySpread", "Name", "MySpreadName"],
  ["MySpread", "Icon", "nanobot"],
  ["MySpread", "Chance", 10],
  ["MySpread", "Target", "World"]
]
{
  "MySpreadWorldName": "机械群",
  "MySpreadName": "感染邻居"
}

第二块存 Text/zhCN.json。MySpreadWorld、MySpread 自定义,不依赖已有 Modified、NanobotSpread。World 类别、nanobot 图像、Size 3。Orbit.Center Sun 与 Orbit 4 在太阳第四环空格放初始星球。Has MySpread 赋能力,转变邻居也变同类并继续感染。

一个星球仅可有一个有效 Spread。继承已有此能力类时先消除重复。移除或关闭唯一 Spread 特质则停止传播,删除内部 Spreads。一次性非连锁转变用事件结果 Transforms。

Visibility - 视亮度与角尺寸

Visibility 描述观察点看到的亮度与角尺寸,例如近小天体可比远大天体占更多天空。普通 《前曲速时代》 不因此改图像大小或生产。

Visibility.Brightness 是描述视星等:

["Earth", "Visibility.Brightness", 1]

数越小越亮,不改星冠或图像。范围用 Visibility.Brightness.Min、Max。

角直径是另一量,表示天空占比,加入 3.13 角分:

["Earth", "Visibility.Brightness", 1],
["Earth", "Visibility.Angle", 3.13]

Earth 视星等 1、角直径 3.13 角分,角度范围用 Visibility.Angle.Min、Max。是作者指定信息,不按相机重算。图像尺寸用 IconSize,物理光度用 Luminosity。

StellarCorona - 星冠亮度

星冠是恒星周围可见光晕。StellarCorona 设置当前客户端效果亮度,不是物理光度或能源产量。

须为有限非负数,无值或零不发光。1 普通,正小数更弱,大于 1 更强。

["ClassG", "StellarCorona", 1]

黄色恒星获得星冠,颜色绘制方式由客户端现有规则决定。

名称、描述与呈现资源

下列字段设置名称、说明、图像和声音,为游戏已有显示方式的对象呈现,不自行创建窗口按钮。文字在 Text、图像在 Art、声音在 Sounds。游戏文本不用 HTML 或颜色标签。游戏已显示效果数值时,别在说明手写重复,否则改数字后说明会过时。

Name - 名称与名称集合

Name 设置名称,通常为 Text 词典键,按语言查找。新星球也可用随机名称集合,有未用名称时不重复。

先用词典键给 PlacedAt 中 MyMarker 固定名:

["MyMarker", "Name", "MyMarkerName"]

若 Text/zhCN.json 的 MyMarkerName 是“我的空间站”,即显示此名。Name 不创建标记或改变类型。

多个新星球需不同名称,先在 MyWorldNames 集合列两个:

["MyWorldNames", "Name.Option", "MyNameOne"],
["MyWorldNames", "Name.Option", "MyNameTwo"]

只是尚未分配的键集合。用 Name.Random 关联 TinyRock,完整如下:

["TinyRock", "Name.Random", "MyWorldNames"],
["MyWorldNames", "Name.Option", "MyNameOne"],
["MyWorldNames", "Name.Option", "MyNameTwo"]

修改新 TinyRock 名称。MyWorldNames 为自定义集合,MyNameOne、Two 为两个键。下词典存 Text/zhCN.json,已有文件只加两记录。

{
  "MyNameOne": "第一块石头",
  "MyNameTwo": "第二块石头"
}

新游戏 TinyRock 获得这两个名称,耗尽前不重复,之后可重复。Name.Option 顺序影响种子复现,不要随意调换。定义自身固定 Name 优先于随机集合。

属性名称用该属性的 Name 细化,不改数值含义。玩家输入名按文字保存,即使恰好匹配词典键,换语言也不重译。

InputName - 输入框建议名称

InputName 设置输入框建议名,例如开局公司名可由玩家替换。界面输入框必须已存在。

值为词典键,<字段>.InputName 为对应属性名称的建议。玩家输入优先,自身 InputName 覆盖继承值。确认游戏时将建议翻译成所选语言并保存结果文字。

CorpMiner 是现有采掘者,CorpMinerName 是已有可翻译名,例子修改现有公司编辑器建议:

["CorpMiner", "InputName", "CorpMinerName"]

选择采掘者时建议 CorpMinerName 翻译。以后换语言不改已存玩家名。Name.Input、Corporation.DefaultName 不是有效别名。

Description - 实体及属性说明

Description 解释对象或属性,三元组存键,词典存文字,可说明前哨站用途而不改价格功能。

用已有 OutpostDesc 说明前哨站:

["Outpost", "Description", "OutpostDesc"]

提示显示 OutpostDesc 翻译,不改价格、期限、收入。具体属性用其 Description,属性的一行再加部分名,文字不替代值。

探索需要显示资源选择而非普通文字。Description.Choices 引用已有 WorkFocus。两种用法一起:

["Outpost", "Description", "OutpostDesc"],
["Explore", "Description.Choices", "WorkFocus"]

前哨站取得说明,探索描述显示 WorkFocus 选项,条件数值从定义本身读取。

科技上的 Description 是提示中的说明。完成报告在另一响应上使用自己的 Description,该响应通过科技的 Has 列表关联,例如具有 Is TechResearched 的 MyStudyResearched。完整示例见 Tech 条目。两种说明使用相同的普通文本键字段,但属于不同主体。

对象自身的多个 Description 事实按声明顺序显示,排序值为 0。需要独立段落时,可使用各自具有 Description 和 Order 的子部分。子部分名称可自由选择;Order 排列的是段落,而非整个实体。为 Outpost 现有说明添加两个段落:

["Outpost.Note", "Description", "MyOutpostNote"],
["Outpost.Note", "Order", 1],
["Outpost.Warning", "Description", "MyOutpostWarning"],
["Outpost.Warning", "Order", 2]

在 Text 中添加 MyOutpostNote 和 MyOutpostWarning。Outpost 原有说明的排序值为 0,仍先显示,然后是排序值为 1 和 2 的段落。子部分的 Requires 条件针对当前读取的实体检查;不满足条件的部分也会排除其嵌套说明。自身直接声明的 Description 定义完整说明,并停止继续向祖先继承。子部分说明收集到该拥有者为止;同一相对路径上最近的子部分 Description 会替换父部分的说明集合。仅在子部分上设置 Text 不会使其成为段落。

段落可以插入本地化的值。Text 和可选的 Color 应设置在说明键上,而不是子部分本身:

["MyOutpostNote", "Text", "MyOutpostNoteValue"],
["MyOutpostNote", "Color", "superGreen"]

例如,MyOutpostNote 的译文为“特性:{0}”,MyOutpostNoteValue 的译文为“已启用”。说明将显示“特性:已启用”,superGreen 只为插入的值着色。两个译文都保持不带标记的普通文本。这只改变静态标签的显示,不创建游戏效果。没有 Text 时,说明按普通段落显示。

Text - 文字标签

Text 在已有显示位置设置短标签,例如有效特质。Name 命名,Description 详解,Text 标记具体呈现。给任意对象加 Text 不创建标签位置。

游戏已关联的 SizeScale 按尺寸缩放工位数。下面仅改可读标签,不给全星球新特质或改数值。

["SizeScale", "Text", "MySizeScaleText"]

词典存 Text/zhCN.json 或加到已有文件,SizeScale 将显示“按尺寸计算工位数”。这是修改原版现有特质。新特质先 Is Trait,用 Has 接对象或 Grants 条件发放。

{
  "MySizeScaleText": "按尺寸计算工位数"
}

Hint - 额外提示

Hint 提示能通过属性执行什么行动。《前曲速时代》 在相关事件选项可用时显示于有效特质提示。普通对象说明用 Description。

RobotHeldTrait 是“受机器人控制”特质,已关联 RetakeStart 夺回行动。Hint 设置行动可用时的提示文字,<字段>.Hint 属对应属性。Hint 和翻译都不声明快捷键。

["RobotHeldTrait", "Hint", "RobotControlHint"]

此为现有记录。RobotControlHint 已译为点击开始夺回行动,改文字只需覆盖 Text/zhCN.json 对应键。任意 Outpost 的 Hint 不创建新行动窗口。

Tag - 类别标签

Tag 为通用类别提供标签,例如星球可同时属于岩质和寒冷类别,显示两个类别,而非另起冗长星名。

Tag 写在类别上引用名称键。对象显示 Is 类别标签且去重,因此不用复制到每个行星,Is 已说明适用类别。

["Rocky", "Tag", "CatRocky"]

所有 Is Rocky 通过关系显示“岩质”类别,无需每星手写 Tag。有 Tag 的类别不作为自动推导的独立具体 Type。

Default - 默认选项

Default 选择主菜单某列表的初始项,如公司或开局设定,直到玩家另选。每列表仅一个默认。

值 true/false,每组一个 true,例如一公司一开局设定。属于定义本身,不继承,因此 CorpMiner 派生公司不成为第二默认。玩家选择后 Default 不再改变。

完整 Logic/Default.json 补丁取消采掘者默认,改为技术官僚。set 替换字段,详见文件章节:

{
  "set": [
    ["CorpMiner", "Default", false],
    ["CorpTechnocrat", "Default", true]
  ]
}

新菜单默认技术官僚。保留两个 Default true 会报歧义错误。

Order、Tier 与 Level - 顺序、层级和等级

Order 是卡片顺序,Tier 是科技树层,Level 是重复研究已达等级。调整卡片用 Order、Tier,别改 Level,它属于研究完成次数及效果强度。

深度采掘在第一层:

["DeepExtraction", "Tier", 1]

改 2 移第二层,不创建前置要求,前置用 Requires。Tier 接受有限数,科技树通常整数。

层内位置 Order 2.5 放在 2 与 3 之间:

["DeepExtraction", "Order", 2.5]

Order 可为小数,须有限非负。顺序层级都不意味已研究。

例子只移动现有 DeepExtraction,Tier 1 为第一层、Order 2.5 为中间位置,不赋 Level:

["DeepExtraction", "Tier", 1],
["DeepExtraction", "Order", 2.5]

仍在第一层,位于 Order 2 与 3 之间,价格付款不变。Level 回答重复科技已研究多少级,例如 2 表示两次完成并参与加成强度,不是卡片位置。单个 Level 不给任意对象创建等级系统。

Enabled - 开关状态

Enabled 保存已有开关状态,如麦克风 true 为识别开启、false 关闭。科技建造的可用性用自身要求,非 Enabled。

Microphone 已有点击处理改变 Enabled,客户端开始停止识别。以下设现有元素初始关闭:

["Microphone", "Enabled", false]

换 true 表示现有开关开启,某些菜单也显示绿色。科技建筑用 Requires 或 Blocks,资源的 Enabled 不关闭生产。当前 《前曲速时代》 不支持 Toggle 经济政策格式,界限见 Toggle。

Difficulty - 难度标签

Difficulty 是开局设定卡难度文字,便于菜单比较,不计算平衡。把“中等”改“困难”不改变价格储备期限。

字符串键包括 DifficultyVeryEasy、DifficultyEasy、DifficultyNormal、DifficultyChallenging、DifficultyHard、DifficultyVeryHard、DifficultyMasochist。设置标签与约定显示色,不自动调整价格或敌人。模式规则另设。

["ScenarioG", "Difficulty", "DifficultyNormal"]

卡片显示普通难度,不改资源、期限和地图。

Preview - 主菜单描述组成

Preview 决定主菜单卡片简述哪些能力,仅影响开局前说明。未显示能力仍在游戏生效。

展示采掘者全公司能力,给 CorpMiner Preview MainMenu:

["CorpMiner", "Preview", "MainMenu"]

卡片得到能力简述。删 Preview 缩短卡片,不关闭能力或效果。

“ColdWorld 与 Icy”将加寒冷星球 ColdMining 部分。仅展示新增部分,就在它而非整公司设置:

["CorpMiner.ColdMining", "Preview", "MainMenu"]

简述包括 ColdMining 及嵌套部分。先添加所述加成,Preview 不创建它。此字段属于定义,不继承、不复制到本局对象。

Icon - 实体及属性图像

Icon 设置对象图像或属性图标。先有 PNG,再引用名称。改变图像不改类别、行动或数值效果。

前哨站图像不写 .png:

["Outpost", "Icon", "outpost"]

游戏在 Art 找已有 outpost.png,不创建新类别或行动。

公司工人图标另用 Icon.Workers,不用 CorpMiner 的 Icon:

["CorpMiner", "Icon.Workers", "cosmo_helmet_orange"]

采掘者工人用 cosmo_helmet_orange.png,公司自身图标不变。两项独立改动合并:

["Outpost", "Icon", "outpost"],
["CorpMiner", "Icon.Workers", "cosmo_helmet_orange"]

两图都已存在。地图专用图像用 IconMap,不支持 Icon.Map。

自己的图先建 Art/Icons/my_icon.png,再 Icon my_icon。不按路径查找,所以不同目录两个 my_icon.png 冲突。可从透明 256 × 256 正方形开始,但非强制。

若仅有 my_icon00.png、my_icon01.png 而无精确 my_icon.png,Icon my_icon 为对象选择并保存变体。加入精确文件后它优先。普通属性组件以字段名后 Icon 表示,不要与专用 Icon.Workers 交换次序。

IconMap - 独立地图图像

建筑按钮与地图可用不同图像。IconMap 仅改地图,其他地方保留 Icon。相同图像只需 Icon。

先仅选地图图像:

["Outpost", "IconMap", "outpost"]

此处与通常图标相同,换名称只改地图。删 IconMap 恢复 Icon。可用现成 PNG 或前后两层图像。

仅放大地图图片,加正 IconMap.Scale。现有 Outpost 完整片段:

["Outpost", "Icon", "outpost"],
["Outpost", "IconMap", "outpost"],
["Outpost", "IconMap.Scale", 1.1]

建成前哨站地图图像 1.1 倍,按钮不变。自制双层需 <名>_down、<名>_up PNG,后层在天体后、前层在前,基本文件名也须唯一。

IconGain 与 IconReady - 增量及就绪图标

增大资源源的发现及就绪行动可用单独图像。这两个字段选图,不决定发现数量或行动许可。

矿物源增加图标:

["Minerals", "IconGain", "ore_iron_plus"]

使用现有 ore_iron_plus,不设奖励数。

行动就绪用 IconReady。给探索选 magnifier 放大镜,合并如下:

["Minerals", "IconGain", "ore_iron_plus"],
["Explore", "IconReady", "magnifier"]

矿物发现与就绪探索使用各自图。IconReady 属 Is Action,不取消要求。两字段都需精确文件名,不能只写随机家族名。显示取决于真实结果和可用状态。

IconSize - 图像缩放

IconSize 改屏幕天体图像大小,不改游戏尺寸和工作岗位。没有正 IconSize 时从 Size 推导。

须有限数,作者正值优先。Simulation 上是天体全局缩放,<字段>.IconSize 属支持的属性呈现。不改领土、价格、工位数。

["Debris", "IconSize", 1.5]

Debris 图像缩放 1.5。要改领土工位数用 Size,只改图片用 IconSize,不需为同一视觉结果同时改两个字段。

IconText - 图标短标签

IconText 是现有图标短标签,可为问号或数字。看起来像数字不代表资源储备、价格或期限。

IconText、<字段>.IconText 接受文字或有限数,不接受 true/false。数字用游戏格式显示,“3”不表示三单位资源,真实数量用 Count。

MyMarker 为 PlacedAt 中 outpost 图像对象,在 Is Building、Icon、PlacedAt Earth 后加此行,IconText 本身不创建标记。

["MyMarker", "IconText", "?"]

显示问号,是现成文字而非词典键。改为数字仅替换值:

["MyMarker", "IconText", 3]

标签显示 3,储备并未成为三。数量用 Count。只能文字或有限数,标签不产生行动窗口。

Color - 颜色标识

Color 选现成颜色,例如橙色公司或红色危险事件。只改呈现,不决定效果强度、危险类型或出现条件。

Color、<字段>.Color 接受下方调色板名称,不写 RGB、CSS、HTML。短缺和行动不可用的颜色由界面从状态选择。

["CorpMiner", "Color", "orange"]

采掘者为橙色,能力资源不变。

玩家公司:red, orange, yellow, green, teal, blue, purple, pink。事件:green, superGreen, lightGreen, darkGreen, red, superRed, darkRed, gray, lightGray, darkGray, veryDarkGray, lightBlue, blue, darkBlue, darkDarkBlue, grayYellow, yellow, pink, cyan, darkCyan, orange, darkOrange, lightViolet, purple, chartreuse, navyBlue。区分大小写。另有语义 positive、danger、info,以及 difficultyVeryEasy、difficultyEasy、difficultyNormal、difficultyChallenging、difficultyHard、difficultyVeryHard、difficultyMasochist。任意颜色码不创建新调色板。

Hide - 隐藏呈现

Hide 隐藏现有呈现,隐藏属性仍可计算生效。隐藏数字与取消效果不同。

只隐藏恒星尺寸显示,true 属 Size.Hide,不是 Size:

["Star", "Size.Hide", true]

不再单独显示尺寸按钮,数值仍有。Hide 不切物理单位或决定生成。取消继承隐藏可用自身 false:

["ClassG", "Size.Hide", false]

父 Star 隐藏,但 ClassG 可显示。true/false 都只管呈现,不改尺寸值。

可隐藏整个通知,例如发水的 SuppliesWater:

["SuppliesWater", "Hide", true]

事件仍发水,但消息不出现。数值效果 Hide 同样隐藏说明行、保留计算,不适合取消能力。

关闭能力需改规则或移除能力,Hide 不能做到。隐藏加成仍生效,隐藏通知不取消事件。

Background - 场景背景

Background 选地图背景。视差是相机移动时图层微移产生深度,可与星层分别关闭。

选择现成 nebula:

["Simulation", "Background", "nebula"]

它指定背景图像集合,额外星层另开:

["Simulation", "Background.Stars", true]

false 取消星层、保留 nebula。相机移动时的图层偏移另设,关闭并组合三项:

["Simulation", "Background", "nebula"],
["Simulation", "Background.Stars", true],
["Simulation", "Background.Parallax", false]

地图使用 nebula 与星层,视差关闭,相机移动时背景不偏移。

《前曲速时代》 在 Simulation 设置这些。自制背景建 Art/Backgrounds/my_space00.jpg,再 Background my_space。多图接 01、02,即使单图也须 00.jpg。不能跳号,搜索在首个缺失文件终止。此处不能用 PNG 替 JPG。

Sound 与 Music - 音效、环境和音乐

先给 Explore 短音效 Sound:

["Explore", "Sound", "scan"]

scan 是已有 OGG 无路径无扩展名。探索执行时播放,不是持续背景。

音乐属于全场景,在 Simulation 用 Music。加入现有 interstellar_waltz:

["Explore", "Sound", "scan"],
["Simulation", "Music", "interstellar_waltz"]

scan 仍为行动声,interstellar_waltz 为场景音乐。普通数组 Music 替换旧列表,追加用补丁 add。同文件多条 Music 按顺序组成新列表。没有 Sound.Music。

短声可允许音高音色微变,不是选别的音乐:

["Explore", "Sound.Variants", true]

false 关闭音色变化。多文件选择另有机制:Sound 可指家族。创建两文件,不单建 my_scan.ogg:

Sounds/FX/my_scan00.ogg
Sounds/FX/my_scan01.ogg

只引用公共名称,不带数字后缀:

["Explore", "Sound", "my_scan"]

探索可选择 my_scan00 或 01。数字可紧跟名称或下划线。Sound.Variants 仍是独立的已选声音音高音色变化许可。

Sound.Ambience 已注册为地图环境字段,但当前 《前曲速时代》 界面没有此处支持的独立播放例子。不要当作保证的持续背景办法。已展示有效上下文是行动 Sound 与场景 Music。音量顺序由界面管,任意 Sound 后缀不创建设置。

自制音效为 Sounds/FX/my_scan.ogg,音乐为 Sounds/Music/my_theme.ogg,引用 my_scan、my_theme。用 OGG Vorbis,短音可单声道,音乐可立体声。不同目录文件名也须唯一。行动执行才播非持续,采样率在音频文件设置。

FunFact、Myth 与 Machinery - 补充故事

可加趣闻、神话和运动说明,只在描述阅读,不启动叙述中的事件物理。

给地球一条趣闻,FunFact 引翻译键:

["Earth", "FunFact", "MyEarthFact"]

在 Text/zhCN.json 将 MyEarthFact 设为“地球表面存在液态水。”,显示文字但不创建水。

另加运动说明,Machinery.Description 不要求裸 Machinery:

["Earth", "Machinery.Description", "MyMotionText"]

MyMotionText 翻译说明运动,不改轨道。合并两项:

["Earth", "FunFact", "MyEarthFact"],
["Earth", "Machinery.Description", "MyMotionText"]

加入两个翻译后,作者地球显示说明,不启动新物理。

对应 Text/zhCN.json:

{
  "MyEarthFact": "地球表面存在液态水。",
  "MyMotionText": "地球围绕太阳运行。"
}

例子针对“太阳系”Earth。神话故事用另一对字段:

["Earth", "Myth", "MyEarthMyth"],
["Earth", "Myth.Name", "MyEarthMythName"]

例如 MyEarthMyth 译为“地球被视为生命之母”,MyEarthMythName 译“大地母亲”。Myth 是故事,Myth.Name 是角色名。Deity 档案另设,故事本身不创建。

Deity、Nature、Metal 与 Weekday - 神祇档案

Deity 将天体关联神话角色,可设名称、说明、象征金属、星期。是补充叙述,不改经济。

创建 MyDeity 并关联已有地球,Is 后 Deity 为档案角色,Earth 的 Deity 为引用:

["MyDeity", "Is", "Deity"],
["Earth", "Deity", "MyDeity"]

地球得到档案关联,可给通常 Name、Description、Icon。无 Is Deity 则 MyDeity 引用错误。

Nature 是性格文字键,不是行为规则:

["MyDeity", "Nature", "MyDeityNature"]

如“平和而丰饶”出现在档案,不提高星球肥沃度。

象征金属另设,Iron 是“铁”的文字键,不是玩家资源:

["MyDeity", "Metal", "Iron"]

档案得到金属标签,不改矿物储备产量。星期同样独立:

["MyDeity", "Weekday", "Tuesday"]

Tuesday 翻译“星期二”,不是日历或事件安排。合并名称、描述与现有 ares 图:

["MyDeity", "Is", "Deity"],
["MyDeity", "Name", "MyDeityName"],
["MyDeity", "Description", "MyDeityDesc"],
["MyDeity", "Icon", "ares"],
["MyDeity", "Nature", "MyDeityNature"],
["MyDeity", "Metal", "Iron"],
["MyDeity", "Weekday", "Tuesday"],
["Earth", "Deity", "MyDeity"]

第一块关联地球与档案,第二块为 Text/zhCN.json。一个档案可关联多个天体并用普通 Is 继承。Deity.Nature 经关联档案读取 Nature。

{
  "MyDeityName": "地球守护神",
  "MyDeityDesc": "与此星球关联的神话形象。",
  "MyDeityNature": "平和而丰饶",
  "Iron": "铁",
  "Tuesday": "星期二"
}

Url - 外部地址

Url 保存网络地址。现有 《前曲速时代》 试玩 StorePage 按钮用它打开商店,以下仅示关联。试玩禁用用户模组,完整版单加 Url 不创建任意按钮。

地址在 Store 或 Site 类别独立定义上,需完整 http://、https:// 和域名,保留问号参数。Simulation Demo.Store 指 StorePage 读取的商店。

["MyStore", "Is", "Store"],
["MyStore", "Url", "https://example.com/game?utm_source=demo"],
["Simulation", "Demo.Store", "MyStore"]

MyStore 自定义,example.com 为示意地址带 utm_source。游戏文本不支持 HTML 链接,Description 或事件相同地址不会自动可点击。

事件兼容性

Conflicts - 事件互斥

水短缺与过剩等状态不兼容。Conflicts 禁止它们同时作用同一玩家。“作用”表示本局仍存续、未完成或移除的事件。

WaterShortage、WaterAbundance 都是已有 Event,有自身触发条件。已有互斥为:

["WaterShortage", "Conflicts", "WaterAbundance"]

WaterShortage 存续时不触发 WaterAbundance,反之亦然。关系对称,无需反向记录。此行不抽事件、制造短缺或加入时间表。

自制事件先 Is Event 并安排触发,例如 Events 组 Deck,再在一方 Conflicts 引另一方。两者都必须事件。模组包不兼容用 modinfo.json conflicts,科技或公司 Conflicts 不能替代。

完整地图与资源发牌示例

ColdWorld 与 Icy - 寒冷与组成

寒冷和冰质不同。ColdWorld 是气候,生成天体在 Snow、Outer 获得,UltraHot、Hot 为 HotWorld,Habitable 都没有。卫星使用行星区。类别依位置,不依统一开尔文阈值。作者固定系统需明确 Is 气候类别。

Icy 为组成。现有星球 TinyIce、SmallIce、StandardIce、LargeIce、TinyCryogenic、SmallCryogenic、StandardCryogenic、StandardAmmonia、LargeAmmonia 都是 Icy。冰巨星 IceGiantSmall、Medium 名字有 Ice 不代表 World.Icy,它们属于 Giant。名称不决定类别。

["CorpMiner.ColdMining", "Target", "World.ColdWorld"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]

给 CorpMiner 增加 ColdMining 部分,点表示公司定义的部分,无需单独 Has。采掘者的寒冷星球每工人每回合多 0.3 矿物,仅作用于已有矿物源。

仅改接受者,使冰质星球不论轨道都得加成,效果行不变:

["CorpMiner.ColdMining", "Target", "World.Icy"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]

现在看冰质组成,不看区域。寒冷岩石失去加成,非寒区冰质得到,仍需已有矿物源。

也可去掉 World 限制,包含其他寒冷类别天体:

["CorpMiner.ColdMining", "Target", "ColdWorld"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]

保留寒区条件、不查 World。这是同一 Target 的三种替代方案,若只检一种接受者就别同时添加。

自定义恒星与保证母星

原版用 Spawn.Random Earthlike 选家园,地图至少有一个类地才能开始。StandardOcean 是 World 非 Earthlike,不能替代。宜居区仅一个位置时,大类地权重只提高概率,只要还有其他结果就不保证。

本例 ClassK 宜居区两位置、恰两卡 StandardEarthlike 和 StandardOcean,两抽两种保证家园。第一块存 Logic/ColdSystem.json,第二块 Text/zhCN.json。复现不要改环数区域权重,它们决定位置数。自制分配需重新检查位置足够必需类地卡。

[
  ["MyColdStar", "Is", "ClassK"],
  ["MyColdStar", "Name", "MyColdStarName"],
  ["MyColdStar", "Orbits.Habitable.Deck.StandardEarthlike", 1],
  ["MyColdStar", "Orbits.Habitable.Deck.StandardOcean", 1],
  ["MyColdStar", "Orbits.Snow.Deck.TinyIce", 1],
  ["MyColdSystem", "Is", "ScenarioK"],
  ["MyColdSystem", "Name", "MyColdSystemName"],
  ["MyColdSystem", "Description", "MyColdSystemDesc"],
  ["MyColdSystem", "Orbit.Center", "MyColdStar"],
  ["MyColdSystem", "Order", 12]
]
{
  "MyColdStarName": "冰之摇篮",
  "MyColdSystemName": "冰雪邻居",
  "MyColdSystemDesc": "类地家园、海洋邻居和雪区冰质星球。"
}

启用模组,新游戏选择“冰雪邻居”。MyColdStar 继承 ClassK 图像生成,自身卡组整体替换对应祖先:Habitable 发类地海洋,Snow 仅 TinyIce。其他区域和 ScenarioK 初始储备保留。检查母星类地、旁有海洋、雪区有冰质天体。资源与每工人产量独立抽取,冰质不保证水源。

固定系统与 Plane 边界

手动放天体,不用随机区域卡组。放独立模组,启用时 Player Spawn 改所有开局设定家园,只用“我的系统”。它有自定义恒星、类地家园和冰质水源。第一块 Logic/FixedSystem.json,第二块 Text/zhCN.json。开局设定 Orbit.Center 关联恒星,Player Spawn 明选家园。

[
  ["MyFixedSystem", "Is", "ScenarioG"],
  ["MyFixedSystem", "Name", "MyFixedSystemName"],
  ["MyFixedSystem", "Description", "MyFixedSystemDesc"],
  ["MyFixedSystem", "Orbit.Center", "MyFixedSun"],
  ["MyFixedSystem", "Order", 13],
  ["MyFixedSun", "Is", "Star"],
  ["MyFixedSun", "Type", "MyFixedSun"],
  ["MyFixedSun", "Name", "MyFixedSunName"],
  ["MyFixedSun", "Icon", "star_yellow00"],
  ["MyFixedSun", "Orbits", 3],
  ["MyFixedSun", "Production.Energy", 1],
  ["MyFixedHome", "Is", "StandardEarthlike"],
  ["MyFixedHome", "Name", "MyFixedHomeName"],
  ["MyFixedHome", "Orbit.Center", "MyFixedSun"],
  ["MyFixedHome", "Orbit", 1],
  ["MyFixedHome", "Explored", true],
  ["MyFixedIce", "Is", "TinyIce"],
  ["MyFixedIce", "Is", "ColdWorld"],
  ["MyFixedIce", "Name", "MyFixedIceName"],
  ["MyFixedIce", "Orbit.Center", "MyFixedSun"],
  ["MyFixedIce", "Orbit", 2],
  ["MyFixedIce", "Production.Water", 2],
  ["Player", "Spawn", "MyFixedHome"]
]
{
  "MyFixedSystemName": "我的系统",
  "MyFixedSystemDesc": "自定义家园和冰质水源。",
  "MyFixedSunName": "我的恒星",
  "MyFixedSun": "自定义恒星",
  "MyFixedHomeName": "我们的家",
  "MyFixedIceName": "冰雪邻居"
}

启用并选“我的系统”,第一环“我们的家”、第二环“冰雪邻居”。Orbit.Center 明确设置,不继承。初始资源来自 ScenarioG。Production.Water 2 是每工人每回合采两水,不是仓库两水。地图只示放置,不保证完整通关,仍需其他源及平衡。

其他开局设定不创建 MyFixedHome 就无法获得指定家园。回普通开局设定前关闭模组。

用 Plane.Cols、Rows 替换 Orbit.Center 不会创建矩形版本,恒星家园可能在当前地图外不同网格。《前曲速时代》 无此组合完整例子。显式中心系统可作独立作者开局设定,Plane 此处仅为其他几何参考。

新采掘资源与延迟探索

加冷冻矿和两种可采冰质星球。CryoOre、My 名称为自定义。先分解三项发牌,再合成开局设定。资源声明与玩家储备用 Is Resource、Is Stat、Player Has。

第一任务在共享发牌允许资源选择,建立 MyOreDeck,仅一张 Resource:

["MyOreDeck", "Deck.Resource", 1]

Resource 表示选天体允许资源之一,尚未指定冷冻矿及产量。1 是卡数量。

第二任务把 MyOreIceA 加入发牌并允许冷冻矿:

["MyOreIceA", "Deck.CryoOre", "MyOreDeck"]

星球通过冷冻矿关联共享卡组,只是允许资源种类,未设每工人产量。CryoOre 在 Deck 内不是独立谓词,不需 Is Predicate。

第三任务给可能产量每工人每回合 2.1:

["MyOreIceA", "Deck.CryoOre.2.1", 1]

2.1 是一个小数产量,不是路径 2 再 1。最后 1 是该产量卡数。产量须正,卡数非负整数。不会发 2.1 到储备,只设探索并分工后可能产出。

添加第二可能产量:

["MyOreIceA", "Deck.CryoOre.2.1", 1],
["MyOreIceA", "Deck.CryoOre.3.1", 1]

两张等权,工人产 2.1 或 3.1,不相加。其他资源需独立关联和数值卡组:

["MyOreIceB", "Deck.Minerals", "MyOreDeck"],
["MyOreIceB", "Deck.Minerals.0.9", 1],
["MyOreIceB", "Deck.Minerals.1.5", 1]

MyOreIceB 允许矿物 0.9 或 1.5。完整例子也允许冷冻矿,探索显示两种。玩家选择新资源需在现有“工作重点”加回答,先声明并指定资源:

["FocusCryoOre", "Is", "EventChoice"],
["FocusCryoOre", "Resource", "CryoOre"]

回答的 Resource 表示选择采冷冻矿,不是发储备。尚无星球目标,无法记录结果。

设目标,Parent 是包含回答的窗口,其 Target 是探索星球:

["FocusCryoOre", "Resource.Target", "Parent.Target"]

FocusCryoOre 回答 → 父 WorkFocus 窗口 → 窗口 Target 星球。在星球固定预先抽好的 CryoOre 产量,不把回答或窗口变矿床。仅 Parent 会指窗口,不能少 .Target。

把回答加入窗口组成:

["WorkFocus", "Has", "FocusCryoOre"]

探索允许冷冻矿星球时可提供回答。MyOreIceB 选冷冻矿固定 Production.CryoOre,选矿物固定 Production.Minerals,只一个非两者和。Resource 改 Minerals 会在相同路径改选矿物。自制窗口不能机械套 Parent.Target,必须真实在 Target 保存星球。

完整块存 Logic/CryoOre.json,词典存 Text/zhCN.json,连接资源、储备、卡组星球、窗口回答及开局设定。

[
  ["CryoOre", "Is", "Resource"],
  ["CryoOre", "Is", "Stat"],
  ["CryoOre", "Name", "CryoOreName"],
  ["CryoOre", "Icon", "ore_iron"],
  ["CryoOre", "Count", 0],
  ["CryoOre", "Price", 2],
  ["Player", "Has", "CryoOre"],
  ["MyOreDeck", "Deck.Resource", 1],
  ["MyOreIceA", "Is", "World"],
  ["MyOreIceA", "Is", "Icy"],
  ["MyOreIceA", "Name", "MyOreIceAName"],
  ["MyOreIceA", "Size", 3],
  ["MyOreIceA", "Icon", "ice"],
  ["MyOreIceA", "Deck.CryoOre", "MyOreDeck"],
  ["MyOreIceA", "Deck.CryoOre.2.1", 1],
  ["MyOreIceA", "Deck.CryoOre.3.1", 1],
  ["MyOreIceB", "Is", "World"],
  ["MyOreIceB", "Is", "Icy"],
  ["MyOreIceB", "Name", "MyOreIceBName"],
  ["MyOreIceB", "Size", 4],
  ["MyOreIceB", "Icon", "ice"],
  ["MyOreIceB", "Deck.CryoOre", "MyOreDeck"],
  ["MyOreIceB", "Deck.CryoOre.1.2", 1],
  ["MyOreIceB", "Deck.CryoOre.2.4", 1],
  ["MyOreIceB", "Deck.Minerals", "MyOreDeck"],
  ["MyOreIceB", "Deck.Minerals.0.9", 1],
  ["MyOreIceB", "Deck.Minerals.1.5", 1],
  ["FocusCryoOre", "Is", "EventChoice"],
  ["FocusCryoOre", "Name", "CryoOreName"],
  ["FocusCryoOre", "Icon", "ore_iron"],
  ["FocusCryoOre", "Resource", "CryoOre"],
  ["FocusCryoOre", "Resource.Target", "Parent.Target"],
  ["WorkFocus", "Has", "FocusCryoOre"],
  ["MyOreStar", "Is", "ClassK"],
  ["MyOreStar", "Orbits.Snow.Deck.MyOreIceA", 1],
  ["MyOreStar", "Orbits.Snow.Deck.MyOreIceB", 1],
  ["MyOreSystem", "Is", "ScenarioK"],
  ["MyOreSystem", "Name", "MyOreSystemName"],
  ["MyOreSystem", "Description", "MyOreSystemDesc"],
  ["MyOreSystem", "Orbit.Center", "MyOreStar"],
  ["MyOreSystem", "Order", 14]
]
{
  "CryoOreName": "冷冻矿",
  "MyOreIceAName": "冷冻矿星球",
  "MyOreIceBName": "采掘选择星球",
  "MyOreSystemName": "冷冻矿系统",
  "MyOreSystemDesc": "两类拥有冷冻矿床的冰质星球。"
}

启用并选“冷冻矿系统”。雪区有 MyOreIceA、B,前者仅冷冻矿,后者冷冻矿或矿物。直接继承 World、Icy,避免 TinyIce 资源卡组。Deck.CryoOre、Deck.Minerals 关联 MyOreDeck 共用发牌。恒星继承 ClassK,保留适合母星。

先为未揭示天体编制发牌计划,指定 Resource 卡(选择允许资源),尚不记录最终 Production.CryoOre、Minerals。Explored.Plan、Remainder 由游戏保存计划剩余。

探索 MyOreIceB 打开 WorkFocus,有矿物和冷冻矿。显示时各允许资源已抽并保存数值产量,未回答前无最终资源。选择只记录一个 Production 和窗口显示产量,再开天体不改变。MyOreIceA 唯一选项则不弹窗直接记录。

初始自动揭示时游戏选最大已抽产量,不等回答。探索后用滑块派工。Resource、Stat、Player Has 创建玩家储备及指标,Price 允许交易。

保留通常 Explore 价格及雪区远近。初始矿物可能只够一个,第二个积累后再探索。例子不免费远距、不暗发测试储备。揭示后派工验证产出,例如两体各一工、产量 2.1 和 2.4 合为每回合 4.5 冷冻矿,具体数值随发牌。

继承、物理模型与文件

哪些可继承,哪些需明确声明

继承可不复制整个定义就创建变体。但有些规则查祖先,有些需自身记录,以恒星开局设定说明。

自己的恒星保留普通 ClassK 设置,只需 Is:

["MyColdStar", "Is", "ClassK"]

取得 ClassK,环数星球卡组不用重复,生成器查祖先。尚未为任何开局设定选择新恒星。

创建 ScenarioK 变体,选择 MyColdStar 而非原恒星:

["MyColdSystem", "Is", "ScenarioK"],
["MyColdSystem", "Orbit.Center", "MyColdStar"]

自身 Orbit.Center 选择生成恒星,不要依赖 Is 而删此行。开局设定描述能找到祖先恒星,不等于实际创建中心。标签继承和天体生成不同。组合如下:

["MyColdStar", "Is", "ClassK"],
["MyColdSystem", "Is", "ScenarioK"],
["MyColdSystem", "Orbit.Center", "MyColdStar"]

这是“冰雪邻居”片段,恒星继承设置,开局设定用自身中心。下方备忘基于已有条目,别把开局设定规则推广任何字段。天体放置看 Orbit,建筑看 PlacedAt。

  • Orbits、OrbitFill 填充比例、Spawn/Spawn.Random 家园规则可留在 Is 祖先,各机制能在那里读取。例如 RockyAsteroid 派生带不需重复比例,但新位置须另设。
  • 新天体 Orbit、Orbit.Center,新对象 PlacedAt,新地图 Center、Plane 须明确声明。TrojansOf 属群本身定义,继承小行星不指定行星,见同名条目。
  • Deck 保留组成不需重复父卡,自身声明整体替换。Random 范围及 <字段>.Chance 合适时保留祖先。子定义固定值取消继承 Random,见 Deck、Random、Chance。
  • Changes 关联所指对象类。新类按 Changes 指定变体,不能只靠父继承。Grants 条件及 Modify/Adds/Multiplies 能力按 Trait、Grants 和数值条目处理,是独立应用规则,非位置设置。
  • Default、Preview、Text 需要时在新定义明确设。Tag 留类别,由全部 Is 后代读取。Order 合适可继承不改。Progress、Tutorial 有自身状态,用对应条目,不复制存档状态。
  • Players、Imports、Seed 是本局通用设置,不逐对象复制。Parent、Started、生成标记由游戏写。通常 Name、Description、Icon、价格、数值能力按各字段规则继承。Is Predicate 权利不继承,每个新词独立声明。

不能改已创建对象的 Is 期待重新完整继承。最好开局前定义新类,再通过组成、生成、行动或开局设定接入。声明类别本身不创建本局对象。

Owner 与 PlacedAt 的明确关联

Owner 回答归属,PlacedAt 回答位置,Parent 回答从哪个对象产生。地球标记例子见 Owner、PlacedAt,所有关系分别必需,不能互代。

每玩家独立科技用 Player Has <科技>。由玩家建造用 Building、Build,详见科技与建造。

无需外部库的物理字段

组合 Weight、Temperature、Atmosphere、Hydrography、Habitability。未懂单字段先做短例。本例无需 Imports,描述环境不自建人口经济。完整块存 Logic/PhysicalWorld.json,词典 Text/zhCN.json,在独立新“太阳系”测试。先核下方输入。普通殖民需现成类别的游戏尺度,物理直径限制在例后。

  • 密度重力:公里物理 Size 和正公斤 Weight。也可 Size、Density 算缺质量,或 Weight、Density 算缺 Size,无 Diameter 字段。明确质量直径时重算密度,三者勿矛盾。半径不大于史瓦西半径的过密天体自动塌缩黑洞,失去大气、生命及物理核心不保留的属性。
  • 恒星温度:正 Luminosity、天体正 Distance 和真实 Distance.CentralBody。卫星沿行星查恒星。Temperature.Modifier 必正,无这些输入保留明确 Temperature,不从环号推导。
  • 压力:明确 Atmosphere.Pressure 优先。否则需相对地球大气 Atmosphere.Mass、Gravity、物理直径。地球直径、Gravity 1、Mass 1 得 1 大气压,缺输入不算。
  • 相态:Hydrography 物质、总 Surface 百分比、正 Temperature。识别 H2O、S、SO2、NH3、CH4、N2、CO2、H2SO4,按温度算 SurfaceLiquid、SurfaceSolid。未知物质不自动获得新熔点。
  • 宜居:Habitability 0,加大气、水覆盖、温度。零开计算,人类结果在 Habitability.Human,与工人经济独立。Affinity、Economy 不自动开启生产、资源收入、人口或政府。
[
  ["MyPhysicalWorld", "Is", "World"],
  ["MyPhysicalWorld", "Name", "MyPhysicalWorldName"],
  ["MyPhysicalWorld", "Icon", "earth_africa"],
  ["MyPhysicalWorld", "Orbit.Center", "Sun"],
  ["MyPhysicalWorld", "Orbit", 3],
  ["MyPhysicalWorld", "Size.Measure", "Kilometers"],
  ["MyPhysicalWorld", "Size", 12742],
  ["MyPhysicalWorld", "Weight", 5.972e24],
  ["MyPhysicalWorld", "Temperature", 288],
  ["MyPhysicalWorld", "Atmosphere", "Breathable"],
  ["MyPhysicalWorld", "Atmosphere.Pressure", 1],
  ["MyPhysicalWorld", "Hydrography", "H2O"],
  ["MyPhysicalWorld", "Hydrography.Surface", 71],
  ["MyPhysicalWorld", "Habitability", 0]
]
{
  "MyPhysicalWorldName": "物理星球"
}

新游戏第三环空格出现“物理星球”,地球保留。描述中质量直径计算密度重力,大气水参与宜居。本例温度固定,未设加热用 Distance 和 CentralBody。

重要限制:同一 Size 也用于游戏工位数,12742 公里可能产生巨大工位数而非普通领土。没有自动公里转游戏尺度开关。例子展示物理,不提供平衡殖民或资源发牌。普通游戏地图保留 World 尺度。

大气性质及开放组成见 Atmosphere。MagneticField、Geology.Tectonics 数字无分类规则仍是作者分数,非百分比或自动类别。Habitability、Economy 不替代 Workers、Production、Income。

新图像、背景和音效的确切文件

下面把自己素材关联现有对象。先在模组创建所列文件,子目录用于整理,三元组只用不含路径扩展的名。因此 Art/Icons/my_icon.png 与 Art/Worlds/my_icon.png 冲突。新素材名唯一,替换旧素材则重复原名位置。

Art/Icons/my_corporation.png
Art/Worlds/my_ice00.png
Art/Worlds/my_ice01.png
Art/Stars/my_star00.png
Art/Worlds/Sprites/myrings_down.png
Art/Worlds/Sprites/myrings_up.png
Art/Backgrounds/my_space00.jpg
Sounds/FX/my_scan.ogg
Sounds/Music/my_theme.ogg

图标天体用透明 PNG,可先用 256×256 图标行星、1024×1024 恒星,非强制,游戏会缩放。对象留在方形画布内避免裁切。背景 JPG 可 1920×1080,窗口比例可能裁边。以下为 Logic/Assets.json 数组片段。

["CorpMiner", "Icon", "my_corporation"],
["TinyIce", "Icon", "my_ice"],
["ClassK", "Icon", "my_star00"],
["TinyIce", "Rings", "MyRings"],
["Simulation", "Background", "my_space"],
["Explore", "Sound", "my_scan"],
["Simulation", "Music", "my_theme"]

修改现有采掘者 CorpMiner、微型冰雪星球 TinyIce、橙星 ClassK。作者先创建文件,再关联。无精确 my_ice.png,TinyIce 随机取 my_ice00/01,数字可紧跟或在下划线后,如 my_ice_00。精确基本名文件存在则优先。ClassK 总用 my_star00。MyRings 查小写 myrings_down/up,分别天体后前,另需 MyRings 翻译标签。

Background my_space 查连续 00.jpg、01.jpg 等,单个也需 00,缺首个编号就停止。Sound、Music 用 OGG,建议 Vorbis,短效单声道音乐立体声。采样率不由事实设置。重复 Music 替换列表,追加曲用文件章节 add。

Text/zhCN.json 添加 MyRings 为“我的光环”。启用,选采掘者与“K 型恒星系”,图像应改变。TinyIce 只改该类(提示类型为冰雪星球),其他冰类不变,随机地图不保证有它。保证检查可用“自定义恒星与保证母星”,雪区仅 TinyIce。执行探索检查 my_scan,无素材先查名称路径。

玩家与事件调色板

选择公司事件颜色见“Color - 颜色标识”,包含允许名与例子。

星球转变、伤害及辅助功能

新的传播星球

连锁感染见“Spread 与 Spreads - 连锁转变”的完整例子,一次替换见“Transforms - 天体转变”。

Damage 真正造成伤害的上下文

改小行星炮击见“Health 与 Damage - 耐久与伤害”,说明 Bombard、Damage.Target 及炮击碰撞区别。

Enabled 和 Url 何时有效

麦克风状态见“Enabled - 开关状态”,商店关联见“Url - 外部地址”,注明试玩限制。

玩家状态与可用内容边界

本局包含玩家、连接与当前选择,模组无需手建。下面供阅读状态参考,不是新网络模式配方。

Player 为玩家、Human 为人类、AI 为人工玩家。Simulation Players 是非负整数玩家数,通用调色板最多八个生成变体。但 《前曲速时代》 为单人设计,Is AI 不增加有策略对手或联机,普通模组不改人数。

Seat.<标识> 关联连接玩家,Selected.<标识> 保存此连接选择,Started 表示已开始。由游戏写,不从存档搬入模组。Started 不创建星球,Selected 不决定按钮可用,Seat 不替代行动权限验证。

World 星球、Rocky 岩质组成、Icy 冰质类别(界面标签“寒冷”)、Giant 巨行星、Star 恒星、Satellite 卫星。SurfaceBuilding 地表建筑、Orbital 轨道建筑。Unique 是唯一性,Store、Site 是链接描述类别。不是所有 Is 后词都有同名谓词。新类别分类数据,不因任意角色名称就获得现成行为。

11. 反馈与建议

发现错误、难懂说明或希望改进?请联系 support@clarusvictoria.com,注明游戏版本和章节。若示例表现不同,请附模组文件并说明实际结果。