内联代码(Inline Scripts)

内联代码能够让 modder 在一个文件中写入一个代码块，然后将该代码块包含到其他代码中，就好像它将直接复制黏贴到其他代码中一样（可以理解为跨文件的 C 宏替换），从而可以防止大量的复制粘贴并降低代码的耦合度。当脚本块内部的某些内容需要更新时，它尤其有用，因为更新 inline_script 将自动更新使用该 inline_script 的所有脚本、

这与 scripted_triggers 和 scripted_effects 的工作方式非常相似，但内联脚本可以用于模块化或不是 Effect 或 Condition 的东西（例如，请参阅香草的策展人对话框）。

官方文档参见 Stellaris/common/inline_scripts/00_README.txt 。

如何使用

想要创建一个新的内联代码块，需要在 common/inline_scripts 文件夹中创建一个 txt 文件，其中包含要内联到其他脚本中的代码。请注意，每个文件只能有一个内联代码块，并且在使用该内联代码块时将使用文件名。我们可以通过将内联脚本放在子文件夹中来组织它们。

我们先来看一个示例：

1
resources = {
2
    category = edicts
3
    upkeep = {
4
        unity = 10
5
        multiplier = value:edict_size_effect
6
    }
7
}

随后我们可以使用 inline_script = <file_name_without_extension> 来调用这个内联代码。例如：

1
modifier = {
2
    starbase_upgrade_speed_mult = 0.50
3
    country_starbase_capacity_add = 2
4
}
5
inline_script = "my_test_folder/test_inline_script"

这相当于如下代码：

1
modifier = {
2
    starbase_upgrade_speed_mult = 0.50
3
    country_starbase_capacity_add = 2
4
}
5
resources = {
6
    category = edicts
7
    upkeep = {
8
        unity = 10
9
        multiplier = value:edict_size_effect
10
    }
11
}

参数传递

参数同样可以用于调控内联代码，例如：

1
$KEY$ = {
2
    option = {
3
        name = "$KEY$_a"
4
        on_enabled = {
5
            add_modifier = { modifier = $MODIFIER_A$ days = 360 }
6
        }
7
    }
8
    option = {
9
        name = "$KEY$_b"
10
        on_enabled = {
11
            add_modifier = { modifier = $MODIFIER_B$ days = 360 }
12
        }
13
    }
14
}

然后我们可以这么使用：

1
inline_script = {
2
    script = test_basic_policy
3
    KEY = test_1
4
    MODIFIER_A = evermore_science
5
    MODIFIER_B = fumongus_authoritarian
6
}

等效于如下代码：

1
test_1 = {
2
    option = {
3
        name = "test_1_a"
4
        on_enabled = {
5
            add_modifier = { modifier = evermore_science days = 360 }
6
        }
7
    }
8
    option = {
9
        name = "test_1_b"
10
        on_enabled = {
11
            add_modifier = { modifier = fumongus_authoritarian days = 360 }
12
        }
13
    }
14
}

同时，内联代码的参数可以接受字符串，也就是说我们可以通过字符串传递代码给内联代码块，例如：

定义：

1
resources = {
2
    category = edicts
3
    upkeep = {
4
        unity = 10
5
        multiplier = value:edict_size_effect
6
    }
7
}
8
modifier = { $MODIFIER$ }

使用：

1
inline_script = {
2
    script = just_an_example
3
    MODIFIER = "num_tech_alternatives_add = 1 scientist_skill_levels = 2"   # 就像这样
4
}

等效于：

1
resources = {
2
    category = edicts
3
    upkeep = {
4
        unity = 10
5
        multiplier = value:edict_size_effect
6
    }
7
}
8
modifier = {
9
    num_tech_alternatives_add = 1
10
    scientist_skill_levels = 2
11
}