玩《太空工程師》的都知道飛船開著開著就歪了這件事有多煩。造了一艘大船推進器不對稱、貨艙裝了重東西、或者說你手動轉(zhuǎn)向的時候總得不停按反方向鍵去“剎車”姿態(tài)一塌糊涂。后來我試著用游戲里的可編程塊寫腳本做飛船姿態(tài)矯正實測下來比手動穩(wěn)太多了。這篇帖子就把我踩過的坑和寫腳本的思路捋清楚給同樣想搞姿態(tài)矯正的朋友做個參考。我默認你已經(jīng)至少跑過一個基礎(chǔ)的可編程塊腳本知道游戲內(nèi)C#是什么概念但細節(jié)不用怕我會把關(guān)鍵步驟都拆開說甚至新手按這個思路也能做出能用的姿態(tài)矯正。1. 為什么需要姿態(tài)矯正1.1 飛船在空中“跑偏”的高發(fā)場景先聊聊什么情況下你會需要姿態(tài)矯正而不是靠手動按鍵去頂。游戲里的飛船一旦超過幾十個小方塊手動控制的精度就會急劇下降。最常見的情況是一邊推進器點得多、一邊點得少。哪怕你造的是標準對稱船戰(zhàn)斗損失、貨倉裝礦、鉆頭伸出去鉆小行星都可能導致飛船質(zhì)心偏移。這時候你按W往一個方向飛飛著飛著船就朝一邊轉(zhuǎn)。另一個很常見的就是太陽帆太陽能板對朝向敏感你要用它充電必須把船頭對準太陽但一旦你手動調(diào)整過角度船就會慢慢晃開。還有一種是自動導航或者降落的時候你想讓飛船自動對正某個朝向比如對接舷窗的方向但手動去按軸轉(zhuǎn)總是要來回推最后要么轉(zhuǎn)過頭要么轉(zhuǎn)不到位。所以姿態(tài)矯正腳本最直接解決的就是“不靠人手按鍵、讓飛船自動穩(wěn)定在對準的朝向”。1.2 手動矯正的痛點你先試試純手動打“姿態(tài)”按住鼠標中鍵拖視角或者用陀螺儀控制方向你會發(fā)現(xiàn)船是有慣性的。你松開按鍵船并不是馬上停而是還會轉(zhuǎn)一段。你需要在快到位的時候提前按反方向鍵“剎車”但每次力度很難把握輕了剎不住重了就反向又轉(zhuǎn)了。要是船特別重陀螺儀轉(zhuǎn)速慢來回修正就更煩。更麻煩的是你在手動對正的時候沒法干別的比如你想一邊讓飛船對準某個方向一邊去操作鉆頭純手動就很難。而腳本不一樣它每秒幾十次甚至上百次地檢測偏差、自動調(diào)節(jié)推進器和陀螺儀的出力飛船就像被一只無形的手穩(wěn)穩(wěn)扶住。1.3 腳本能省掉哪些操作姿態(tài)矯正腳本可以做到點一下把船頭原地對準指定朝向。自動鎖錕讓船在飛行時保持當前姿態(tài)相對慣性不變。配合自瞄、對接、搜敵等自動操作騰出你的手去拉警報、啟動武器或切換視角。我寫這個腳本最主要的目的就是對準太陽板方位時不再手動糾正其次就是對接的時候不再反復調(diào)方向。實際用下來只要陀螺儀數(shù)量夠、推進器出力足腳本比老玩家手動操作還平滑。2. 姿態(tài)矯正腳本的核心原理2.1 游戲里的朝向是怎么表示的太空工程師里每個網(wǎng)格Grid有它自己的空間朝向這個世界坐標系是三維的游戲引擎底層用四元數(shù)Quaternion來表示旋轉(zhuǎn)但在腳本里我們通常把它轉(zhuǎn)成歐拉角Euler Angle方便理解和控制。你可以把飛船的朝向想象成三個軸船頭朝向、船頂朝向、船右朝向。在代碼里我們用Transform的WorldMatrix來取得這三個方向向量。矯正姿態(tài)本質(zhì)上就是讓你船頭指向目標方向同時船頂跟船右也固定在一個合適的狀態(tài)上也就是整體對正朝向。很多新手會把“正面朝向”理解成只要船頭對就行但實際游戲中比如對接、起降、用太陽帆都要求“船頂”或者“船側(cè)”也固定。比如你的船頭對著太陽但船頂如果不正刮到旁邊的小行星還是會麻煩。所以我的腳本里做了全軸矯正不是單軸鎖頭。2.2 PD控制器為什么直接補角度不行自動矯正光看“現(xiàn)在朝向”和“目標朝向”的差是不夠的。假如你直接按誤差比例加推力船快到目標位置時速度會特別大直接沖過頭然后反向再沖就會來回震蕩跟手動操作差不多。所以這里要用PD控制器比例項P項負責“偏了多少就補多少”微分項D項負責“船還在轉(zhuǎn)的時候提前剎一點”。D項相當于阻尼它的作用就是當你接近目標朝向時根據(jù)角速度自動減弱控制力防止沖過頭。我用的核心公式大致是這樣誤差向量 目標朝向向量 - 當前朝向向量 角速度向量 陀螺儀的測量值每秒轉(zhuǎn)動多少弧度 控制力 誤差 * Kp - 角速度 * KdKp和Kd是調(diào)出來的系數(shù)調(diào)Kp越大”拉回力”越強調(diào)Kd越大“剎車”越強。如果Kp太大Kd太小飛船就來回晃如果Kd太大飛船反應(yīng)遲鈍像是沒力氣。2.3 推進器與陀螺儀誰干誰的活姿態(tài)矯正有兩種執(zhí)行機構(gòu)陀螺儀Gyroscope和推進器Thruster。陀螺儀是最適合的旋轉(zhuǎn)執(zhí)行器它的特點是不耗燃料、能直接用功率產(chǎn)生力矩但它的力矩有個上限由陀螺儀數(shù)量和質(zhì)量決定。如果你的飛船特別大一個陀螺儀根本掰不動得裝幾個并聯(lián)。陀螺儀的轉(zhuǎn)速和功率都可以通過腳本控制設(shè)置GyroOverride。推進器也能噴出橫向推力產(chǎn)生旋轉(zhuǎn)力矩但會消耗燃料推力有限而且如果用反方向的推進器剎車會特別費油。不過在某些情況下——比如你想快速轉(zhuǎn)頭光用陀螺儀太慢可以同時調(diào)用左右兩側(cè)的推進器做輔助偏航。我最終的方案是默認用陀螺儀執(zhí)行姿態(tài)穩(wěn)定如果誤差較大超過30度短暫啟動側(cè)向推進器輔助快速轉(zhuǎn)向等誤差小于閾值再切換回全陀螺儀模式。這樣既省燃料又保持平滑。3. 從零寫一個姿態(tài)矯正腳本3.1 腳本環(huán)境和基礎(chǔ)框架在太空工程師里腳本寫在編程塊Programmable Block的C#編輯器里游戲每幀或者你設(shè)定的Update頻率都會調(diào)用Main函數(shù)。你要做的事就是在這個Main里循環(huán)處理。首先你要拿到主飛船的引用我推薦用Me.CubeGrid獲取當前網(wǎng)格。然后拿到所有陀螺儀和推進器ListIMyGyro gyros new ListIMyGyro(); ListIMyThrust thrusters new ListIMyThrust(); Me.GridTerminalSystem.GetBlocksOfType(gyros); Me.GridTerminalSystem.GetBlocksOfType(thrusters);注意GetBlocksOfType會包含所有子網(wǎng)格的部件如果你的船有轉(zhuǎn)子或活塞可能會拿到別的部分的陀螺儀需要過濾掉不是本網(wǎng)格的gyros gyros.Where(g g.CubeGrid Me.CubeGrid).ToList();這一步很容易忽略不然你裝了連接的小船上的陀螺儀腳本會把它們一起控了。3.2 獲取當前朝向與目標朝向在Main里獲取飛船當前位置和朝向IMyCubeGrid grid Me.CubeGrid; Vector3D shipForward grid.WorldMatrix.Forward; // 船頭方向 Vector3D shipUp grid.WorldMatrix.Up; // 船頂方向 Vector3D shipRight grid.WorldMatrix.Right; // 船右方向目標朝向怎么定義最常見的是“讓船頭指向某個位置”比如你想讓船頭對準某個GPS坐標點那么目標Forward向量就是Vector3D targetForward (targetGPS - grid.GetPosition()).Normalized();如果你還要求船頂方向也固定比如“船頂朝向上方”那么目標Up向量可以取世界坐標系的上方向。然后就構(gòu)建一個從當前朝向到目標朝向的旋轉(zhuǎn)求出旋轉(zhuǎn)軸和旋轉(zhuǎn)角度。C#里有個高級方法是計算四元數(shù)差但更直觀的是用叉積Vector3D rotationAxis Vector3D.Cross(shipForward, targetForward); rotationAxis.Normalize(); double angle Math.Asin(Vector3D.Dot(Vector3D.Cross(shipForward, targetForward).Length(), Vector3D.Dot(shipForward, targetForward) 0 ? 1 : -1));注意這里有個坑叉積算出的向量的長度就是sin角直接求Asin就能得到旋轉(zhuǎn)角。但Unity/游戲坐標全靠右手系你要小心符號。我習慣是先算旋轉(zhuǎn)軸再根據(jù)需求計算控制方向的符號。3.3 扭轉(zhuǎn)控制信號限制轉(zhuǎn)速和推力陀螺儀的控制是通過一個方向向量和轉(zhuǎn)速大小來指定的。在游戲里你給陀螺儀的GyroOverride設(shè)一個Vector3D它就會按那個軸方向轉(zhuǎn)轉(zhuǎn)速由向量長度決定。把旋轉(zhuǎn)軸和誤差結(jié)合起來就能產(chǎn)生控制力矩Vector3D rotationError rotationAxis * controlGain;但為了防止船轉(zhuǎn)太快你要對向量長度做限制比如限制最大轉(zhuǎn)速為每秒0.5弧度約30度每秒超過就歸一化。然后對每個陀螺儀設(shè)定gyro.GyroOverride true; gyro.GyroOverrideAxis rotationError; gyro.SetValueFloat(GyroOverrideX, ...);實際操作中我用的是自定義屬性寫起來更方便簡化的設(shè)置方式如下var errorVector rotationAxis * scaledSpeed; foreach (IMyGyro g in gyros) { g.SetValue(Override, true); g.SetValue(GyroOverrideAxis, errorVector); }需要注意的是游戲里的陀螺儀默認是按照網(wǎng)格局部坐標來設(shè)置Override軸的所以你要把世界坐標的旋轉(zhuǎn)軸轉(zhuǎn)換到網(wǎng)格局部坐標。用Vector3D.Transform(rotationAxis, MatrixD.Transpose(grid.WorldMatrix))轉(zhuǎn)換。3.4 完整腳本骨架我把腳本的關(guān)鍵骨架放在下面你可以在自己的編程塊里直接改改參數(shù)跑public Program() { Runtime.UpdateFrequency UpdateFrequency.Update10; } public void Main(string argument, UpdateType updateSource) { IMyGridTerminalSystem gridTerminal GridTerminalSystem; var gyros new ListIMyGyro(); var thrusters new ListIMyThrust(); gridTerminal.GetBlocksOfType(gyros); gridTerminal.GetBlocksOfType(thrusters); // 過濾子網(wǎng)格 gyros gyros.Where(g g.CubeGrid Me.CubeGrid).ToList(); thrusters thrusters.Where(t t.CubeGrid Me.CubeGrid).ToList(); Vector3D shipPos Me.CubeGrid.GetPosition(); Vector3D targetPos new Vector3D(0, 0, 0); // 這里替換為你的目標GPS坐標 Vector3D currentForward Me.CubeGrid.WorldMatrix.Forward; Vector3D targetForward Vector3D.Normalize(targetPos - shipPos); Vector3D rotationAxis Vector3D.Cross(currentForward, targetForward); double angle Math.Asin(MathHelper.Clamp(rotationAxis.Length(), -1.0, 1.0)); rotationAxis Vector3D.Normalize(rotationAxis); // 如果角度太小就不需要矯正 if (Math.Abs(angle) 0.01) { SetGyroControl(Vector3D.Zero, 0.0f); return; } // 控制增益 float kp 3.0f; float kd 0.5f; // 這里讀取角速度需要從陀螺儀列表讀取 Vector3D shipAngularVelocity gyros.First().GetVelocity(); // 投影到旋轉(zhuǎn)軸 double angularVel Vector3D.Dot(shipAngularVelocity, rotationAxis); // 控制量 double control angle * kp - angularVel * kd; double maxSpeed 0.5; control MathHelper.Clamp(control, -maxSpeed, maxSpeed); Vector3D overrideVec rotationAxis * control; // 轉(zhuǎn)換到局部坐標 Vector3D localOverride Vector3D.Transform(overrideVec, MatrixD.Transpose(Me.CubeGrid.WorldMatrix)); foreach (IMyGyro g in gyros) { g.Orientation Me.CubeGrid.Orientation; // 確保旋轉(zhuǎn)對齊 g.SetValueFloat(Override, 1f); g.SetValue(GyroOverrideAxis, localOverride); } // 輔助推進器 if (Math.Abs(angle) 0.3) { // 啟動推進器輔助這里省略只演示陀螺儀 } } void SetGyroControl(Vector3D localOverride, float speed) { foreach (IMyGyro g in gyros) { g.SetValueFloat(Override, speed); g.SetValue(GyroOverrideAxis, localOverride); } }這個代碼只是演示基礎(chǔ)流程實際使用還要處理角速度讀取比如從陀螺儀接口里拿實際的角速度、目標朝向在滾動方向上的穩(wěn)定控制。如果你只想鎖定船頭方向不關(guān)心滾動只控制兩個軸即可如果要全姿態(tài)矯正你還需要再算一個“繞Forward軸”的旋轉(zhuǎn)誤差控制船頂和船右的方向。4. 實戰(zhàn)中的坑與調(diào)試技巧4.1 陀螺儀力不夠怎么瘋狂轉(zhuǎn)不動很多人的船很大但只裝了2個陀螺儀這時候就算你的控制算法正確飛船也反應(yīng)很慢。我在一艘50萬公斤的運輸船上裝了4個大陀螺儀才勉強能在5秒內(nèi)轉(zhuǎn)90度。解決辦法增加陀螺儀數(shù)量并且把Override軸設(shè)成局部坐標注意陀螺儀本身也有方向和朝向在網(wǎng)格里裝歪了會導致軸混疊。陀螺儀設(shè)置里有一個“轉(zhuǎn)速上限”默認可能很低我在腳本里直接把MaxOverrideSpeed調(diào)大一點。如果陀螺儀真的不夠你可以在轉(zhuǎn)向時用左右舷的推進器做輔助轉(zhuǎn)角。我測試過對于大型船最好同時控制橫搖的推進器用噴氣背包和推進器的側(cè)噴否則轉(zhuǎn)向角度大時陀螺儀要轉(zhuǎn)半天。4.2 方向判斷相反左右不分寫這個腳本最常的bug就是Override軸的方向?qū)懛戳?。因為陀螺儀的方向向量是“右手定則”而我用的是叉集很可能算出來的方向正好相反。解決辦法就是加入一個手動“反轉(zhuǎn)”變量bool invert true;如果發(fā)現(xiàn)船越調(diào)越偏就把rotationAxis乘以-1。我在調(diào)試時開著駕駛艙看著船慢慢地往反方向轉(zhuǎn)就知道是這里的正負號反了改一次就行。另外如果你腳本里控制的目標是船頭對準GPS但陀螺儀被裝反了也會造成方向混亂。所以在代碼里我用gyro.Orientation和網(wǎng)格Orientation做了一次匹配盡量讓陀螺儀的本地方向和網(wǎng)格方向一致。4.3 游戲內(nèi)Update頻率與續(xù)航游戲內(nèi)腳本不是每幀都跑而是基于UpdateFrequency。我用Update10是每10個Tick約每秒6次跑一次如果你要求非常平滑可以改成Update1每幀但這樣會消耗更多游戲性能在服務(wù)器里還可能被管理員限制。一般來說姿態(tài)矯正不用每幀都跑每秒6次和每秒60次效果差不多因為陀螺儀自身的響應(yīng)本來就有滯回。不過你注意PD控制器的Kd要根據(jù)更新頻率來調(diào)頻率低就適當減小Kd否則會出現(xiàn)控制量亂跳。4.4 堆棧溢出與心跳計數(shù)有一段時間我的腳本跑久了會卡死。排查發(fā)現(xiàn)是花了大量時間在GetBlocksOfType它每次都掃描整個網(wǎng)格所以我改進成在構(gòu)造方法Program()里只查一次把列表緩存下來只用引用更新。另一個小技巧是加一個調(diào)試輸出用Echo(angle...);在編程塊的LCD上顯示角度誤差和輸出力矩很方便觀察有沒有調(diào)過頭。4.5 多軸鎖定別只用船頭如果你的船頭對準了目標但船身還在慢慢滾這是因為輪換軸沒有控制。需要再檢測船頂方向與目標Up方向的夾角施加一個繞Forward的俯仰/偏航力矩來穩(wěn)定。我后來在第2版里加入了“LockFullAttitude”開關(guān)可以用參數(shù)控制是否要求船頂也固定。對接、入塢時用全鎖定向巡航時只鎖船頭方便省燃料。5. 調(diào)試參數(shù)速查表這里給你一個我自己調(diào)參時的對照表你直接拿你的船去試Kp先從小調(diào)大Kd從大調(diào)小有一組很合適的工作點場景KpKd結(jié)果船太小陀螺儀響應(yīng)快125非常穩(wěn)但反應(yīng)快中型貨船4陀螺儀52平滑不震超大量級10陀螺儀輔助推力31.5大角度轉(zhuǎn)向平穩(wěn)剛開始測試20.5安全不飛掉記住原則如果船在目標位置前后震蕩把Kp調(diào)小或Kd調(diào)大如果反應(yīng)遲緩轉(zhuǎn)不動把Kp調(diào)大或Kd調(diào)小。6. 進階把姿態(tài)矯正接入自動駕駛當你把姿態(tài)矯正腳本跑通后最大的瓶頸不再是“能不能轉(zhuǎn)”而是“怎么和游戲里的自動導航協(xié)調(diào)”。我的做法是給編程塊加一個參數(shù)接口在Main里讀取字符串參數(shù)比如target:GPS:X:Y:Z:0或者用attitude:lock來切換自動矯正模式。然后通過定時器塊連接讓駕駛員按一下面板上的某個按鍵就執(zhí)行一次轉(zhuǎn)向。這樣你可以在一個控制面板里集成多個預設(shè)朝向起飛朝向、入港朝向、太陽帆朝向。甚至可以用腳本監(jiān)聽傳感器探測到障礙物后自動把船側(cè)偏向不過這就是另一個項目了。我實測下來姿態(tài)矯正腳本只要跑起來、調(diào)參調(diào)穩(wěn)基本不怎么需要再管。用了它之后我手動操作率降了七八成再也沒掉進以前那種“按W轉(zhuǎn)圈”的尷尬。最后再分享一個小技巧腳本跑多了之后也許你會感覺某個朝向總是鎖定不到位那不是算法問題很可能是你這個網(wǎng)格的重心偏偏到一側(cè)了做一個穩(wěn)定的姿態(tài)矯正不如把重心對齊一下。先用腳本把船頭指向某個方向然后關(guān)掉矯正看它往哪側(cè)漂就用這個信息去做配重。按這個順序來遠比單純調(diào)Kp和Kd更有效。