Stellaris Mod 教程 | 博客

雇佣领袖（仅供参考）

Wed, 08 Oct 2025 00:00:00 GMT

country_event = {
    id = cns_psibac.6
    title = cns_psibac.6.title
    desc = cns_psibac.6.desc
    show_sound = par_event_beholder
    location = event_target:beholder_planet
    is_triggered_only = yes

    event_window_type = leader_recruit
    picture_event_data = {
        portrait = event_target:clam_psibac_leader
        room = ethic_spaceship_room
    }
    picture = GFX_leader_recruitment_bg_legendary_beholder

    trigger = {
        always = yes
    }

    immediate = {
        create_country = {
            name = "NAME_clam_psibac_country"
            type = faction
            auto_delete = yes
            flag = {
                icon = {
                    category = "special"
                    file = "unknown.dds"
                }
                background = {
                    category = "backgrounds"
                    file = "00_solid.dds"
                }
                colors = {
                    "red"
                    "red"
                    "null"
                    "null"
                }
            }
            effect = {
                save_event_target_as = clam_psibac_country
            }
        }
        event_target:clam_psibac_country = {
            create_species = {
                name = "NAME_clam_psibac"
                class = PARAGON
                portrait = root.species
                traits = random
                allow_negative_traits = no
                effect = {
                    save_event_target_as = clam_psibac_species
                }
            }
            event_target:clam_psibac_species = {
                change_species_characteristics = {
                    portrait = root.leader
                    can_be_modified = no
                    can_change_leader = yes
                }
            }
            create_leader = {
                class = scientist
                species = event_target:clam_psibac_species # 物种
                tier = leader_tier_legendary
                name = "NAME_The_clam_psibac" # 领袖名
                skill = 5
                gender = indeterminable
                event_leader = yes
                background_ethic = ethic_gestalt_consciousness
                skip_background_generation = yes

                # loc 开场白
                custom_catch_phrase = clam_psibac_catch_phrase
                # loc 背景故事
                custom_description = clam_psibac_backstory

                immortal = yes # 不朽
                hide_age = yes

                randomize_traits = no
                can_manually_change_location = no
                can_assign_to_council = no

                traits = {
                    trait = leader_trait_living_sea_of_psibac
                    # 命定特质还没写，总之是要加经验获得和研究能力。
                    trait = leader_trait_bio_psychic_gene
                    trait = leader_trait_superbrain_acceleration
                    trait = leader_trait_spark_of_genius
                    trait = subclass_scientist_councilor
                }

                set_age = 0

                effect = {
                    # 先生成
                    save_global_event_target_as = clam_psibac_leader

                    # 传奇领袖标记，哪怕不是传奇也会成为传奇
                    set_leader_flag = legendary_leader
                    # 挂个名
                    set_leader_flag = clam_psibac
                    # 免疫负面特质
                    set_leader_flag = immune_to_negative_traits
                    # 不会在部分事件探索中死亡，意外死亡不触发葬礼事件
                    set_leader_flag = leader_death_events_blocked

                    # 下两个是核心内容

                    # 定在这个自动被删掉的国家里。
                    set_owner = root
                    # 后删除，该事件完成后国家也会消失，但 event target 被保留。
                    exile_leader_as = clam_psibac_leader
                }
            }
        }
    }

    option = { # HIRE
        name = HIRE
        tag = hire_leader

        # "§Y$XXX$§!作为一名§H领袖§!加入你的帝国"
        custom_tooltip = paragon_clam_psibac_joins
        #sound = par_beholder_hire

        hidden_effect = {
            clone_leader = {
                target = event_target:clam_psibac_leader
            }
            last_created_leader = {
                save_global_event_target_as = clam_psibac_leader
                set_leader_flag = legendary_leader
                set_leader_flag = clam_psibac

                # 上面三个是标准的，后面两个是额外追加的免疫负面特质和抗拒死亡

                set_leader_flag = immune_to_negative_traits
                set_leader_flag = leader_death_events_blocked
                leader_event = { id = cns_psibac.8 days = 180 }
            }
            create_message = {
                type = MESSAGE_RECRUITED_LEADER
                localization =  MESSAGE_RECRUITED_LEADER_DESC
                days = @toast_message_days
                target = event_target:clam_psibac_leader
                variable = {
                    type = name
                    localization = LEADER
                    scope = event_target:clam_psibac_leader
                }
                variable = {
                    key = "border"
                    value = "GFX_border_legendary"
                }
            }
            hidden_effect = {
                root = {
                    random_owned_planet = {
                        set_planet_flag = psibac_hatcher_planet
                    }
                }
            }
        }
    }

    option = { # DISMISS
        name = REFUSE
        tag = dismiss_leader
        #sound = par_beholder_dismiss

        hidden_effect = { } # 藏不了一点
        event_target:clam_psibac_leader = {
            kill_leader = { show_notification = no }
        }
    }

    # 选项慢慢填，做好差异.

    option = {
        name = cns_psibac.6.a # 直接投降：你是什么东西？
        response_text = cns_psibac.6.a.response
        is_dialog_only = yes
        trigger = {
            has_country_flag = psi_bacterias_method4
        }
    }
    option = {
        name = cns_psibac.6.b # 宣誓顺从：你为什么愿意加入我们？
        response_text = cns_psibac.6.b.response
        is_dialog_only = yes
        trigger = {
            has_country_flag = psi_bacterias_method3
        }
    }
    option = {
        name = cns_psibac.6.c # 通用：你能为我们做什么？
        response_text = cns_psibac.6.c.response
        is_dialog_only = yes
    }
    option = {
        name = cns_psibac.6.d # 通用：你能为我们做什么？
        response_text = cns_psibac.6.d.response
        is_dialog_only = yes
    }

    after = {
        # 打扫收尾,清除 flag 什么的，你也可以不收尾，无所谓。
    }
}

在银河界面生成粒子效果

Sat, 04 Oct 2025 00:00:00 GMT

common/message_types/tc_message_types.txt

message_type = {
    key = "TC_TEST_MESSAGE"

    icon = "GFX_tc_message_infusion"
    icon_frame = 1

    name = TC_TEST_MESSAGE
    ping = tc_ping_target
    sound = "notification"
}

events/tc_test.txt

planet_event = {
    id = tc_test.5
    is_triggered_only = yes
    hide_window = yes

    trigger = {}

    immediate = {
        create_message = {
            type = TC_TEST_MESSAGE
            target = this
            recipient = owner
            localization = TEST
            days = 30
        }
    }
}

gfx/pingmap/tc_pingmap.txt

tc_ping_target = {
    system_entity = "t_mega_aura_beam_hit_entity"
    galaxy_entity = "tc_mega_aura_beam_hit_entity"

    system_normal_zoom = 1000
    galaxy_normal_zoom = 1000
    duration = 10
}

基于 4.1 版本的领袖框修复（原版向）

Sat, 04 Oct 2025 00:00:00 GMT

添加本地化

看了一下原本的本地化也删了，可以不做覆盖了

l_simp_chinese:
  LEADER_TIER_FRAME: "[Root.LeaderTierNumberExpand]"

Scripted Loc

defined_text = {
    name = LeaderTierNumberExpand
    random = no
    text = {
        trigger = {
            OR = {
                has_leader_flag = renowned_leader
                is_leader_tier = leader_tier_renowned
                check_variable = {
                    which = leader_tier_graphical_mlr
                    value = 2
                }
            }
        }
        localization_key = 2
    }
    text = {
        trigger = {
            OR = {
                has_leader_flag = legendary_leader
                is_leader_tier = leader_tier_legendary
                check_variable = {
                    which = leader_tier_graphical_mlr
                    value = 3
                }
            }
        }
        localization_key = 3
    }
    default = 1
}

恐惧状态兼容

Tue, 30 Sep 2025 00:00:00 GMT

兼容用恐惧状态相关的修正

immune_to_terrify = {
    icon = mod_ship_experience_gain_mult
    percentage = yes
    good = yes
    category = ship
    localize_with_value_key = yes
}
immune_chance_terrify = {
    icon = mod_ship_experience_gain_mult
    percentage = yes
    neutral = yes
    category = ship
}
terrify_duration_mult = {
    icon = mod_ship_experience_gain_mult
    percentage = yes
    neutral = yes
    category = ship
}
terrify_duration_add = {
    icon = mod_ship_experience_gain_mult
    percentage = no
    neutral = yes
    category = ship
}

本地化

l_simp_chinese:
  mod_immune_to_terrify: "不会受到['concept_terrify',恐惧状态]影响"
  mod_immune_chance_terrify: "受到['concept_terrify',恐惧状态]影响的概率"
  mod_terrify_duration_mult: "['concept_terrify',恐惧状态]持续时间"
  mod_terrify_duration_add: "['concept_terrify',恐惧状态]持续时间"

需要覆盖的 SV

immune_chance_terrify = {
    base = 1
    add = modifier:immune_chance_terrify
    min = 0
}
ship_terrify_chance = {
    base = 0
    modifier = { add = 25 ship_size_multiplier < 2 }
    modifier = { add = 20 ship_size_multiplier >= 2 ship_size_multiplier < 4 }
    modifier = { add = 10 ship_size_multiplier >= 4 ship_size_multiplier < 8 }
    modifier = { add = 3 ship_size_multiplier >= 8 ship_size_multiplier < 16 }
    modifier = { add = 1 ship_size_multiplier >= 16 }
    modifier = {
        factor = 0
        OR = {
            has_ship_flag = immune_to_terrify
            check_modifier_value = {
                modifier = immune_to_terrify
                value > 0
            }
        }
    }
        mult = value:immune_chance_terrify
}
terrify_duration_factor = {
    base = 1
    add = modifier:terrify_duration_mult
    min = 0
}
ship_terrify_duration = {
    base = 0
    modifier = { add = 10 ship_size_multiplier < 2 }
    modifier = { add = 8 ship_size_multiplier >= 2 ship_size_multiplier < 4 }
    modifier = { add = 6 ship_size_multiplier >= 4 ship_size_multiplier < 8 }
    modifier = { add = 5 ship_size_multiplier >= 8 }
    add = modifier:terrify_duration_add
    mult = value:terrify_duration_factor
}

灵能抑制/增幅通用

Tue, 30 Sep 2025 00:00:00 GMT

灵能抑制/增幅通用修正

is_psionic_inhibitor = {
    icon = mod_ship_psionic_aura_speed_mult
    percentage = no
    neutral = yes
    category = ship
    localize_with_value_key = yes
}
is_psionic_burster = {
    icon = mod_ship_psionic_aura_fire_rate_mult
    percentage = no
    neutral = yes
    category = ship
    localize_with_value_key = yes
}

修正的本地化

l_simp_chinese:
  mod_is_psionic_inhibitor: "具备['concept_psionic_inhibitor']"
  mod_is_psionic_burster: "具备['concept_psionic_burster']"
  # concept_psionic_inhibitor与concept_psionic_burster这两个概念如下：
  concept_psionic_inhibitor: "灵能抑制器"
  concept_psionic_inhibitor_desc: "更先进的灵能抑制器能够有效的抑制大多数的灵能活动模式，从而逐渐阻断星系内的灵能光环等灵能活动影响，抑制灵能光环的扩散，甚至让灵能物种缓慢的失去灵能能力。\n\n面对某些§M危害性的灵能活动§!，其完全不会被腐化，同时表现出显著的抑制效应。"
  concept_psionic_burster: "灵能增幅器"
  concept_psionic_burster_desc: "灵能增幅器能够有效的增强大多数的灵能活动模式，从而逐渐增强星系内的灵能光环等灵能活动影响，加强灵能光环的扩散，甚至让无灵能物种缓慢的获得灵能能力。\n\n面对某些§P灵能抑制效应§!，其仍然可以生效。"

必须覆盖的 `scripted_trigger`

check_aura_suppressors = {
    optimize_memory
    NOT = {
        any_ship_in_system = {
            check_modifier_value = {
                modifier = "is_psionic_burster"
                value != 0
            }
        }
    }
    OR = {
        any_system_colony = {
            OR = {
                has_active_building = building_psionic_suppressor
                has_active_building = building_ancient_ward_2
            }
        }
        has_megastructure = shroud_seal
        check_variable_arithmetic = {
            which = value:count_neighbor_shroud_seals
            value > 0
        }

        any_ship_in_system = {
            check_modifier_value = {
                modifier = "is_psionic_inhibitor"
                value != 0
            }
        }
        tc_check_aura_suppressors = yes
    }
}

如果需要能提供灵能光环抑制，需要覆盖common/inline_scripts/shroud/psionic_aura_monthly_decrease.txt为以下内容

# Natural decrease - final value must be <= 0
monthly_decrease = {
    base = 0
    modifier = {
        subtract = 75
        system_has_psionic_inhibition_station = yes
        system_has_psionic_burster_station = no
        desc = mod_is_psionic_inhibitor
    }
    modifier = {
        subtract = 50
        neighbor_system_has_psionic_inhibition_station = yes
        system_has_psionic_burster_station = no
        desc = neighbor_has_psionic_inhibitor
    }
    modifier = {
        subtract = 50
        NOR = {
            can_system_generate_psionic_aura = {
                OWNER = root.aura_owner
            }
            is_close_to_psionic_aura_generator_system = {
                OWNER = root.aura_owner
            }
        }
        desc = DISCONNECTED_FROM_AURA_COLONY
    }
    modifier = {
        subtract = @aura_clashing_loser_decrease
        any_neighbor_system = {
            has_star_flag = aura_clash_winning_against_@root
        }
        desc = BLANK_STRING
    }
}

用到的scripted_trigger

system_has_psionic_inhibition_station = {
    optimize_memory
    any_ship_in_system = {
        check_modifier_value = {
            modifier = is_psionic_inhibitor
            value > 0
        }
    }
}
neighbor_system_has_psionic_inhibition_station = {
    optimize_memory
    any_neighbor_system = {
        check_modifier_value = {
            modifier = is_psionic_inhibitor
            value > 0
        }
    }
}
system_has_psionic_burster_station = {
    optimize_memory
    any_ship_in_system = {
        check_modifier_value = {
            modifier = is_psionic_burster
            value > 0
        }
    }
}
neighbor_system_has_psionic_burster_station = {
    optimize_memory
    any_neighbor_system = {
        check_modifier_value = {
            modifier = is_psionic_burster
            value > 0
        }
    }
}

使用 SteamCMD 上传 Mod

Fri, 24 Jan 2025 00:00:00 GMT

1. 下载并安装 Steam CMD

Steam CMD 官网：SteamCMD - Valve Developer Community。

下载链接（Windows）：https://steamcdn-a.akamaihd.net/client/installer/steamcmd.zip

下载后解压到某个文件夹中即可完成安装。

2. 准备 Mod 文件

将你的 MOD 文件整理到一个单独的文件夹中，例如 C:\StellarisMod；
确保 MOD 文件夹中包含所有必要的文件和子文件夹。

3. 创建 Steam CMD Mod 配置文件

在 MOD 文件夹中创建一个名为 mod.vdf 的文件，用于描述 mod 的基本信息；

使用文本编辑器编辑该文件，内容如下：

"workshopitem"
{
    "appid"          "281990" // 群星的 Steam APPID
    "contentfolder"  "C:\\StellarisMod" // MOD 文件夹的路径
    "previewfile"    "C:\\StellarisMod\\thumbnail.jpg" // MOD 封面图片路径
    "title"          "你的 MOD 名称"
    "description"    "你的 MOD 描述"
    "changenote"     "更新说明"
    "visibility"     "0" // 0 - 公开，1 - 仅限好友，2 - 私密
    "publishedfield" "000" // 工坊物品 ID，自动生成，不需要手动填写
    "tags"
    {
        "0" "标签1"
        "1" "标签2"
    }
}

示例：

"workshopitem"
{
    "appid"          "281990"
    "contentfolder"  "F:\\SteamLibrary\\mod\\my_stallaris_mod\\a\\Sample\\Sample\\paks"
    "previewfile"    "F:\\SteamLibrary\\mod\\my_stallaris_mod\\a\\Sample\\Sample\\images\\1.png"
    "visibility"     "0"
    "title"          "二段宇宙创生"
    "description"    "描述"
    "changenote"     "Initial release"
    "publishedfield" "3412937963"
}

4. 上传 Mod

4.1 启动 Steam CMD

打开命令提示符（CMD）或者 PowerShell；
切换到 SteamCMD 所在的文件夹：
```
cd D:\steamcmd
```
或直接点击 Steamcmd.exe

4.2 登录 Steam 账号

在 Steam CMD 中输入以下命令登录你的 Steam 账号：

login 用户名 密码

4.3 上传 MOD

输入以下命令上传 Mod:

workshop_build_item C:\StellarisMod\mod.vdf

等待上传完成，成功后会显示：

Success!

银河地图 Modding 指南

Wed, 03 Jul 2024 00:00:00 GMT

银河地图编辑器是一款第三方小工具，可用于辅助制作静态银河地图。当然，他界面是英文的，不过理解用法并不算非常困难。

UI 元素简介

左侧选项栏

Save/Load Project: 保存或加载一个用于该程序的存档，可随时读取再编辑。
Export Mod Files: 完成编辑后使用此按钮生成一个用于群星的MOD文件
Donate to Retalyx: 该软件作者的捐赠链接
Exit Editor: 顾名思义，关闭编辑器
Galaxy Generation: 这块是随机生成星系的选项
<Name> 名字当然就是名字了
Minimal system distance: 随机生成的星系最小间隔距离
Galaxy size: 顾名思义，银河大小，不能大于半径 500（即 1000）
Numbers of systems: 随机生成多少个星系
Perlin Noise: 微调噪声生成器的选项。

若需要随机散布，设定好选项后点“Auto Generate Galaxy“进行随机生成若不需要，这里只需要填个名字，然后看后面的内容。

顶部选项栏

顶部按钮，从左到右：

[切换背景图显示]：给编辑界面叠加一个背景图。读取 images 文件夹下的 imageBackground01.png，图像分辨率 2048*2048。若有一个预先设计好的背景图片，在放置星系时会方便定位很多。
[切换星系中心] 即编辑界面的黑圆，这指示了银河核心的大概范围
[切换边框] 即方形边框红色是最大可用范围蓝色是可用范围的一半位置。
[开关背景音乐] 切换这个软件的背景音乐
[改变风格] 切换这个软件UI的风格，建议默认，其他大部分都挺辣眼睛
[显示快捷键] 显示这个软件的快捷键操作提示

右侧选项栏

、最重要的一部分。

[Reset Mode] 清除当前的选择模式。转换为”选择模式”
[Spawn Mode] 选择生成位置模式，这个指的是玩家和 AI 可能作为出生位置的地方，使用该模式选定一个星系即可指定其为出生地。或用 [Auto Generate X spawn] 随机指定出生点。
[Move Mode] 移动编辑器内的元素，移动方式是按住不放并拖动
[Create system] [Delete system] 创建和删除星系
[Create nebula] [Delete nebula] 创建和删除星云注意：已放置的星云有时会无法选中，谨慎操作，善用保存
[Connect Hyperlane] 创建航道。选择该模式后，左键点击星系 A，再点击星系 B，即可在 AB 之间创建航道。也可利用该功能的随机系统随机为当前已放置星系生成随机航道。

星系信息面板

选择一个星系时会有这些选项。

[is Home/Center Star] 不明
System ID 是在代码上这个星系的 ID，若需要在文档内精确查找可以找这个 ID
System Name 是这个星系的代码名生成在最终的文件中，可直接显示，或被本地化文件作为本地化 key.
Position: 位置，也会被生成于输出后的文件中
Hyperlanes: 超空间航道数量，左侧数字为当前连接数，实际上不存在上限所以右侧数字不重要。
[prevent Hyperlanes to any] 这是个切换模式的按钮，切换阻挡/允许航道连接。似乎是用于控制自动生成航道时的行为，多次切换此模式会清除该星系已连接的航道。谨慎操作。
[delete connected hyperlanes] 删除航道，会删除与该星系相连的所有航道
[Enable Empire Spawn] 作为/不作为为帝国生成位置属于生成位置的星系会有一个品红色圆圈背景。
[System Intializer] 星系预设，三个点是一些内置的预设。预设名称可以在 presets.json 中修改，也可在下面的输入框手动输入，默认为空，即随机。（似乎存在问题，不能正确在导出文件中生成）

如何进行一个静态星系的编辑

（可选）替换文件中的背景图，以作为参考。若需要控制星系预设，编辑 presets.json 文件中的 sys_init 部分
在界面中放置星系

滚轮缩放、方向键平移。不过这程序似乎没有限制帧数，且没有分离渲染帧和逻辑帧，导致平移速度异常的快。
创建航道连接，使用航道工具左键星系A，再左键星系B即可创建，注意，该程序没有阻止生成完全相同航道的行为，因此请注意是否有重复生成航道
使用 [Spawn Mode] 或星系选项指定至少一个帝国生成位置，以及若有需要，重命名这些星系并指定星系预设
所有条件都符合时，界面左上角 [Export Mod Files] 会变绿并可按下，输出为可用的 MOD 文件
在编辑器所在位置会出现一个 GeneratedMods 文件夹里面有刚刚编辑器输出的文件，在 GeneratedMods\[你刚刚导出的银河名称]\map\setup_scenarios\retalyx_[银河名称].txt 中，还需要进行一些后续操作：

retalyx_test.txt

# Made with Retalyx Static Galaxy Generator v0.97
static_galaxy_scenario = {
    name = "TEST_galaxy"
    default = no
    priority = 0
    num_empires = { min = 1 max = 1 }
    num_empire_default = 1
    marauder_empire_default = 1
    marauder_empire_max = 4
    fallen_empire_max = 4
    advanced_empire_default = 1
    core_radius = 0
    primitive_odds = 1
    crisis_strength = 1
    random_hyperlanes = no
    num_wormhole_pairs = { min = 1 max = 30 }
    num_wormhole_pairs_default = 1
    num_gateways = { min = 1 max = 20 }
    num_gateways_default = 1
    random_hyperlanes = no

    system = { id = "0" name = "Random" position = { x = -185.3112 y = 24.45286 } initializer = retalyx_random_spawn spawn_weight = { base = 1 } }
    system = { id = "1" name = "富矿星系" position = { x = -134.7234 y = 65.75729 } }
    system = { id = "2" name = "Random" position = { x = -165.4173 y = 117.861 } }
    system = { id = "3" name = "Random" position = { x = -244.6154 y = 48.89447 } }
    system = { id = "4" name = "Random" position = { x = -237.6052 y = 107.2509 } initializer = retalyx_random_spawn spawn_weight = { base = 1 } }

    add_hyperlane = { from = "0" to = "1" }
    add_hyperlane = { from = "4" to = "0" }
    add_hyperlane = { from = "3" to = "1" }
    add_hyperlane = { from = "2" to = "0" }
    add_hyperlane = { from = "4" to = "1" }
}

顶部有一堆控制星系生成属性的值，其中,确保 empires 的数量不会大于星系可用生成位置的数量。

程序会自动为出生点星系创建一个预设，删除它，出生地星系不能有星系预设。 spawn_weight 即为作为出生地的权重值，权重相同时，0号玩家总是会生成在 ID 最小的可生成星系处。由于该程序的星系预设导出似乎存在问题，若需要指定星系预设就手动添加上 initializer = [预设key值]，因此也务必在编辑器内为星系命名来便于识别。

name = "Random" 也会使这些星系真的被叫做 Random。因此如果不想要这种，删除所有 name = "Random"

星系预设建议自己制作命名一批，然后在 common\solar_system_initializers 文件夹下编写对应的星系预设，可实现星系内容完全控制，或也可调用原版已有的星系预设，没有指定预设的星系会随机生成内容。

静态地图若需要一种对称结构，也可只制作一个单元，然后用一些坐标变换的码来复制剩余的部分。输入坐标转换的 effect: coordinate_transform，那么在下一个坐标转换代码之前的星系坐标都将会根据代码乘上相应的数值。

常见的坐标转换使用方法有：

左右翻转

coordinate_transform = {
    x = { mul = -1 }
}

上下翻转

coordinate_transform = {
    y = { mul = -1 }
}

中心翻转

coordinate_transform = {
    x = { mul = -1 }
    y = { mul = -1 }
}

因此，我们可以将代码额外复制 3 次，后三部分单元分别令 x 乘 -1、y 乘 -1、x 与 y 都乘 -1 来制作一个四分的中心对称的地图。此外，除了坐标轴对称与中心对称，通过交换 x 与 y 两个坐标轴的数值可以得到沿 y=x 对称的部分，配合轴对称与中心对称可以利用其制作 8 分的对称地图；或是拼凑、复制转换不同大小的星系单元来制作更复杂的结构，如 12 分地图。

如果想要减轻编写工作量，增加代码可读性，有 mod 基础的作者可以尝试利用传参机制编写 inline_scripts，如下例：

inline_script = {
    script = map/NPVP1_1
    SEQ = F
    X = x
    Y = y
    ENC = guardians_artist_init_03
}

特别注意，要理清坐标转换之后各单元星系所在的位置，避免星系之间的连接航道发生错误。

完成所有工作后，只需要带走 map\setup_scenarios\retalyx_[星系名称].txt 文件(当然，可自由命名该文件名称)，然后带去用于联机的 MOD 中的对应位置。若也有星系预设文件，也得放在最终联机使用的 MOD 文件中（这软件自动生成的没必要留）。

IDEA 保姆级教学

Tue, 06 Feb 2024 00:00:00 GMT

第一步：下载IDEA

官网网址：https://www.jetbrains.com/zh-cn/idea/

两个版本，你要是有钱可以下上面那个，下面那个是官方免费的！

等待下载完成。

第二步：先设置中文，再安装支持插件

搜索 Chinese，下载。

搜索 Paradox，下载。

下载好后，开启（即为 √），重启IDEA。

第三步：打开你的MOD目录

注意是你某个 MOD 的整个，而不是 MOD 里的某个文件或者文件夹！！！！

第四步：设置你的游戏目录

打开 descriptor.mod，右上角会存在齿轮，点击打开。

如果配置正确，会在 “外部库” 出现如下：

好了，开始你的 modder 之旅吧。

关于新站点

Fri, 19 Jan 2024 00:00:00 GMT

鉴于 Docsify 功能的局限性，本站迁移至当前站点。

目前，旧站点已停止运营，本站点为维护z站点。

关于博客区

本站指南部分与原站点内容保持一致，而博客部分为本站点特有。

博客区会发布一些新的而无法合适地整合入指南的攻略和文档，以及一些关于 P 社和群星游戏的新闻事件。

贡献指南

本站挂载在 Github 上，并依赖 Github 作依赖管理。任何修改应该以 Github Pull Request 形式进行。

对于文档内容修改和增添，请说明修改理由。对于博客发布，请注明作者来源。

具体内容和指南参考 Github 仓库中的自述文件。

粒子编辑器配置

Fri, 05 Jan 2024 00:00:00 GMT

此篇教程仅讲述粒子编辑器的配置与基本使用，具体粒子编辑方式不进行教学。

首先，粒子编辑器并非一个独立的应用程序，而是包含在游戏主程序中的一个分支程序（这么说应该不严谨，不过明白意思就行）。

为了使用粒子编辑器，首先需要找到 Stellaris.exe 程序位置（不是 STEAM 创建的桌面图标）右键复制，并于任意位置粘贴快捷方式，然后右键此快捷方式，选择属性，在目标处的路径后面添加：

-editor -filterfile=previewer_filefilter.txt -mount="C:\Users\admin\Documents\Paradox Interactive\Stellaris\mod\<你 MOD 的根文件夹>"

注意每个 - 之间都有且仅有一个空格，其余位置没有空格。

如果你的 Mod 文件夹位于其他位置，-mount处的路径也需要作出相应修改来指向正确位置。

随后，前往 Stellaris\previewer_assets 文件夹内，打开previewer_filefilter.txt，将文件内的几个注释符 # 删除（P 社默认注释了它们，不知为何）。

然后就可以打开粒子编辑器并使用了，部分重要按钮参考下图：

如何安装新的触发器结构

Mon, 03 Jul 2023 00:00:00 GMT

经过本人长时间的测试，对游戏事件触发器产生的消耗有了进一步的认识。基于游戏触发器的消耗，以及更多 mod 环境下触发器产生的问题，本人提出以下模组的触发器结构，该结构已经被我应用在 40 多个多类型且具备高度频繁的触发器的模组内。实测在一起运行时，已取得良好效果。因此希望各位如有意愿可按照本文介绍，将您的模组接入到我们的触发器结构当中。

触发器结构的准入门槛

首先，我们的触发器结构仅包括月，年，2 年，5 年，10 年，科研完成的触发器，包括 no_scope 域与 country 域，因此如您有相关触发器，均可选择接入。

触发器列表：

`no_scope`	`country`
`on_monthly_pulse`	`on_monthly_pulse_country`
`on_yearly_pulse`	`on_yearly_pulse_country`
`on_bi_yearly_pulse`	`on_bi_yearly_pulse_country`
`on_five_year_pulse`	`on_five_year_pulse_country`
`on_decade_pulse`	`on_decade_pulse_country`
`on_tech_increased`	/

触发器结构的接入步骤

接入本触发器，需要进行以下步骤：

将以上列出的触发器前缀均加入 VOP （请务必大写），例如 on_monthly_pulse ➡️ VOP_on_monthly_pulse；

新增一个触发器 txt，如 xxx_on_actions_FRAMEWORK.txt （文件命名请务必不同，事件 id 务必相同）。
并按需（你用几个写几个，没用到的不要写）在其中添加以下代码：

VOP 全局

###     VOP 全局

# No scope, like on_game_start
on_monthly_pulse = {
    events = {
        VOP_evt_FRAMEWORK.1
    }
}

# No scope, like on_game_start
on_yearly_pulse = {
    events = {
        VOP_evt_FRAMEWORK.2
    }
}

# No scope, like on_game_start
on_bi_yearly_pulse = {
    events = {
        VOP_evt_FRAMEWORK.3
    }
}

# No scope, like on_game_start
on_five_year_pulse = {
    events = {
        VOP_evt_FRAMEWORK.4
    }
}

# No scope, like on_game_start
on_decade_pulse = {
    events = {
        VOP_evt_FRAMEWORK.5
    }
}

VOP 国家

###     VOP 国家

# this = country
on_monthly_pulse_country = {
    events = {
        VOP_evt_FRAMEWORK.8
    }
}

###     VOP 国家
# this = country
on_yearly_pulse_country = {
    events = {
        VOP_evt_FRAMEWORK.9
    }
}

###     VOP 国家
# this = country
on_bi_yearly_pulse_country = {
    events = {
        VOP_evt_FRAMEWORK.10
    }
}

###     VOP 国家
# this = country
on_five_year_pulse_country = {
    events = {
        VOP_evt_FRAMEWORK.11
    }
}

###     VOP 国家
# this = country
on_decade_pulse_country = {
    events = {
        VOP_evt_FRAMEWORK.12
    }
}

2.3 新增一个唯一触发器 txt，如 xxx_on_actions_FRAMEWORK_unique.txt （如果用到了，请保持唯一，否则会多次触发，且 id 务必相同）。
插入以下代码：
```
###     VOP 唯一

# This = Country
on_tech_increased = {
    events = {
        VOP_evt_FRAMEWORK.15
    }
}
```

前往 common/events 文件夹内，新建一个事件 txt，txt 命名务必保持不同，务必不同，务必不同，事件 id 与事件声明必须相同，如 xxxx_evts_FRAMEWORK_events.txt。
按需插入以下以下代码（请注意，如果你只是用到了月触发，请不要写入其他的触发，只写入自己用到的）：

VOP 全局

#       VOP_on_monthly_pulse
event = {
    id = VOP_evt_FRAMEWORK.1
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_monthly_pulse } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_monthly_pulse days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_monthly_pulse }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_yearly_pulse
event = {
    id = VOP_evt_FRAMEWORK.2
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_yearly_pulse } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_yearly_pulse days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_yearly_pulse }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_bi_yearly_pulse
event = {
    id = VOP_evt_FRAMEWORK.3
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_bi_yearly_pulse } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_bi_yearly_pulse days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_bi_yearly_pulse }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_five_year_pulse
event = {
    id = VOP_evt_FRAMEWORK.4
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_five_year_pulse } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_five_year_pulse days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_five_year_pulse }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_decade_pulse
event = {
    id = VOP_evt_FRAMEWORK.5
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_decade_pulse } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_decade_pulse days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_decade_pulse }
        set_update_modifiers_batch = end
    }
}

VOP 国家

#       VOP_on_monthly_pulse_country
country_event = {
    id = VOP_evt_FRAMEWORK.8
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_monthly_pulse_country } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_monthly_pulse_country days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_monthly_pulse_country }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_yearly_pulse_country
country_event = {
    id = VOP_evt_FRAMEWORK.9
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_yearly_pulse_country } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_yearly_pulse_country days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_yearly_pulse_country }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_bi_yearly_pulse_country
country_event = {
    id = VOP_evt_FRAMEWORK.10
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_bi_yearly_pulse_country } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_bi_yearly_pulse_country days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_bi_yearly_pulse_country }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_five_year_pulse_country
country_event = {
    id = VOP_evt_FRAMEWORK.11
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_five_year_pulse_country } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_five_year_pulse_country days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_five_year_pulse_country }
        set_update_modifiers_batch = end
    }
}

#       VOP_on_decade_pulse_country
country_event = {
    id = VOP_evt_FRAMEWORK.12
    hide_window = yes
    is_triggered_only = yes
    trigger = { NOT = { has_global_flag = VOP_CD_on_decade_pulse_country } }
    immediate = {
        set_timed_global_flag = { flag = VOP_CD_on_decade_pulse_country days = 1 }
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_decade_pulse_country }
        set_update_modifiers_batch = end
    }
}

VOP 唯一

#       VOP_on_tech_increased
country_event = {
    id = VOP_evt_FRAMEWORK.15
    hide_window = yes
    trigger = { exists = this }
    immediate = {
        set_update_modifiers_batch = begin
        fire_on_action = { on_action = VOP_on_tech_increased }
        set_update_modifiers_batch = end
    }
}

触发器结构的接入注意事项

触发器仅有 on_tech_increased 触发器文件必须保持唯一。
事件框架请按需使用，文件命名务必不可与其他 mod 相同，id 务必保持相同。
触发器结构请务必保持文件命名不同，id 务必相同，按需使用，不使用的不要输入。
接入到本触发器结构内的事件不能存在，任何调动途径的批处理代码，例如 set_updated_modifier_batch = begin , set_updated_modifier_batch = end

Stellaris 动画导出教程

Tue, 20 Jun 2023 00:00:00 GMT

这是一个简易的 Stellaris 模型动画导出教程，由于本人水平有限，因此无法做的非常详细，必须要假设看教程的善良人有一定的 Maya 动画基础，以及知道如何导出没有动画的模型。

因为一些奇妙的原因，Stellaris 导出带有动画的模型时，若要导出的模型包含多张贴图并且不同贴图对应的模型依托不同的骨骼的动画，导出时模型可能会意外损坏，导致部分模型消失。这个问题可以通过调整关节权重解决，不过这是一个麻烦的工程，此处介绍一个简易的不调整关节权重的导出方法。

模型概览

如下图是一个没有动画的奇怪的模型，以及带有骨骼的大纲视图。其中每个活动部件都由一个关节（joint）控制，要随部件活动的定位器（locator）都放在对应的关节下。

模型外观

骨骼 - 大纲视图

制作动画

在不绑定蒙皮的情况下制作好模型动画，注意动画只能操作关节，不能直接操作关节内的模型。

完成后选择一组无动画的部分，此处选择 ZhuTiQian 、ZhuTiZhong、ZhuTiHou （以及碰撞箱模型 col，此处截图中没有，但是仍可和前三部分模型一起绑定蒙皮处理）（其他部分其实也有没有动画的，比如 Zhuangjia ，也可以和前三个一起导出，不过制作的时候不知道未来要不要动于是就没塞进来），与 rootcenter 关节绑定蒙皮。其余部分不绑定蒙皮。

导出模型

随后删除除了刚才绑定蒙皮的 ZhuTiQian 、ZhuTiZhong、ZhuTiHou 以外的所有模型，即 Zhuangjia、FuYiA、FuYiB、FuYiC、FuYi_D……，得到如下模型（大纲视图）。

骨骼 - 导出后（带动画）- 大纲视图

其中名为 xx_attachment 的定位器为定位那些会旋转的组件使用的（见下文），其位置和所属关节重合，但进行了一定的旋转。

导出这个模型，即可获得一个动画正常，但是没有搭接其他组件的模型以及需要的动画文件。

带动画的部分导出完毕后，剩余部分（使用撤销恢复这些模型）都是一些无动画的模型（当然也可以有动画），将它们单独导出（即删除除了它自己之外的其他东西，例如之前导出的模型主体以及其他和它类似的组件），即将 Zhuangjia、FuYiA（前后两种不同的模型，此处狡猾建模命名相同无法区分）、jianxingzujian、xinghuishuijingA 作为 5 个不同的模型单独导出，获得 5 个零件。

注册模型与拼接

所有模型和零件导出完毕后，通过 .asset 中注册 entity 时的 attach 机制将它们拼在一起既是一个包含动画的完整模型，拼接方式如下：

attach = { front_armor = "ags_SRA_SOGZ_front_armor_entity" }
attach = { front_fin_01_attachment = "ags_SRA_SOGZ_front_fin_entity" }
attach = { front_fin_02_attachment = "ags_SRA_SOGZ_front_fin_entity" }
attach = { front_fin_03_attachment = "ags_SRA_SOGZ_front_fin_entity" }
attach = { front_fin_04_attachment = "ags_SRA_SOGZ_front_fin_entity" }
attach = { back_fin_01_attachment = "ags_SRA_SOGZ_back_fin_entity" }
attach = { back_fin_02_attachment = "ags_SRA_SOGZ_back_fin_entity" }
attach = { back_fin_03_attachment = "ags_SRA_SOGZ_back_fin_entity" }
attach = { back_fin_04_attachment = "ags_SRA_SOGZ_back_fin_entity" }
attach = { planet_killer = "ags_SRA_SOGZ_planet_killer_entity" }
attach = { crystal_01 = "ags_SRA_SOGZ_crystal_entity" }
attach = { crystal_02 = "ags_SRA_SOGZ_crystal_entity" }
attach = { crystal_03 = "ags_SRA_SOGZ_crystal_entity" }
attach = { crystal_04 = "ags_SRA_SOGZ_crystal_entity" }

其中由于同一个组件要以四个不同的旋转角度拼接在模型上，而直接导出的骨骼并不会记录旋转属性，因此需要使用位置和关节重合但是旋转了一定角度（此处为绕 z 轴旋转 0°，90°，180°，270°）来作为组件的搭接点。

调用这个拼接好的模型即可绕开麻烦的刷权重过程，是不是很方便呢（笑）？

Stellaris 模型三千问

Tue, 20 Jun 2023 00:00:00 GMT

Q: 模型无法通过 Maya 打开/格式不对/不支持的格式。

A: 若模型文件已损坏，那么放弃吧。若模型文件未损，可以相将模型导入 3DS 或者 Blender 软件，转换格式为 obj 或者 fbx 后再导入 Maya。
Q: 模型导出时什么都没有/导出文件大小为0/空文件。

A: 群星的模型导出必须为每个模型绑定一个 phong 材质球，并且材质球应被赋予群星模型属性，否则该模型不会被识别为应导出的模型。
Q: 模型在游戏中的颜色、光泽预览与导出预览/建模软件中的预览不同。

A: 正常现象，游戏中的模型外观受多种因素影响，如恒星光照、国家旗帜等，无需因此惊慌。
Q: 模型过于明亮，要闪瞎眼睛了。

A: 降低 diffuse 贴图 alpha 通道的亮度。
Q: 模型导出后出现拉丝、线、黏合物。

A: 通常由于模型存在破面、不闭合造成的，检查并修复可能存在的问题。若确认不存在破损仍然如此，可以在插件中选择 skip megre 等跳过合并、跳过合并三角面的选项，有概率解决问题。
Q: 模型绑定了关节和动画，进入游戏后会不停闪烁、闪屏、类似于屏幕撕碎的观感。

A: 通常情况下是因为关节数量过多导致的，建模时的关节数量不应超过 50。小概率可能是因为模型的动画过于复杂、存在破损导致的。
Q: 模型的关节无法附加属性，导出时无法导出关节和动画。

A: 确保你存在一个 root 关节作为根节点，并且所有的其他关节都是 root 关节的子关节。确保关节的确被赋予了属性，并且导出时选中了导出动画。（blender 的动画导出，对骨架名字也有要求，一定要 bones）
Q: 明明制作了动画，导出时却没有动画/动画有异。

A: 每个类别的动画应具有偶数帧，每偶数帧会被视为一段完整的动画。
Q: 进入游戏后，模型出现出现异常的拉伸动作，撕扯模型形变。

A: 通常情况下是关节绑定模型权重异常导致的，每个关节都对模型的一部分持有影响，若没有手动调整权重而自动绑定的话，比较容易出现这种问题。如果不会手动刷新权重或者懒得手动刷新权重，可以增加关节密度，让每个关节持有的模型体积减小。
Q: 我没有 normal 贴图、specular 贴图怎么办？

A: 知道你懒得做贴图了，当然，你的模型可以不使用这两种贴图，只不过会丢失一下层次感、光泽感的细节而已。但是仍然推荐你制作这两种贴图，实在不会的话，你可以把 diffuse 的 R\G\B 通道分别降低色度后赋给 specular 贴图（慎用）。
Q: 模型移动的方向不对/相反/颠倒/过于庞大或小。

A: 在 Maya 中重置模型的大小、方向，通常情况下与坐标系等大为游戏内一个正常星球的一半大小。当然你也可以通过在模型定义文件中修改 scale、绑定 locator 来控制方向。
Q: 我的星球模型一团黑。

A: 星球模型的 phong 的 shader 属性只能选择 pdxMeshPlanet。

怎么在只有 diffuse 的情况下制作 normal 和 specular

Tue, 20 Jun 2023 00:00:00 GMT

使用说明

本方法适用于已经有 diffuse 的情况。
本方法适用简单模型，复杂的模型和对细节要求高的模型本方法效果不佳。
本方法需要准备的软件：PS（必要）（演示中用的软件是 sai2，并不是必要的）。

想认真学习模型的 modder 最好还是学习一下 Substance Painter。

如何操作

首先。如图所示，你现在有了一个模型（mesh）和一个 diffuse 贴图，第一步就是先做出图中的后面两个材料。

这一步我们要先做一个黑黑的蒙版，normal 在蓝通道透明的地方就能在群星里有发光效果，所以可以理解为黑色的部分在 normal 蓝通道里起一个遮光的作用，把想要发光的地方扣出来如图所示，然后其他部分涂黑，设置背景为透明导出为 png 备用。

金属度和上述的 normal 同理，这个越白，金属光泽越高。通过调整颜色深浅可以调整不同地方的金属度（注：如果你的模型长得白白的，金属度最好调低一点，不然会很亮）。最后导出备用。

原贴图在 ps 中去色（最顶端左数第三个按钮“图像” ➡️ “调整”中操作）然后在滤镜（最顶端左数第七个按钮）中“3d”选项中选择“生成法线图”，然后随便调整一下细节（真·随便）。

把我们上面处理好的黑色遮罩放进蓝通道里。

然后就快大功告成了！记得把透明度改成需要的效果，这一步不想试就无脑 50%（亲测有效）

同理处理一下 specular，和 normal 不同的是，specular 不需要 3d 滤镜，diffuse 去色后直接把我们刚刚准备的灰色贴图放进蓝通道里吧。调整一下透明度（也可以无脑50%）。

Stellaris Mod 教程 | 博客

雇佣领袖（仅供参考）

在银河界面生成粒子效果

基于 4.1 版本的领袖框修复（原版向）

添加本地化

Scripted Loc

恐惧状态兼容

兼容用恐惧状态相关的修正

本地化

需要覆盖的 SV

灵能抑制/增幅通用

灵能抑制/增幅通用修正

修正的本地化

必须覆盖的 scripted_trigger

如果需要能提供灵能光环抑制，需要覆盖common/inline_scripts/shroud/psionic_aura_monthly_decrease.txt为以下内容

用到的scripted_trigger

使用 SteamCMD 上传 Mod

1. 下载并安装 Steam CMD

2. 准备 Mod 文件

3. 创建 Steam CMD Mod 配置文件

4. 上传 Mod

4.1 启动 Steam CMD

4.2 登录 Steam 账号

4.3 上传 MOD

银河地图 Modding 指南

UI 元素简介

左侧选项栏

顶部选项栏

右侧选项栏

星系信息面板

如何进行一个静态星系的编辑

IDEA 保姆级教学

第一步：下载IDEA

第二步：先设置中文，再安装支持插件

第三步：打开你的MOD目录

第四步：设置你的游戏目录

关于新站点

关于博客区

贡献指南

粒子编辑器配置

如何安装新的触发器结构

触发器结构的准入门槛

触发器结构的接入步骤

触发器结构的接入注意事项

Stellaris 动画导出教程

模型概览

制作动画

导出模型

注册模型与拼接

Stellaris 模型三千问

怎么在只有 diffuse 的情况下制作 normal 和 specular

使用说明

如何操作

必须覆盖的 `scripted_trigger`