update doc/en/**

doc/en/scripting/builtins/libgui.md

@@ -0,0 +1,41 @@
+# *gui* library
+
+The library contains functions for accessing the properties of UI elements. Instead of gui, you should use an object wrapper that provides access to properties through the __index, __newindex meta methods:
+
+Example:
+
+```lua
+print(document.some_button.text) -- where 'some_button' is an element id
+document.some_button.text = "new text"
+```
+
+```python
+gui.str(text: str, context: str) -> str
+```
+
+Returns translated text.
+
+```python
+gui.get_viewport() -> {int, int}
+```
+
+Returns size of the main container (window).
+
+```python
+gui.get_env(document: str) -> table
+```
+
+Returns environment (global variables table) of the specified document.
+
+```lua
+gui.get_locales_info() -> table of tables {
+  name: str
+ }
+-- where
+--   key - locale id following isolangcode_ISOCOUNTRYCODE format
+--   value - table {
+--       name: str # locale display name
+--   }
+```
+
+Returns information about all loaded locales (res/texts/\*).

doc/en/scripting/builtins/libhud.md

@@ -0,0 +1,50 @@
+# *hud* library
+
+```lua
+-- Open player inventory.
+hud.open_inventory()
+
+-- Close inventory.
+hud.close_inventory()
+
+-- Open block UI and inventory. 
+-- Throws an exception if block has no UI layout.
+-- Returns block inventory ID (if *"inventory-size"=0* a virtual 
+-- inventory will be created), and UI layout ID.
+hud.open_block(x: int, y: int, z: int) -> int, str
+```
+
+> [!NOTE]
+> Only one block may be open at same time
+
+```lua
+-- Show overlay with layout specified.
+-- Shows player inventory also if playerinv is true.
+hud.show_overlay(layoutid: str, playerinv: bool)
+
+-- Add element to the screen. 
+-- The element will be removed on world close only.
+-- inventory element will be bound to the player inventory.
+hud.open_permanent(layoutid: str)
+
+-- Remove an element from the screen.
+hud.close(layoutid: str)
+
+-- Get open block inventory ID or 0.
+hud.get_block_inventory() -> int
+
+-- Gives the ID of the player that the UI is bound to.
+hud.get_player() -> int
+
+-- Opens the pause menu
+hud.pause()
+
+-- Closes the pause menu.
+hud.resume()
+
+-- Returns true if pause menu is open.
+hud.is_paused() -> bool
+
+-- Returns true if inventory is open or overlay is shown.
+hud.is_inventory_open() -> bool
+```

doc/en/scripting/builtins/libinventory.md

@@ -0,0 +1,56 @@
+# *inventory* library
+
+Library for inventories interaction.
+
+```lua
+-- ID = 0 (core:empty) means that slot is empty.
+inventory.get(
+    -- inventory ID
+    invid: int,
+    -- slot index
+    slot: int
+) -> int, int
+-- Returns item ID and count. 
+
+-- Set slot content.
+inventory.set(
+    -- inventory ID
+    invid: int,
+    -- slot index
+    slot: int,
+    -- item index
+    itemid: int,
+    -- item count
+    count: int
+)
+
+-- Returns inventory size (slots number). 
+-- Throws an exception if there's no inventory having specified ID.
+inventory.size(invid: int) -> int
+
+-- Add an item to the specified inventory. 
+-- Returns remaining count if could not to add fully.
+inventory.add(invid: int, itemid: int, count: int) -> int
+
+-- Returns block inventory ID or 0.
+inventory.get_block(x: int, y: int, z: int) -> int
+
+-- Bind inventory to the specified block.
+inventory.bind_block(invid: int, x: int, y: int, z: int)
+
+-- Unbind inventory from the specified block.
+inventory.unbind_block(x: int, y: int, z: int)
+```
+
+> [!WARNING]
+> Unbound inventories will be deleted on world close.
+
+```lua
+-- Create inventory copy. Returns the created copy ID.
+inventory.clone(invid: int) -> int
+
+-- Move item from slotA of invA to slotB of invB. 
+-- invA may be the same as invB.
+-- If slotB will be chosen automaticly if argument is not specified.
+inventory.move(invA: int, slotA: int, invB: int, slotB: int)
+```

doc/en/scripting/builtins/libtime.md

@@ -0,0 +1,13 @@
+# *time* library
+
+```python
+time.uptime() -> float
+```
+
+Returns time elapsed since the engine started.
+
+```python
+time.delta() -> float
+```
+
+Returns time elapsed since the last frame.

doc/en/scripting/builtins/libworld.md

@@ -0,0 +1,40 @@
+# *world* library
+
+```lua
+world.get_list() -> tables array {
+    -- world name
+    name: str,
+    -- world icon/preview (loading automatically)
+    icon: str
+}
+
+-- Returns current day time in range \[0.0-1.0\] 
+-- where 0.0 and 1.0 - midnight, 0.5 - noon.
+world.get_day_time() -> number
+
+-- Set day time value.
+world.set_day_time(time: number)
+
+-- Sets the specified day time cycle speed.
+world.set_day_time_speed(value: number)
+
+-- Returns the day time cycle speed.
+world.get_day_time_speed() -> number
+
+-- Returns total time passed in the world.
+world.get_total_time() -> number
+
+-- Returns world seed.
+world.get_seed() -> int
+
+-- Proves that this is the current time during the day 
+-- from 0.333(8 am) to 0.833(8 pm).
+world.is_day() -> boolean
+
+-- Checks that it is the current time at night
+-- from 0.833(8 pm) to 0.333(8 am).
+world.is_night() -> bool
+
+-- Checks the existence of a world by name.
+world.exists() -> bool
+```