add ai with race and difficulty; more docs

Author: malytomas

c/uwapi/uwapi/modules/botsAdmin.h

@@ -22,7 +22,7 @@ extern "C"
 	UNNATURAL_API void uwAdminTerminateGame(void);
 	UNNATURAL_API void uwAdminPauseGame(bool pause);
 	UNNATURAL_API void uwAdminSkipCutscene(void);
-	UNNATURAL_API void uwAdminAddAi(void);
+	UNNATURAL_API void uwAdminAddAi(uint32 intendedRace, float difficulty);
 	UNNATURAL_API void uwAdminKickPlayer(uint32 playerId);
 	UNNATURAL_API void uwAdminPlayerSetAdmin(uint32 playerId, bool admin);
 	UNNATURAL_API void uwAdminPlayerSetName(uint32 playerId, const char *name);

c/uwapi/uwapi/modules/scriptsServer.h

@@ -39,11 +39,12 @@ extern "C"
 	UNNATURAL_API void uwDestroyForce(uint32 force);
 	UNNATURAL_API void uwSetForceColor(uint32 force, float r, float g, float b);
 	UNNATURAL_API void uwSetForceFinish(uint32 force, bool winner, bool defeated);
+	UNNATURAL_API void uwSetForceRace(uint32 force, uint32 race);
 	UNNATURAL_API void uwSetForceStartingTeam(uint32 force, uint32 team);
 	UNNATURAL_API void uwSetForceStartingPosition(uint32 force, uint32 position);
 	UNNATURAL_API void uwSetForeignPolicy(uint32 force1, uint32 force2, UwForeignPolicyEnum policy);
 
-	UNNATURAL_API uint32 uwCreateAiPlayer(void);
+	UNNATURAL_API uint32 uwCreateAiPlayer(uint32 race, float difficulty);
 	UNNATURAL_API void uwSetPlayerAiConfig(uint32 player, const UwPlayerAiConfigComponent *config);
 	UNNATURAL_API void uwSetPlayerForce(uint32 player, uint32 force);
 	UNNATURAL_API void uwPlayerCamera(uint32 player, uint32 tileIndex, bool resetToDefaultZoomAndOrientation, float duration, float smooth); // use -1 to send to all players, use NaN for default values

csharp/uwapi/admin.cs

@@ -56,9 +56,9 @@ public static void SkipCutscene()
             Interop.uwAdminSkipCutscene();
         }
 
-        public static void AddAi()
+        public static void AddAi(uint intendedRace = 0, float difficulty = 0)
         {
-            Interop.uwAdminAddAi();
+            Interop.uwAdminAddAi(intendedRace, difficulty);
         }
 
         public static void KickPlayer(uint playerId)

csharp/uwapi/interop.cs

@@ -48,7 +48,7 @@ public static class Interop
         public static extern void uwAdminSkipCutscene();
 
         [DllImport(LibName, CallingConvention = CallingConvention.Cdecl)]
-        public static extern void uwAdminAddAi();
+        public static extern void uwAdminAddAi(uint intendedRace, float difficulty);
 
         [DllImport(LibName, CallingConvention = CallingConvention.Cdecl)]
         public static extern void uwAdminKickPlayer(uint playerId);

python/uwapi/admin.py

@@ -33,8 +33,8 @@ def set_game_speed(self, speed: float) -> None:
     def set_weather_speed(self, speed: float, offset: float) -> None:
         uw_interop.uwAdminSetWeatherSpeed(speed, offset)
 
-    def add_ai(self) -> None:
-        uw_interop.uwAdminAddAi()
+    def add_ai(self, intendedRace: int = 0, difficulty: float = 0) -> None:
+        uw_interop.uwAdminAddAi(intendedRace, difficulty)
 
     def kick_player(self, player_id: int) -> None:
         uw_interop.uwAdminKickPlayer(player_id)

python/uwapi/bots.h

@@ -83,7 +83,7 @@ void uwAdminStartGame(void);
 void uwAdminTerminateGame(void);
 void uwAdminPauseGame(bool pause);
 void uwAdminSkipCutscene(void);
-void uwAdminAddAi(void);
+void uwAdminAddAi(uint32 intendedRace, float difficulty);
 void uwAdminKickPlayer(uint32 playerId);
 void uwAdminPlayerSetAdmin(uint32 playerId, bool admin);
 void uwAdminPlayerSetName(uint32 playerId, const char *name);

python/uwapi/interop.py

@@ -543,8 +543,8 @@ def uwAdminPauseGame(self, pause: bool) -> None:
     def uwAdminSkipCutscene(self) -> None:
         self._api.uwAdminSkipCutscene()
 
-    def uwAdminAddAi(self) -> None:
-        self._api.uwAdminAddAi()
+    def uwAdminAddAi(self, intendedRace: int, difficulty: float) -> None:
+        self._api.uwAdminAddAi(intendedRace, difficulty)
 
     def uwAdminKickPlayer(self, playerId: int) -> None:
         self._api.uwAdminKickPlayer(playerId)

sphinx/source/concepts/economy.rst

@@ -51,12 +51,21 @@ Producing units and researching upgrades works the same as recipes.
 
           // todo
 
+Destroyed Buildings
+^^^^^^^^^^^^^^^^^^^
+
+When a building is destroyed, same construction is automatically placed in its place.
+It has ``disabled`` priority, you just change it when appropriate.
+Its previous recipe is also restored.
+
 Logistics
 ---------
 
 Resources are automatically transported by trucks.
 They will fulfill tasks by their priority, and on first-come-first-serve basis.
 
+Priorities apply to both constructions and recipes.
+
 .. tab-set::
    :sync-group: language
 

sphinx/source/concepts/entities.rst

@@ -223,7 +223,7 @@ Contains additional state for a unit (or building).
 
       .. code-block:: python
 
-          # check if unit is Processing:
+          # check if unit is processing:
           (x.Unit.state & UnitState.Processing) != 0
 
    .. tab-item:: C#
@@ -251,8 +251,9 @@ Amount of mana of the unit (or building).
 
 Move Component
 --------------
-Timestamp of when the unit finishes its current movement.
-Information is available for the next neighboring tile only.
+Movements are synchronized on tile-to-tile basis only, the whole path is stored only on the client of the owner of the unit.
+This component provides timestamp of when the unit finishes its current movement.
+The Position Component already represents the new position.
 
 Aim Component
 -------------

sphinx/source/maps/editor.rst

@@ -0,0 +1,2 @@
+Editor
+======