From 36284ee9ed930ac782e648fabe33948b39d3d565 Mon Sep 17 00:00:00 2001
From: Shahovalov MIkhail <m.shahovalov@yandex.ru>
Date: Tue, 7 Apr 2026 18:26:20 +0300
Subject: [PATCH] Add localization mod metadata and build scripts

---
 .gitignore                  |  7 ++++++
 Mods/DnD55eRussian/meta.lsx | 44 +++++++++++++++++++++++++++++++++++++
 README.md                   | 34 +++++++++++++++++++++++++++-
 scripts/build.ps1           |  7 ++++++
 scripts/build.sh            |  5 +++++
 5 files changed, 96 insertions(+), 1 deletion(-)
 create mode 100644 .gitignore
 create mode 100644 Mods/DnD55eRussian/meta.lsx
 create mode 100644 scripts/build.ps1
 create mode 100644 scripts/build.sh

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..60ca4a9
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,7 @@
+build/
+*.pak
+*.tmp
+*.temp
+*.log
+Thumbs.db
+.DS_Store
diff --git a/Mods/DnD55eRussian/meta.lsx b/Mods/DnD55eRussian/meta.lsx
new file mode 100644
index 0000000..8f0fb81
--- /dev/null
+++ b/Mods/DnD55eRussian/meta.lsx
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<save>
+  <version major="4" minor="8" revision="0" build="500"/>
+  <region id="Config">
+    <node id="root">
+      <children>
+        <node id="Dependencies">
+          <children>
+            <node id="ModuleShortDesc">
+              <attribute id="Folder" type="LSString" value=""/>
+              <attribute id="MD5" type="LSString" value=""/>
+              <attribute id="Name" type="LSString" value="DnD 5.5e All-in-One BEYOND"/>
+              <attribute id="PublishHandle" type="uint64" value="0"/>
+              <attribute id="UUID" type="guid" value="897914ef-5c96-053c-44af-0be823f895fe"/>
+              <attribute id="Version64" type="int64" value="36028797018963968"/>
+            </node>
+          </children>
+        </node>
+        <node id="ModuleInfo">
+          <attribute id="Author" type="LSString" value="MikhailRaw"/>
+          <attribute id="CharacterCreationLevelName" type="FixedString" value=""/>
+          <attribute id="Description" type="LSString" value="Русская локализация мода, который добавляет и обновляет контент в соответствии с правилами DnD 5.5e и другими источниками, включая предыстории, классы, таланты, расы, заклинания и многое другое. Это отдельный мод локализации и он требует установленный оригинальный мод."/>
+          <attribute id="FileSize" type="uint64" value="0"/>
+          <attribute id="Folder" type="LSString" value="DnD55eRussian"/>
+          <attribute id="LobbyLevelName" type="FixedString" value=""/>
+          <attribute id="MD5" type="LSString" value=""/>
+          <attribute id="MenuLevelName" type="FixedString" value=""/>
+          <attribute id="Name" type="LSString" value="DnD 5.5e All-in-One BEYOND Russian Localization"/>
+          <attribute id="NumPlayers" type="uint8" value="4"/>
+          <attribute id="PhotoBooth" type="FixedString" value=""/>
+          <attribute id="PublishHandle" type="uint64" value="0"/>
+          <attribute id="StartupLevelName" type="FixedString" value=""/>
+          <attribute id="UUID" type="FixedString" value="6401e84d-daf2-416d-adeb-99c03a2487a6"/>
+          <attribute id="Version64" type="int64" value="36028797018963968"/>
+          <children>
+            <node id="PublishVersion">
+              <attribute id="Version64" type="int64" value="36028797018963968"/>
+            </node>
+          </children>
+        </node>
+      </children>
+    </node>
+  </region>
+</save>
diff --git a/README.md b/README.md
index 1b2bc8e..2e47357 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,35 @@
 # bg3-dnd55e-russian-localization
 
-Russian localization for DnD 5.5e All-in-One BEYOND mod (Baldur's Gate 3)
\ No newline at end of file
+Русская локализация для мода **DnD 5.5e All-in-One BEYOND** для Baldur's Gate 3.
+
+Оригинальный мод: [Yoonmoonsik/dnd55e](https://github.com/Yoonmoonsik/dnd55e)
+
+Оригинальный `meta.lsx`: [Mods/DnD2024_897914ef-5c96-053c-44af-0be823f895fe/meta.lsx](https://github.com/Yoonmoonsik/dnd55e/blob/main/Mods/DnD2024_897914ef-5c96-053c-44af-0be823f895fe/meta.lsx)
+
+Репозиторий содержит только исходники локализации. Готовый `.pak` в репозиторий не добавляется.
+
+## Installation
+
+1. Установите оригинальный мод **DnD 5.5e All-in-One BEYOND**.
+2. Получите собранный `.pak` локализации из CI-артефакта или соберите его локально.
+3. Откройте **BG3ModManager**.
+4. Импортируйте `.pak` локализации в менеджер модов.
+5. Убедитесь, что локализация стоит после основного мода в активном порядке загрузки.
+6. Сохраните порядок и экспортируйте его в игру.
+
+## Build
+
+Сборка выполняется вне репозитория: локально или через CI.
+
+Для локальной сборки требуется **LSLib (Divine)**. Пример команд находится в:
+
+- `scripts/build.sh`
+- `scripts/build.ps1`
+
+Пример упаковки:
+
+```bash
+Divine -a pack -s Mods -d build/DnD55eRussian.pak
+```
+
+В CI должен формироваться только артефакт `.pak`, без коммита бинарников обратно в репозиторий.
diff --git a/scripts/build.ps1 b/scripts/build.ps1
new file mode 100644
index 0000000..2e5f6a3
--- /dev/null
+++ b/scripts/build.ps1
@@ -0,0 +1,7 @@
+$ErrorActionPreference = "Stop"
+
+if (-not (Test-Path -LiteralPath "build")) {
+    New-Item -ItemType Directory -Path "build" | Out-Null
+}
+
+Divine -a pack -s Mods -d build/DnD55eRussian.pak
diff --git a/scripts/build.sh b/scripts/build.sh
new file mode 100644
index 0000000..b1fa6c9
--- /dev/null
+++ b/scripts/build.sh
@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+mkdir -p build
+Divine -a pack -s Mods -d build/DnD55eRussian.pak