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{
/ J, S3 S: z. @9 I* `4 T; T7 z( f
DWORD Magic1; // 0xDEC0ADDE DEADCODE
& q8 i2 t% m( \* D% E0 |% l
DWORD Magic2; // 0x4B4E554A "JUNK"
; @! e9 P. w* Q( D
DWORD PackageVersion; // 0x00000200 包版本
5 y4 G3 @* R1 `; B9 I8 B* B' ?
DWORD GameVersion; //游戏版本; [7 }. c8 x/ Y
BYTE Priority; //优先级
5 b4 y6 M% Y+ Y M) L9 ]3 U
BYTE CD;
0 d0 d& H0 g# P0 o& m3 v1 @
bool MasterIndex;/ T+ [, A/ l5 ?5 r
__time32_t CreationTime;
( ~/ G1 v5 z& L0 `( s. m
char Desc[100]; //包描述0 C6 l7 w' a) O4 A8 c) X" h
DWORD NumDirs; //目录数
9 D* C7 A8 W! h, w6 s7 K" r7 V v
} PackageHeader;+ O6 d0 v9 k$ d/ `; o2 B/ W
if (PackageHeader.PackageVersion >=0x200), k/ i# ^) n z) ?. V
DWORD DirOffset //目录偏移量 \; {6 p' v7 R+ [6 M. ~# Q* b
struct Dir{4 z/ }* B$ [. k2 b- p
BYTE NameLength;
/ @0 D) R# [6 B0 X
char Name [NameLength]; //文件名& ^: S Z9 S3 @ }! I
BYTE CD;/ z/ Q* u1 {; D/ I3 h( J
DWORD NumEntries;//文件数
1 z% h8 v8 Y# W6 g
struct Entry{2 F3 k$ q) r- w& x b' a
BYTE NameLength;
; w2 k! ]0 H9 p+ A& p- R
char Name [NameLength];; G. S! [, q* ]( ~: N
DWORD Offset; //文件位置
7 _8 |) H8 Q! a( ^% W. J: u
DWORD Length;//文件大小( N; ~ M0 T( C0 V+ y! y+ G2 i$ l5 K
DWORD CompLength;//压缩大小: H* w- R! T1 o/ K
DWORD Flags;
5 p* s1 M1 q0 @, w7 d2 j
if (PackageHeader.PackageVersion >=0x200)
' |* i, U: M* ~: ^1 W
{ DWORD TimeDate1# f# f$ T0 S" }3 P+ g1 n8 Q: T1 ]
DWORD TimeDate2 // not used. D0 g6 `& ~( I5 U% ^2 U$ t( C
}
2 |8 j+ n- T! M
} Entries[NumEntries];
- b: ?' U6 Y5 O% j, q( W, u
} 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; //DEADC0DE2 R z* ~6 _6 B4 k! v+ s% s
DWORD version; //当前版本为0102
; t% w. H" C6 j( u1 V) o
DWORD code_start ;//代码地址- R. A9 C* L- ^1 r+ \$ o6 T
DWORD function_table_start; //函数表地址9 s7 c; Z) t7 n$ X
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移1 [. U5 ?4 C4 `; d2 Z
DWORD event_table_start; //函数表地址 \% q6 b0 Y9 n: q
if (verson >=0x0101)
6 O6 d0 D/ _/ n4 a9 u' m
DWORD dll_table_start;
6 n; o U: `! U( H6 l
if (verson >=0x0102)
$ V& G0 \, l+ j& w6 o
DWORD method_table_start;6 n2 G7 e" W' g+ I
string source_name; //0结尾字符串- G2 ~. Y4 f, n7 p2 @* _3 ?$ k( Z
byte[] code; //代码的字节码
4 N, x0 J v4 M# Q! r1 U' W
4 m0 n9 _4 i: T9 Y6 e0 K5 ~$ q
struct {1 y0 |' l( q: e9 J' O2 l
int num;
& O# u, g" @ N+ ]# m
struct {
& j4 p1 a/ I5 \% D4 `8 y
int pos;
! Q: r5 u& L0 g6 ]5 p
string name;
) F6 H) b9 q) b. ? a x6 E/ \
} function[num];
! r' e6 ^+ o4 K. n' J7 z
} function_table ;; L3 B& P1 c1 a
struct {" i% Z) U+ p/ L. I0 F2 ~! o3 N4 U- e
int num;, T ?5 ~% N! b5 B2 P8 i3 D
struct {1 z& E, p. \ l) E* v( D8 q A0 N0 E
int id;
/ J& n. P/ L6 a6 z) `3 N
string name;$ D e9 |; X( Y& T Z7 W( P
} string [num];4 Q5 t- X: \4 K2 [$ C" r
} string_table;
" v5 x8 W ^# y' K# {) j4 r
struct {
% ^# w* ^& j; F- [; b
int num;
0 i# ?( \5 F( ?: m, Z5 ~
struct {
+ @0 w5 v( ^" A7 P4 P( Y) N
int id;% q. L7 `6 j" X5 @% b
string name;8 W# g6 J: B* x# y" w( W
} event [num];" ?) R' R) y. T6 b5 V7 l
8 r* R, q4 Y1 p0 T! i6 S1 [) ^; H
} event_table;( _- s! j' S% R2 T* z, H% C* ?
if (version >=0x0101)
/ d; N6 G0 }& c& {
struct { f9 k; T2 A) _$ Q H$ |5 O
int num;5 B, s( L) Q- d; e2 {# l4 `
struct {& {7 r0 z% T8 v7 y+ u9 _4 J4 x
string dll;8 ~/ _6 V; ~) H0 n
string name;0 o0 J! Z5 ~3 D; L
int call;& |. E0 b2 z) c; ^+ e2 d
int returns;9 [9 }- x- S# m0 n* L# [0 ?
int num_params;
, e7 A ~+ r A5 J/ \
int params[num_params];
# y% O4 V8 m2 Q, j, N+ ?, x
} dll [num]; + }5 c3 e, O# s c4 i. V
* ~. ?1 S j: G3 ?: b3 G4 {7 {
} dll_table;
1 a9 ~- F; ?. R! C
if (version >=0x0102)6 o: H: c% H x/ g7 a! v
struct {7 P+ z2 g6 _9 c
int num;
0 C) l3 S) a% i! g* R
struct {
' T, }8 f$ ]" R8 J+ w( ]
int pos;
. ?4 v$ K, s/ d& p' H2 l4 V1 p
string name;
7 P1 u4 p8 d7 p% Q9 w: P
} method [num];
7 H- S3 Q5 t6 M9 V( o. `
} method table;6 z5 z, b1 G/ w, ]* Q. z
5 r3 U5 N! m+ Z8 K8 x% |5 b

复制代码

音频：
游戏音频格式是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字库。
9 \$ o) g, V; Q' [( \+ g2 p7 g. `不能简单用黑体.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 汉化教程

楼主热贴

社区热点