From 446affc54f78af48bd52109c7470d22b9c44c964 Mon Sep 17 00:00:00 2001
From: mleaf233 <magicleaf06151@gmail.com>
Date: Mon, 15 Dec 2025 22:10:48 +0800
Subject: [PATCH] Add TEOcean@mleaf233

---
 mods/TEOcean@mleaf233/description.md | 72 ++++++++++++++++++++++++++++
 mods/TEOcean@mleaf233/meta.json      | 12 +++++
 2 files changed, 84 insertions(+)
 create mode 100644 mods/TEOcean@mleaf233/description.md
 create mode 100644 mods/TEOcean@mleaf233/meta.json

diff --git a/mods/TEOcean@mleaf233/description.md b/mods/TEOcean@mleaf233/description.md
new file mode 100644
index 00000000..8b406073
--- /dev/null
+++ b/mods/TEOcean@mleaf233/description.md
@@ -0,0 +1,72 @@
+<div align="center">
+    <h1> 🌏TEOcean Localization Framework🌎 </h1>
+    <p>Also is a language pack</p>
+    <p><a href="https://github.com/mleaf233/TEOcean/blob/main/README_zh_CN.md">简体中文</a> &nbsp;&nbsp; English</p>
+    <img src="https://img.shields.io/github/license/mleaf233/TEOcean">
+    <a href="https://github.com/mleaf233/TEOcean/issues"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat"></a>
+</div>
+
+---
+
+## Introdution
+
+A lightweight localization framework for mods in the Balatro/SMODS, which also functions as a language pack.
+
+## Use Cases
+
+- Fill in missing localization for a mod  
+- Override the original translations of a mod  
+- Apply a unified translation across multiple mods  
+- When a target mod is still under active development and its localization files change frequently, making PRs inconvenient  
+
+## How It Works
+
+Translation files under `impl/mods/<modid>/localization/` are merged into the corresponding target mod’s `localization/` directory, allowing unified translations to override or supplement the originals in-game.
+
+## Features
+
+- **Merge by modid**: Iterates over `SMODS.mod_list` and only performs merging for mods that exist in the workspace at `impl/mods/<modid>/`
+- **Backup original files (once only)**: Before the first merge, the target mod’s existing `localization/<lang>.lua` / `.json` files are copied to `impl/backup/<modid>/localization/`. If a backup already exists, it is skipped to ensure the backup always represents the “original” localization files
+- **Skip meaningless writes**: Before writing, the merged result is normalized for newlines and trailing whitespace and compared with the existing file. If they are identical, no write or backup is performed
+- **Hot reload**: Supports execution when clicking the “Manual Reload” button in the mod configuration menu in-game
+
+## How to Use
+
+### Method 1
+
+- Like any other mod, simply copy the entire project folder into `%AppData%/Balatro/mods`
+
+### Method 2 (Hot Reload)
+
+1. Launch the game.  
+2. Open the main menu → Mods.  
+3. Select the mod(this mod itself is **The Eighth Ocean**) and enter the `Config` tab.  
+4. Click the **Manual Reload** button to trigger merging and reload.
+
+> Note: The initial backup preserves the original files of the target mod at the moment it is triggered.  
+> To force a fresh backup of the original files, manually delete the corresponding backup files under  
+> `impl/backup/<modid>/localization/`, then click Manual Reload again.
+
+
+## Development
+
+- The merge logic is implemented in `mod.lua`, in the function `merge_impl_mod_localizations()`, which handles reading, merging, serialization, and writing.
+- To support additional mods, create a new folder under `impl/mods/` according to the modid. Refer to the existing examples for details.
+- It is recommended to ensure this mod loads with higher priority than the mods it adapts.
+
+## Directory Structure
+
+- `impl/mods/<modid>/localization/` — Source of your override/supplemental translations  
+- `impl/backup/<modid>/localization/` — Automatic backup of the target mod’s original localization (backed up once only)  
+- Target write path: `<target_mod_path>/localization/<lang>.lua`
+
+## Troubleshooting
+
+- If no backup or output is generated after clicking the button, check the game startup logs (console output) for entries prefixed with `[TEOcean Language Packs]`.
+- Ensure the target mod’s `localization/` directory is writable.
+- If the localization still does not take effect after merging, confirm that the selected in-game language (`G.SETTINGS.language`) matches the merged language file (e.g. `zh_CN.lua`).
+
+## License
+
+- This project is licensed under GPLv3.
+- Please comply with each mod’s individual license terms. This mod only modifies the target mod’s `localization` files locally; make backups when necessary and obtain the original author’s permission before distribution.
\ No newline at end of file
diff --git a/mods/TEOcean@mleaf233/meta.json b/mods/TEOcean@mleaf233/meta.json
new file mode 100644
index 00000000..f9d3fa38
--- /dev/null
+++ b/mods/TEOcean@mleaf233/meta.json
@@ -0,0 +1,12 @@
+{
+  "title": "TEOcean",
+  "requires-steamodded": true,
+  "requires-talisman": false,
+  "categories": ["Quality of Life"],
+  "author": "mleaf233",
+  "repo": "https://github.com/mleaf233/TEOcean",
+  "downloadURL": "https://github.com/mleaf233/TEOcean/archive/refs/heads/main.zip",
+  "folderName": "TEOcean",
+  "version": "1.0.5",
+  "automatic-version-check": true
+}
\ No newline at end of file