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):

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

1. The search text is split on whitespace; every part must match (same as vanilla).
2. A part matches if it is a substring of the item name (case-insensitive, vanilla behaviour), or
3. 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/.

更新日志

0.1.1

• 修复 Blueprint 搜索 hook 的回调契约，避免 UE4SS 因空回调移除共享脚本 hook。
• 优化目标函数解析：成功注册后不再保留用于解析的 EngineTick 回调。
• 增加中文使用说明，保留原生文字搜索并支持拼音、首字母和多音字。
• 正式构建关闭开发诊断输出。

0.1.0

• 首次发布。
• 为游戏共享的 filterWidget 搜索入口增加拼音匹配，支持笔记本商店、玩家库存和容器配方搜索。
• 支持全拼、首字母、部分音节和混合输入；支持声调折叠、ü 折叠及多音字。
• 匹配结果是原生搜索的严格超集，不改变原有文字片段搜索行为。
• 拼音表来自 mozillazg/pinyin-data v0.15.0（MIT），编译进 DLL，运行时无需下载数据。