> For the complete documentation index, see [llms.txt](https://spintowin.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/gong-neng/localized-item-name.md).

# 🌍本地化物品名称

## 运行要求

服务端版本为 1.16 或更高。

## 配置

在 `config.yml` 中找到以下配置：

```yaml
config-files:
  generate-default-files: true
  language: en_US
  minecraft-locate-file:
    enabled: true
    generate-new-one: true
    file: 'zh_cn.json'
```

1. 启用 `config-files.minecraft-locate-file.enabled`。
2. 首次生成时，将 `config-files.minecraft-locate-file.generate-new-one` 设为 `true`。
3. 在 `config-files.minecraft-locate-file.file` 中填写语言文件名，例如 `zh_cn.json`。
4. 启动或重载插件，检查语言文件是否下载成功。

支持的语言文件名与英文文档一致：

* af\_za.json
* ar\_sa.json
* ast\_es.json
* az\_az.json
* ba\_ru.json
* bar.json
* be\_by.json
* bg\_bg.json
* br\_fr.json
* brb.json
* bs\_ba.json
* ca\_es.json
* cs\_cz.json
* cy\_gb.json
* da\_dk.json
* de\_at.json
* de\_ch.json
* de\_de.json
* el\_gr.json
* en\_au.json
* en\_ca.json
* en\_gb.json
* en\_nz.json
* en\_pt.json
* en\_ud.json
* enp.json
* enws.json
* eo\_uy.json
* es\_ar.json
* es\_cl.json
* es\_ec.json
* es\_es.json
* es\_mx.json
* es\_uy.json
* es\_ve.json
* esan.json
* et\_ee.json
* eu\_es.json
* fa\_ir.json
* fi\_fi.json
* fil\_ph.json
* fo\_fo.json
* fr\_ca.json
* fr\_fr.json
* fra\_de.json
* fur\_it.json
* fy\_nl.json
* ga\_ie.json
* gd\_gb.json
* gl\_es.json
* haw\_us.json
* he\_il.json
* hi\_in.json
* hr\_hr.json
* hu\_hu.json
* hy\_am.json
* id\_id.json
* ig\_ng.json
* io\_en.json
* is\_is.json
* isv.json
* it\_it.json
* ja\_jp.json
* jbo\_en.json
* ka\_ge.json
* kk\_kz.json
* kn\_in.json
* ko\_kr.json
* ksh.json
* kw\_gb.json
* la\_la.json
* lb\_lu.json
* li\_li.json
* lmo.json
* lo\_la.json
* lol\_us.json
* lt\_lt.json
* lv\_lv.json
* lzh.json
* mk\_mk.json
* mn\_mn.json
* ms\_my.json
* mt\_mt.json
* nah.json
* nds\_de.json
* nl\_be.json
* nl\_nl.json
* nn\_no.json
* no\_no.json
* oc\_fr.json
* ovd.json
* pl\_pl.json
* pt\_br.json
* pt\_pt.json
* qya\_aa.json
* ro\_ro.json
* rpr.json
* ru\_ru.json
* ry\_ua.json
* sah\_sah.json
* se\_no.json
* sk\_sk.json
* sl\_si.json
* so\_so.json
* sq\_al.json
* sr\_cs.json
* sr\_sp.json
* sv\_se.json
* sxu.json
* szl.json
* ta\_in.json
* th\_th.json
* tl\_ph.json
* tlh\_aa.json
* tok.json
* tr\_tr.json
* tt\_ru.json
* uk\_ua.json
* val\_es.json
* vi\_vn.json
* vp\_vl.json
* yi\_de.json
* yo\_ng.json
* zh\_hk.json
* zh\_cn.json
* zh\_tw\.json
* zlm\_arab.json

文件生成成功后，插件即可使用相应语言的原版物品名称。

<figure><img src="https://1320984984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZa8qg7GyuZPlsNnz1EO%2Fuploads%2Fgit-blob-e3b4edda6afbf81f23d1ae6ebd078b8e73b08e55%2Fimage.png?alt=media" alt="本地化物品名称示例"><figcaption></figcaption></figure>

## 问题排查

* 删除 `plugins/SpinToWin/` 中对应的已生成 JSON 文件，再重新生成。
* 检查下载或生成过程中是否有错误，必要时重启服务器重试。

## 注意事项

* **生成成功后，将 `generate-new-one` 改回 `false`。**
* **升级或更换游戏版本后，删除旧语言文件并重新生成。**
* 重启后首次需要解析大量物品名称时，可能因构建缓存而出现短暂延迟；之后会使用缓存。
