Multi-Star Systems / 多星系统

真实宇宙中，约 50% 的恒星以双星或更高阶多星系统的形式存在。Multi-Star Systems 为《戴森球计划》的新银河加入稳定、可见且持续运动的多星系统：恒星会围绕共同质心运行，外层恒星与外层双星也会在行星区之外缓慢公转。

这不是把几颗恒星静态摆在一起的视觉效果。星图、飞行、行星位置和本地光照都会跟随多星系统的运动更新，让玩家能在游戏中观察并探索真正运动的多恒星环境。

主要内容

稳定的二至六星系统

新银河会生成双星、三星、四星、五星和六星系统。不同星数采用稳定的层级构型：

紧凑双星会清晰地高速互绕。层级构型中的外层恒星或外层双星位于主恒星最外层行星轨道之外，并以更慢的周期绕系统质心运行。

可探索的外层星系

每个多星系统都有一个主恒星，负责核心星系玩法。层级系统中的外层恒星同样可以拥有自己的行星；在双双星系统中，远侧双星也可以作为独立的外层行星子系统存在。

外层行星可在星图中直接选择、抵达和开发，并会与所属恒星同步移动。为维持游戏结构，黑雾与戴森球仍由主恒星承担，外层星系不会生成黑雾或独立戴森球。

多恒星光照与戴森球

伴星会依据光度和距离向本地行星提供方向性补光。夜侧可能出现类似黎明或黄昏的亮度，但补光受到限制，不会让整颗行星长期处于正午。

当主恒星属于直接双星时，建造戴森球会合并这对恒星的光度，用于戴森球的有效光度计算。

特殊恒星与星图信息

多星系统可能包含 O 型星、蓝巨星、中子星或黑洞。新银河保证至少出现一个特殊多星系统，约半数多星系统会包含特殊恒星。

在星图中查看恒星详情时，面板会显示其所属的双星、三星或更高层级关系，便于识别系统结构。

新银河与星数

创建新银河时，游戏中的星数设置仍表示可正常形成主行星系的恒星数量。以默认 64 星为例，银河会保证至少有 64 个常规行星星系；多星伴星和外层行星子系统会作为额外天体加入，不会挤占这 64 个位置。

多星系统会为主恒星的近轨区域留出空间，直接环绕主恒星的行星从更外侧轨道开始生成。

运动速度

默认速度已针对星图观察调整：紧凑双星通常约以两分钟完成一周，外层成员与双星质心的周期更长。可在首次启动后生成的配置文件中调整：

BepInEx/config/Zincon.DSPMultiStarSystems.cfg

安装

使用 r2modman

发布到 Thunderstore 后，在 r2modman 中搜索 MultiStarSystems 并安装即可。也可以下载 GitHub Release 的压缩包，通过 r2modman 的“导入本地 Mod”功能安装。

手动安装

1. 安装 BepInEx 5。
2. 安装 DSPModSave。
3. 将发布包解压到 BepInEx/plugins/。
4. 启动游戏并创建新银河。

依赖与兼容性

必需依赖：

• BepInEx 5
• DSPModSave

已知不兼容：

• GalacticScale 2
• RealGalaxy

这些 Mod 同时修改银河生成、恒星位置或天体编号，不能与本 Mod 一起使用。

WanderingPlanetIII 可以与本 Mod 同时使用。它的流浪系统会使用独立的恒星编号，多星系统成员不会被转换为流浪行星锚点。

BulletTime 目前可能与本 Mod 存在兼容性问题。如果同时安装后出现银河生成、恒星运动或存档载入异常，请先停用其中一个 Mod。

存档说明

• 多星系统只会加入安装本 Mod 后创建的新银河；普通旧存档不会被转换。
• 已由本 Mod 创建的存档会保存多星系统的构型与运动状态，可正常继续读取。
• 不建议在含有多星系统的存档中途移除本 Mod。操作前请保留备份。
• 更新版本后，新增加的银河生成内容需要新建银河才能出现；已有系统不会被强制重排，以避免改变现有行星归属。

本版本基于《戴森球计划》0.10.34.28529 构建和验证。

English Summary

Multi-Star Systems adds stable, visibly moving binary through six-star systems to newly generated Dyson Sphere Program universes.

• Compact binaries orbit rapidly while outer stars and outer binaries move beyond the main system's planetary region.
• Outer hierarchy stars can own, display, and be reached through their own planets; Dark Fog and Dyson spheres remain tied to the primary star.
• Companion starlight creates capped twilight-style fill lighting on local planets.
• Direct binary companions contribute their luminosity to the primary star's Dyson-sphere calculation.
• Requires BepInEx 5 and DSPModSave. GalacticScale 2 and RealGalaxy are incompatible. WanderingPlanetIII is supported together with this mod. BulletTime may have compatibility issues.

License

MIT License. See LICENSE.txt.

Changelog

1.3.4 - 2026-07-29

• Fixed loading multi-star saves created before outer hierarchy stars could own planets. Legacy plans now retain their original single-real-star planet topology, preventing core save data from being read with shifted planet IDs.

1.3.3 - 2026-07-29

• Fixed save loading when another galaxy-generation mod restores the selected gameplay-star count after Multi-Star Systems has expanded it into physical companion stars.
• Multi-star save restoration now runs after compatible galaxy generators have completed their setup, and logs an explicit diagnostic when a .dsv file and its .moddsv sidecar do not belong together.

1.3.2 - 2026-07-27

• Added a compatibility warning for BulletTime, which may conflict with galaxy generation, stellar motion, or save loading.
• Clarified the public compatibility notes.

1.3.1 - 2026-07-27

• Added compatibility with wandering planet III.
• Reserved wandering-system star IDs outside the multi-star plan and prevented wandering anchors from consuming multi-star members.

1.3.0 - 2026-07-27

• Outer hierarchy stars can now generate and retain their own planets while remaining virtual for Dark Fog and Dyson-sphere ownership.
• Double-binary systems now support an outer binary subsystem: its primary star owns planets, and its companion remains planetless.
• Planet-owning outer stars remain directly selectable, reachable, and synchronized while their stellar hierarchy moves.

1.2.1 - 2026-07-27

• Reduced the default stellar orbit multiplier from 3600x to 1800x. Existing untouched 3600x settings migrate automatically.
• Guaranteed a visible O-star or blue-giant virtual companion in each new galaxy without increasing the special-system rate.
• Kept hierarchical massive outer stars virtual and placed them outside the real star's outermost planetary orbit; inner binaries remain compact.
• Restored multi-star relationship text inside the star-detail panel, reserving vertical space so it no longer overlaps resource entries.

1.2.0 - 2026-07-27

• Raised the default stellar orbit speed from 20x to 3600x and migrated untouched legacy default settings so binary motion is immediately visible.
• New galaxies now treat the selected star count as the number of planet-owning stars; a default 64-star galaxy contains exactly 64 real or single stars plus any required virtual companions.
• Guaranteed at least one O star in every newly generated galaxy and separated white dwarfs from the neutron-star/black-hole compact-object binary branch.
• Added inverse-square companion-star fill lighting on local planets. It is capped at 35% of the primary light so an opposite companion can produce twilight-level nights without full daytime brightness.
• Moved multi-star relationship text to a dedicated side area of the star-detail panel to avoid resource-list overlap.

1.1.0 - 2026-07-27

• Reserved primary orbit slots 1 through 5 for every real star in newly generated multi-star systems; all direct planets now begin at slot 6.
• Expanded each real multi-star system's maximum stellar diameter to 3.0-5.5 times the real star's theoretical first-orbit diameter.
• Added separately randomized 1.0-5.0 factors for virtual-only nested subsystems, while keeping every hierarchy inside its real system's maximum diameter.
• Added save-layout versioning so existing 1.0.x multi-star saves retain their original spacing and remain loadable.
• Fixed multi-star plans being discarded during save loading or new-game initialization, which could reset stars to normal galaxy positions.
• Added multi-star relationship text to the star-detail panel, including nested binary and four-star relationships.
• Synchronize real-star planet poses immediately before star or planet arrival so sandbox direct travel uses current multi-star coordinates.

1.0.2 - 2026-07-26

• Fixed Wrong version of unigen algorithm! during galaxy preview and new-game creation.
• Stopped using GameDesc.galaxyAlgo as a mod marker; the vanilla algorithm version is now preserved unchanged.
• New games generate deterministic plans directly, while existing saves are recognized exclusively through matching DSPModSave data.

1.0.1 - 2026-07-26

• Fixed Harmony argument binding for Dyson editor star selection, which prevented version 1.0.0 from initializing in game.
• Changed all single-star redirection patches to positional argument binding so original parameter names cannot break initialization.

1.0.0 - 2026-07-26

• Added deterministic two- through six-star system generation.
• Added binary, triangle, hierarchical triple, square, double-binary, hierarchical four-star, pentagon, and hexagon layouts.
• Added the requested 30% square, 30% double-binary, and 40% triple-plus-massive four-star distribution.
• Added exactly one real star per system and suppression of planets, factories, Dark Fog, asteroid belts, and Dyson spheres on virtual stars.
• Added direct-binary luminosity combination for Dyson spheres.
• Added guaranteed special-star generation and approximately 50% special multi-star systems.
• Added fast visible inner-binary motion plus moving outer stars and binary barycenters.
• Added next-frame planet interpolation correction for moving real stars.
• Added deterministic save serialization, navigation redirection, tests, and game-assembly patch validation.