FCC 脚本语言
支持类、继承、函数、宏、条件和循环,让游戏逻辑以熟悉的类 C 语法表达。
2D GAME ENGINE & RUNTIME
FancyBox2D 是面向 2D 游戏与交互式应用的运行时框架:以 Go 实现核心,以 Ebiten 负责图形呈现,并提供类 C 语法的 FCC 脚本开发体验。
DEVELOPER TOOL
面向开发者的本地图形工作台:脚本编辑与诊断、构建打包、场景预览,安装后以独立窗口启动;内置客户端与服务端运行时,打开任意脚本目录即可预览,新建项目即可构建并运行服务端程序。
CAPABILITIES
从对象、脚本到绘制命令,FancyBox2D 将运行时的核心环节组合在一起。
支持类、继承、函数、宏、条件和循环,让游戏逻辑以熟悉的类 C 语法表达。
以 Root 对象树组织窗口、文本、图像、地图与人物,并通过参数和方法组合交互行为。
对象系统生成设备无关的 DrawCmd 绘制命令,由 Ebiten 后端执行 GPU 呈现。
使用 launcher.exe 直接运行 FCC 脚本,适合快速预览、演示与 Windows 开发流程。
objsys.dll 以 c-shared 产物提供宿主集成入口,与独立启动器共享同一引擎核心。
VS Code / Qoder 插件提供 FCC 语法高亮与补全、F5 一键运行、运行时追踪面板,以及 ALE 动画资源预览与编辑(偏移十字线、播放速度、帧内脚本、帧序调整)。
浏览 FCC 语法、内置函数、对象属性、系统方法与事件参考。
进入手册WORKFLOW
FCC 源文件经过扫描、宏处理和语法解析后由解释器执行;对象树生成绘制命令,Ebiten 在屏幕上完成渲染。
DOCUMENTATION
现有手册收录 900 余条语法、对象、方法、函数与事件参考,覆盖脚本开发的常用入口。
RELEASE NOTES
按日期罗列各次更新的内容,新的在上、历史的在下。
class MyTable:台球桌),不需要写任何导入语句;沿用旧导入写法的脚本也照常可用。palette / linkpalette 与素材源一起拦截,颜色设置永远失败。现在只拦素材源,调色板交回基类对象处理,与参考实现相同。CallSubAll 此前只转发事件名、丢掉后面的实参,接收方拿不到对象,于是又出现「'.'前不是对象」。现在事件名之后的实参按个数打包成单值或数组随事件一起送出。ViewX − 地图自身 Xpos)减掉,再换算成屏幕坐标;主视、小地图等多张被观察地图各自按自己的相机计算,两边回到同一个屏幕坐标系。局部上传的收益保留,重影消失。512 ÷ 帧率 推导(18fps 动画约 28 毫秒,上限 50 毫秒)。在 50fps 的渲染节奏下这个门限每两帧才开一次,角色一次跳约 6 像素,再被镜头跟随的整数追赶放大成左右 5–7 像素的摆动。SplitAsInt64 / UniteAsInt64 把一串紧凑字符拆成整数数组、再拼回去:物品串、领奖证书、队伍战场的坐标串都走这条路。函数名里的「Int64」指的是64 进制定长编码,不是十进制整数串,引擎此前按十进制实现,还把「拆几个元素」的参数错当成「每块几个字符」,于是物品栏、证书、坐标一读出来就是错的数值。0-9 表示 0..9、A-Z 表示 10..35、_ 36、重音符 37、a-z 表示 38..63;不足位数用字符 0 左补齐(不是空格)。两个字符就能表示 0..4095,五个字符能装下一对地图坐标。SplitAsInt64(串, 元素数, 缺省值, 每块字符数) 按每块字符数切分(末块不足按实际长度),块数不够用缺省值补齐,元素数给小了就按「总长 ÷ 每块字符数」;UniteAsInt64(数组, 每块字符数) 把每个元素钳到该位宽的上限再逐块拼接;GetFromInt64 / FormatInt64 走同一套 64 进制编解码。"3zzzzz" 解出 −1)。每块字符数只接受 1..6,越界现在是明确的报错,而不再静默按默认值处理。"ZZ"→2275、"gh"→2861、5 位随机坐标往返 2008 组、6 位回绕为负、越界报错,以及真引擎跑脚本的端到端断言(证书串拆开再拼回原样、物品串 "0102zZ" 解出 1 / 2 / 4067,零报错);反证在旧实现下这些断言全红。语料里 1260 处调用点逐类核对过,没有出现 1..6 之外的位宽。wnd_bk 在客户端上百处、t_btn 有 6 处。此前引擎全进程只维护一张类表,后写的定义覆盖先写的;更麻烦的是,类体里嵌着定义的类(class A { class B { … } })对兄弟对象、对文件级代码同样可见,别处可以 new B 出来,拿到的却是另一份定义。运行期因此一直刷「类被新的同名类替换」,偶发拿错实现。class 语句执行时才把定义注册进当前执行的那个实例,new 时从该实例开始沿父对象链逐级查找,走到根还没有就失败。也就是说,类定义只对「声明它的实例 + 它的子孙对象」可见。index.fcc/login2.fcc 这类文件级脚本)上的类仍然对所有对象可见,所以文件级公共类不需要改写。<A>{ class B { … } } 这种块体写法把 B 注册进新建的那个实例,可以覆盖 A 类体里的同名 B;同一实例里重复定义同名类仍是后写覆盖,与以前一致。new 某个嵌套类的写法,现在会失败并报 new语句错误:无法创建对象类X——这与旧版的表现一致。语料静态排查出的 96 处跨作用域引用逐条核对过,绝大多数属于「样式体在声明它的实例上执行」「父链解析」「Run() 共享调用者作用域」的正常用法,只剩 3 处是复制粘贴导致的真错(原版同样失败)。<X>{…} 的正常行为);只有根级替换系统类时仍会提示。同一段客户端流程的诊断日志从 287 行降到 61 行。#RE 各 14 行且内容完全相同、新增的类未找到 0 条;ECS 上六服实跑两侧同为 7 条既有报错。round4_3 的半透明底色换成了一条 3 像素边框,背后的画面直接透上来;移开鼠标也不再恢复。misc.fcc 里 wnd_dlg 内嵌的 class wnd_bk(底板,画 round4_3)与 login2.fcc 顶层的同名 wnd_bk(两条提示条,悬停时把 bk:= 改成 rect)共用一个域,后定义的那份把前一份顶掉:底板悬停时跑的是提示条的 OnMouseIn。FObj::CallUserFun 一致。显式的 Class::Method() 调用与 obj.Method() 的解析链不受影响。bk)改颜色、改图案时补上变更标记,bk:= 的改动能真正进入脏矩形——此前这类改动要等别的事件碰巧刷新才显示。OnMouseIn/OnMouseOut 不串用」用例,并把登录对话框用例扩展成逐帧脏矩形统计;实机悬停提示条:绿框 0→1136 像素、底板 #0066AA 前后都是 845 像素且包围盒一致,移开不再透底。obj.Method() 这类显式调用仍可能解析到另一份定义。事件处理器现在不会再串用了。表达式运行错误:'.'前不是对象:src(login2.fcc:65);界面没崩,但提示框里的文字再也不更新。对象.方法() 在对象自己的方法表和类域链都没找到时,还会落到一份「所有文件共享的全局函数槽」。类域编号由类名派生,misc.fcc 里 wnd_dlg 内嵌的 class wnd_bk 与 login2.fcc 顶层的同名类共用一个类域,于是对话框里 new wnd_bk 的实例解析到了另一份定义里的 OnMouseIn/Out;它对 pid 调 OnTip(0),这个调用又被全局槽里 login2.fcc 的文件级 OnTip 接走,在错误的接收者上解引用 m_pTip。FObj::OnCallFun 只走 CallFun 与「对象自己的函数表」两条路,找不到即 FUN_NOTFIND)。OnTip,也就是这个缺陷)原本靠全局槽兜住,其余都是内建派发,行为不变。裸函数调用(foo())完全不受影响。OnMouseOut 派发到已销毁对象上、在已释放的脚本状态里执行。p.OnTip()、本文件级 OnTip 解引用 m_pTip」并断言零报错(去掉修复即复现同一句报错),一组覆盖对话框销毁后悬停槽归零。实机点「登录」:login2.fcc:65 的报错消失,流程走到 index.fcc:584-587(m_sName = scale、m_nID = 12)并进入广场。obj.方法() 可能解析到另一份定义里的实现。edit 写 bkcolor=0(regman.fcc 等处十余例)本该不画底色,实际是一块不透明黑矩形把父面板遮住;插入符默认也是黑色,落在黑底上完全看不见。bkcolor=0 的打包值就是 0,绘制时直接跳过底色矩形;Go 侧把 0 当成「不透明黑」画了出来。光标默认值参考实现是白色,Go 侧写成了黑。RGB565(25,85,150)、文字近白、光标白。文字色与选中文字色不做这项判定(参考实现对这两项本来就不打包)。corpus/fc102 从「脚本跑不起来」推进到「中心/登录/主服/广场/账号服加库服同时在线,客户端登录后可进入广场移动、聊天、右键转镜头」。以下按主题列出这一段的主要改动。v[i]=rec 不再让各槽共享同一块数组);0.5.81 Split 默认逗号、OnRestart 只查对象自有方法表、_MAIN 跟随调用深度;0.5.82 数组的 .str 成员与实参求值失败如实报错;0.5.83 Class::Method() 作用域限定调用(139 个服务端入口体检,70 个零报错,其余全部归因到语料缺分号/缺库表/部署宏/32 位 DLL);0.5.86–0.5.87 CallSubAll 派发与逗号启动串修复;0.5.92 宏别名链递归展开(此前只展开一层,connect 恒 0 卡在「连接中...」)。text 支持内联颜色转义 \#RRGGBB(此前把标记画成方框、再把色号当正文);0.5.97 IsPress 接上真实按键状态(广场 Shift+右键奔跑);0.5.99 ==/!= 按参考实现逐类型比较(此前任意两个对象都相等,双客户端聊天与头顶名字全变成「我」);0.5.100 GetStrWord 剥掉两侧引号(昵称显示成 'scale')。TimerCall 可变参、网络对象引用编码、DB 回包函数 id 换算——登录服连不上世界、注册事件配不上的问题一并解决,客户端首次渲染出「奇域(绿色世界)→波赛敦→波赛敦广场」。hitid 取参与帧命令管线,广场 NPC 的累积泄漏收敛(ECS 上 12 分钟内存净降 6.4 MB);0.5.96 delthis 补发 OnDestroy,广场右键不再被残留全屏遮罩吞掉;0.5.98 核实并补测鼠标单击/双击的合成与悬停刷新。fbserver 宿主(心跳、优雅停机),fwdemon 负责把它当守护进程管起来;0.5.89 守护加令牌鉴权与 HTTPS,引擎补「大小写不敏感 + 反斜杠分隔符」的只读路径垫层(ECS 上 130 条语料路径全部命中,语料零改动);0.5.90 移植 DBM2 库服 fwdb,10012 端口闭环;0.5.93 账号服查库取真实 uid、库错误帧带回请求事件 id。ext/particle 顶替 showdown.dll(雪花/花瓣四路特效),老脚本里的 #import userdll "bin/showdown.dll" 不再飘红,类已编进引擎、导入直接短路成功;语料中 12 处导入随之下线。play/ 体验页仍为 0.5.79;上述改动目前只在桌面版 launcher.exe / objsys.dll 与 Linux 服务端二进制中生效。ISDEVMODE 才为真,数据库连接套接字(dbsocket / dbsocket2)与服务器套接字在非授权环境下会被直接拒绝——设置连接参数返回失败、发起连接直接报错。一批旧版服务端脚本在开头给数据库套接字赋 gamename / login / connect 时因此报错。ISDEVMODE 分岔的地方一律走「已授权」那条路:数据库套接字的连接参数随时可设,connect 不再返回失败;服务器套接字的用户上限固定为 2048(原版非授权环境只给 8),同时取消了非授权环境下的流量看门狗(原版累计写入超 8KB/s 或第 4 个连接进来就直接销毁对象)。_DEV 现在恒为已定义。老脚本里用 #ifdef _DEV / #ifndef _DEV 二选一的地方(例如只有未授权环境才弹的提示、兜底跳转官网的分支)从此一律走授权版。FANCYBOX_DEV、配置里的调试级别、可执行目录的 dev.txt 标记文件——已整体删除。跑服务端脚本不需要再设置任何环境变量。SELECT TOP、[表名]、GETDATE() 等改成了 MySQL 能认的写法,但还有两类没处理:CONVERT(…,style)(把时间转成指定格式的字符串)与 DATEADD(按小时/天偏移时间)。少数节日、婚礼类活动服务用到它们,连 MySQL 仍然报语法错。CONVERT 转日期类型时变成 CAST;带样式码转字符串时变成 DATE_FORMAT,常见的 101/111/120/126 等样式都按原格式出串。DATEADD 变成 DATE_ADD(…, INTERVAL n 单位),单位支持年/季/月/周/日/时/分/秒及其缩写。'CONVERT(varchar,d,111)' 不动,名字里含这几个字母的标识符(如 CONVERTED)也不动。嵌套写法(DATEADD 里套 DATEADD 再套 CONVERT)由内向外逐层改写。del=1 会把这个对象连同它的子对象一起销毁,对象上已注册的接口也随之失效,后续注册同名接口一律查不到。这是旧版引擎就有的行为,移植后保持一致;数据库连不上时的兜底分支容易撞上它。"icon="+icon+";sex="+sex+…,每行末尾或行首放一个 +。此前这种写法在换行处就被判成语法错,整条语句被丢掉——脚本看着没报错,实际那段动作从未执行过。x = 1 + 换行),或下一行以运算符开头(换行 +";city="+…)。括号里的实参、下标、条件本来就可以随便折行。?(调试输出)或 : 开头的下一行不算续行——这类行在语料里大量作为独立语句存在,当成续行会把真正的漏分号错误一起吞掉。SELECT TOP 1 …、GETDATE()、[表名] 方括号标识符、WITH (UPDLOCK) 表提示。这类语句交给 MySQL 会直接语法错,而引擎的数据库层走标准的 MySQL 驱动,没有兼容层。SELECT TOP n / TOP (n) 改成语句尾的 LIMIT n、[标识符] 改成反引号标识符、N'…' 改成 '…'、GETDATE() 改成 NOW()、删掉 WITH (UPDLOCK/ROWLOCK/NOLOCK…) 之类的表提示。'select top 1' 不会被当成语法;TOP 只在 FROM 之前才改成 LIMIT,已经带 LIMIT 的语句、派生表里的 TOP 都原样保留;多条语句按分号逐句处理。void OnRev(var v) 就报「函数没有找到」。现在按参数表达式里有没有顶层逗号判断:单个数组参数原样包成一个数组实参,真正的逗号参数表保持原样。SELECT TOP 1 …(实际下发 … LIMIT 1),客户端收到 8 个字段且逐项与库内数据一致,随后干净退出。CONVERT(…,style) 与 DATEADD 这两类写法尚未改写,命中它们的脚本(少数节日/婚礼活动服务)在 MySQL 上仍会报错。date m_dStartDate=GetLocalTime();),与参考实现一致;紧随其后的发行期限弹窗属于演示版逻辑,仍保持注释。Port:10004 比旁边汉字更宽更粗,与旧版的观感不一致——原版只有一个字体句柄,中英文本就同款。Post、ClockLink、SendHtml、Call、connect、Close 全是死分支,调用静默落到基类,脚本还以为成功了。new 类名(参数) 的构造函数原先直接读全局槽,而全局槽按「最后写入者赢」,同名的构造函数可能跑到别的类的实现。改为先查新对象自己的函数表,再沿类继承链查找。style:)注入的刷新方法里。样式注入本身没问题,错在方法派发:类体执行期间 new 出来的子对象会回调父对象,此刻父对象还没登记自己的类,派发落到全局槽,跑的是最后注册的同名方法——而那份实现来自另一个类,它引用的成员在该对象上是空的。GetLine 之类的函数恒报「未找到」。function "GetLine" not found,同次运行暴露的 5 条样式错误由 0.5.72 修复。new FightFunc / new IPTest。这两个不是外部插件——原版把它们的注册放在主对象系统里,Go 侧缺类,脚本直接停在这两个名字上。FindSubPos / FindSubNear 按接收者类型分流。ip[3]+(ip[2]<<8)+(ip[1]<<16)+(ip[0]<<24) 打包成 32 位整数。Set:只更新已有项、不插入新项,缺项返回失败,与原版一致。new palette(src) 没有构造参数,img.palette / img.linkpalette 也不接收调色板对象。旧实现里「img.palette 接受数组」是移植时臆造的,原版只认对象。0xFF 表示「无索引」——阴影、背景与未赋值像素都属于此类;镜像随帧一起深拷贝,动画复制、灰度帧处理都不会丢。RGB565 真彩帧(kind=3)本来没有索引,保持原样。img.palette= 拷一份整表(256 项)存到对象上——传 nil 表示清空,源调色板还没加载完则拒绝并保持旧表;img.linkpalette= 只记引用,绘制时实时取用,且跟随调色板的修改版本。调色板内容被改(重新加载、改单项、渐变填充、从动画取表)都会让纹理缓存失效并重传,不会画出旧颜色。私有拷贝优先于链接,与原版一致。new palette("res$/def.act")、palette=、Load 落到同一段实现,只要求字符串参数,然后按名字加载。Go 照此实现:文件读不到在两边都算调用成功,只是对象状态标为错误。恢复 768 字节 RGB 块的读写与 565 镜像同步。human 的 src/palette/linkpalette 参数仍归尚未移植的装备逻辑,角色贴图今天只能经内部的图像对象换色。new palette(src) 的构造参数(只加载一次、名字统一小写、缺参或类型不符失败、加载失败仍算成功、非调色板对象不认领)、上传时的换色与缓存失效、链接调色板跟随修改版本与状态、human 走同一条绘制路径。全套 Go 测试通过;启动器冒烟自报 0.5.69,八次 CPU/GPU 位精确校验一致。GetFormImg 生成图像);单元测试只能证明上传的像素字节正确。本轮只动调色板数据链,不涉及其它渲染语义。m_pPal.GetFormImg(pman)、菜单的 AddItem 全都不响应。根因是两套编号——对象类里按原版的函数编号常量分发,而脚本调用传进来的是解释器自己分配的字符串编号,两者永不相交;单元测试也照抄同一批常量,所以测试一直是绿的。Get/Set 与数据库记录集同名,走数据库入口再分派;Load 与用户 DLL 同名,走原入口再分派。同一个名字只能注册一次,后注册会静默覆盖,所以冲突名字必须靠入口分派而不是重复注册。Popup、AddItem、AddLine 三项,旧实现里的 Clear 把一个「左键抬起」的编号误标成了方法名。删掉之后,脚本里的 Clear 回到全局画布的 Clear,与原版行为一致——文档里列过不等于原版实现过,移植以原版源码的调用分支为准。res$名字 与磁盘路径统一走资源加载器,并带加载跟踪;768 字节的格式校验留在对象层。没有装加载钩子(单元测试、浏览器版)时按失败处理,不会静默当成空表。GlintFill 不被调色板版本遮蔽、参数错误如实上报;对象层测试按新接口重写(565 截断、渐变逐字节插值、保存往返、名字小写化)。参数通道另由 0.5.67 的哈希修正打通。全套测试通过。src 记个名字,play/stop 只翻转一个标志位,「播放结束」事件从不派发。原版靠 Windows 的软波表直接喂 MIDI 流,Go 侧要能发声,先得自己把标准 MIDI 文件解析成 PCM。.gsm/.adm 音效完全相同的那条混音输出链——因此与其他音效共用一个出口,也能在无界面环境下推进播放时钟。string ?msg = "x"; 只报「变量声明缺少名字」(variable declaration missing name),作者看不出真正原因是 ? 写错了位置。原版扫描器只在句子开头接受调试前缀,名字这一格读到的是 ?,而旧诊断只会说「期望一个名字」——Hello World 示例一度就是这么写的,靠人工比对才发现。string script,cname;(fw2 的 pubuser_s.fcc:117)把类型关键字 script 当变量名,扫描器返回的是关键字 token,落到同一个名字槽,同样报「缺名字」。作者会以为自己漏写了名字,实际是名字非法。? 提示「调试输出前缀必须位于句子开头,改成 ?<类型> <名字> = ...,或先声明再 ?<名字>;」;关键字提示「"xxx" 是关键字,这里不能当名字」;其余情况保留调用方原来的措辞。变量声明、类名、基类、<> 与 <A:B>、style、方法名、:= 函数名、<< 网络调用名共 10 处全部接上。#RE{文件,行,列} 直接指向 ? 本身或那个关键字,不再笼统落在句子起点。? 照旧合法,关键字照旧不能当名字——只改提示,不改规则;真正漏写名字的写法仍然报原来的「缺少名字」。cmd/fccaudit 扫全部 4056 个 .fcc:variable declaration missing name 由 7 次 / 6 文件变为 6 次 / 6 文件,新增 "script" is a keyword and cannot be used as a name here 1 次 / 1 文件(正是 pubuser_s.fcc:117,10);文件级中断仍为 0,出错文件仍 529 个。报告附录补了这一行的判读。? 不受影响」的回归),go vet 干净、全套 Go 测试通过,launcher 冒烟自报 0.5.65 且 CPU/GPU 位精确校验一致。temple.fcc(GAME100 / fc102 / smallqiyu 同一份老地图,旧版 MapEdit 1.03)在 overdata=$PKH{750:…} 处整文件解析中断,报 bad uncompressed length 1075060480 (payload 750 bytes)。这一项既可能是引擎读错偏移,也可能是语料本身损坏,需要取证分辨。$PKH 载荷的结构是「4 字节小端未压缩长度 + FZip 12 位 LZW 流」,Go 读长度头的位置与字节序和原版一致(LittleEndian.Uint32 等价于原版的 *((int *)ptr)),不存在偏移错。坏块的前 4 字节是 00 1F 14 40 = 1075060480,而语料里另外 25 个 overdata=$PKH 块的长度头都是合理的小数值。把 750 字节从偏移 0 直接解 LZW,得到完整的 825 字节(165 条 5 字节 TileAniNode 记录,首码就是 CLEAR)——正文完好,丢的只是那 4 字节长度头。FCodeNode::SetData 遇到长度头异常只打一行 _TR 跟踪,节点保留原始打包字节后继续扫描,文件照旧载入;Go 却把整文件扫描直接中断。改为「保留打包字节 + 定位告警继续解析」,与 C++ 行为对齐:脚本侧告警进 ParseErrors 并以 #RE{文件,行,列} 打到控制台,地图离线/编辑器侧告警进清单的 warnings。DecodePKHPayload 单一实现,脚本扫描器与地图扫描器共用,避免两条路径的容错策略再次分叉。长度头合理但解压尺寸对不上时同样降级为告警,不再中断。cmd/fccaudit 扫全部 4056 个 .fcc:文件级解析中断由 3 清零,句子级错误由 13 类变为 14 类(新增的正是 $PKH payload unusable,出现在同样的 3 处),出错文件数 526 → 529,正好是三份原先被中断的文件。报告 docs/corpus_audit.md 已重新生成,判读附录补记了这一行。mapdump probe corpus/GAME100/map/temple.fcc 由退出码 1 变为 0,输出完整清单(format 8、usermap/bktile、35×200、1681×2401、indexData 21000 字节、overData 750 字节)并附一条告警;原先断言「探测报错即正确」的测试已按 C++ 语义改写。$PKH 块的错误处理策略与语料体检报告,不动解码算法与地图渲染语义;坏块保留原始字节,与原版一样呈现原样数据。全套 Go 测试通过,launcher 冒烟自报 0.5.64、CPU/GPU 位精确校验一致。GAME100/bout/chess/gobang/ChessClientUser.fcc:160 的 void StepDelaySet(int delay, 换行 overtime) 正是这个形态。另一处盲区是:类体、函数体、switch 子块各自持有一份脚本代码对象,解析错误写进去后没有人读取,因此类里写错一行,运行时完全静默。<< 网络调用实参、:player、if/while/for 三段、switch 头这些括号内的换行一律当空白处理;语句级表达式、变量初始化、表达式语句仍按原版规则把换行视为错误。这对应原版行为——括号内可以折行,语句跨行不行。#RE{文件,行,列}消息 的格式打到控制台,不再静默吞掉。; 或 },与原版 FCodeScaner::SkipSentenceCode 一致;跨行的坏句子整句丢弃,其后续行不会再被当成新句子重复报错。#if 条件的循环变量在 Go 的 case 作用域内被局部变量遮蔽,导致条件 token 漏回代码流;改为预声明后赋值。cmd/fccaudit,扫描 fw2 全部 4056 个 .fcc:13 类句子级错误全部可解释、无一为移植缺陷(缺分号或运算符后换行、方法体内 #include 类文件等均与原版同语义,键:值 数据文件属单文件审计失真),文件级中断只剩三份 temple.fcc 的同一处资源长度异常。出错文件数由 82 升至 526 不是回归——是此前埋在子块里的错误这次浮出了水面。string ?msg = ... 把调试前缀 ? 写在类型关键字之后(原版只认句子开头的 ?),此前一直静默,本版本开始在控制台报错,示例已改为先声明再用 ?msg; 输出,四个示例现均零解析错误;示例取数加入时间戳参数,改完示例不会再被浏览器旧缓存挡住。position: relative + overflow: hidden),画布改为绝对定位铺满容器后继续承担滚动;帧信息与帧进度提升为容器的直接子节点并改为绝对定位——左上 10/8 像素、右下 24/24 像素(留出 24 像素避开原生滚动条),层级压在画布之上。只调整定位与层级,颜色、字号、圆角等视觉样式一律未动。PlayAni("stand") 报「函数未找到」,而紧邻的 anikind="stand" 写法正常。根因是对象方法表按函数名算出的固定编号分发,脚本调用传进来的是解释器驻留的字符串编号,两套编号空间并不相交,于是本来存在的分支永远不会命中,最终回落到「函数未找到」。PlayAni、PlayAniCmd 注册为对象内建,参数面与原版对齐:PlayAni(动画类型, 步进毫秒=33, 结束事件名="", 结束帧),步进为每步间隔毫秒,动画播完时以指定名字触发事件;脚本调用路径与对象调用路径都落到同一份实现,行为一致。../ 的问题(浏览器版的虚拟工作目录下取不到,改为相对工作目录直接取)。imgtype 选填充方向,fillmethod 选填充方法(水平 0 / 垂直 1 / 90° 扇形 2 / 180° 扇形 3 / 360° 扇形 4),fillorigin 选起点(0–3,越界按 0 处理),fillamount 是 0–1 的填充比例。比例可写小数(如 fillamount:=0.5),脚本解析器新增浮点字面量支持;比例达到 1.0 时直接走正常绘制,与遮罩结果等价。atan2 结果按 1e-6 度取整回绕,避免恰好落在扇区边界时忽隐忽现。fillamount 只在 360°(中心圆心)时近似等于可见面积占比;按比例做扇形进度条时需注意这一点。\r\n 此前既不换行、又把控制字符画成方框(字体没有对应字形)。本轮按原版逐字符走串的规则移植:遇到回车换行先把当前段画出去、纵坐标下移一行、横坐标回到左缘;量尺寸时宽度取各行最宽、高度为各行之和;空行只占一行高度不画任何字;末尾多写的分隔符不会凭空多出一行。选择字体前先剥掉控制符,方框随之消失。文本对象的自动尺寸与水平/垂直对齐都从同一处量取,因此多行排版自动正确。#define,不污染脚本即可用条件编译做分支调试;宏在加载启动脚本之前应用,系统脚本不受影响,取消勾选不会残留,重启后仍生效。③运行脚本不再自动跳到输出面板抢焦点,跟踪记录照常写入调试面板。④新增「显示运行输出」命令与标题栏按钮,按需把运行日志提到输出面板,同时把「开始运行 / 已退出 / 启动失败」三条生命周期行镜像进跟踪面板,隐藏输出面板也不丢信息。改动只涉及本扩展自己的输出通道,其他扩展的日志互不干扰。dx/dy + fight 的攻击判定点用红色小叉标出,位置相对帧偏移原点(即十字线交点);③w/h 占地用黄色阴影线菱形铺出,格子从帧原点起算、相邻格共边贴合;④两个复选框默认勾选,改帧脚本即时重绘;⑤帧脚本里的汉字乱码自动按 GBK 转成 UTF-8——fw2 时代的资源把字符串存成 GBK 字节并带尾部填充空字符,转码必须在运行时一侧完成,因为导出成 JSON 时非法字节已被替换掉,编辑器侧无从挽回;⑥附带处理空字符尾巴、前导分号容错、帧条徽标与叠加层扩界。占地轴向经用户两次实机指正后定稿:w 轴斜向右上、h 轴斜向右下,格心按等轴网格计算,与地图格同构。class usermap:bktile 后执行 new usermap,实例化的是内建方格地图而非脚本类,类体(loadtle / indexdata 等参数与方法)从不生效。根因是 new 的类解析先查内建注册表、命中即返回,而引擎为早期测试脚本自加的 "usermap" 内建注册(原版引擎并无此注册名)抢跑了同名脚本类。