Auto building rally points (#12)

* unfinished

* update

* [Docs] update & fix

* [Doc][zh-cn] CREDITS

Due to some processing issues with the sphinx-build command, there were some minor problems with the previous Mentalmeisters Team section

* update

* update

* update

* ready to go

* 更新改动说明

* 更改一些可本地化内容

* 更新改动说明

* 删个等号

* update

* 修复扩散抛体的小问题

* 更新改动

* update

* docs

* 1

* 移除多余

* Core

* 额外功能说明

* 更新改动说明

* Fit with trajectory

* Fix compile error

* Fix YRpp

* Optimize and rename

---------

Co-authored-by: 九千天华 <[email protected]>
Co-authored-by: CrimRecya <[email protected]>

Author: 3 people

CREDITS.md

@@ -6,15 +6,15 @@ This page lists all the individual contributions to the project by their author.
   - Disable empty spawn positions
   - `gamemd.exe` icon customization
   - Full-color non-paletted PCX support
-  - Initial SpySat, BigGap, TransactMoney warheads
+  - Initial `SpySat`, `BigGap`, `TransactMoney` warheads
   - PCX Loading Screen support
-  - Custom DiskLaser radius
+  - Custom `DiskLaser` radius
   - Extended tooltips
   - Building upgrades enhancement
   - Option to hide health bar
-  - Sidebar.GDIPosition
-  - Help with CellSpread
-  - Blowfish.dll-related errors fix
+  - `Sidebar.GDIPosition`
+  - Help with `CellSpread`
+  - `Blowfish.dll`-related errors fix
   - Zero size map previews fix
   - Semantic locomotor aliases
   - Shield logic
@@ -38,7 +38,7 @@ This page lists all the individual contributions to the project by their author.
   - Laser graphics fixes
   - Recursive transport killer fix
   - Custom locomotors example implementation and piggybacking test warheads
-  - Jumpjet initial facing fix
+  - Initial jumpjet facing fix
   - Migration utility
   - GitHub Actions setup
   - Official docs
@@ -63,12 +63,12 @@ This page lists all the individual contributions to the project by their author.
   - `NoManualMove`
   - Weapon target house filtering
   - `DeathWeapon` fix
-  - Re-enable obsolete `JumpjetControls`
+  - Re-enable obsolete `[JumpjetControls]`
   - `AITrigger` Building Upgrades support
   - Wall-Gate links
   - Ability for deployed infantry to use both weapons
   - Observer PCX loading screen
-  - Official CN docs
+  - Official CN docs for Build#29 and previous versions
 - **secsome (SEC-SOME)**:
   - Debug info dump hotkey
   - Refactoring & porting of Ares helper code
@@ -108,12 +108,12 @@ This page lists all the individual contributions to the project by their author.
   - Hooks for ScriptType Actions 92 & 93
   - Ore stage threshold for `HideIfNoOre`
   - Occupied building `MuzzleFlashX` bugfix
-  - `EnemyUIName=` for other TechnoTypes
+  - `EnemyUIName` for other TechnoTypes
   - TerrainType `DestroyAnim` & `DestroySound`
   - Laser trails for VoxelAnims
-  - MakeInfantry logic on BombClass bugfix
+  - `MakeInfantry` logic on BombClass bugfix
   - Debris & meteor impact behaviour settings
-  - Upgrade logic to allow altering of SpySat status
+  - Upgrade logic to allow altering of `SpySat` status
   - Ares detection and integration
   - Help with custom locomotors
   - Extension class optimization
@@ -153,7 +153,7 @@ This page lists all the individual contributions to the project by their author.
   - `IsSimpleDeployer` improvements
   - Shield modification warheads
   - Warhead decloaking toggle
-  - Warp(In/Out)Weapon
+  - `Warp(In/Out)Weapon`
   - Grinder improvements / additions
   - Attached animation position customization
   - Critical hit logic additions
@@ -165,15 +165,15 @@ This page lists all the individual contributions to the project by their author.
   - Laser fixes & improvements
   - Mind control indicator animation cloak fix
   - Warhead / Play animation trigger animation owner fix
-  - Nuke carrier & payload Bright fix
+  - Nuke carrier & payload `Bright` fix
   - Display damage numbers hotkey command
-  - TransactMoney.Display
+  - `TransactMoney.Display`
   - Building-provided self-heal customization
-  - AI deploy script DeploysInto fix
+  - AI deploy script `DeploysInto` fix
   - Passable & buildable-upon TerrainTypes
   - Automatic passenger owner change toggle
   - Interceptor improvements
-  - OpenTopped transport behaviour customizations
+  - `OpenTopped` transport behaviour customizations
   - Animation damage / weapon improvements
   - Warhead self-damaging toggle
   - Trailer animation owner inheritance
@@ -187,11 +187,11 @@ This page lists all the individual contributions to the project by their author.
   - Cloaked & disguised objects displaying to observers
   - Building airstrike target eligibility customization
   - IvanBomb detonation & image display centered on buildings
-  - Customizable ROF random delay
-  - BibShape drawing during buildup fix
+  - Customizable `ROF` random delay
+  - `BibShape` drawing during buildup fix
   - Spawner spawn delay customization
-  - Cluster scatter distance customization
-  - FlakScatter distance customization
+  - `Cluster` scatter distance customization
+  - `FlakScatter` distance customization
   - Debris & meteor impact behaviour settings
   - Custom warhead debris animations
   - Attached particle system for animations
@@ -211,7 +211,7 @@ This page lists all the individual contributions to the project by their author.
   - Crushing tilt and slowdown customization
   - Extra warhead detonations on weapons
   - Chrono sparkle animation display customization and improvements
-  - PipScale pip size & ammo pip frame customization
+  - `PipScale` pip size & ammo pip frame customization
   - Extension class optimization
   - Additional sync logging
   - `Arcing` elevation inaccuracy fix
@@ -273,7 +273,7 @@ This page lists all the individual contributions to the project by their author.
   - Unlimited skirmish colors
   - Show designator & inhibitor range
   - Dump variables to file on scenario end / hotkey
-  - "House owns TechnoType" and "House doesn't own TechnoType" trigger events
+  - `601 House owns TechnoType` and `602 House doesn't own TechnoType` trigger events
   - Voxel light source position customization
   - Extending `Power` to all TechnoTypes
   - Help with docs
@@ -282,15 +282,15 @@ This page lists all the individual contributions to the project by their author.
    - Interceptor logic prototype
    - LaserTrails prototype
    - Laser fixes prototype
-- **Trsdy**
-   - Preserve IronCurtain status upon DeploysInto/UndeploysInto
+- **Trsdy**:
+   - Preserve IronCurtain status upon `DeploysInto/UndeploysInto`
    - Several jumpjet fixes:
       - Facing towards target even if not omni-firing
       - Turret direction in idle state fix
       - Sensor fix
-      - Allow to tilt regardless of TiltCrashJumpjet
+      - Allow to tilt regardless of `TiltCrashJumpjet`
       - Forbid firing when crashing
-   - OmniFire.TurnToTarget
+   - `OmniFire.TurnToTarget`
    - Strafing aircraft weapon customization
    - Object Self-destruction logic
    - Misc vanilla suicidal behavior fix
@@ -304,21 +304,21 @@ This page lists all the individual contributions to the project by their author.
      - Trigger actions that allow/forbid MCV to redeploy in game
    - `AlternateFLH` of vehicles in `OpenTopped` transport.
    - Slaves' house customization when owner is killed
-   - Trigger Action spawned team IFV/Opentopped logic fix
-   - Singleplayer Campaign AI's base node/SW-delivered/trigger action 125-delivered structures' auto-repairability dehardcode
+   - Trigger Action spawned team IFV/OpenTopped logic fix
+   - Singleplayer Campaign AI's base node/SW-delivered/trigger action `125 Create Building At...`'s auto-repairability dehardcode
    - Power delta counter : blackout indication mark
    - Harvester counter
    - Income money string indication upon ore dump
    - Warhead superweapon launch logic
    - TechnoType conversion placeholder
-   - "Shield is broken" trigger event
-   - RadialIndicator observer visibility
+   - `606 The shield of the attached object is broken` trigger event
+   - `RadialIndicator` observer visibility
    - Cloaked objects from allies displaying to player in singleplayer campaigns
    - Skip `NaturalParticleSystem` displaying from in-map pre-placed structures
    - Random crate generation limited to land option, optimization for crates' random sampling
    - `ImmuneToCrit` for shields
    - Forbidding parallel AI queues by type
-   - The option to allow DieSound/VoiceDie being played when grinding
+   - The option to allow `DieSound/VoiceDie` being played when grinding
    - Allow iron-curtain effects on infantries
    - Break the mindcontrol link when capturing a mind-controlled building with engineer
    - Remove sound events when mind-controlled vehicles deploy into buildings or when buildings considered as vehicles get captured
@@ -344,10 +344,10 @@ This page lists all the individual contributions to the project by their author.
    - Better fix for Ares academy not working on the initial payloads of vehicles built from a war factory
    - Fix Ares' InitialPayload for teams spawned by trigger actions
    - Misc code refactor & maintenance, CN doc fixes, bugfixes
-- **FlyStar**
+- **FlyStar**:
    - Campaign load screen PCX support
    - New condition for automatic self-destruction logic when TechnoTypes exist/don't exist
-- **NetsuNegi**
+- **NetsuNegi**:
    - Forbidding parallel AI queues by type
    - Jumpjet crash speed fix when crashing onto building
    - Disguised units not using the correct palette if target has custom palette bugfix
@@ -357,34 +357,32 @@ This page lists all the individual contributions to the project by their author.
    - Fix amphibious harvesters can not automatically return to refineries with `WaterBound`
    - Exclusive SuperWeapon Sidebar
 - **Apollo** - Translucent SHP drawing patches
-- **ststl**
-   - Customizable ShowTimer priority of superweapons
+- **ststl**:
+   - Customizable `ShowTimer` priority of superweapons
    - Iron Curtain effects customization on infantries and organic units
    - Use `CustomPalette` for animations with `Tiled=yes`
    - Unlimited `AlternateFLH` entries
    - Build limit group
    - Customizing whether passengers are kicked out when an aircraft fires
-- **TwinkleStar**
+- **TwinkleStar**:
   - Custom slaves free sound
   - Jumpjet crash rotation control
   - Vehicle voxel turret shadows & body multi-section shadows
   - `TurretOffset` support for SHP vehicles
   - Customizable rocker amplitude
   - Customizable wake anim
   - Initial effort on optimization for crates' random distribution
-- **Fryone**
+- **Fryone**:
   - Customizable ElectricBolt Arcs
   - Sound entry on unit's creation
   - Auto-deploy/Deploy block on ammo change
   - Flashing Technos on selecting
   - Promotion animation
-- **ZivDero**
+- **ZivDero**:
   - Re-enable the Veinhole Monster and Weeds from TS
   - Recreate the weed-charging of SWs like the TS Chemical Missile
   - Allow to change the speed of gas particles
-- **NaotoYuuki**
-  - Vertical & meteor trajectory projectile prototypes
-- **CrimRecya**
+- **CrimRecya**:
   - Fix `LimboKill` not working reliably
   - Allow using waypoints, area guard and attack move with aircraft
   - Fix `Stop` command not working so well in some cases
@@ -426,15 +424,17 @@ This page lists all the individual contributions to the project by their author.
   - Distribution click action mode
   - Jumpjet Tilts While Moving
   - Change the scrolling action of the sidebar and trigger hook of mouse wheel scroll
-- **Ollerus**
+  - Laser, electric bolt and rad beam scatter
+  - Fix the bug that laser, electric bolt and rad beam not support `FlakScatter=true` and `Inaccurate=true` projectiles
+- **Ollerus**:
   - Build limit group enhancement
   - Customizable rocker amplitude
   - Allowed `AuxBuilding` and Ares' `SW.Aux/NegBuildings` to count building upgrades
   - Type select for buildings (doc)
   - Enhanced Bombard trajectory
 - **NaotoYuuki** - Vertical & meteor trajectory projectile prototypes
-- **handama** - AI script action to jump back to previous script
-- **TaranDahl (航味麻酱)**
+- **handama** - AI script action to `16005 Jump Back To Previous Script`
+- **TaranDahl (航味麻酱)**:
   - Skirmish AI "sell all buildings and set all technos to hunt" behavior dehardcode
   - Skirmish AI "gather when MCV deploy" behavior dehardcode
   - Global value of `RepairBaseNodes`
@@ -457,14 +457,14 @@ This page lists all the individual contributions to the project by their author.
   - Units are now unable to kick out from a factory that is in construction process
   - No turret unit turn to the target
   - Units are now unable to kick out from a factory that is in construction process
-- **Aephiex**
+- **Aephiex**:
   - initial fix for Ares academy not working on the initial payloads of vehicles built from a war factory
   - Aggressive stance toggle command (auto target unarmed enemy buildings)
-- **tyuah8**
+- **tyuah8**:
   - Drive/Jumpjet/Ship/Teleport locomotor did not power on when it is un-piggybacked bugfix
   - Destroyed unit leaves sensors bugfix
 - **Multfinite** - Allow to toggle main exception handler via command line argument `-ExceptionHandler=boolean`
-- **Ares developers**
+- **Ares developers**:
   - YRpp and Syringe which are used, save/load, project foundation and generally useful code from Ares
   - unfinished RadTypes code
   - prototype deployer fixes
@@ -475,7 +475,7 @@ This page lists all the individual contributions to the project by their author.
 - **SukaHati (Erzoid)** - Minimum interceptor guard range
 - **E1 Elite** - TileSet 255 and above bridge repair fix
 - **AutoGavy** - interceptor logic, Warhead critical hit logic
-- **Chasheen (Chasheenburg)** - CN docs help
+- **Chasheen (Chasheenburg)** - CN docs help for Build#24
 - **tomsons26** - all-around help, assistance and guidance in reverse-engineering, YR binary mappings
 - **CCHyper** - all-around help, current project logo, assistance and guidance in reverse-engineering, YR binary mappings, custom locomotors example implementation
 - **AlexB** - Original FlyingStrings implementation

Phobos.vcxproj

@@ -18,7 +18,6 @@
     </ProjectConfiguration>
   </ItemGroup>
   <ItemGroup>
-    <ClCompile Include="src\Commands\ToggleSWSidebar.cpp" />
     <ClCompile Include="src\Ext\Sidebar\SWSidebar\SWColumnClass.cpp" />
     <ClCompile Include="src\Ext\Sidebar\SWSidebar\SWSidebarClass.cpp" />
     <ClCompile Include="src\Ext\Sidebar\SWSidebar\SWButtonClass.cpp" />
@@ -44,6 +43,8 @@
     <ClCompile Include="src\Commands\SelectedInfo.cpp" />
     <ClCompile Include="src\Commands\HerosInfo.cpp" />
     <ClCompile Include="src\Commands\AutoBuilding.cpp" />
+    <ClCompile Include="src\Commands\AssignRallyPoint.cpp" />
+    <ClCompile Include="src\Commands\ToggleSWSidebar.cpp" />
     <ClCompile Include="src\Commands\DistributionMode.cpp" />
     <ClCompile Include="src\Commands\ShowCurrentInfo.cpp" />
     <ClCompile Include="src\Commands\ManualReloadAmmo.cpp" />
@@ -114,6 +115,7 @@
     <ClCompile Include="src\Ext\Building\Hooks.Refinery.cpp" />
     <ClCompile Include="src\Ext\Building\Hooks.Production.cpp" />
     <ClCompile Include="src\Ext\Building\Hooks.Selling.cpp" />
+    <ClCompile Include="src\Ext\Building\Hooks.SecondaryArchive.cpp" />
     <ClCompile Include="src\Ext\BulletType\Body.cpp" />
     <ClCompile Include="src\Ext\Bullet\Body.cpp" />
     <ClCompile Include="src\Ext\Bullet\Hooks.cpp" />
@@ -215,8 +217,6 @@
     <ClCompile Include="YRpp\StaticInits.cpp" />
   </ItemGroup>
   <ItemGroup>
-    <ClInclude Include="src\Commands\FireTacticalSW.h" />
-    <ClInclude Include="src\Commands\ToggleSWSidebar.h" />
     <ClInclude Include="src\Ext\Sidebar\SWSidebar\SWColumnClass.h" />
     <ClInclude Include="src\Ext\Sidebar\SWSidebar\SWSidebarClass.h" />
     <ClInclude Include="src\Ext\Sidebar\SWSidebar\SWButtonClass.h" />
@@ -242,6 +242,9 @@
     <ClInclude Include="src\Commands\SelectedInfo.h" />
     <ClInclude Include="src\Commands\HerosInfo.h" />
     <ClInclude Include="src\Commands\AutoBuilding.h" />
+    <ClInclude Include="src\Commands\AssignRallyPoint.h" />
+    <ClInclude Include="src\Commands\FireTacticalSW.h" />
+    <ClInclude Include="src\Commands\ToggleSWSidebar.h" />
     <ClInclude Include="src\Commands\DistributionMode.h" />
     <ClInclude Include="src\Commands\ShowCurrentInfo.h" />
     <ClInclude Include="src\Commands\ManualReloadAmmo.h" />
@@ -549,4 +552,4 @@
   </ItemDefinitionGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
   <ImportGroup Label="ExtensionTargets" />
-</Project>
+</Project>

docs/Fixed-or-Improved-Logics.md

@@ -196,6 +196,7 @@ This page describes all ingame logics that are fixed or improved in Phobos witho
 - Fix an issue where a unit will leave an impassable invisible barrier in its original position when it is teleported by ChronoSphere onto an uncrushable unit and self destruct.
 - Fix the bug that destroyed unit may leaves sensors.
 - Fix an issue that harvesters with amphibious movement zone can not automatically return to refineries with `WaterBound` on water surface.
+- Fix the bug that laser, electric bolt and rad beam not support `FlakScatter=true` and `Inaccurate=true` projectiles.
 
 ## Fixes / interactions with other extensions
 
@@ -324,7 +325,7 @@ ExtraShadow=true              ; boolean
     - `SmallFireAnims` can be used to set the animation types, defaults to `[AudioVisual] -> SmallFire` (single animation).
     - `SmallFireChances` is a list of probabilities for the animations to spawn, up to `SmallFireCount` amount of items are read. Last item listed is used if count exceeds the number of listed probabilities. Defaults to `1.0,0.5` for `Flamer=true`, `1.0` otherwise.
     - `SmallFireDistances` is a list of distances in cells for the animations to spawn at from the parent animation's coordinates, up to `SmallFireCount` amount of items are read. Last item listed is used if count exceeds the number of listed probabilities. Defaults to `0.25,0.625` for `Flamer=true`, `0.0` otherwise.
-  - `LargeFireCount` determines number of large fire animations to spawn by`Flamer=true` animations only.
+  - `LargeFireCount` determines number of large fire animations to spawn by `Flamer=true` animations only.
     - `LargeFireAnims` can be used to set the animation types, defaults to `[AudioVisual] -> LargeFire` (single animation).
     - `LargeFireChances` is a list of probabilities for the animations to spawn, up to `LargeFireCount` amount of items are read. Last item listed is used if count exceeds the number of listed probabilities.
     - `LargeFireDistances` is a list of distances in cells for the animations to spawn at from the parent animation's coordinates, up to `LargeFireCount` amount of items are read. Last item listed is used if count exceeds the number of listed probabilities.