New lib Fireflies: first docs

Author: ArtemKot4

i18n/ru/docusaurus-plugin-content-docs-libraries/current.json

@@ -14,5 +14,13 @@
   "sidebar.librariesSidebar.category.Component": {
     "message": "Component",
     "description": "The label for category Component in sidebar librariesSidebar"
+  },
+  "sidebar.librariesSidebar.category.Fireflies": {
+    "message": "Fireflies",
+    "description": "The label for category Fireflies in sidebar librariesSidebar"
+  },
+  "sidebar.librariesSidebar.category.Block": {
+    "message": "Блоки",
+    "description": "The label for category Block in sidebar librariesSidebar"
   }
 }

i18n/ru/docusaurus-plugin-content-docs-libraries/current/Fireflies/blocks/BasicBlock.md

@@ -0,0 +1,70 @@
+# Начало
+Приветствую читателей! Данное руководство расскажет о моде-библиотеке Fireflies.
+
+Данная мод-библиотека была написана с целью добавления более понятного api для объектно-ориентированного подхода, а так же недостающих на взгляд автора инструментов, по типу новых важных событий и методов. Она нацелена в основном на TypeScript, но может использоваться и без.
+
+<div style={{textAlign: "center", color:"yellow", marginTop: "30px"}}>
+
+А при чём тут светлячки?
+
+</div>
+
+<div className="resource-atlas-align-box">
+
+![fireflies.png](/images/libraries/fireflies.png)
+
+</div>
+
+Эта библиотека изначально разрабатывалась как аналог `BlockEngine` для таких проектов, как Galacticraft и Infinite Forest, поэтому в некоторых случаях может использоваться как аналог. 
+
+## Возможности
+Ниже будут рассмотрены некоторые возможности, добавляемые мод-библиотекой.
+### Блоки
+Блоки получили отдельный класс `BasicBlock`, который располагает инструментами добавления событий для блока, тегов, блокстейтов, моделей и тайл-энтити; которые так же позволяют полностью исключить специальные типы блоков, заменяя их методами с возвратом значений, что широко практикуется в Java моддинге.
+
+Блоки имеют свои классы-наследники, добавляя классы для создания блоков-растений, кустов и блоков, относящихся к дереву.
+
+### Предметы
+Предметы получили отдельный класс `BasicItem`, который располагает инструментами добавления событий предметов, в том числе и новых, а так же тегов и свойств предмета.
+
+### Тайл-энтити
+Тайл-энтити получили два класса: `CommonTileEntity` и `LocalTileEntity`, а так же удобный декоратор `NetworkEvent`, который позволяет добавлять пакеты в зависимости от разновидности тайла.
+
+Тайлы были разделены на клиентские и серверные, которые выражены в отдельных классах. Это позволяет разделить визуальную часть и серверные вычисления явно.
+
+### Измерения
+Добавлен новый класс `Dimension`, который позволяет в виде класса создавать кастомные миры и использовать события по типу входа-выхода игрока из мира и генерации чанка мира. Так же есть некоторые новые возможности по типу автоматического создания слоя бедрока на нижнем слое мира.
+
+### Рендеринг
+Добавлены инструменты для более удобного создания рендеров `Animation.Base` в мире в виде класса `RenderObject`, который делает некоторую работу за вас:
+1. Автоматически описывает рендер исходя из указанных данных в методах.
+2. Запускает и убирает поток исходя из того, описали ли вы действия в нём, позволяет автоматически указать количество fps при помощи метода.
+3. Позволяет автоматически менять позицию рендера при смене параметров: x, y, z. Работает если эта фишка включена при помощи метода.
+4. Позволяет переиспользовать созданный рендер нужное количество раз.
+
+### Новые возможности для кастомизации мира
+В модуль World были добавлены новые методы, которые позволяют менять цвета неба, тумана, подводного тумана и облаков во время игры. Так же переключать сложность и получать значение сложности игры.
+
+### Подписка на события
+Благодаря новому декоратору `SubscribeEvent` вы можете "подписываться" на события так же, как и в Java моддинге. Достаточно просто объявить декоратор над методом в классе.
+
+## Подключение
+
+Подключить можно двумя способами:
+### ModAPI
+Такой способ позволяет подключить api для конкретных участков кода, и выглядит так:
+
+```js
+ModAPI.addAPICallback("FirefliesAPI", function(api) {
+    // Ваш код. В api лежат все модули и классы мода-библиотеки 
+});
+```
+
+### ModAPI и launcher.js
+Данный способ более предпочтителен. Он позволяет запустить мод сразу с запуском api мода-библиотеки. Это значит, что вы сможете его использовать так же, как оно используется в коде библиотеки, сразу по имени модулей и классов.
+
+```js title="launcher.js"
+ModAPI.addAPICallback("FirefliesAPI", function(api) {
+    Launch(api);
+});
+```

i18n/ru/docusaurus-plugin-content-docs-libraries/current/Fireflies/items/BasicItem.md

@@ -0,0 +1,9 @@
+# Динамические данные
+Стандартное api позволяет нам получить многие данные из любого места в коде, но не все. Новый модуль `RuntimeData` призван исправить данную проблему.
+## Клиентские данные
+Модуль `local` позволяет нам узнать данные, которые часто отличаются от пользователя к пользователю. Это клиентские данные.
+### Данные о ванильном окне
+Мы можем узнать, какое окно открыто в данный момент у пользователя. Для этого используется переменная `screenName`:
+```ts
+Game.message(RuntimeData.local.screenName);
+```

i18n/ru/docusaurus-plugin-content-docs-libraries/current/Fireflies/readme.md

@@ -56,6 +56,24 @@ export default {
 				'KernelExtension/custom-block-entities'
 			]
 		},
+        {
+            type: 'category',
+            label: 'Fireflies',
+            link: {
+                type: 'doc',
+                id: 'Fireflies/readme'
+            },
+            items: [
+                {
+                    type: 'category',
+                    label: 'Block',
+                    items: [
+                        'Fireflies/blocks/BasicBlock'
+                    ]
+                },
+                'Fireflies/runtime-data',
+            ]
+        },
         {
             type: 'category',
             label: 'Component',