【汉化工具】 游戏文件多功能通用分析器

shane007

RipFiles  Console/Prototype Version
V0.02.071103

, }0 b+ f6 I  a: ?9 g5 F
最后更新于：2008年2月25日(星期一)
6 v0 T( _( h  U9 m首先，这个是一个用来解开各种游戏的资源包的程序，但是每种都要一个对应的插件才能正常运行，嗯，就像SUSIE还有汉工做的那个CRASS之类的类似的工具吧。最初做这个程序的原因嘛……，因为之前在为汉工的那个CRASS做插件的时候，无论如何我都做不好的样子，总是运行失败。后来，在一次和汉工对话时说一句话提醒了我，（原本谈的是什么内容我已经完全全忘了，只是记得大概是关于所有的文件读写操作都是通过主程序，再调用DLL来完成这类的话题的吧），于是我突然想起了很久以前的一个想法：

如何使用最少的代码来描述和定义一个资源文件包的结构和信息，这样子就可以使用极少的代码来操作各种文件资源包了～～，甚至只需要使用一个INI文件来定义一组信息就可以进行解包操作了。
8 H& d+ D7 W& a; h8 L
突然就这样子想到了方法：原理就是只要让主程序来进行所有的读写操作操作就可以了，而插件程序只要进行数据解释就可以了～，于是按这个思路，这个工具就这样子出现了……
, U6 J$ |1 @* a$ n; Z
4 B8 J, K0 B( @* Q: L' K, a; q虽然现在这个东西还只是Prototype(原型版)，也只出了一个DOS版，不过DOS版的好处就是可以让你专注于系统和数据结构之上，而不必管WINDOWS界面那繁杂的设定。预计以后会同时推出DOS和WIN版的，现有的核心的代码都是完全可以脱离出来的。两个版本可以使用同一个内核，所以一般用户可以使用WIN版的，而插件开发人员可以使用DOS版来进行调试信息的输出（本来我的PROTOTYPE版就是用来调试用的……)
! m2 V- a. R+ }/ D, s4 v+ M) z


命令行参数说明：


, {0 o, `$ f* @" [3 @8 g注：部分命令在WIN版中也是通用的。另外，命令行参数也是可以被传递给插件的，所以你可在插件中定义自己的命令行参数。
RipfileD Packetfile [-o Dirname] [-f pluginname] [-p pluginpath][-i] [-e] [-d] [-c] [-a] [-h]
         Packetfile 文件名，现在还不支持 '*' 和 '?'
& p9 t, ?( j' e3 J# M" j& U+ N8 X         -o 解开文件保存在 Dirname 中
2 Q: y5 E) _5 w- w/ p1 H" e         -f 指定只使用某一个插件
         -p 指定插件所在目录，不指定时所有的插件是存在于当前目录下的plugins 目录下
         -i 当有插件配对通过时显示插件的相关信息
         -e 显示目录项的数据
         -d 显示调试信息
* u& d* m; W# y+ t. e. N4 w$ V         -c 显示一个设置对话框
         -a 强行保存一次原始的数据（使用原有的文件名），不管是否插件能对数据进行解释。（用于DEBUG及需要原始数据的场合）
         -h 显示这个帮助
+ g& }7 V) i5 n5 Q$ Y' \9 B9 i! t
& u' A4 [6 O0 N, F
) x. {6 K/ a! }5 a8 S5 ^0 `
' z% j$ G* [1 v% H0 u开发计划：

( A" f6 T$ F2 B. ]' S+ w
由于种种的原因 现在这东西，现在只完成了一个 Prototype(原型版)现在这个版本只完成了预计功能的60%……，而在已以知的未来的一个月内是否还有时间写我现在都还不知道，所以……
( H$ x; x+ S# G5 u以下是没有完成的内容：
) P) c& B3 w0 D, |5 a( T  X  V插件的命名规则还没定
* z2 H/ j+ {0 d- N( c' |RIP插件支持：未完善
( f7 f9 D: ]* b  _) g+ m7 G' @INI插件支持：未完成
* o4 N- D. C5 D- V汉工的CRASS插件支持：未完成
: a3 L2 ]+ z. j  @  G( nWINDOWS版制作：……

2 C: r$ K& O$ i) b) ~
三插件版打包下载
$ I6 k1 a6 o5 T+ \8 R4 `
把左边图像目标另存为 RipFileC.rar
包含0.02版的程序和三个插件
ActG插件关于此插件和游戏的介绍见此：http://blog.sina.com.cn/s/blog_571b19a001000ahh.html
Rbo 插件 用于解开 Ragnarok battle offline 的封包的程序（支持到EX3版本,本来是为了汉化而写的，但是……现在看来这个项目已经没有爱了）
Rbo_cg 插件 用于 rbo 的CG文件的解释，这些文件在存档目录中存在。注意：这个插件是处于不稳定状态的……
  f% }$ ^6 ?/ F8 v) n; n! S
MO下载  http://pickup.mofile.com/7016561194314813
插件示范源码下载 ActG插件的源代码（在VS 2003平台下开发)
, j" w; r3 B2 T9 V7 `' p+ _
9 o* B% a9 c1 ]& F$ b 存为 Actg.rar
6 A& o$ i- H2 f5 J
' g+ ?+ J2 v5 m2 `0 ]" TMO下载 http://pickup.mofile.com/0607492233855083
SDK 开发包下载 v0.92 配合以上源码及开发你自己的插件用。
! }2 z, T8 U" L
存为sdk.rar

% X& s- A- m+ UMO下载 http://pickup.mofile.com/6472507050765381
6 \4 B9 h. P+ W% m

% H# f, u1 Q* F7 |' [+ }: ^   插件制作说明：
+ z, s2 l6 g% ?* E0 K6 ~+ v现在暂时只支持DLL形式的插件。
, U) ^( k( G2 ~( M1 d7 a6 q2 h在你的项目中stdafx.h 包含"common.h" 这个文件即可。
相关接口和说明请看common.h文件中的定义即可，其中有比较详细的说明。
你也可以参考ActG 这个示范用的源代码。这个是开源的，里面我写有详细的注释。
2 I$ R# g9 R" A6 t+ ~. v' M插件接口定义：
8 C5 d. @1 w! A' k
  u$ m  l# r! [
RIP_API struct Information* GetInformation(void);
8 h) Q0 B2 A( g0 i9 `+ l7 b( Q

& {2 S# i6 \; y, h! HRIP_API struct RipOperation* RegisterRip(void);

以上两个为插件公开的调用接口，请按要求进行添写相关项目即可。
+ P1 x1 N) H: l: J( n0 ~主程序根据 RipOperation* 返回的结构确认插件所能提供的功能，并按一定的方式进行调用。

  H& w: S9 V8 n" W3 t3 R8 ^0 l插件的基本调用流程如下：
2 g# C. D8 d2 `进行准备工作。
void (*PreRunning)(const char* , struct CallBackFunction* );
. K7 I6 d; B( n; U) b7 M传递命令行进行处理。
void (*ParseCmdLine)(int argc,TCHAR* argv[]);
测试插件是否支持该封包
struct PreData* (*PreMatch)(struct packageInfo*);
4 M6 o7 J  z; l2 P/ q- Q int (*DoMatch)(struct packageInfo*);   
如果支持，进行目录项的解释
struct PreData* (*PreEntries)(struct packageInfo*);
int (*GetEntries)(struct packageInfo*, struct EntryData*&);
+ f* U+ A3 W7 E得到目录项后开始根据目录取得数据，如果数据进行了加密等处理，再进行一次解释
struct DecodedData* (*GetData)(struct packageInfo*, struct EntryData*);
int (*GetData)(struct packageInfo*, struct EntryData*, struct DecodedData*&);
释放插件,进行数据清除工作。（如果 DoMatch失败，就可直接进行到这一步）
2 H. E+ a. T2 m0 A! n6 h void (*ReleasePlugin)(void);
如果存在多个插件时，对一个文件轮流进行以上操作。真到插件全部试完。

根据封包的不同，功能有些可以进行省略。有些不是必要有的，例如各个Pre函数，有些项目是必须存在的例如 DoMatch和GetEntries，不提供这些函数时会被认为插件不造合当前

封包。不使用的功能请添写为NULL即可。
* B7 t! V( w) M: t7 T具体的调用方法和函数的原型请看示例代码，里面包含了所有的可能的功能了的。
+ ?  i' y, x3 V5 ~" n
7 G- W% h1 q, p5 Z7 H% x关于rip插件
7 e$ ~! s5 P/ [# orip插件的定义
插件名由rip开头(注意小写字母)
2 F+ z' S+ f0 Kmatch操作一般总是返回MATCH_SURE。
) N2 c, j( n! S  Y. h) X& V1 U能打开的文件操作是*.*（即可以打开任意文件）
( D$ B0 m2 d) x  h, y, T  n+ h用于在对文件的格式不知情或者非常少资料的情况下抽出某一种或者几种类型的文件用
例如：直接抽取BMP，WAV格式的文件用。
9 l( k, i8 d) g7 m1 q此种插件的调用方式和一般插件不完全相同。
4 T6 ~) k& M7 [8 N1 J2 ~
. T3 T  Q$ o. d, p+ D

更新列表：
2007年11月3日(星期六)
1:版本名称修改， Dos/Prototype version 修改为Console/Prototype Version
: M4 J/ D0 G$ M+ x- m9 c$ T用DOS这个名称已经偏移其定义了……
% Z$ V) ]4 h; k  l+ @- s+ w8 \插件参数传俤值见 ruledefine.h
2:-a 参数功能修改。
" b" J# s; _+ S默认为在能解压并且不失败的情况下(parsedata 功能定义并且返回正常)只保存解码后的数据。
2 m3 A! }4 y$ O9 V, u2 [$ v  g只有当指定了此参数的时候才会保存原始数据（RAW　data）。
4 h, P! _9 m9 d% ~2 M2 M- F+ b3:pasedata 返回funciton no exist 时不作为错误处理
* W& _! S9 Q( }7 O6 Q# q2 ^4:当插件版本高于当前版本时会提示功能未定义。
& m0 V6 t6 i9 \; [
2 v8 p* ~- l: O( I8 E9 P; d+ s/ H2007年10月18日(星期四)
, f2 `7 ?+ _. n) y, q/ C新的命令参数 -p 用于指定插件所在目录（不指定时默认为当前目录中的 plugins 目录
4 q" P5 z0 a3 M! g% m1 }9 T如果指定了参数 -a，但是解压函数返回出错时，会自动保存原始的RAW数据
. ], y& |9 q5 q& |# y) Q
2007年10月7日(星期日)
: a6 h( [' s1 g3 f+ a命令行传递完成
路径处理完成。
指定某一个插件运行完成
& j. c" q% ~+ T# a" CCLoadPlugin　改名为 CPluginsLib
CallBackFunction 在需要的时候才会被提供。
所有的返回的定义被定义到　RuleDefine.h  中
! [9 H/ \. R: |3 d7 S% @8 c4 O$ z规范了函数的返回值。定义错误返回代码。
( B$ s0 V" h7 Iout dir 没有 \ 结束时出错。
对RIP类插件的支持完成。RIP类的插件只在指定使用时才会被调用。其他时会自动跳过。

9 V: _; g5 C9 d2007年7月4日
第一个原型完成。世界开始有光……
2 E# e) n) E! _/ n" R8 a
% y) M. K# I0 {" o; n) i9 I

好了，十分感谢你能看到这里，一个好的插件软件需要有大家的支持才能放出光彩……所以，感谢大家的支持。

- ~- N( z( E9 |2 M9 p8 \by blues city
, G, `# i- N, ]6 `' G3 B

原贴
4 |0 |4 G7 x; H: y. c5 y  l+ k/ Ehttp://blog.sina.com.cn/s/blog_571b19a001008fpg.html