Skip to content

fairygui资源逆向还原工具。本工程仅作学习研究使用,本意用于工程项目不幸破损,通过发布出来的资源文件进行紧急还原,请勿用于资源破解侵权等行为,否则后果自负!!

Notifications You must be signed in to change notification settings

krapnikkk/fgui-restore

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

写在前面

本工程仅作学习研究使用,本意用于工程项目不幸破损,通过发布出来的资源文件进行紧急还原,请勿用于资源破解侵权等行为,否则后果自负!!

下载

git clone git@github.com:krapnikkk/fgui-restore.git

安装

npm install

使用方法

node restore [inputFile] [outputPath]

参考

node restore ./test/MainMenu.bin ./output 

支持版本 && 还原说明

nodejs版本:12

数据版本 [向下兼容] : buffer.version: 5

编辑器版本:FairyGUI Editor: 2020.3.3

【已测试官方DEMO工程99%高度还原,还原出来的包资源文件推荐使用最新版编辑器打开】

还原程度

  • 将合并的纹理图片还原成碎图【统一png格式】
  • 将碎图和package.xml关联绑定
  • 将组件xml和package.xml关联绑定
  • 将动画Movieclip还原成jta文件【动画设置以帧频:24为基准进行还原】
  • 将位图字体文件还原成fnt文件【二进制格式资源包统一还原成UIBuilder默认格式】

无法还原项

  • 骨骼动画资源还原
  • 项目设置中的默认设置项
  • 不被打包合并的资源或者不支持的资源【比如:swf,仅单纯放置到包内】
  • 设计辅助功能配置【比如:[组件]组件设计图、元件保持比例和背景颜色[装载器]发布时清除等】
  • 普通组元件无法还原
  • 部分数值由于浮点数精度问题会有一位小数上的偏差

资源文件内容一览

  • package.xml
  • sprites.bytes
  • .xml
  • .fnt
  • .jta

xml解析流程

  • 解析发布出来的资源文件
  • 根据文件格式版本分布解析二进制和压缩描述文件
  • 将发布的资源文件解析还原为xml
  • 【image】图片资源根据id还原name 和 文件路径 packageDescription.resources[0].image
  • 【movieclip】packageDescription.resources[0].movieclip
  • 【sound】packageDescription.resources[0].sound

文件解析流程

  • createObject 【UIPackage】
  • constructFromResource【 GComponent | GImage | GMovieClip 】
  • controller.setup【controller】
  • setup_beforeAdd 【component-child-GObject】
  • relations.setup【relations】
  • setup_afterAdd 【component-child-GObject】
  • gear.setup 【GObject】
  • trans.setupp 【transion】
  • constructExtension 【extension】

todo list [maybe]

  • 【组件】组件自定义属性还原
  • 【组件】组件出入场音效还原
  • 【组件】属性控制中对原始属性的判断进行还原
  • 【标签】标签中的标题为输入文本相关属性还原
  • branch分支相关逻辑处理
  • fnt文件初始化完善
  • 校验需要还原文件的合法性&合理性及异常处理
  • 浮点数数值精准还原
  • 属性默认值及属性顺序精准还原
  • BMFont字体文件还原
  • and more

changelog

  • 修复纹理集旋转后,还原图片文件的宽高及旋转角度异常问题
  • 对文本元件的特殊字符进行encode
  • 尝试对跨包引用的资源进行兜底(扫描同目录下的其他资源)
  • 扩展支持二进制格式下的压缩描述文件

License

MIT

About

fairygui资源逆向还原工具。本工程仅作学习研究使用,本意用于工程项目不幸破损,通过发布出来的资源文件进行紧急还原,请勿用于资源破解侵权等行为,否则后果自负!!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published