M0 回合制战斗壳层：接口与单局状态、调试入口、暂停联动

2026-09-01 10:20:02 +08:00
parent fce331da84
commit 8413c2688b
82 changed files with 12032 additions and 8 deletions
@@ -0,0 +1,46 @@
+using UnityGameFramework.Runtime;
+
+namespace SepCore.CustomComponent
+{
+    /// <summary>
+    /// 单局共享随机组件。
+    /// 种子由局外（战备/部署界面玩家输入）带入，进入单局时初始化；
+    /// 地图生成、物资点、敌人 AI、逃跑判定和敌人掉落依次消费同一个随机源，
+    /// 战斗只沿用该随机源，不创建战斗私有随机源。
+    /// 对应 Docs/GameDesign/03_RunExploration.md 的随机生成器约定。
+    /// </summary>
+    public class RandomComponent : GameFrameworkComponent
+    {
+        private int _seed;
+        private IRunRandomSource _random;
+
+        /// <summary>
+        /// 获取本局随机种子；未开始单局时为 0。
+        /// </summary>
+        public int Seed => _seed;
+
+        /// <summary>
+        /// 获取本局共享随机源；未开始单局时为 null。
+        /// </summary>
+        public IRunRandomSource Random => _random;
+
+        /// <summary>
+        /// 开始一局新的单局：使用局外带入的种子初始化共享随机源。
+        /// </summary>
+        /// <param name="seed">本局随机种子。</param>
+        public void BeginRun(int seed)
+        {
+            _seed = seed;
+            _random = new RunRandomSource(seed);
+        }
+
+        /// <summary>
+        /// 结束当前单局，清空种子与随机源。
+        /// </summary>
+        public void EndRun()
+        {
+            _seed = 0;
+            _random = null;
+        }
+    }
+}