Texture Locale Redirector

Texture Locale Redirector

通过扩展原版资源加载机制,为资源包提供原生多语言纹理支持,实现纹理资产的本地化

Texture Locale Redirector

modrinth curseforge forge neoforge fabric

Texture Locale Redirector 为 Minecraft 资源包添加了原生的多语言纹理支持。

通过扩展原版资源加载机制,此模组允许你在单个资源包中提供特定语言的纹理。
它解决了某一种语言的本地化纹理(带有文字或符号)可能会对其他语言的玩家造成负面影响的问题。

使用方法

按照以下三个简单步骤即可启用多语言纹理:

  1. 安装模组:将此模组放入你的 mods 文件夹中。
  2. 创建资源包:按照所需的文件夹结构组织你的本地化纹理。
  3. 启动游戏:启用资源包,并在 Minecraft 中切换到相应的语言。

资源包结构示例

在你的资源包中,将本地化纹理存放在 assets/<namespace>/textures/<language>/ 下。

  • <namespace> 是命名空间——原版为 minecraft,模组则为对应的 modid。
  • <language> 是语言代码,例如 zh_cn(简体中文)或 ja_jp(日语)。

注意: 要替换的纹理的相对路径必须与原始纹理路径一致。

ResourcePackName/
└── assets/
    └── minecraft (namespace)/
        └── textures/
            ├── zh_cn/          # 简体中文纹理
            │   ├── block/
            │   │   └── dirt.png  # 替换后的泥土纹理
            │   └── item/
            │       └── diamond_sword.png  # 替换后的钻石剑纹理
            └── ja_jp/          # 日语纹理
                └── item/
                    └── diamond_sword.png  # 替换后的钻石剑纹理

性能

此模组经过大量优化,性能影响可以忽略不计:

  • 仅在当前语言不是 en_us 时生效,也就是说对英语玩家没有影响。
  • 实现了高级缓存系统,大幅减少不必要的磁盘 I/O。
  • 在语言切换或资源重载时清除缓存,确保纹理立即更新。
  • 当系统内存不足时自动释放缓存内存,以防止卡顿。
  • 如果资源包没有特定语言的纹理文件夹,则不会执行替换扫描——避免不必要的工作。
  • 不会干扰其他资源包的正常运行。

许可证

本项目基于 MIT 许可证开源。

欢迎贡献和提交 PR!也欢迎随时提交 issue 来报告 bug 或请求新功能。