Godot 富文本与 BBCode
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-ui-rich-text。
技能介绍
问题从哪来
Godot 里大量文案落在 RichTextLabel 上:任务说明、日志、可点击的 [url]、玩家聊天。难点往往在解析与性能(每帧重拼 BBCode)、逐字演出(暂停、变速标签)、以及不可信输入把 [img]、[color=transparent] 打进界面。官方文档能查 API,但很少把「该用 visible_ratio 还是 visible_characters」「meta_clicked 里能做什么」收成可执行的约束。
技能在帮你做什么
本技能把 BBCode、meta_clicked 前缀分发和 RichTextEffect 绑成一套格式化文本系统,并附带一组可直接对照的 GDScript 参考实现:
- 演出与控制:
rich_text_typewriter_controller.gd用visible_characters解析[pause]、[speed]等事件标签,避免用visible_ratio做逐字逻辑。 - 交互与反馈:
rich_text_meta_dispatch.gd处理多前缀 URL;rich_text_hover_reactive.gd让可点击片段有悬停与光标反馈。 - 视觉扩展:彩虹/故障等自定义
RichTextEffect(需注册到custom_effects/install_effect());rich_text_image_scaler.gd让[img]跟行高对齐,而不是写死像素宽。 - 安全与展示:
rich_text_bbcode_sanitizer.gd在用户生成字符串进 Label 前必须过一遍;另有自动滚动、语法高亮、渐变生成等辅助脚本。
文档里的 NEVER Do 相当于审稿清单:大循环里别反复解析超长 BBCode;打字机动画别逐帧改字符串;meta_clicked 里别塞重逻辑。
边界与习惯
内置标签如 [b]、[color] 以官方文档为准,技能侧重非显而易见的用法与决策表(例如简单整行淡入用 visible_ratio,带标签的打字机强制走 typewriter controller)。布局和表格应靠 BBCode 对齐/表格标签,不要把布局硬编码进字符串。标题级大字优先考虑 MSDF 字体,避免位图字体放大发糊。
使用场景
- 视觉小说台词框要做逐字显示,并在句中插入 `[pause]`、`[speed]` 控制节奏
- 大厅聊天把玩家输入显示在 `RichTextLabel` 前,需要拦截恶意 BBCode 破坏布局
- 任务日志里物品、NPC 链接共用 `[url=payload]`,点击时要按前缀分发到不同系统
- 成就界面或新闻条需要长文平滑纵向自动滚动,且内嵌自定义彩虹/故障文字效果
适合人员
- 独立开发者正在用 Godot 4 做带可点击选项的对话 UI,需要分清 meta 与打字机 API
- 负责 Godot 网游或联机大厅 UI 的程序员,要为用户输入加 BBCode 白名单净化
- 做教育/工具类 Godot 应用的前端向 GDScript 作者,要在说明面板里嵌代码高亮与渐变标题
- 从位图字体迁到高分辨率 UI 的技术美术,想按技能规则启用 MSDF 并统一 `[img]` 缩放