Depth-sort upright world planes; mod documentation

docs/ru.md

@@ -0,0 +1,37 @@
+# Isometric Tiles — ромбовидный вид карты
+
+Isometric Tiles рисует тайловые карты под углом, сеткой ромбов 2:1, так что дома и деревья поднимаются из земли. Это один из двух видов карты общего движка Tile Rendering; второй — Top-down Tiles. Те же карты, события и сохранения работают в обоих.
+
+![Деревня RPG Plus в полдень в изометрии: площадь, фонари, дома, жители и герой на дорожке; за краем карты виден пустой фон.](assets/village-isometric.jpg)
+
+## Чем изометрия отличается от вида сверху
+
+- **Ромбовидные клетки.** Каждая клетка карты рисуется ромбом, вдвое более широким, чем высоким. Логическая сетка остаётся квадратной: у клетки те же четыре соседа, что и раньше.
+- **Стоящие объекты.** Дома и другие много-клеточные объекты, которые тайлсет пометил особым образом, рисуются стоящими картинками или несколькими плоскими гранями — а не плоскими тайлами.
+- **Персонажи** выбирают строку спрайта, отвечающую их направлению на ромбовидной сетке.
+- **Щелчок** по карте выбирает ромб под указателем; редактор RPG-карт пользуется тем же правилом.
+
+![Та же карта деревни в обоих видах: слева вид сверху, справа изометрия.](assets/same-map-two-projections.jpg)
+
+Не меняется следующее: правила ходьбы, коллизии, события, бои, сохранения, освещение и время суток принадлежат моду RPG и Tile Rendering и ведут себя одинаково в обоих видах.
+
+## Ограничения
+
+- **Клавиши следуют за сеткой, а не за экраном.** Вверх и вниз (W/S, стрелки) двигают по одной диагонали экрана, влево и вправо — по другой: они смещают героя ровно на одну клетку квадратной сетки.
+- **Края карты видны.** Возле угла карты виден пустой фон за пределами ромба — как на картинке выше.
+- **Тайлсеты нужно готовить.** Объекты выглядят стоящими, только если тайлсет описывает их группами; обычные тайлы кладутся плашмя на ромбы.
+
+## Как включить
+
+В схеме игры (**Моды и коллекции → Коллекции → игра → Изменить схему**) подключите этот мод и установите **Проекцию карты** в **Изометрия**. Значение настройки `tile.renderer` — `isometric`:
+
+```json
+"settings": { "tile.renderer": "isometric" }
+```
+
+Чтобы попробовать один раз, не меняя игру, запустите её с ключом `--tile-renderer=isometric` в командной строке. RPG Plus уже включает оба рендерера, так что достаточно поменять настройку.
+
+## Если что-то пошло не так
+
+1. **Карта пуста.** **Проекция карты** игры просит рендерер, которого нет в составе; подключите этот мод или выберите другую проекцию.
+2. **Герой ходит наискосок.** Так работают клавиши в этом виде (см. «Ограничения»).