Description

Changelog

Reviews (0)

[中文描述在英文描述末尾]

English Description

Chinese Node Selector (Godot 4.7)

An editor plugin that fully localizes Godot's "Add Node" dialog into Chinese.

Press Ctrl+A (or click the + button, or right‑click and select "Add Child Node") to open a dialog that replicates the original but is fully in Chinese—node names, categories, and descriptions are all in Chinese, with bilingual search support (Chinese and English).

Compatibility: Godot 4.7+ ｜ Type: Editor Plugin ｜ Version: 1.0.1 ｜ Author: Zzzl_io ｜ License: MIT

Works on Windows / macOS / Linux with Godot 4.7 editor. Pure GDScript, no compilation needed.

✨ Features

Feature	Description
Fully Chinese Dialog	A complete replica of the original "Add Node" dialog, with all node names, categories, and descriptions translated into Chinese.
Bilingual Search	Search for "精灵" (sprite) or "Sprite" – both work.
Favorites & Recent	Star frequently used nodes, and recently used nodes are automatically recorded.
Official Chinese Descriptions	Each node displays its Chinese summary and full description from the official documentation. Node references inside descriptions are also translated and highlighted.
Custom Translation Mapping	Built‑in translations for 250+ nodes; you can add your own mappings. Untranslated nodes are pinned to the top for easy completion.
Entry Point Toggles	Independently enable/disable the `+` button, `Ctrl+A` shortcut, and right‑click "Add Child Node". At least one entry must remain active.
Markers	Experimental and deprecated nodes are automatically marked with ⚠️.

Detailed Introduction

Fully Chinese Interface: When opened, all node names (e.g., CharacterBody2D → 角色体2D), categories, and descriptions are in Chinese. The look and feel are identical to the original, with zero learning curve.

Bilingual Search: Both Chinese and English names are matched, so both Chinese‑speaking and English‑speaking users can use it smoothly.

Official Descriptions: Each node’s description is taken directly from the official Godot documentation, showing the Chinese summary and full description. Node references inside the description are translated and underlined in a highlighted color.

Custom Mappings: If you are not satisfied with a built‑in translation, you can add your own Chinese name for any node in the settings – the custom mapping overrides the built‑in one. Mappings can be saved globally (all projects) or per project.

Entry Point Toggles: The three open methods (+ button, Ctrl+A shortcut, right‑click "Add Child Node") can be toggled individually. If all are turned off, they will automatically re‑enable to ensure at least one entry point is always available.

📦 Installation

Copy the addons/ChineseNodeSelector/ folder into your Godot project's addons/ directory.
Open Project → Project Settings → Plugins and enable "Chinese Node Selector".
Restart the editor (or start using it immediately).

If you downloaded from GitHub, extract the archive and use the addons/中文节点选择器/ directory inside.

🚀 Usage

Press Ctrl+A, click the + button at the top of the Scene tree, or right‑click on an empty area in the Scene tree and select "Add Child Node".
Type a Chinese or English keyword in the search box.
Select a node to view its Chinese description; double‑click or press Enter to add it.
Click the ⚙️ in the top‑right corner of the dialog to open settings: Favorites, Recent, Custom Translations, Entry Toggles, and Save Scope.

🧩 Custom Translations & Data

Favorites / Recent / Custom Mappings can be saved either globally (across all projects) or per project.
Untranslated nodes are shown in red at the top of the settings list for easy completion.

⚠️ Known Limitations

Node references in descriptions are not clickable: References to other nodes are underlined and highlighted, but due to Godot engine API limitations (the editor's documentation control is not bound to GDScript), they cannot be clicked to jump to the corresponding class documentation.
Only "Add Child Node" is replaced in the right‑click menu: Other right‑click menu items such as "Change Type" and "Instantiate Child Scene" remain in the original English.
Experimental / Deprecated markers are based on Godot 4.7 documentation: These are static internal lists; if the engine is upgraded across major versions, the markers may not be fully accurate.
Creating the root node in an empty scene does not support Undo: When you create the first root node in an empty scene using this dialog, it cannot be undone with Ctrl+Z (due to an editor API limitation).

📄 QR Code Generation Credits

The QR code in the "About Author" window is generated by godot-qrcode-generator, under the MIT License. The QR code is generated entirely locally and does not access any network.

⚖️ License

This plugin is licensed under the MIT License – completely free, open‑source, with no functional restrictions.

The Godot official documentation translations embedded in this plugin are copyrighted by the Godot Engine contributors and are used solely for local display.

"Chinese Node Selector" is an independently developed third‑party plugin and is not affiliated with the official Godot project. Godot is a registered trademark of the Godot Foundation.

中文描述

中文节点选择器 (Godot 4.7)

一个将 Godot 编辑器「添加节点」对话框完全中文化的编辑器插件。

按下 Ctrl+A（或点击「+」按钮、右键「添加子节点」），会打开一个复刻自原版但全中文的节点选择对话框——节点名称、分类、描述全部中文，支持中英文双语搜索。

兼容性： Godot 4.7+ ｜类型：编辑器插件｜版本：1.0.1 ｜作者：Zzzl_io ｜许可：MIT

适用于 Windows / macOS / Linux 上的 Godot 4.7 编辑器，纯 GDScript 实现，无需编译。

✨ 功能

功能	说明
全中文对话框	完全复刻原版「添加节点」对话框，节点名称、分类、描述全部中文化
中英文双语搜索	搜「精灵」或「Sprite」都能找到对应节点
收藏与最近使用	常用节点一键收藏，最近使用自动记录
官方中文描述	每个节点展示官方文档的中文简介与完整说明，描述中引用的节点名自动翻译并高亮
自定义翻译映射	内置 250+ 节点翻译，可自行添加映射；未翻译节点自动置顶待补
入口劫持开关	可独立开关：`+` 按钮 / `Ctrl+A` 快捷键 / 右键「添加子节点」，至少保留一个入口
标记显示	实验性节点与弃用节点自动打上 ⚠️ 标记

详细介绍

全中文界面： 打开后所有节点名（如 CharacterBody2D → 角色体2D）、分类、描述均为中文，界面观感与操作方式和原版完全一致，没有学习成本。

双语搜索： 中文名与英文原名都能匹配搜索，英文用户或中文用户均可顺畅使用。

官方描述： 每个节点的说明文字直接取自 Godot 官方文档，展示中文简介与完整说明；描述里引用的其他节点名会翻译成中文并以高亮下划线标出。

自定义映射： 若内置翻译不满意，可在设置中为任意节点添加自己的中文名映射，覆盖内置翻译，映射支持按全局或仅当前项目保存。

入口劫持： 三种打开方式（+ 按钮、Ctrl+A 快捷键、右键「添加子节点」）可分别开关，全部关闭时会自动全部重新点亮，保证总能找到入口。

📦 安装

将 addons/ChineseNodeSelector/ 文件夹复制到你的 Godot 项目 addons/ 目录
打开项目 → 项目设置 → 插件 → 启用「ChineseNodeSelector」
重启编辑器（或直接使用）

说明：若你从 GitHub 下载，请解压后取其中的 addons/中文节点选择器/ 目录使用。

🚀 使用

按 Ctrl+A，或点击场景树顶部的「+」按钮，或右键场景树空白处选择「添加子节点」
在对话框搜索框输入中文或英文关键词
选中节点即可查看中文描述，双击或回车添加
对话框右上角「⚙」打开设置：收藏、最近使用、自定义翻译、入口开关、保存范围

🧩 自定义翻译与数据

收藏 / 最近使用 / 自定义映射：可选择保存在 编辑器全局（所有项目生效）或 当前项目
未翻译节点会在设置中红色置顶，方便逐个补全

⚠️ 已知限制

描述中的节点引用不可点击跳转文档：描述里引用的其他节点名会以高亮下划线标出，但受 Godot 引擎 API 限制（编辑器文档控件未绑定 GDScript），无法像原版那样点击跳转到对应类文档。
右键菜单仅替换「添加子节点」一项：场景树右键菜单中的「更换类型」「实例化子场景」等其他菜单项未做中文化处理，仍为编辑器原版显示。
实验性 / 弃用标记基于 Godot 4.7 文档：为内置静态列表，若引擎跨版本升级，标记可能不完全准确。
空场景创建根节点不支持撤销：在空场景中通过本对话框创建首个根节点时，无法用 Ctrl+Z 撤销（编辑器 API 限制）。