gameworld-tools

GameWorld 项目专用的 VS Code 辅助工具插件。

道具字典悬停提示

插件会读取道具字典文件：

Assets/MainGame/DevTool/PropEditor/dict.txt

在任意文件中，把鼠标悬停到道具 id 或预置体名字上，就能看到对应信息：

3341008 -> ID3341BoothChair1
ID3341BoothChair1 -> 3341008

例如 dict.txt 中有这一行：

3341008	ID3341BoothChair1	雅座餐椅1	0

悬停到 3341008 时会显示 ID3341BoothChair1；悬停到 ID3341BoothChair1 时会显示 3341008。

性能说明

• 字典文件会懒加载，首次需要查询时才读取。
• 读取后会缓存在内存中，悬停查询时不会反复扫描 dict.txt。
• 当 dict.txt 被修改、创建或删除时，插件会自动清理缓存，下次查询重新加载。
• 如果同一个 id 或预置体名匹配到多条记录，悬停窗口默认最多显示 20 条。

插件设置

• gameworldTools.propDictionaryPath：道具字典路径，默认是相对工作区的 Assets/MainGame/DevTool/PropEditor/dict.txt。
• gameworldTools.maxHoverMatches：一次悬停最多显示多少条匹配结果，默认 20。

排查方法

如果悬停没有显示：

1. 打开扩展页，确认 gameworld-tools 是启用状态。如果按钮显示“启用”，说明插件当前没有运行，需要先点“启用”。
2. 在命令面板执行 GameWorld Tools: 查看道具字典状态，确认插件找到了 dict.txt，并且记录数量不是 0。
3. 如果项目不是从 Unity 工程根目录打开的，可以在设置里把 gameworldTools.propDictionaryPath 改成绝对路径。
4. 修改 dict.txt 后，可以执行 GameWorld Tools: 重新加载道具字典 立即刷新缓存。

安装方式

使用 VS Code 的 “Install from VSIX...” 功能，选择生成好的安装包：

gameworld-tools-0.0.2.vsix

开发调试

用 VS Code 打开 Tools/vscode/gameworld-tools，按 F5 启动 Extension Development Host。

重新打包本地 .vsix：

npx --yes @vscode/vsce package