Fabric rewrite: MC 26.2 project scaffold (Phase 0)

.gitattributes

@@ -1,4 +1,9 @@
-gradlew* linguist-vendored
-gradle/wrapper/* linguist-vendored
-*.bat text eol=crlf
+#
+# https://help.github.com/articles/dealing-with-line-endings/
+#
+# Linux start script should use lf
+/gradlew        text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat           text eol=crlf
 

.github/workflows/build.yml

@@ -1,29 +1,30 @@
-name: Run Gradle Build
-on:
-  - push
-  - pull_request
+# Automatically build the project and run any configured tests for every push
+# and submitted pull request. This can help catch issues that only occur on
+# certain platforms or Java versions, and provides a first line of defence
+# against bad commits.
+
+name: build
+on: [pull_request, push]
 
 jobs:
-  gradle:
-    runs-on: ubuntu-latest
+  build:
+    runs-on: ubuntu-24.04
     steps:
-      - name: Checkout source
-        uses: actions/checkout@v4.1.1
-
-      - name: Setup Java
-        uses: actions/setup-java@v4.0.0
+      - name: checkout repository
+        uses: actions/checkout@v6
+      - name: validate gradle wrapper
+        uses: gradle/actions/wrapper-validation@v6
+      - name: setup jdk
+        uses: actions/setup-java@v5
         with:
-          distribution: temurin
-          java-version: 17
-
-      - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v3
-
-      - name: Execute Gradle build
+          java-version: '25'
+          distribution: 'microsoft'
+      - name: make gradle wrapper executable
+        run: chmod +x ./gradlew
+      - name: build
         run: ./gradlew build
-
-      - name: Upload built mod JAR
-        uses: actions/upload-artifact@v4.3.0
+      - name: capture build artifacts
+        uses: actions/upload-artifact@v7
         with:
-          name: mod-jar
-          path: build/libs/*.jar
+          name: Artifacts
+          path: build/libs/

.gitignore

@@ -1,6 +1,51 @@
+# gradle
+
+.gradle/
+build/
+out/
+classes/
+
+# eclipse
+
+*.launch
+
+# idea
+
 .idea/
+*.iml
+*.ipr
+*.iws
+
+# vscode
+
+.settings/
 .vscode/
+bin/
+.classpath
+.project
+
+# macos
+
+*.DS_Store
+
+# fabric
+
 run/
-build/
-.gradle/
 
+# java
+
+hs_err_*.log
+replay_*.log
+*.hprof
+*.jfr
+
+# claude
+.claude/
+
+# local secrets / personal data — never commit
+.env
+*.env
+.devauth/
+local.properties
+*.pem
+*.key

LICENSE

@@ -1,24 +1,21 @@
-This is free and unencumbered software released into the public domain.
+MIT License
 
-Anyone is free to copy, modify, publish, use, compile, sell, or
-distribute this software, either in source code form or as a compiled
-binary, for any purpose, commercial or non-commercial, and by any
-means.
+Copyright (c) 2026 LayBalt
 
-In jurisdictions that recognize copyright laws, the author or authors
-of this software dedicate any and all copyright interest in the
-software to the public domain. We make this dedication for the benefit
-of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of
-relinquishment in perpetuity of all present and future rights to this
-software under copyright law.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
-OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-For more information, please refer to <http://unlicense.org/>
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,26 +1,50 @@
-<!-- markdownlint-disable-file MD001 MD033 -->
-<h2 align="center">LayBalt Repository</h2>
-<h2 align="center">Version 1.0.0</h2>
-<h4 align="center">Skyblock Translator is a 1.8.9 Minecraft Forge mod for Hypixel Skyblock.</h4>
+# SkyBlock Translator
 
----
+**[Русский]** Клиентский Fabric-мод, который переводит Hypixel SkyBlock на ваш язык: предметы, лор, меню, диалоги NPC и чат. Игра «внутри» остаётся английской — перевод накладывается только при отрисовке, поэтому другие моды (NEU, Skyblocker и т.д.), поиск и команды продолжают работать.
 
-<h3 align="center">Mod Information</h3>
-<p align="center">
-Skyblock Translator is a Forge 1.8.9 for Minecraft. This mod will translate all the NPC dialogs, Item description, GUI menu's, etc.
-</p>
+**[English]** A client-side Fabric mod that translates Hypixel SkyBlock into your language: items, lore, menus, NPC dialogues and chat. The game stays English under the hood — translation is applied at render time only, so other mods (NEU, Skyblocker, etc.), search and commands keep working.
 
----
+> ⚠️ В ранней разработке / Early development.
 
-<h3 align="center">Official Links</h3>
-<p align="center">
-Discord: <a href="https://discord.gg/555QWxv6nS">LayBalt Discord</a><br>
-More links coming soon...
-</p>
+## Как это работает / How it works
 
----
+```
+Рендер текста → сегментация (сохраняем §-форматирование)
+  → нормализация (числа → плейсхолдеры: "Damage: +{0}")
+  → словарь → локальный кэш → API-переводчик
+```
 
-<h3 align="center">Contribution Information</h3>
-<p align="center">
-Pull requests are welcome. We recomend using <a href="https://bell-sw.com">BellSoft JDK</a> with this project.
-For more info: <a href="https://github.com/LayBalt/LayBalt-QOL/blob/main/ContributingGuide.md">Contributor Guide</a>.
+- **Free** — встроенные словари, локальный кэш, бесплатный машинный перевод для нового текста (с лимитами).
+- **Premium** (планируется) — облачный сервис: LLM-перевод со SkyBlock-глоссарием, общий кэш переводов, перевод чата игроков, без лимитов. Сам мод бесплатен для всех — Premium это подписка на облачный API.
+
+## Версии / Versions
+
+| | |
+|---|---|
+| Minecraft | 26.2 |
+| Loader | Fabric (Loader ≥ 0.19.3, Fabric API) |
+| Java | 25 |
+
+## Сборка / Building
+
+```
+./gradlew build
+```
+
+Jar появится в `build/libs/`. Для запуска дев-клиента: `./gradlew runClient`. Java 25 скачается автоматически (Gradle toolchain), нужна лишь любая Java 17+ для запуска Gradle.
+
+## Словари / Dictionaries
+
+Переводы лежат в `src/main/resources/assets/skyblock-translator/dict/<lang>/*.json` в формате `"английский шаблон": "перевод"`. Числа и имена заменяются плейсхолдерами `{0}`, `{1}`… — один шаблон покрывает все значения. PR с переводами приветствуются.
+
+## Роадмап / Roadmap
+
+- [x] Фаза 0 — каркас проекта, CI
+- [ ] Фаза 1 — pipeline перевода, словарь, кэш, тултипы и меню
+- [ ] Фаза 2 — чат и диалоги NPC, бесплатный API-переводчик — первый публичный релиз
+- [ ] Фаза 3 — Premium: облачный LLM-перевод, общий кэш, перевод чата игроков
+- [ ] Фаза 4 — scoreboard/bossbar/tablist, другие языки, комьюнити-словари
+
+## Лицензия / License
+
+[MIT](LICENSE). Not affiliated with Hypixel or Mojang.

build.gradle

@@ -0,0 +1,80 @@
+plugins {
+	id 'net.fabricmc.fabric-loom' version "${loom_version}"
+}
+
+version = project.mod_version
+group = project.maven_group
+
+repositories {
+	// Loom adds the essential maven repositories to download Minecraft and libraries from automatically.
+	// Add repositories here only when depending on other mods.
+	maven {
+		name = 'DevAuth'
+		url = 'https://pkgs.dev.azure.com/djtheredstoner/DevAuth/_packaging/public/maven/v1'
+	}
+}
+
+loom {
+	mods {
+		"skyblock-translator" {
+			sourceSet sourceSets.main
+		}
+	}
+
+	runs {
+		client {
+			// DevAuth: log the dev client into a real Microsoft account.
+			// First launch prints a device-code link; tokens are stored in
+			// ~/.devauth (outside the repo, never committed).
+			vmArg "-Ddevauth.enabled=true"
+		}
+	}
+}
+
+dependencies {
+	// To change the versions see the gradle.properties file
+	minecraft "com.mojang:minecraft:${project.minecraft_version}"
+	implementation "net.fabricmc:fabric-loader:${project.loader_version}"
+
+	implementation "net.fabricmc.fabric-api:fabric-api:${project.fabric_api_version}"
+
+	// Dev-environment only: real-account login for runClient (not bundled in the jar)
+	runtimeOnly "me.djtheredstoner:DevAuth-fabric:1.2.2"
+}
+
+processResources {
+	def version = project.version
+	inputs.property "version", version
+
+	filesMatching("fabric.mod.json") {
+		expand "version": version
+	}
+}
+
+tasks.withType(JavaCompile).configureEach {
+	it.options.release = 25
+	it.options.encoding = 'UTF-8'
+}
+
+java {
+	withSourcesJar()
+
+	// Minecraft 26.x requires Java 25. The foojay resolver (see settings.gradle)
+	// downloads it automatically if missing.
+	toolchain {
+		languageVersion = JavaLanguageVersion.of(25)
+	}
+}
+
+test {
+	useJUnitPlatform()
+}
+
+jar {
+	def projectName = project.name
+	inputs.property "projectName", projectName
+
+	from("LICENSE") {
+		rename { "${it}_$projectName" }
+	}
+}