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{3 ~( k1 d" O) R+ |6 x/ _( C7 X
DWORD Magic1; // 0xDEC0ADDE DEADCODE6 f2 {9 Y2 a% F7 I: w
DWORD Magic2; // 0x4B4E554A "JUNK"2 W3 C* t8 ^5 p7 h; s) O3 {4 f; U
DWORD PackageVersion; // 0x00000200 包版本- N( b2 ?5 p: l6 }4 s' k/ p2 O
DWORD GameVersion; //游戏版本. Q0 B& \2 G' d
BYTE Priority; //优先级' s A" j) U8 Z2 K3 s- x4 V
BYTE CD;$ `" J; T$ \9 L5 o
bool MasterIndex;$ U) T$ e/ x, N. U- y
__time32_t CreationTime;; e2 n1 ^' d" R2 A5 m3 I9 B
char Desc[100]; //包描述4 N& @" i' T$ T/ ^+ c* k. D/ K- m: q
DWORD NumDirs; //目录数( |, N Z1 [$ W4 w
} PackageHeader;
& M/ ?, F( w% c7 Q
if (PackageHeader.PackageVersion >=0x200), `9 D& U' {6 o) B
DWORD DirOffset //目录偏移量
' Y5 V* t7 \0 h: e1 e7 }" K
struct Dir{
$ L7 s0 _6 \3 _) d# ^/ G" p: C' n9 s! C
BYTE NameLength;& b# Q) }- G% S2 H
char Name [NameLength]; //文件名- K" M( |9 k8 f( k1 S+ p/ l7 P% c: i5 Y
BYTE CD;5 @8 g$ H# [; d; b6 t2 U* M; I
DWORD NumEntries;//文件数
' T: w: ]- V) N0 E/ a) P
struct Entry{
j, F9 T0 Z' O- C& ]
BYTE NameLength;
2 P9 G* M) K" ~1 |& M
char Name [NameLength];
) f2 H \+ o6 H
DWORD Offset; //文件位置2 `& ?/ @# \6 I* N# y6 @3 l
DWORD Length;//文件大小
9 a: ~ q9 v' e1 l- v
DWORD CompLength;//压缩大小
* ~5 _6 ?; m0 \# ]
DWORD Flags;
* B ~4 L. Z6 S) J
if (PackageHeader.PackageVersion >=0x200)
: b# Y) u# i+ A6 V- G
{ DWORD TimeDate1
& a( T! \ Z) ~$ p& t
DWORD TimeDate2 // not used
) u1 i# C4 y8 I# p7 t6 T- y# q
}. d1 S4 f3 S( X% A, l6 w( z
} Entries[NumEntries];& ]; o- [9 b H$ N
} 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
/ Y6 `4 M1 ~+ u* [# g
DWORD version; //当前版本为0102) q: N* M0 n0 h ? I7 l* D
DWORD code_start ;//代码地址$ ?! l( h7 I$ I* m
DWORD function_table_start; //函数表地址
: T9 }- p3 b% f9 }9 j4 ?& W' m
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移
2 v* }6 x' j4 X* z: Y: F: a' [
DWORD event_table_start; //函数表地址- W* K) T: S& J n$ {3 W% ]
if (verson >=0x0101)/ `: O0 J" i1 K( u% g, p: Y2 i
DWORD dll_table_start;
- X, p# Z" X! Q( c
if (verson >=0x0102)
& [0 x4 B+ h; h) h7 @
DWORD method_table_start;
" @' ?* K2 y! L7 I
string source_name; //0结尾字符串
. _& t! T4 Y3 y4 ^7 g+ j
byte[] code; //代码的字节码
. U( d1 e, q0 u) K5 \7 i
# H+ q# q% d: y- n4 {- E
struct {
" j8 c+ E! N; D
int num;
7 Q P8 u& Z1 t. ~3 ?) H; e, K
struct {8 L; D5 Q; V' G& T) k5 c; e
int pos;
( X0 P& G7 T/ C4 p/ U3 T6 `8 K
string name;- [, l0 F: l9 Y2 D; B
} function[num];
- e6 p. p0 e. ]6 M2 ]
} function_table ;
2 i$ A- u# O! p! ]4 g
struct {! h {# \% Q% y @- `2 N- d& n4 @
int num; k/ b# W7 U% w4 _
struct {, ^( d5 ?0 D# j: t+ t6 |. i
int id;1 h' T5 [( e5 n7 x A2 u) b
string name;
: W% L0 M; ]2 o7 P
} string [num];; W1 O8 Y: E- |6 L% N
} string_table;- s3 X5 x5 Z5 [2 f: T D* t9 L
struct {
0 @& f" V1 {$ l5 T
int num;
% e: x. u; Y% G5 z/ T/ u5 S
struct {. h; @' J6 G, N7 C0 ^- e* t$ l
int id;# V: z' z! D3 {, Z. I6 g
string name;7 C; H0 T7 g* D
} event [num];
0 [. |: E( o3 s- c
" a ?5 q& {+ l7 m
} event_table;
; S3 v/ U; G8 R
if (version >=0x0101)
' s5 D% H: X4 n' q2 C
struct {
" ?+ f$ g$ w: ?) k4 a
int num;" U4 h2 p% U9 ^9 n: c9 b
struct {
- U1 v; u/ G B5 m% m) K
string dll;
; I. s* m+ h# |* F) s: L% s3 l
string name;
. j, Q* J. E0 Z6 u; K& ~
int call;
; S ~. ^' B* l" r: o
int returns;, [0 ^+ d$ d9 ~' D( A( H# ^4 L Z
int num_params;9 G* T3 T1 i7 a- Y3 n1 A: l1 z
int params[num_params];2 O7 B! I Q) c( S& W
} dll [num];
# P! ~6 {0 ^+ B5 v" o# Y1 P/ {3 A5 A# n
( x, G. D. L0 C5 R1 k
} dll_table;# C! b/ z, m0 V# V5 c
if (version >=0x0102)
+ a; O6 U1 e) q) {, B3 y- ?
struct {
. { B, K3 P- g0 @- ]% \+ T. _
int num;
- J3 O: m' d% Q, j3 Z
struct {$ }; `2 @ t' a: ~
int pos;; h: R; `, e' ~# E4 ^
string name;
; x7 H" q! ^) u6 R
} method [num]; 2 ]6 }: r& w' ~4 M k
} method table;
" M) ?+ B" ^) I W2 _+ I% T. G Z
, C* v9 p4 A' F

复制代码

音频：
游戏音频格式是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字库。* a2 L5 D; y+ D1 R2 v
不能简单用黑体.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 汉化教程

楼主热贴

社区热点