Texture Locale Redirector

Texture Locale Redirector

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

游戏机制

纹理语言重定向器

modrinth curseforge forge neoforge fabric

纹理语言重定向器 为 Minecraft 资源包添加了原生的多语言纹理支持。

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

使用方法

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

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

资源包结构示例

在您的资源包内,将本地化纹理存放于 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 许可证 开源。

欢迎提交贡献和拉取请求!随时可以提交问题报告以反馈错误或提出功能建议。