https://github.com/localizedmc/texturelocaleredirector
Support redirecting resource paths based on the game language to achieve multi-language texture loading
https://github.com/localizedmc/texturelocaleredirector
localization minecraft minecraft-mod
Last synced: 21 days ago
JSON representation
Support redirecting resource paths based on the game language to achieve multi-language texture loading
- Host: GitHub
- URL: https://github.com/localizedmc/texturelocaleredirector
- Owner: LocalizedMC
- License: mit
- Created: 2025-08-06T06:57:12.000Z (6 months ago)
- Default Branch: 1.21.x
- Last Pushed: 2025-08-31T04:48:53.000Z (5 months ago)
- Last Synced: 2025-08-31T06:12:40.932Z (5 months ago)
- Topics: localization, minecraft, minecraft-mod
- Language: Java
- Homepage:
- Size: 1.3 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**Texture Locale Redirector** adds native multi-language texture support to Minecraft resource packs.
By extending vanilla resource loading mechanism, this mod allows you to provide language-specific textures within a single resource pack.
It solves the problem where localized textures (with text or symbols) for one language may negatively affect players in other languages.
## Usage
Follow these three simple steps to enable multi-language textures:
1. **Install the mod**: Place this mod in your `mods` folder.
2. **Create a resource pack**: Organize your localized textures according to the required folder structure.
3. **Start the game**: Enable the resource pack and switch to the corresponding language in Minecraft.
## Resource Pack Structure Example
Inside your resource pack, store localized textures under `assets//textures//`.
- `` is the namespace — `minecraft` for vanilla, or the modid for mods.
- `` is the language code, such as `zh_cn` (Simplified Chinese) or `ja_jp` (Japanese).
**Note:** The relative path of the texture to be replaced must match the original texture path.
```
ResourcePackName/
└── assets/
└── minecraft (namespace)/
└── textures/
├── zh_cn/ # Simplified Chinese textures
│ ├── block/
│ │ └── dirt.png # Replaced dirt texture
│ └── item/
│ └── diamond_sword.png # Replaced diamond sword texture
└── ja_jp/ # Japanese textures
└── item/
└── diamond_sword.png # Replaced diamond sword texture
```
## Performance
This mod is heavily optimized and should have negligible performance impact:
* Works **only** when the current language is not `en_us`, meaning no effect for English players.
* Implements an **advanced caching system** to drastically reduce unnecessary disk I/O.
* Clears cache upon language change or resource reload, ensuring textures are updated immediately.
* Automatically releases cache memory when system memory is low to prevent lag.
* If a resource pack has no language-specific texture folder, no replacement scan is performed — avoiding unnecessary work.
* Does not interfere with the normal operation of other resource packs.
## License
This project is open-sourced under the [MIT License](LICENSE).
Contributions and PRs are welcome! Feel free to submit issues for bug reports or feature requests.
