Chinese with Pinyin
- By
A Minecraft: Java Edition resource pack that displays Chinese characters (Hanzi) alongside tone-marked Pinyin for items, blocks, mobs, and UI elements, while keeping all in-game slash commands in standard English.
Minecraft Chinese with Pinyin (拼音) Resource Pack
A Minecraft: Java Edition resource pack that displays Chinese characters (Hanzi) alongside tone-marked Pinyin for items, blocks, mobs, and UI elements, while keeping all in-game slash commands and parser feedback in standard English. Features
Dual Hanzi and Tone-Marked Pinyin: Every in-game item, block, mob, and menu string is annotated with pronunciation and tone marks using Chinese NLP tokenization (jieba + pypinyin). Broad CJK Unicode Coverage: Supports standard BMP Hanzi as well as CJK Extension A, compatibility, and supplementary plane characters (e.g. 䃮 cobblestone, 㭜 acacia, 䦪 creaking, 𥹉). Domain Polyphone Overrides (data/pinyin_overrides.json): Fine-tuned pronunciation for Minecraft-specific terminology (e.g. 重锤 -> Zhòngchuí, 藏宝图 -> Cángbǎotú, 附魔 -> Fùmó, 潜影贝 -> Qiányǐngbèi). 100% English Commands Preserved: All command syntax, arguments, error parsing strings, and command feedback (/give, /teleport, /locate, /gamerule, argument helpers, SNBT parsing) remain in standard English to maintain muscle memory and autocomplete functionality. Broad Dialect & Custom Language Support: Dedicated Language (zh_py): Registered directly in pack.mcmeta as 中文 (拼音) / Chinese with Pinyin, selectable from the Language menu without changing system English. Simplified Chinese (zh_cn) Traditional Chinese - Hong Kong (zh_hk) Traditional Chinese - Taiwan (zh_tw) Classical Chinese (lzh): Uses clean monosyllabic tokenization for classical grammar morphemes. English Client Fallback (en_us): Allows players using English language settings to view Chinese with Pinyin immediately upon activating the pack. Multi-Version Compatibility: Includes supported_formats (min_inclusive: 32, max_inclusive: 97+) to eliminate red "Incompatible pack" warnings across 1.20.5 through 1.21.4+ and newer releases. Fast Automated Asset Generation: Includes a cached Python generator that queries Mojang's official piston-meta API with local caching and CLI flags.
In-Game Examples
| Item / Concept | Standard English | Vanilla Chinese | Pinyin Resource Pack |
|---|---|---|---|
| Diamond Sword | Diamond Sword | 钻石剑 | 钻石剑 (Zuànshí Jiàn) |
| Creeper | Creeper | 苦力怕 | 苦力怕 (Kǔlì Pà) |
| Crafting Table | Crafting Table | 工作台 | 工作台 (Gōngzuòtái) |
| Golden Apple | Golden Apple | 金苹果 | 金苹果 (Jīn Píngguǒ) |
| Ender Dragon | Ender Dragon | 末影龙 | 末影龙 (Mòyǐnglóng) |
| Potion of Swiftness | Potion of Swiftness | 迅捷药水 | 迅捷药水 (Xùnjié Yàoshuǐ) |
| Commands | /teleport @p ~ ~10 ~ |
/teleport @p ~ ~10 ~ |
/teleport @p ~ ~10 ~ (English) |
Contributing
Feedback, bug reports, and pull requests are welcome:
- Polyphonic character pronunciation corrections (多音字).
- Support for additional game versions or Bedrock Edition.
- Submit issues and pull requests via the GitHub Issues page.
License
Distributed under the MIT License.
Chinese with Pinyin Team
