YYKA-FloatText —— Cocos Creator 高性能飘字插件
一款开箱即用的伤害数字 / 飘字 / 弹幕组件，主打低开销、易用、稳定。既能一条 DrawCall 跑大量飘字，又能自动兜底保证任何设备都有字可出；面板可视化一键生成位图字体，内置多种预设动画，支持 2D / 3D / UI 三种坐标来源，一套代码通吃。

◆ 功能亮点
一、极低 DrawCall

默认使用位图字体合批渲染，几十上百个飘字合并为 1 个 DrawCall，性能抗打。
内置渲染降级链：有位图字体走合批（D 级，性能最佳）；没有则自动降级为系统字体 Label 池（B 级）兜底，任何设备都能出字，不给空窗。
二、零 GC 对象池

飘字实例全部复用对象池，避免每帧 new 对象，显著降低垃圾回收带来的卡顿，适合弹幕、范围 AOE、连续命中等高频场景。
三、2D / 3D / UI 全覆盖

支持 3D 世界坐标、2D 世界坐标、UI 空间坐标三种来源，统一投影到 UI 层渲染，坐标换算内置完成。
默认取场景主相机，也支持 setCamera() 显式指定投影相机。
四、多种预设动画（面板下拉即选）

上浮淡出：经典伤害数字。
原地淡出：低调状态提示。
原地弹入：过冲回落，有弹性手感。
上浮回弹：放大回弹，适合暴击。
上弹回落：先弹起放大、再小幅回落并缓缓滑落，爽感拉满。
动画曲线集中在单独文件，方便自行扩展定制。
五、内置位图字体一键生成（fnt）

无需 Python / 第三方工具，面板直接基于 Canvas 栅格化 TTF/OTF 字体。
可选择字体、字号、图集上限（256/512/1024/2048），自定义字符集。
实时预览最终图集：真实尺寸、占用率、空闲容量一目了然，缺字/超容量当场提示。
自动补齐 0-9 与常见符号，一键生成并写入项目。
六、默认配色 + 可整体换肤

未指定颜色时按飘字类型自动取值（普通 / 伤害 / 暴击 / 治疗 / 状态）。
位图字体为白色纹理、颜色全部运行时染色，任意颜色安全生效，支持整体换肤。
七、内置限流保护

支持设置同时活跃上限与单帧生成上限，超限自动丢弃（不报错、不崩），防止瞬时海量飘字拖垮性能。
◆ 简单使用方法
安装——打开插件面板，点「全部安装」，自动把运行时、示例和默认位图字体写入项目。
跑通——场景里新建节点，挂载内置 Demo 组件（2D/3D 皆可），运行即可看到飘字。
接入代码——创建 FloatTextMgr 并挂到 UI 承载节点，在 update 中驱动：
import { FloatTextMgr } from './YYKAFloatText/FloatTextMgr';

// onLoad：建 UI 根节点并挂载管理器
this.mgr = new FloatTextMgr();
this.mgr.attach(uiRoot); // 未传字体 → 自动加载默认位图字体

// update：每帧推进
update(dt: number) { this.mgr.update(dt); }

// 需要飘字时
this.mgr.showDamage(enemyPos3D, 453, false); // 普通伤害
this.mgr.showDamage(enemyPos3D, 999, true); // 暴击
this.mgr.showHeal(playerPos3D, 120); // 治疗
this.mgr.showTip(playerPos3D, '眩晕'); // 状态提示
this.mgr.showUI(uiLocalPos, '金币+100'); // UI 空间
自定义——在面板里选字体 / 调字号 / 编辑字符集并实时预览，点「生成并安装 BitmapFont」生成自己的图集。
◆ 环境与兼容
引擎版本：Cocos Creator 3.8+
适用项目：2D / 3D / UI，单机与网络游戏均可
目录结构清晰：运行时（coord/data/anim/render）与插件面板分离，方便查看与扩展
◆ 联系我们
如遇问题、有定制需求或希望增加动画 / 功能，欢迎联系作者：

官网：https://www.yyka.cn
邮箱：yykacn@qq.com
公众号：智能运营咖
购买须知
本产品为付费虚拟插件商品，一经购买成功概不退款，请支付前谨慎确认购买内容。

购买后获得对应版本授权，仅限授权范围内使用； 插件仅支持标注的 Cocos Creator 版本，请确认引擎版本符合要求再下单； 不包含定制开发服务，如有定制需求可单独咨询； 严禁二次分发、转售、反编译本插件。

给好评、给建议，就是对我们最大的支持，感谢使用 YYKA-FloatText！*
YYKA-FloatText 使用文档
适用于 Cocos Creator 3.8+。高性能飘字 / 伤害数字 / 弹幕组件，支持 2D / 3D / UI 三种坐标来源，位图字体合批渲染（DrawCall≈1），内置零 GC 对象池与多种预设动画，并自带 fnt 位图字体一键生成能力。