WinterMute Engine 汉化教程

weiyun · 发表于 2014-3-22 22:08

本帖最后由 weiyun 于 2014-3-24 19:11 编辑

Winter Mute这个引擎是专门用来开发点击式冒险游戏的，下面我来讲一下这个引擎的汉化方法。
使用此引擎的游戏比较多，而且汉化非常容易，论坛之前有很多相关资料，但没有完整格式分析等

以下是官方主页：http://dead-code.org/home/
注意本引擎是开源的，源码可以在这里查看：
https://bitbucket.org/MnemonicWME/wme1/

下面开始正文

包格式
游戏的包格式为dcp格式，文件标志是0xDEC0ADDE也就是DEADCODE。

格式分析：

struct{0 a. u2 Z9 h4 V+ t9 A* _( g
DWORD Magic1; // 0xDEC0ADDE DEADCODE2 }. ^9 t" b/ k% R0 a
DWORD Magic2; // 0x4B4E554A "JUNK"
, d, ?! H" d0 D7 f. X$ r; l
DWORD PackageVersion; // 0x00000200 包版本2 O; j8 B3 d( \0 \! o
DWORD GameVersion; //游戏版本
$ j# V5 u2 a; t
BYTE Priority; //优先级; G# \4 M5 W3 x* H2 R
BYTE CD;! o3 D. e% p I& m/ _( ^! X
bool MasterIndex;
8 q. }0 m6 S) u- z8 ]5 {
__time32_t CreationTime;
' _! a& j, r1 w# L0 y& } q
char Desc[100]; //包描述' e- M& `: B6 V
DWORD NumDirs; //目录数
( R! y. H( ^' s- K9 T, ~" z
} PackageHeader;
2 `/ J; j% H3 z. s
if (PackageHeader.PackageVersion >=0x200)
! h# N9 h* S9 Q R% B( l* m1 _, Z" t
DWORD DirOffset //目录偏移量
) O- r+ F( I, r- k
struct Dir{
- d' p. J5 ?3 d+ [4 T, k" h
BYTE NameLength;' m) q" L6 a& e% @
char Name [NameLength]; //文件名/ i6 G2 {) B+ ]9 p1 ?2 i+ V0 s
BYTE CD;* {- r- L# O" H- N
DWORD NumEntries;//文件数1 H$ L% ]" Y( p5 O# ?( G
struct Entry{0 ^, C2 U4 s/ f" W: l. d
BYTE NameLength;8 k2 J% o# }* {7 M5 d P/ B
char Name [NameLength];! o; u1 n7 I; S! w8 B8 N" x
DWORD Offset; //文件位置
" H: g$ N( T8 @4 X) Q; _) P* H6 d
DWORD Length;//文件大小+ W# P4 S% w* v; u- m
DWORD CompLength;//压缩大小7 |( t* l! Q7 E+ U8 d: c
DWORD Flags;
$ ]8 ]/ N ?, H. w+ M
if (PackageHeader.PackageVersion >=0x200)3 d- ^% y3 q4 k8 o$ p3 G
{ DWORD TimeDate1
5 s. m8 [; X( _' t! o: `
DWORD TimeDate2 // not used
6 C ^4 G. H0 S+ _! h% ?
}
" M3 G0 ^! ~, H8 I9 Z* o
} Entries[NumEntries];
' [- o2 U% ~& Q' o& z9 e- h/ r
} Dirs[NumDirs];

复制代码

解包；
可选解包工具 GOBREAD，UNPAKKE，Quickbms 脚本，引擎自带的专用解包器。

打包：
可以不打包，打包工具可选UNPAKKE和引擎自带的工具。

文本：
语言表格式如下：
SYSENG0001 Game settings
SYSENG0002 Display
SYSENG0003 Sound
SYSENG0004 Use hardware acceleration
SYSENG0005 Display device:
SYSENG0006 Colors:
SYSENG0007 Run in window
语言表可以互相引用
SYSENG0001 Game settings
SYSENG0008 /SYSENG0001/
甚至能支持阿拉伯语等从右向左的语言，只要文本里加上这个标记就行
@right-to-left
语言表一般为String.xls，这是csv文件，而不是真正的xls格式，直接翻译即可，注意编码选择可选简体中文（GBK编码，非中文系统将无法显示），和utf8编码，注意如果文本编码有BOM将自动切换为UTF8格式。

字库：
游戏支持两种字库，图片字库和ttf字库，注意只有ttf字库支持中文。
字库都需要描述文件，因为图片字库不支持中文，所以此处略过，有需要请看官网。
http://docs.dead-code.org/wme/inside_ui_fonts_bitmap.html
要注意的是ttf字库是不能打包的。
TTF格式字库的描述文件：
TTFONT
{
  SIZE = 12
  FACE = "Arial"
  FILENAME = "fonts\arial.ttf"

  BOLD = TRUE
  ITALIC = FALSE
  UNDERLINE = FALSE
  STRIKE = FALSE

  CHARSET = 1

  COLOR { 255, 0, 0 }
  ALPHA = 255
  LAYER
  {
OFFSET_X = 1
OFFSET_Y = 1
COLOR { 0, 0, 0 }
ALPHA = 255
  }

  LAYER
  {
OFFSET_X = -1
OFFSET_Y = -1
COLOR { 0, 0, 0 }
ALPHA = 255
  }

  LAYER
  {
OFFSET_X = -1
OFFSET_Y = 1
COLOR { 0, 0, 0 }
ALPHA = 255
  }

  LAYER
  {
OFFSET_X = 1
OFFSET_Y = -1
COLOR { 0, 0, 0 }
ALPHA = 255
  }

  LAYER
  {
OFFSET_X = 0
OFFSET_Y = 0
COLOR { 255, 0, 0 }
ALPHA = 255
  }
}
各参数说明
• SIZE – 字库的大小，一般根据英文来选择。
• FACE – 字库的名称，注意是显示名称，比如系统自带宋体SimSun 。建议不要写中文，容易出现问题。
• FILENAME – 字体文件名称，就是ttf的文件名，如果要直接使用系统自带字库可以留空。
• BOLD – 为TRUE则以粗体显示。
• ITALIC -为TRUE则以斜体显示。
• UNDERLINE -为TRUE则显示下划线。
• STRIKE -为TRUE则显示删除线。
• CHARSET – 字符集，简体中文要选6，繁体要选4.
• COLOR – 文字颜色(RGB)显示
• ALPHA – 透明度， (0 到 255)，一般选255.
注意这个定义文件下面的Layer就是按层绘制，可以实现模拟的描边效果，就是左移，右移，上移，下移1像素各绘制一次，颜色不同。如果不需要描边效果只需要1曾就够了。

以下是字符集，注意和windows的GDI中LOGFONT的值是一样的，游戏本身也是用GDI处理文本绘制的。
详细内容请看MSDN
http://msdn.microsoft.com/en-us/library/windows/desktop/dd145037(v=vs.85).aspx
WME 字符集编号解释
0 ANSI 字符集（注意这是英文字符集）
1 默认字符集，根据系统语言变化。
2 OEM 字符集，根据系统变化。
3 波罗的海。
4 繁体中文。
5 中欧及东欧语言。
6 简体中文。
7 希腊语。
8 韩语（Wansung）。
9 Mac字符。
10 西里尔字符（俄文）。
11 日文 shift-jis 字符。
12 标准符号集。
13 土耳其语。
14 越南语。
15 韩语(Johab) 。
16 阿拉伯语。
17 希伯来语。
18 泰语。

图片：
本游戏图片格式为PNG，直接处理即可。

脚本：
一般不需修改，除非遇到文本保存在脚本中。

脚本格式分析（不含虚拟机分析）：

DWORD magic; //DEADC0DE
8 N, l1 O/ s/ K. I4 X& F/ l0 d+ _
DWORD version; //当前版本为0102
9 Q8 A5 G6 S- w1 O Q9 S& ?/ i
DWORD code_start ;//代码地址! V$ j& B5 C% H, e
DWORD function_table_start; //函数表地址8 ?7 C3 J& ]4 u# _
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移 M( ^% C; I' g4 l! j6 Q* g. Q
DWORD event_table_start; //函数表地址7 `8 z4 f U9 n# v3 z
if (verson >=0x0101)
% w1 F# V9 |9 S. {2 }; u1 F d8 w
DWORD dll_table_start;1 S+ i6 w$ ~0 M8 B J4 N, ^
if (verson >=0x0102)
8 M$ F3 q/ W. h* W* q+ P/ }2 Q
DWORD method_table_start;7 A: g3 q8 c* B+ n( {
string source_name; //0结尾字符串
0 w* T( z: K2 S8 d
byte[] code; //代码的字节码
) e) i6 j0 I& m2 }
( `5 v H" |9 [4 Y: y; Q
struct {
1 [8 b3 a7 h+ D
int num;% K7 \4 D1 ]& ^( c" `
struct {
J. k% i8 F1 M' `# m! j8 h
int pos;
6 C/ ]7 j1 r9 \) k1 V
string name;- R' @: n8 ~: K O" i
} function[num];
$ u, M5 V/ m3 K
} function_table ;' E( b- z2 ^5 m
struct {5 Q Q! K# s' ~6 p5 _3 r
int num;
A8 x! c$ ~% s$ y' o1 ?# }
struct { f$ P' @% M. B; x- K: U
int id;
. X$ _* Y6 Z) \3 ^) X2 i6 F
string name;6 t& M0 y. E& s1 y6 p
} string [num];: |- e4 S" R) T: D* g, N' K* x
} string_table;
3 d; @3 E, ?: ~& M9 Q' Y
struct {( k9 M8 ?" W W- C) Q9 }) h
int num;1 b, A" J0 m2 d/ _. Y! u
struct {4 D& L+ h4 ~% k/ N0 i
int id;7 x8 S1 d- m- l4 ?2 A# g+ c
string name;8 o* I9 I0 `; I3 n# X0 i, z
} event [num];
9 v. L+ K$ a' k" w0 a. `9 `3 p% o
' U' I+ ?! v2 g Z: o& M
} event_table;; m- l/ l4 \) V% c6 a7 A- A
if (version >=0x0101)$ v1 N3 j8 P/ I
struct {
* v5 a4 i( ~/ V5 O+ h4 _8 ?
int num;
) C' T! S+ w* W i
struct {7 k' Q8 F- l# b( z9 c5 k
string dll;
1 F( H" U" a3 j# e, b3 ]/ ?
string name;
. Y+ K9 J7 m# L# W
int call;
% f9 i8 O+ Q/ u2 m) }: b! v
int returns;# ?5 {; t! C9 q z) q: s: I
int num_params;) t1 A* X% U% k* Z% Z& [, e
int params[num_params];3 |7 w4 g$ z5 i* Y: a! e
} dll [num]; 7 q& N( j+ u2 f
7 t! m5 \' R' S3 O7 x3 [, A5 b
} dll_table;
" B8 Y& b7 ^2 E6 E* F1 G0 {5 Y
if (version >=0x0102)
7 {! A8 J' C; Q
struct {
( v& Y' [+ f/ k" g
int num;7 S* y" J0 Q; \
struct {" D7 |( u. f5 o# U/ q9 ?
int pos;3 F; X2 P" c. n
string name;
. j: A' g C2 K0 C7 P8 [& E/ l$ \
} method [num];
, J0 b* U3 q. G4 l# @1 _4 S
} method table;2 k# `2 Z* z0 @5 R3 e
! g3 H1 I7 H6 ?. k8 W

复制代码

音频：
游戏音频格式是Ogg格式，Vorbis编码。

视频：
游戏视频是ogv格式，theora编码。

汉化流程：
1. 如果有dcp包，先解包
2. 翻译字符串表
3. 找到中文ttf字库放入游戏目录，并修改定义文件为ttf的定义，参数根据需要调整
4. 修改图片
5. 改过的文件放到目录，或者打包
6. 测试

注意：
换行问题，经测试ansi格式下换行有bug，中文超出行数会出现乱码，utf-8也会出现一些问题，如unicode码低位为00时会无法显示，可以采用自定义编码方法解决，需修改文本编码和ttf中的映射表，或修改引擎解决，较为麻烦。

XYZ · 发表于 2014-3-22 22:20

感谢分享！沙发支持！

davidgbl · 发表于 2014-3-22 23:13

本帖最后由 davidgbl 于 2014-3-22 23:37 编辑

太好了好好学习学习。avg用这个引擎开发的游戏很多。
不过遇到过一些问题，主要是一些动词在汉化文本中没有。比用use XXX with XXX
其中的XXX在翻译文本中是有的，但那些动词不知道藏在什么地方了。始终没有找到。
比如之前汉化的：409号黑夜童话，有这个问题
（另外328号埃德娜&哈维：逃离疯人院也有类似问题，但我不记得是不是wme的游戏了，我几个应该是，老啦，呵呵呵）。
还有一点可能需要注意：
就是使用ttf的字库要用ttf字库的内部名称，尤其是中文的ttf字库。 t9 x1 c/ x1 q7 X+ v) T
不能简单用黑体.ttf啥的，最好用字库查看软件看一下字库的内部名称和字库名是否一致。

巴厘岛之夏 · 发表于 2014-3-22 23:23

牛贴必顶，强人必赞

setsail615 · 发表于 2014-3-22 23:27

本帖最后由 setsail615 于 2014-3-22 23:35 编辑

不明觉厉啊~膜拜楼主~~
PS 友谊哥，328好像不是wme的，我也不太清楚……

seasonmonster · 发表于 2014-3-22 23:31

嗯，很详细，值得学习

myq495 · 发表于 2014-3-23 09:54

支持楼主的处女贴

leahlee · 发表于 2014-3-23 18:12

不明觉厉。。。:D

欧兰妮 · 发表于 2014-3-24 23:47

感谢楼主秉承着热爱汉化之心所做的技术分享~

慕言思语 · 发表于 2014-3-24 23:58

突然感受到了大家对汉化技术的热情，顶weiyun。

汉化资料 WinterMute Engine 汉化教程

[汉化资料] WinterMute Engine 汉化教程

楼主热贴

社区热点

浏览过的版块