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{ \' z* v/ K# t7 T
DWORD Magic1; // 0xDEC0ADDE DEADCODE6 k- ]: W* C- Y m+ ]
DWORD Magic2; // 0x4B4E554A "JUNK"
+ ~ A: U0 Y, K( @
DWORD PackageVersion; // 0x00000200 包版本
+ i; O0 @( D6 N, M G9 \' ^
DWORD GameVersion; //游戏版本
6 I8 ?5 ]9 _+ c3 R4 t# a! R: ^
BYTE Priority; //优先级! g, Y" t" n9 a I7 k+ G& \
BYTE CD;7 U" e' P1 i, V( v
bool MasterIndex;. ?* v: X4 M: k8 \( x1 x
__time32_t CreationTime;7 C& M5 g) K: a7 t) p; Q% \
char Desc[100]; //包描述
4 O, q* g3 Q L: q. _3 _6 Z( i9 y0 [
DWORD NumDirs; //目录数( U9 S, ~+ d# V/ \
} PackageHeader;) X$ M# ~. d* G: P/ F* s
if (PackageHeader.PackageVersion >=0x200)
& W% r, E5 }& K( f8 z
DWORD DirOffset //目录偏移量
$ r9 Q% g! P/ _9 n" n4 P
struct Dir{, o: Q/ C/ R `6 E
BYTE NameLength;
! N- V* i: Y, c8 X
char Name [NameLength]; //文件名) ~8 Q! |: r# Z, P2 O1 ?9 E4 ~
BYTE CD;
+ t# _; U7 K) v2 W6 W* Z) x `
DWORD NumEntries;//文件数
% _7 e, N0 Z+ u Z' g; b: P
struct Entry{3 m8 l) d4 U B' ]6 [% ?
BYTE NameLength;
* L2 F5 v* [" l$ B" G! _6 j( i6 k
char Name [NameLength];
( C% r2 w) K/ o" p' }* M
DWORD Offset; //文件位置
\; c9 |& d x) V$ Y: O
DWORD Length;//文件大小+ m Y- ]5 N$ P6 T& H
DWORD CompLength;//压缩大小
5 l2 o8 c/ T) u4 | t4 }, H
DWORD Flags;6 N+ I9 G$ q, ]9 P$ {6 M9 m
if (PackageHeader.PackageVersion >=0x200)
5 |! D) B! L1 {- g1 f
{ DWORD TimeDate1+ H0 ]( @: X1 j# m5 O S* p
DWORD TimeDate2 // not used. p9 S4 k% p# Y* [8 J5 Y
}) d. g# q) d& f8 o' \
} Entries[NumEntries];$ S: N z- D: m4 _1 G' I% P
} 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; //DEADC0DE1 v% `& u N3 e" j
DWORD version; //当前版本为0102
K* ]1 s1 L- }" d8 h
DWORD code_start ;//代码地址
9 C: a P( u6 w9 N2 t+ J9 U
DWORD function_table_start; //函数表地址9 L: I( c$ U) I# C# B! [
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移8 Y$ Y" _) u, a
DWORD event_table_start; //函数表地址" u6 y4 R0 j. ^+ T+ D
if (verson >=0x0101)
o* q- x. V" h, [: r( ~6 w
DWORD dll_table_start;$ `# J& X% W4 j! x; d
if (verson >=0x0102)
5 Y# r4 X9 C4 s. v6 y1 Y% N S
DWORD method_table_start;
; c: r- I6 G5 k
string source_name; //0结尾字符串- t! D% o1 y% d" V
byte[] code; //代码的字节码# f! X- L- M& x
4 d2 n6 X+ Y2 ?8 W
struct {
2 L: @2 l# H8 S+ I+ v' u! t
int num;, ^; d/ }: K3 J
struct {
( S- N0 l1 k& V& u; o8 |- Y
int pos;
. X6 ?1 C, Y! x1 z
string name;& Y3 O/ A/ H- t: E* G1 z2 t+ b/ W+ b
} function[num]; [3 a h' d T5 i! B1 t
} function_table ; j% q# \ G M" U* p* L
struct {5 |( m3 h5 s9 Q5 F
int num;; w, I ]- \( v. w1 X
struct {
. s0 L( R7 l0 q
int id;
; i. p! g" Y. R3 D
string name;
" o! G, u" ?2 X& ~- Y' E
} string [num];
2 Q! h* c1 V3 Q; T4 D* X2 U! n& E
} string_table;
5 j+ z7 f& h: d" F& t5 J
struct {+ p; T3 z; r i9 p
int num;: I' X" L5 t# u% P% }
struct {9 i3 w4 O; E" W" ]
int id;
- m9 s0 @( F- f# s9 z6 o
string name;
v/ k" c& u) ]! K! n# i- M
} event [num];' d. X a! @4 O1 f+ M; |7 l
6 x A0 b9 u$ g( D- k- t7 X7 J
} event_table;* Y* d* X. a7 `3 H' t
if (version >=0x0101). S0 F+ `0 ~8 \6 z- c
struct {3 ^( v' h0 P/ V! ]" a
int num;8 ~6 l5 g: {4 U; E4 [* u1 ^4 O. L
struct {
( O6 f I+ O; b0 G' I
string dll;. l9 `' @9 B$ P' h
string name;
8 ? a: R: T( _$ N) x+ h# @ D2 Q
int call;* I i/ N! f2 v3 B; }# Y A+ A
int returns;
5 M/ ^ L6 p" r0 h
int num_params;! Z- `1 D' o1 m( Q. W5 u8 g) R- N; f* c- ]
int params[num_params];4 P, G; y( D6 |5 {: Z' ]! E
} dll [num]; 4 `' g7 _! y" w! d6 j0 y* V
; r. L% X7 z% U3 I: [( C
} dll_table; E* w1 {7 w* R4 q. E6 C9 n
if (version >=0x0102)1 N5 E3 y# V) N6 a5 k1 w8 a
struct {7 u4 L9 U9 h* D
int num;. W: a" Z5 g1 h5 c+ c( @
struct {
6 v {' y% p; A% S3 g
int pos;
5 f7 F& }) [( j
string name;
1 J; X& y9 q& j! ]& }
} method [num]; 9 \/ _" N: d \2 \9 W7 }
} method table;
# a/ H1 {5 h+ q3 J( W' }
8 t v( D* C: g

复制代码

音频：
游戏音频格式是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字库。5 v2 z' w; R! d3 R( |2 V4 _
不能简单用黑体.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 汉化教程

楼主热贴

社区热点