Phobos-developers · DeathFishAtEase · May 31, 2026 · Jan 11, 2026 · Jan 11, 2026 · Jan 11, 2026
diff --git a/.gitignore b/.gitignore
@@ -28,5 +28,3 @@ out
 
 # Python virtual environment for docs
 .venv/
-
-debug.log
diff --git a/CREDITS.md b/CREDITS.md
@@ -418,8 +418,8 @@ This page lists all the individual contributions to the project by their author.
   - Vehicle Deployment Enhancement
   - Fix an issue where miners affected by `Passengers/DeployFire` were unable to unload minerals
   - Fix an issue where mining vehicles could not move after leaving a tank bunker
-  - Fixed the bug in AI scripts 56 and 57 that forced the launch of superweapons with index numbers 3 and 4
-  - Fixed an issue where parachute units would die upon landing if bridges were destroyed during their descent
+  - Fix the bug in AI scripts 56 and 57 that forced the launch of superweapons with index numbers 3 and 4
+  - Fix an issue where parachute units would die upon landing if bridges were destroyed during their descent
   - Custom hover vehicles shutdown drowning death
   - SHP turret vehicles support the use of `*tur.shp` files
   - Fix a bug where game will crash after loading if a techno with `AlphaImage` converts to a type without it, or an anim with `AlphaImage` changes to a type without it through `Next`
@@ -761,7 +761,7 @@ This page lists all the individual contributions to the project by their author.
   - Allow replacing vanilla repairing with togglable auto repairing
   - Fix an issue that the time for units in the area guard mission to reacquire targets after eliminating the target is significantly longer than that in other missions
   - Framework for dynamic sight
-  - Fixed voxel projectile and animation lighting issues
+  - Fix voxel projectile and animation lighting issues
   - Export interface for external call
 - **solar-III (凤九歌)**
   - Target scanning delay customization (documentation)

diff --git a/docs/Interoperability.md b/docs/Interoperability.md
@@ -1,4 +1,3 @@
-
 # Interoperability
 
 This page documents the exported interfaces in [Interop](https://github.com/Phobos-developers/Phobos/tree/develop/src/Interop).
@@ -7,30 +6,30 @@ This page documents the exported interfaces in [Interop](https://github.com/Phob
 
 All exported API functions return `HRESULT` to indicate success or failure following COM convention:
 
-| HRESULT | Meaning |
-|---------|---------|
-| `S_OK` | Operation completed successfully. |
-| `S_FALSE` | Operation completed but had nothing to do (e.g., no matching effects found). |
-| `E_POINTER` | A required pointer parameter was null. |
-| `E_INVALIDARG` | One or more arguments are invalid. |
-| `E_UNEXPECTED` | An unexpected internal error occurred (e.g., extension data not found). |
-| `E_FAIL` | The operation failed. |
+| HRESULT        | Meaning                                                                      |
+|----------------|------------------------------------------------------------------------------|
+| `S_OK`         | Operation completed successfully.                                            |
+| `S_FALSE`      | Operation completed but had nothing to do (e.g., no matching effects found). |
+| `E_POINTER`    | A required pointer parameter was null.                                       |
+| `E_INVALIDARG` | One or more arguments are invalid.                                           |
+| `E_UNEXPECTED` | An unexpected internal error occurred (e.g., extension data not found).      |
+| `E_FAIL`       | The operation failed.                                                        |
 
 Functions that produce output data take an additional output pointer parameter that receives the result. Use `SUCCEEDED(hr)` / `FAILED(hr)` to check the return value.
 
 ## API Version Tracking
 
 ### Semantic Versioning Rules
 
-- **Major (X)**: Increment for breaking changes (backward incompatible API modifications).  
-  Example: Deleting an API, changing function parameters, modifying data structures that break existing code.  
+- **Major (X)**: Increment for breaking changes (backward incompatible API modifications).\
+  Example: Deleting an API, changing function parameters, modifying data structures that break existing code.\
   When bumped, reset Minor and Patch to 0 (e.g., 1.2.3 → 2.0.0).
 
-- **Minor (Y)**: Increment for backward-compatible new features.  
-  Example: Adding a new API function, new parameters that don't break existing code.  
+- **Minor (Y)**: Increment for backward-compatible new features.\
+  Example: Adding a new API function, new parameters that don't break existing code.\
   When bumped, reset Patch to 0 (e.g., 1.2.3 → 1.3.0).
 
-- **Patch (Z)**: Increment for backward-compatible miscs (no API changes).  
+- **Patch (Z)**: Increment for backward-compatible miscs (no API changes).\
   Example: Fixing crashes, correcting calculations, optimizing internals without changing interface (e.g., 1.2.3 → 1.2.4).
 
 ### GetInteropAPIVersion
@@ -84,22 +83,22 @@ When an API is deprecated, its function stub is retained but with a fatal error
 
 ## Available APIs
 
-| Module | API | Availability | Status |
-|----------|-----|---------------|--------|
-| AttachEffect | AE_Attach | [1.0.0, ∞) | Active |
-| AttachEffect | AE_Detach | [1.0.0, ∞) | Active |
-| AttachEffect | AE_DetachByGroups | [1.0.0, ∞) | Active |
-| AttachEffect | AE_TransferEffects | [1.0.0, ∞) | Active |
-| BulletExt | Bullet_SetFirerOwner | [1.0.0, ∞) | Active |
-| EventExt | EventExt_AddEvent | [1.0.0, ∞) | Active |
-| TechnoExt | ConvertToType_Phobos | [1.0.0, ∞) | Active |
-| TechnoExt | RegisterCalculateExtraThreatCallback | [1.0.0, ∞) | Active |
+| Module       | API                                        | Availability   | Status |
+|--------------|--------------------------------------------|----------------|--------|
+| AttachEffect | AE_Attach                                  | `[1.0.0, ∞)`  | Active |
+| AttachEffect | AE_Detach                                  | `[1.0.0, ∞)`  | Active |
+| AttachEffect | AE_DetachByGroups                          | `[1.0.0, ∞)`  | Active |
+| AttachEffect | AE_TransferEffects                         | `[1.0.0, ∞)`  | Active |
+| BulletExt    | Bullet_SetFirerOwner                       | `[1.0.0, ∞)`  | Active |
+| EventExt     | EventExt_AddEvent                          | `[1.0.0, ∞)`  | Active |
+| TechnoExt    | ConvertToType_Phobos                       | `[1.0.0, ∞)`  | Active |
+| TechnoExt    | RegisterCalculateExtraThreatCallback       | `[1.0.0, ∞)`  | Active |
 
 ### AttachEffect
 
 #### AE_Attach
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT AE_Attach(
@@ -137,7 +136,7 @@ Attaches one or more AttachEffect types to the target.
 
 #### AE_Detach
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT AE_Detach(
@@ -161,7 +160,7 @@ Detaches effects by explicit effect type names.
 
 #### AE_DetachByGroups
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT AE_DetachByGroups(
@@ -185,7 +184,7 @@ Detaches effects by AttachEffect group name.
 
 #### AE_TransferEffects
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT AE_TransferEffects(
@@ -208,7 +207,7 @@ Transfers all attached effects from source to target.
 
 #### ConvertToType_Phobos
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT ConvertToType_Phobos(FootClass* pThis, TechnoTypeClass* toType)
@@ -226,7 +225,7 @@ Converts a FootClass instance to another TechnoType.
 
 #### RegisterCalculateExtraThreatCallback
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 typedef double (*CalculateExtraThreatCallback)(TechnoClass* pThis, ObjectClass* pTarget, double originalThreat);
@@ -253,7 +252,7 @@ Registers a callback function to calculate extra threat for a unit.
 
 #### Bullet_SetFirerOwner
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT Bullet_SetFirerOwner(BulletClass* pBullet, HouseClass* pHouse)
@@ -272,7 +271,7 @@ Updates the recorded firer house for a bullet extension.
 
 #### EventExt_AddEvent
 
-**Availability:** [1.0.0, ∞)
+**Availability:** `[1.0.0, ∞)`
 
 ```cpp
 HRESULT EventExt_AddEvent(EventExt* pEventExt)

diff --git a/docs/New-or-Enhanced-Logics.md b/docs/New-or-Enhanced-Logics.md
@@ -840,7 +840,7 @@ Interceptor.WeaponOverride=                 ; WeaponType
 Interceptor.WeaponReplaceProjectile=false   ; boolean
 Interceptor.WeaponCumulativeDamage=false    ; boolean
 Interceptor.KeepIntact=false                ; boolean
-                                            
+
 [SOMEPROJECTILE]                            ; Projectile
 Interceptable=false                         ; boolean
 Interceptable.DeleteOnIntercept=false       ; boolean

diff --git a/docs/Whats-New.md b/docs/Whats-New.md
@@ -649,6 +649,7 @@ HideShakeEffects=false           ; boolean
 - Fixed an issue where a unit might cause the target to fall from above its own head when using a locomotor warhead with `Locomotor=Jumpjet` to pull a target with `BalloonHover=yes` (by NetsuNegi)
 - Fixed the [EIP#007120F7](https://modenc.renegadeprojects.com/Internal_Error#eip_007120F7) caused when the `Strength` value is lower than `RepairStep` (by NetsuNegi)
 - Fixed the bug where non-Teleporter miners would not return to work after minerals are depleted and then regenerated (by TaranDahl)
+- Fixed units with Fly, Jumpjet or Rocket locomotors destroyed while crashing off-map never being fully cleaned up, permanently blocking production slots and counting towards unit limits (by RAZER)
 - Miners back to work when ore regenerated (by TaranDahl)
 - Fixed the incorrect mission switching in infantry EnterIdleMode (by TaranDahl)
 - Fixed BalloonHover incorrectly considering ground factors when pathfinding (by TaranDahl)
@@ -697,7 +698,6 @@ HideShakeEffects=false           ; boolean
 - Fixed an issue where hover vehicles could not be destroyed after malfunctioning on water surfaces (by FlyStar)
 - Fixed an issue where shadow matrix scaling was incorrectly applied to `TurretOffset` causing turret shadow misplacement (by Noble_Fish)
 - Fixed an issue that customizable warhead animation scatter cannot override 32 leptons scatter of `Inviso=yes` projectile (by NetsuNegi)
-- Fixed units with Fly, Jumpjet or Rocket locomotors destroyed while crashing off-map never being fully cleaned up, permanently blocking production slots and counting towards unit limits (by RAZER)
 - Fixed a bug where a unit's turrets would also get locked when the unit became deactivated for reasons other than being under EMP (by Noble_Fish)
 - Fixed a bug that prevented recalculation of stats etc. on discarding self-owned AE (by Starkku)
 - Fixed combat light ignoring / behaving differently from vanilla game regarding detail level and framerate checks (by Starkku)

diff --git a/docs/locale/zh_CN/LC_MESSAGES/CREDITS.po b/docs/locale/zh_CN/LC_MESSAGES/CREDITS.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Phobos \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-05-08 21:24+0800\n"
+"POT-Creation-Date: 2026-05-31 23:53+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -873,8 +873,10 @@ msgid "Frame CRC generation rewrite"
 msgstr "重写帧 CRC 生成"
 
 msgid "Laser drawing Z-adjust customization"
-msgstr ""
-"自定义激光绘制的 Z 深校正值"
+msgstr "自定义激光绘制的 Z 深校正值"
+
+msgid "Armed building guard mission retry delay customization"
+msgstr "武装建筑警戒任务重试间隔的自定义"
 
 msgid "**Morton (MortonPL)**:"
 msgstr "**Morton (MortonPL)**："
@@ -1283,14 +1285,16 @@ msgid ""
 "bunker"
 msgstr "修复了矿车离开坦克碉堡后无法移动的问题"
 
+#, fuzzy
 msgid ""
-"Fixed the bug in AI scripts 56 and 57 that forced the launch of "
+"Fix the bug in AI scripts 56 and 57 that forced the launch of "
 "superweapons with index numbers 3 and 4"
 msgstr "修复了 56 和 57 号 AI 动作脚本强制发射注册索引 3 和 4 的超武的 Bug"
 
+#, fuzzy
 msgid ""
-"Fixed an issue where parachute units would die upon landing if bridges "
-"were destroyed during their descent"
+"Fix an issue where parachute units would die upon landing if bridges were"
+" destroyed during their descent"
 msgstr "修复了空降到桥上的单位会由于降落过程中桥梁被毁而在着陆后死亡的问题"
 
 msgid "Custom hover vehicles shutdown drowning death"
@@ -1759,22 +1763,27 @@ msgid ""
 msgstr "修复了类型转换会更新 `OpenTopped` 属性却不更新乘客坐标的 Bug"
 
 msgid ""
-"Fix the bug that low-air taking off / landing objects will receive "
-"twice damage"
+"Fix the bug that low-air taking off / landing objects will receive twice "
+"damage"
 msgstr "修复了低空起飞／降落的物体会受到两次伤害的 Bug"
 
-msgid ""
-"Aux technos and TechLevel requirement of superweapon"
+msgid "Aux technos and TechLevel requirement of superweapon"
 msgstr "超级武器的辅助单位和科技等级限制"
 
 msgid ""
 "Allow `AuxBuilding` and Ares' `SW.Aux/NegBuildings` to count building "
 "upgrades"
-msgstr ""
-"允许了 Ares 的 `SW.AuxBuildings` 和 `SW.NegBuildings` 计入建筑加载物"
+msgstr "允许了 Ares 的 `SW.AuxBuildings` 和 `SW.NegBuildings` 计入建筑加载物"
 
-msgid "Fix the bug where passengers, when their transport unit is removed, would cause incorrect `LimboTracker` counts due to either having their destructor called directly (bypassing `UnInit`) or nested `UnInit` calls resetting the deletion flag too early, thereby breaking auto-death and superweapon auxiliary techno checks"
-msgstr "修复了乘客在其所在的运输工具被移除时，因被直接调用析构函数（绕过 `UnInit` ）或 `UnInit` 嵌套调用导致删除标志过早重置，从而使 `LimboTracker` 计数错误，进而影响自动死亡及超武辅助单位判定的 Bug"
+msgid ""
+"Fix the bug where passengers, when their transport unit is removed, would"
+" cause incorrect `LimboTracker` counts due to either having their "
+"destructor called directly (bypassing `UnInit`) or nested `UnInit` calls "
+"resetting the deletion flag too early, thereby breaking auto-death and "
+"superweapon auxiliary techno checks"
+msgstr ""
+"修复了乘客在其所在的运输工具被移除时，因被直接调用析构函数（绕过 `UnInit` ）或 `UnInit` 嵌套调用导致删除标志过早重置，从而使 "
+"`LimboTracker` 计数错误，进而影响自动死亡及超武辅助单位判定的 Bug"
 
 msgid "**Apollo** - Translucent SHP drawing patches"
 msgstr "**Apollo** - 半透明 SHP 绘制补丁"
@@ -2546,13 +2555,13 @@ msgstr "修复了处于 `Area Guard` 任务中的单位消灭目标后重新获
 
 msgid "Framework for dynamic sight"
 msgstr "动态视野框架"
-msgid "Export interface for external call"
-msgstr "用于外部调用的导出接口"
 
-msgid ""
-"Fixed voxel projectile and animation lighting issues"
+msgid "Fix voxel projectile and animation lighting issues"
 msgstr "修复了 Voxel 抛射体和动画的光照问题"
 
+msgid "Export interface for external call"
+msgstr "用于外部调用的导出接口"
+
 msgid "**solar-III (凤九歌)**"
 msgstr "**solar-III（凤九歌）**"
 

diff --git a/docs/locale/zh_CN/LC_MESSAGES/Fixed-or-Improved-Logics.po b/docs/locale/zh_CN/LC_MESSAGES/Fixed-or-Improved-Logics.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Phobos \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-05-21 01:03+0800\n"
+"POT-Creation-Date: 2026-05-31 23:53+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -1686,8 +1686,7 @@ msgstr "修复了低空起飞／降落的物体会受到两次伤害的 Bug。"
 msgid "Allowed `AuxBuilding` to count building upgrades."
 msgstr "允许了 `AuxBuilding` 计入建筑加载物。"
 
-msgid ""
-"Fixed voxel projectile and animation lighting issues."
+msgid "Fixed voxel projectile and animation lighting issues."
 msgstr "修复了 Voxel 抛射体和动画的光照问题。"
 
 msgid "Fixes / interactions with other extensions"
@@ -2966,6 +2965,20 @@ msgstr ""
 "以在深度缓冲区中调整它们并用于修复与此相关的例如建筑缺角等问题）。现在可以通过设置 `ZShapePointMove.OnBuildup` "
 "来开关此行为。"
 
+msgid "Armed building guard retry delay"
+msgstr "武装建筑警戒重试间隔"
+
+msgid ""
+"By default buildings with weapons (including garrisoned buildings) have a"
+" delay of `[Guard]` -> `AARate` multiplied by 900 plus random value in "
+"range 0-2 (inclusive) before rechecking if the building can attack if it "
+"has a target. This delay is now customizable globally by `[General]` -> "
+"`BuildingGuardRetryDelay` or per-BuildingType with `GuardRetryDelay`."
+msgstr ""
+"默认情况下拥有武器的建筑（包括驻军建筑）在拥有目标的情况下有一个 `[Guard]` -> `AARate` 乘 900 再加上 `[0,2]` "
+"范围内随机值的间隔用于重新检查是否可以攻击。现在，这个间隔可以通过 `[General]` -> "
+"`BuildingGuardRetryDelay` 和 `GuardRetryDelay` 进行全局或建筑微观层面的自定义。"
+
 msgid "Buildings considered as vehicles"
 msgstr "被视为载具的建筑"
 
@@ -3578,7 +3591,7 @@ msgid ""
 " not enough objects around to satisfy `ShrapnelCount`."
 msgstr ""
 "`Shrapnel.IgnoreHitBuildings` 用于覆盖多格建筑可能被溅射子武器多次命中的默认行为。注意这并不能在周围没有满足 "
-"`ShrapnelCount` 数量的目标时组织建筑 `Foundation` 内的随机单元格被选为目标。"
+"`ShrapnelCount` 数量的目标时阻止建筑 `Foundation` 内的随机单元格被选为目标。"
 
 msgid "Technos"
 msgstr "科技类型"

diff --git a/docs/locale/zh_CN/LC_MESSAGES/General-Info.po b/docs/locale/zh_CN/LC_MESSAGES/General-Info.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Phobos \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-02-10 22:05+0800\n"
+"POT-Creation-Date: 2026-05-29 17:39+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -121,3 +121,9 @@ msgid ""
 "matter though!"
 msgstr "尽管我们也希望支持 HAres，但由于其用户群体及开发者与国际社区分离，所以我们无法保证兼容性。但我们欢迎就此问题提供任何帮助！"
 
+msgid "API versioning"
+msgstr "API 版本管理"
+
+msgid "See [Interoperability](Interoperability.md#api-version-tracking)."
+msgstr "参见 [互操作性](Interoperability.md#api-version-tracking)。"
+
Original file line number	Diff line number	Diff line change
Expand Up		@@ -28,5 +28,3 @@ out

		# Python virtual environment for docs
		.venv/

		debug.log