PinyinSearch

PinyinSearch

在《Voices of the Void》的搜索框中輸入拼音或首字母，即可搜索中文物品名稱，無需中文輸入法。

中文補丁（如 Votv-PatchChinese）會將物品名稱顯示爲中文，而遊戲原生搜索只能進行文字片段匹配。PinyinSearch 在不改變原生搜索結果的基礎上，增加拼音搜索支持，普通英文鍵盤也可以使用。

功能簡介

• 支持筆記本商店搜索。
• 支持玩家庫存和容器中的配方搜索。
• 支持全拼、首字母、全拼與首字母混合輸入。
• 支持多音字；聲調會被忽略，ü 會按 v 處理。
• 不需要額外配置文件，不聯網，也不會下載數據。

Where it works

Any search box that goes through the game's shared filterWidget filter:

• Laptop store search box (the shop)
• Player inventory / container search box (recipe search)

Matching is a strict superset of vanilla: everything that worked before still works.

What you can type

For an item named 手錶 (shǒu biǎo):

| You type | Result | Why |

|---|---|---|

| shoubiao | ✅ | full Pinyin |

| sb | ✅ | initials |

| shoub | ✅ | partial syllables |

| biao | ✅ | starting from the second syllable |

| shb | ✅ | mixed full + initial |

| shǒu | ✅ | tones are ignored |

| 手錶 | ✅ | literal Chinese, unchanged |

| hou | ❌ | matching starts at syllable boundaries |

Multi-reading characters are supported: 銀行 matches both yinhang and yinxing.

Multiple words work like vanilla — they are ANDed: metal scrap finds Metal Scrap, and each word is matched independently.

Matching rules

• The search text is split on whitespace; every part must match (same as vanilla).
• A part matches if it is a substring of the item name (case-insensitive, vanilla behaviour), or
• it matches the item's Pinyin syllables, where each syllable may contribute its full reading or just its first letter.

ü is folded to v, tones are ignored, so nv finds 女.

Data & credits

• Pinyin table generated from mozillazg/pinyin-data v0.15.0 — MIT.
• Matching approach inspired by JustEnoughCharacters and its PinIn library — both MIT.

The Pinyin table is compiled into main.dll; nothing is downloaded at runtime and no extra files are needed.

Limitations

• No fuzzy-Pinyin matching yet (e.g. zh/z, ang/an are treated as distinct). Planned for a later version.
• Matching starts at syllable boundaries, so a mid-syllable fragment like hou will not match shou.
• Items whose names are still English keep working exactly as before.

Requirements

• Voices of the Void (a09n or later)
• Unreal Shimloader (installed automatically by mod managers)

Source

Part of a multi-mod workspace; source and build scripts ship with the ContainerCrafting repository layout under mods/PinyinSearch.