deploy: 3445c3a

Author: malytomas

.doctrees/bots/setup.doctree

@@ -52,3 +52,4 @@ This will show you additional information about any single thing you select in t
 For example: unit id, its state, position (both index and 3D coordinates), etc.
 It shows at the bottom of the left panel.
 
+Enable *Detailed tooltips* too.

.doctrees/concepts/callbacks.doctree

@@ -18,21 +18,86 @@ This callback is the primary driving point for your program.
    Use ``>=`` when waiting for number of ticks to pass.
 
 Shootings Callback
------------------
+------------------
 Shootings events are synchronized *asynchronously and unreliably*.
 This event is useful for measuring threat.
 
+The data encode multiple events, possibly of different types, mixed together.
+Make sure to carefully decode them, as shown in the example below.
+
 .. warning::
    The entity id may be expired.
 
-Deaths Callback
----------------
-Deaths events are synchronized *asynchronously and unreliably* - some events may be lost, or delivered much later.
-Do *not* depend on deaths events for important decisions.
-It is useful for measuring threat.
+.. tab-set::
+   :sync-group: language
+
+   .. tab-item:: Python
+      :sync: python
+
+      .. code-block:: python
+
+          def shootings_callback(data: List[int]) -> None:
+              index = 0
+              while index < len(data):
+                  control = uw_events.shooting_control_data(data[index])
+                  if control.type == UwShootingEventEnum.Shooting:
+                      shooter_id = data[index + 1]
+                      for i in range(1, control.count):
+                          target_id = data[index + i + 1]
+                          # handle shooting event
+                          pass
+                  index += control.count + 1
+
+   .. tab-item:: C#
+      :sync: csharp
+
+      .. code-block:: csharp
+
+          void ShootingsCallback(IReadOnlyList<uint> data)
+          {
+              int index = 0;
+              while (index < data.Count)
+              {
+                  var control = Events.ShootingControlData(data[index]);
+                  if (control.type == UwShootingEventEnum.Shooting)
+                  {
+                      uint shooterId = data[index + 1];
+                      for (uint i = 1; i < control.count; i++)
+                      {
+                          uint targetId = data[index + i + 1];
+                          // handle data event
+                      }
+                  }
+                  index += control.count + 1;
+              }
+          }
+
+   .. tab-item:: C++
+      :sync: cpp
+
+      .. code-block:: cpp
+
+          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;
+          	}
+          }
 
-.. warning::
-   The entity id may be expired.
 
 Task Completed Callback
 -----------------------

.doctrees/environment.pickle

@@ -3,7 +3,7 @@ Mods
 Guide on making mods for Unnatural Worlds.
 
 .. warning::
-   Making custom mods is not yet fully supported.
+   Making mods is not yet fully supported.
 
 A mod is a collection of assets that can modify the look and/or behavior of any moddable map.
 It may contain :ref:`prototypes <concepts/prototypes:Prototypes>`, :ref:`scripts <scripts/index:Scripts>`, models, sounds, etc.

.doctrees/mods/index.doctree

@@ -1,9 +1,9 @@
 Scripts
 =======
-Guide on making scripts for custom maps for Unnatural Worlds.
+Guide on making scripts for custom maps or mods for Unnatural Worlds.
 
 .. warning::
-   Making custom scripts is not yet fully supported.
+   Making scripts is not yet fully supported.
 
 Scripts are executed within the server.
 They have access to all data within the game, and may modify all data.