some texts tweaks

Author: malytomas

sphinx/source/bots/index.rst

@@ -2,15 +2,10 @@ Bots
 ====
 Guide on writing custom AI/bots for Unnatural Worlds.
 
-You can write your bot in any language, as long as it can load a dynamic/shared library (.dll/.so).
-The shared library is distributed together with the game.
-The uwapi repository contains c/c++ headers for all functions and structures provided by the library.
-
-The uwapi repository also contains convenient wrappers for Python and for C# for quicker start of writing your bot.
-
-The bots api is designed such that you retain full control over your bot program - aka it makes it possible to develop and debug it the way you are used to.
-However, to be able to start the game outside of the Steam, it is necessary to copy the file ``steam_appid.txt`` (contained in the uwapi repository) into the ``bin`` folder, next to the game executable.
-This also allows you to start the game, and all other accompanying programs, from command line or from bash, which allows you to manually start the server, and connect any number of bots and human players.
+Bots act as a client connected to the game server.
+The server generally makes no assumption on whether a connection is a bot or a regular player.
+Specifically, bots cannot cheat - no more than a regular player could.
 
 .. toctree::
+	setup
 	troubleshooting

sphinx/source/bots/setup.rst

@@ -0,0 +1,22 @@
+Setup
+====
+You can write your bot in any language, as long as it can load a dynamic/shared library (.dll/.so).
+The shared library is distributed together with the game.
+
+The uwapi repository contains c/c++ headers for all functions and structures provided by the library.
+Furthermore, it contains convenient wrappers for Python and for C# for quicker start.
+
+.. important::
+	Copy ``steam_appid.txt`` into the ``bin`` folder.
+
+The file ``steam_appid.txt`` tells Steam that this is developer copy of the game.
+It allows running multiple processes of the game simultaneously, and to start the programs directly from outside the Steam.
+This allows you to retain full control over your bot program - it makes it possible to develop and debug it from inside your IDE.
+You may also start the game client, game server, built-in AI, or any other associated programs from your terminal.
+You will find the ``steam_appid.txt`` in the uwapi repository.
+Copy it into the ``bin`` folder, next to the game executable.
+
+.. important::
+	If your Steam games are in non-default location, define environment variable ``UNNATURAL_ROOT`` to the directory containing the library.
+
+The default path on Windows: ``C:\Program Files (x86)\Steam\steamapps\common\Unnatural Worlds\bin``, on linux: ``~/.steam/steam/steamapps/common/Unnatural Worlds/bin``.

sphinx/source/bots/troubleshooting.rst

@@ -8,20 +8,19 @@ Troubleshooting
 
 	Make sure you have installed Unnatural Worlds in Steam.
 
-	If your Steam games are in non-default location, define the environment variable ``UNNATURAL_ROOT`` to the directory containing the library.  
-	Example: ``C:\Program Files (x86)\Steam\steamapps\common\Unnatural Worlds\bin``
+	If your Steam games are in non-default location, define environment variable ``UNNATURAL_ROOT`` to the directory containing the library.
 
 .. dropdown:: OSError: cannot load library 'unnatural-uwapi-hard'
 
 	Make sure you have installed Unnatural Worlds in Steam.
 
-	If your Steam games are in non-default location, define the environment variable ``UNNATURAL_ROOT`` to the directory containing the library.  
-	Example: ``C:\Program Files (x86)\Steam\steamapps\common\Unnatural Worlds\bin``
+	If your Steam games are in non-default location, define environment variable ``UNNATURAL_ROOT`` to the directory containing the library.
 
 .. dropdown:: Failed to initialize Steam API
 
 	Make sure that Steam is running and logged in.  
 	It must run under the same user as the program.
+	Do not use any containerization.
 
 .. dropdown:: Linux laptop with switchable GPUs
 

sphinx/source/concepts/map.rst

@@ -12,10 +12,10 @@ Tiles are indexed `0 .. N-1`.
 Data available for each tile:
 
 - Position - 3D coordinates
-- Up - 3D vector - direction opposite of local gravity
+- Up - 3D vector - direction opposite of *local* gravity
 - Neighbors - array of indices of neighboring tiles
 - Cluster - index of the cluster this tile belongs to
-- Terrain - index of the terrain at this tile
+- Terrain - index of the terrain type at this tile
 
 Clusters
 --------

sphinx/source/concepts/prototypes.rst

@@ -16,7 +16,7 @@ It contains amounts and ids of inputs and outputs.
 Also defines the duration of the recipe.
 Recipes are processed in buildings/units.
 
-Some recipes have a *place-over* requirement, which is an id of a unit, that the building must be placed on, in order for the recipe to be available.
+Some recipes have a *place-over* requirement, which is an id of a unit, that the building must be placed on, in order for the recipe to function.
 
 Construction Prototype
 ----------------------
@@ -26,9 +26,11 @@ It contains amounts of input resources, and has exactly one output unit/building
 Unit Prototype
 --------------
 Both buildings and units are treated as units in the game.
-Some neutral objects, such as trees, rocks, ore deposits, etc. are all also units.
 
-The prototype contains combat related properties, movement (speeds), building radius, a list of available recipes, and a list of applicable upgrades.
+.. note::
+	Some neutral objects, such as trees, rocks, ore deposits, etc. are all units too.
+
+The prototype contains combat related properties, movement speeds or building radius, a list of available recipes, and a list of applicable upgrades.
 Additionally, there are several boolean properties, which modify behavior or requirements of the unit/building.
 
 Upgrade Prototype

sphinx/source/maps/index.rst

@@ -10,8 +10,6 @@ It may contain :ref:`prototypes <Prototypes>`, :ref:`scripts <Scripts>`, models,
 
 Assets found in a map have precedence over assets in the base game.
 
-Additional files in the map
----------------------------
 .. toctree::
 	scene
 	collider

sphinx/source/mods/index.rst

@@ -14,4 +14,4 @@ Consequently, multiple mods can be enabled simultaneously.
 Assets found in a mod have precedence over assets in a map or in the base game.
 However, when multiple mods contain same asset ID, the map will fail to load.
 Managing mods with clashing assets IDs is left to the player.
-It is advised to prefix names of all assets in a mod with the name of the mod to reduce a chance of clashing IDs.
+It is advised to prefix names of all assets in a mod with the name of the mod, to reduce a chance of clashing IDs.

sphinx/source/scripts/index.rst

@@ -5,6 +5,9 @@ Guide on making scripts for custom maps for Unnatural Worlds.
 .. warning::
 	Making custom 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.
+
 Scripts can be written in any language that can be compiled into `WASM <https://en.wikipedia.org/wiki/WebAssembly>`_.
 
 The uwapi repository provides c/c++ headers for scripts.