bots have option to preselect map and start; more code samples in docs

malytomas · malytomas · commit 6082c6340f3b · 2025-08-30T18:36:49.000+02:00
diff --git a/csharp/bot/main.cs b/csharp/bot/main.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Threading;
 
 namespace Unnatural
 {
@@ -15,11 +16,9 @@ void AttackNearestEnemies()
             var ownUnits = World.Entities().Values.Where(x => x.Own && x.ProtoUnit?.dps > 0);
             if (ownUnits.Count() == 0)
                 return;
-
             var enemyUnits = World.Entities().Values.Where(x => x.Enemy && x.Unit.HasValue);
             if (enemyUnits.Count() == 0)
                 return;
-
             foreach (Entity own in ownUnits)
             {
                 if (Commands.Orders(own.Id).Length == 0)
@@ -47,27 +46,37 @@ void AssignRandomRecipes()
 
         void Configure()
         {
-            if (isConfigured)
+            // auto start the game if available
+            if (isConfigured && Game.GameState() == Interop.UwGameStateEnum.Session && World.IsAdmin())
+            {
+                Thread.Sleep(3000); // give the observer enough time to connect
+                Admin.StartGame();
+                return;
+            }
+            // is configuring possible?
+            if (isConfigured || Game.GameState() != Interop.UwGameStateEnum.Session || World.MyPlayerId() == 0)
                 return;
             isConfigured = true;
-
+            Game.LogInfo("configuration start");
             Game.SetPlayerName("bot-cs");
             Game.PlayerJoinForce(0); // create new force
             Game.SetForceColor(1f, 0f, 0f);
-            // todo choose race
+            // Game.SetForceRace(RACE_ID); // todo
+            if (World.IsAdmin())
+            {
+                // Admin.SetMapSelection("planets/tetrahedron.uwmap");
+                Admin.SetMapSelection("special/risk.uwmap");
+                Admin.AddAi();
+                Admin.SetAutomaticSuggestedCameraFocus(true);
+            }
+            Game.LogInfo("configuration done");
         }
 
         void Updating(object sender, bool stepping)
         {
-            if (Game.GameState() == Interop.UwGameStateEnum.Session)
-            {
-                Configure();
-                return;
-            }
-
+            Configure();
             if (!stepping)
                 return;
-
             switch (workStep++ % 10) // save some cpu cycles by splitting work over multiple steps
             {
                 case 1:
@@ -84,9 +93,15 @@ void Run()
             Game.LogInfo("bot-cs start");
             if (!Game.TryReconnect())
             {
-                Game.SetConnectStartGui(true);
+                Game.SetConnectStartGui(true, "--observer 2");
                 if (!Game.ConnectEnvironment())
-                    Game.ConnectNewServer();
+                {
+                    // automatically select map and start the game from here in the code
+                    if (false)
+                        Game.ConnectNewServer(0, "", "--allowUwApiAdmin 1");
+                    else
+                        Game.ConnectNewServer();
+                }
             }
             Game.LogInfo("bot-cs done");
         }
diff --git a/python/bot/bot.py b/python/bot/bot.py
@@ -1,4 +1,5 @@
 import random
+import time
 from uwapi import *
 
 
@@ -40,23 +41,39 @@ def assign_random_recipes(self):
                 uw_commands.set_recipe(own.id, recipe)
 
     def configure(self):
-        if self.is_configured:
+        # auto start the game if available
+        if (
+            self.is_configured
+            and uw_game.game_state() == GameState.Session
+            and uw_world.is_admin()
+        ):
+            time.sleep(3)  # give the observer enough time to connect
+            uw_admin.start_game()
+            return
+        # is configuring possible?
+        if (
+            self.is_configured
+            or uw_game.game_state() != GameState.Session
+            or uw_world.my_player_id() == 0
+        ):
             return
         self.is_configured = True
-
+        uw_game.log_info("configuration start")
         uw_game.set_player_name("bot-py")
         uw_game.player_join_force(0)  # create new force
         uw_game.set_force_color(1, 0, 0)
-        # todo choose race
+        # uw_game.set_force_race(RACE_ID) # todo
+        if uw_world.is_admin():
+            # uw_admin.set_map_selection("planets/tetrahedron.uwmap")
+            uw_admin.set_map_selection("special/risk.uwmap")
+            uw_admin.add_ai()
+            uw_admin.set_automatic_suggested_camera_focus(True)
+        uw_game.log_info("configuration done")
 
     def on_update(self, stepping: bool):
-        if uw_game.game_state() == GameState.Session:
-            self.configure()
-            return
-
+        self.configure()
         if not stepping:
             return
-
         self.work_step += 1
         match self.work_step % 10:  # save some cpu cycles by splitting work over multiple steps
             case 1:
@@ -67,7 +84,11 @@ def on_update(self, stepping: bool):
     def run(self):
         uw_game.log_info("bot-py start")
         if not uw_game.try_reconnect():
-            uw_game.set_connect_start_gui(True)
+            uw_game.set_connect_start_gui(True, "--observer 2")
             if not uw_game.connect_environment():
-                uw_game.connect_new_server()
+                # automatically select map and start the game from here in the code
+                if False:
+                    uw_game.connect_new_server(0, "", "--allowUwApiAdmin 1")
+                else:
+                    uw_game.connect_new_server()
         uw_game.log_info("bot-py done")
diff --git a/sphinx/source/concepts/economy.rst b/sphinx/source/concepts/economy.rst
@@ -1,8 +1,11 @@
 Economy
 =======
 
+Recipes And Constructions
+-------------------------
+
 Resources are mined from deposits, or processed from other resources.
-Producing units or researching upgrades works the same way as recipes.
+Producing units and researching upgrades works the same as recipes.
 
 .. tab-set::
    :sync-group: language
@@ -38,8 +41,8 @@ Producing units or researching upgrades works the same way as recipes.
           Commands.PlaceConstruction(DRILL_CONSTRUCTION_ID, p, 0, METAL_RECIPE_ID, UwPriorityEnum.High); // yaw, recipe, and priority are optional
           
           // recipe and priority can be changed later:
-          Commands.SetRecipe(own_id, ANOTHER_RECIPE_ID)
-          Commands.SetPriority(own_id, UwPriorityEnum.Normal)
+          Commands.SetRecipe(ownId, ANOTHER_RECIPE_ID)
+          Commands.SetPriority(ownId, UwPriorityEnum.Normal)
 
    .. tab-item:: C++
       :sync: cpp
@@ -73,9 +76,35 @@ They will fulfill tasks by their priority, and on first-come-first-serve basis.
           // percentage of trucks that are idle:
           100.0 * World.MyForceStatistics().logisticsUnitsIdle / World.MyForceStatistics().logisticsUnitsTotal
 
+Expansion Bases
+---------------
+
+Each map contains predefined set of starting positions.
+These can have some additional conditions to be used as starting base, eg. actual number of forces in the game.
+Anyway, these positions can be used to easily find suitable expansion bases.
+
+.. tab-set::
+   :sync-group: language
+
+   .. tab-item:: Python
+      :sync: python
+
+      .. code-block:: python
+
+          # potential expansion bases:
+          list({p.position for p in uw_map.starting_positions()}) # make the positions unique
+
+   .. tab-item:: C#
+      :sync: csharp
+
+      .. code-block:: csharp
+
+          // potential expansion bases:
+          Map.StartingPositions().Select(p => p.position).Distinct().ToList();
+
    .. tab-item:: C++
       :sync: cpp
 
       .. code-block:: cpp
 
-          // nothing
+          // todo
diff --git a/sphinx/source/concepts/military.rst b/sphinx/source/concepts/military.rst
@@ -23,8 +23,8 @@ You can have multiple orders queued for each unit.
           # order own unit to attack enemy unit (cancels all previous orders):
           uw_commands.order(own_id, uw_commands.fight_to_entity(enemy_id))
           
-          # alternatively, enqueue attack order:
-          o = uw_commands.fight_to_entity(enemy_id)
+          # enqueue move order:
+          o = uw_commands.run_to_position(tile_index)
           o.priority = o.priority | OrderPriority.Enqueue
           uw_commands.order(own_id, o)
 
@@ -34,22 +34,55 @@ You can have multiple orders queued for each unit.
       .. code-block:: csharp
 
           // get list of orders of own unit:
-          var os = Commands.Orders(own_id);
+          var os = Commands.Orders(ownId);
           
           // order own unit to attack enemy unit (cancels all previous orders):
-          Commands.Order(own_id, Commands.FightToEntity(enemy_id));
+          Commands.Order(ownId, Commands.FightToEntity(enemyId));
           
-          // alternatively, enqueue attack order:
-          Order o = Commands.FightToEntity(enemy_id);
+          // enqueue move order:
+          Order o = Commands.RunToPosition(tileIndex);
           o.priority |= UwOrderPriorityFlags.Enqueue;
-          Commands.Order(own_id, o);
+          Commands.Order(ownId, o);
 
-   .. tab-item:: C++
-      :sync: cpp
+Tips For Military Maneuvers
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-      .. code-block:: cpp
+.. tab-set::
+   :sync-group: language
+
+   .. tab-item:: Python
+      :sync: python
+
+      .. code-block:: python
+
+          # position of enemy military unit that is closest to any of our own units:
+          uw_world.my_force_statistics().closestDangerPosition
+
+          # position that is specific distance from target, and closest to us
+          surrounding_positions = uw_map.area_neighborhood(target_position, 200)
+          specific_distance_position = min(surrounding_positions, key=lambda x: uw_map.distance_estimate(my_position, x))
+
+          # flanking position around target
+          surrounding_positions = uw_map.area_neighborhood(target_position, 200)
+          surrounding_positions = sorted(surrounding_positions, key=lambda x: uw_map.distance_estimate(my_position, x))
+          flanking_position = surrounding_positions[len(surrounding_positions) // 2] # note that this picks left or right flanking position at random
+
+   .. tab-item:: C#
+      :sync: csharp
+
+      .. code-block:: csharp
+
+          // position of enemy military unit that is closest to any of our own units:
+          World.MyForceStatistics().closestDangerPosition
+
+          // position that is specific distance from target, and closest to us
+          var surroundingPositions = Map.AreaNeighborhood(targetPosition, 200);
+          var specificDistancePosition = surroundingPositions.OrderBy(x => Map.DistanceEstimate(myPosition, x)).First();
 
-          // nothing
+          // flanking position around target
+          var surroundingPositions = Map.areaNeighborhood(targetPosition, 200);
+          surroundingPositions.Sort((a, b) => Map.DistanceEstimate(myPosition, a).CompareTo(Map.DistanceEstimate(myPosition, b)));
+          var flankingPosition = surroundingPositions[surroundingPositions.Count / 2]; // note that this picks left or right flanking position at random
 
 Shooting
 --------
@@ -111,7 +144,7 @@ Upgrades
 Research usually consumes some resources to produce upgrades.
 Upgrades will stack, up to a specified limit.
 This means that the upgrades have a ramp-up phase.
-When research stops, the upgrades will dissipate after some time.
+When research stops, the upgrades will dissipate over time.
 
 Most upgrades apply percentage increase to one or more of the properties of a unit.
 
