deploy: f56ba27

Author: malytomas

.doctrees/concepts/callbacks.doctree

@@ -40,7 +40,7 @@ Make sure to carefully decode them, as shown in the example below.
               index = 0
               while index < len(data):
                   control = uw_events.shooting_control_data(data[index])
-                  if control.type == UwShootingEventEnum.Shooting:
+                  if control.type == ShootingEvent.Shooting:
                       shooter_id = data[index + 1]
                       for i in range(1, control.count):
                           target_id = data[index + i + 1]
@@ -80,22 +80,22 @@ Make sure to carefully decode them, as shown in the example below.
           extern "C"
           void uwShootingsCallback(const UwShootingsArray *data)
           {
-          	const auto shooting = uw::makeVector(data);
-          	uint32 index = 0;
-          	while (index < shooting.size())
-          	{
-          		const auto control = uw::shootingControlData(shooting[index]);
-          		if (control.type == UwShootingEventEnum_Shooting)
-          		{
-          			const uint32 shooterId = shooting[index + 1];
-          			for (uint32 i = 1; i < control.count; i++)
-          			{
-          				const uint32 targetId = shooting[index + i + 1];
-          				// handle shooting event
-          			}
-          		}
-          		index += control.count + 1;
-          	}
+              const auto shooting = uw::makeVector(data);
+              uint32 index = 0;
+              while (index < shooting.size())
+              {
+                  const auto control = uw::shootingControlData(shooting[index]);
+                  if (control.type == UwShootingEventEnum_Shooting)
+                  {
+                      const uint32 shooterId = shooting[index + 1];
+                      for (uint32 i = 1; i < control.count; i++)
+                      {
+                          const uint32 targetId = shooting[index + i + 1];
+                          // handle shooting event
+                      }
+                  }
+                  index += control.count + 1;
+              }
           }
 
 Task Completed Callback

.doctrees/concepts/economy.doctree

@@ -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
@@ -15,14 +18,14 @@ Producing units or researching upgrades works the same way as recipes.
           # find closest viable position for miner:
           p = uw_world.find_construction_placement(DRILL_CONSTRUCTION_ID, home_position, METAL_RECIPE_ID) # recipe id is optional
           if p == INVALID:
-            return
+              return
 
           # place construction:
-          uw_commands.place_construction(DRILL_CONSTRUCTION_ID, p, 0, METAL_RECIPE_ID, UwPriorityEnum.Normal) # yaw, recipe, and priority are optional
+          uw_commands.place_construction(DRILL_CONSTRUCTION_ID, p, 0, METAL_RECIPE_ID, Priority.High) # yaw, recipe, and priority are optional
           
           # recipe and priority can be changed later:
           uw_commands.set_recipe(own_id, ANOTHER_RECIPE_ID)
-          uw_commands.set_priority(own_id, UwPriorityEnum.High)
+          uw_commands.set_priority(own_id, Priority.Normal)
 
    .. tab-item:: C#
       :sync: csharp
@@ -32,14 +35,14 @@ Producing units or researching upgrades works the same way as recipes.
           // find closest viable position for miner:
           uint p = World.FindConstructionPlacement(DRILL_CONSTRUCTION_ID, homePosition, METAL_RECIPE_ID); // recipe id is optional
           if (p == Entity.Invalid):
-            return;
+              return;
 
           // place construction:
-          Commands.PlaceConstruction(DRILL_CONSTRUCTION_ID, p, 0, METAL_RECIPE_ID, Interop.UwPriorityEnum.Normal); // yaw, recipe, and priority are optional
+          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, Interop.UwPriorityEnum.High)
+          Commands.SetRecipe(ownId, ANOTHER_RECIPE_ID)
+          Commands.SetPriority(ownId, UwPriorityEnum.Normal)
 
    .. tab-item:: C++
       :sync: cpp
@@ -48,12 +51,21 @@ Producing units or researching upgrades works the same way 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
 
@@ -73,9 +85,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