WinterMute Engine 汉化教程

weiyun

  O4 Z$ C# K! f' K  NWinter Mute这个引擎是专门用来开发点击式冒险游戏的，下面我来讲一下这个引擎的汉化方法。
使用此引擎的游戏比较多，而且汉化非常容易，论坛之前有很多相关资料，但没有完整格式分析等
; u3 f0 V9 ?/ q4 |. h
以下是官方主页：http://dead-code.org/home/
注意本引擎是开源的，源码可以在这里查看：
" I! s. z7 J3 m# u- U! Ihttps://bitbucket.org/MnemonicWME/wme1/
& j7 r* o. ~  x- E  Y0 Q9 o
3 X# J2 P2 W( W. P* Q下面开始正文
7 p) t+ e5 Y0 j3 {1 Z) g
包格式
游戏的包格式为dcp格式，文件标志是0xDEC0ADDE也就是DEADCODE。

格式分析：

1. struct{
   . {% y( z- W5 Z
2.         DWORD Magic1; // 0xDEC0ADDE  DEADCODE
   ( t5 z# i. i! V8 I: q* y
3.         DWORD Magic2;  // 0x4B4E554A          "JUNK"
   ( U" b* E9 D0 y8 C
4.         DWORD PackageVersion; // 0x00000200 包版本
   1 P# k) Z$ o0 X8 m9 F
5.         DWORD GameVersion; //游戏版本
   
6.         BYTE Priority; //优先级
   
7.         BYTE CD;
   
8.         bool MasterIndex;
   
9.         __time32_t CreationTime;
   ; z3 _, Y( n) L' \  [
10.         char Desc[100]; //包描述
    
11.         DWORD NumDirs;  //目录数
    ; u2 f- H, {& v' x2 l. j/ X% r8 i
12. } PackageHeader;
    / |3 a9 U" O/ n' \( u8 {( b4 e5 ]7 Z
13. if (PackageHeader.PackageVersion >=0x200)
    ' r' k5 D  D% F1 Y7 b5 z
14. DWORD DirOffset //目录偏移量
    
15. struct Dir{
    : S" {  p5 Z0 x. N; U; L4 j
16. BYTE NameLength;
    
17.          char Name [NameLength];   //文件名
    9 a' G4 X) S( d3 z$ O9 I) f
18.          BYTE CD;
    
19.          DWORD NumEntries;//文件数
    
20.      struct Entry{
    6 T2 D9 J8 x8 m
21. BYTE NameLength;
    
22.        char Name [NameLength];
    ! n! b. T# w! P5 Q5 v3 K
23.        DWORD Offset; //文件位置
    
24.        DWORD Length;//文件大小
    
25.            DWORD CompLength;//压缩大小
    + F6 Y( j, i" T) M
26.        DWORD Flags;
    * Q$ T! u  U: t- Z3 d
27. if (PackageHeader.PackageVersion >=0x200)
    ; _# l; V" j" W& J* O! A5 E
28. {      DWORD TimeDate1
    
29.        DWORD TimeDate2        // not used
    : R1 |. e" D; r2 m1 Q) L
30. }
    3 w+ b: \& D3 E
31. } Entries[NumEntries];
    " U6 ?7 ]9 t" C. N0 C. r
32. }  Dirs[NumDirs];

复制代码

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

" o- c, |& c9 e. `打包：
可以不打包，打包工具可选UNPAKKE和引擎自带的工具。

文本：
! P$ n% F3 m3 [$ d语言表格式如下：
" ]( c& l8 ~% c5 oSYSENG0001        Game settings
SYSENG0002        Display
SYSENG0003        Sound
SYSENG0004        Use hardware acceleration
  D. U& x+ H( R$ cSYSENG0005        Display device:
2 |  V  S% u8 `. ]1 d6 aSYSENG0006        Colors:
3 U) j/ J" m5 nSYSENG0007        Run in window
# ]+ _4 M$ \: K" a- y, f& K语言表可以互相引用
SYSENG0001        Game settings
+ Z; x0 W/ ~) w  X8 j9 P- z8 x% FSYSENG0008        /SYSENG0001/
甚至能支持阿拉伯语等从右向左的语言，只要文本里加上这个标记就行
# ]% Y4 l/ e; O6 \2 H$ ]@right-to-left
语言表一般为String.xls，这是csv文件，而不是真正的xls格式，直接翻译即可，注意编码选择可选简体中文（GBK编码，非中文系统将无法显示），和utf8编码，注意如果文本编码有BOM将自动切换为UTF8格式。

字库：
: G, v' P6 m2 w% E游戏支持两种字库，图片字库和ttf字库，注意只有ttf字库支持中文。
字库都需要描述文件，因为图片字库不支持中文，所以此处略过，有需要请看官网。
" f, y; ?; c5 k* n, Yhttp://docs.dead-code.org/wme/inside_ui_fonts_bitmap.html
要注意的是ttf字库是不能打包的。
TTF格式字库的描述文件：
+ k+ w/ n& ?3 w: {TTFONT
5 a1 x; p" z3 j4 f! ]{
  SIZE = 12  
; }2 q1 _* u1 ^* g, u- Z8 L  FACE = "Arial"
  FILENAME = "fonts\arial.ttf"
1 Y8 H) F/ c/ o( j6 J5 b  I
) ^; P- F! \; f! R  BOLD = TRUE
  ITALIC = FALSE
  UNDERLINE = FALSE
  STRIKE = FALSE

  CHARSET = 1

0 `2 x7 S4 H* p1 P  COLOR { 255, 0, 0 }
" h: |% j* F  E+ Y' D  ALPHA = 255
  LAYER
0 I9 x+ z- D+ m  {
& a% D# Q) c* q4 h! V    OFFSET_X = 1
    OFFSET_Y = 1
7 S$ T- \" ?# y  D    COLOR { 0, 0, 0 }
5 |6 ]) z/ Z; m5 q7 U% A    ALPHA = 255
  }
2 l; u. Z: I. c7 N: S, |2 B
  LAYER
  {
" }0 ~9 Z0 G3 U2 D    OFFSET_X = -1
    OFFSET_Y = -1
, g/ _5 O1 r8 B; h    COLOR { 0, 0, 0 }
) i; f: \% B: l3 p" G2 }; M    ALPHA = 255
  }
4 @$ u) `, `5 ~+ z2 _
  LAYER
  {
2 u/ A; Y4 @, u! D1 n" b9 F/ n    OFFSET_X = -1
' ?( r' P& o1 b3 L    OFFSET_Y = 1
8 T4 I( G- T$ W    COLOR { 0, 0, 0 }
: j3 d1 @* R, A$ U5 i    ALPHA = 255
5 K4 U+ Q1 R1 z% }3 j, A  }

. J# F1 I' c9 v/ @. t! V  LAYER
& F' k+ }4 N7 a! Y# A* a  {
    OFFSET_X = 1
    OFFSET_Y = -1
    COLOR { 0, 0, 0 }
    ALPHA = 255
  }
7 m: ]' D5 e$ s/ h8 q) P
  LAYER
/ ?9 f3 l5 ]0 M  o8 E! w: M* R  {
    OFFSET_X = 0
' L2 c6 u* p+ K& `, U; c% Y    OFFSET_Y = 0
( f( j1 `6 @$ C" {    COLOR { 255, 0, 0 }
    ALPHA = 255
6 u. W+ T6 \$ q1 S% O  }
}
. W+ h, e5 f% X! B9 m( L" T+ ~( {各参数说明
•        SIZE – 字库的大小，一般根据英文来选择。
7 r- z/ Q# j+ {" [•        FACE – 字库的名称，注意是显示名称，比如系统自带宋体SimSun 。建议不要写中文，容易出现问题。
•        FILENAME – 字体文件名称，就是ttf的文件名，如果要直接使用系统自带字库可以留空。
* H+ r/ B) L. a  c0 m6 A# \•        BOLD – 为TRUE则以粗体显示。
•        ITALIC -为TRUE则以斜体显示。
•        UNDERLINE -为TRUE则显示下划线。
5 y" H' d- `/ R+ N1 R! N1 Z•        STRIKE -为TRUE则显示删除线。
•        CHARSET – 字符集，简体中文要选6，繁体要选4.
5 C' G2 n' K/ Q) W•        COLOR – 文字颜色(RGB)显示
•        ALPHA – 透明度， (0 到 255)，一般选255.
" `$ e) \- g  ]; @+ `7 L注意这个定义文件下面的Layer就是按层绘制，可以实现模拟的描边效果，就是左移，右移，上移，下移1像素各绘制一次，颜色不同。如果不需要描边效果只需要1曾就够了。
8 ?7 a9 j, m7 F& F4 u
以下是字符集，注意和windows的GDI中LOGFONT的值是一样的，游戏本身也是用GDI处理文本绘制的。
详细内容请看MSDN
http://msdn.microsoft.com/en-us/library/windows/desktop/dd145037(v=vs.85).aspx
WME 字符集编号        解释
3 V4 Z% s3 e( T1 I! S0        ANSI 字符集（注意这是英文字符集）
& s- d6 E1 }9 s- A# i" i5 ^4 V+ p1 }1        默认字符集，根据系统语言变化。
9 ~8 ^  H  A2 `, _+ _: O2        OEM 字符集，根据系统变化。
3        波罗的海。
4        繁体中文。
5        中欧及东欧语言。
6        简体中文。
7        希腊语。
8        韩语（Wansung）。
, v. }; z. J! h6 s. w1 a9        Mac字符。
+ y6 o: S- w# C# {10        西里尔字符（俄文）。
11        日文 shift-jis 字符。
$ H) R( Q  [  m12        标准符号集。
13        土耳其语。
14        越南语。
15        韩语(Johab) 。
16        阿拉伯语。
17        希伯来语。
18        泰语。
  n2 H2 A/ g- Z5 ^
& O$ R( u4 J9 e: E( C图片：
' b% n1 x  h8 S9 k本游戏图片格式为PNG，直接处理即可。
9 Z& D4 P) U5 O+ y# j
脚本：
. c# f( `6 @2 |* Q7 ^一般不需修改，除非遇到文本保存在脚本中。

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

1. DWORD magic; //DEADC0DE
   
2. DWORD version; //当前版本为0102
   
3. DWORD code_start ;//代码地址
   
4. DWORD function_table_start; //函数表地址
   ! V2 P- [) C( J
5. DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移
   7 ~" L2 D  z% X( ?4 n+ o4 Y
6. DWORD event_table_start; //函数表地址
   + m2 L% v- }  Y; r7 U1 ]
7. if (verson >=0x0101)
   
8. DWORD dll_table_start;
   ! v9 f$ {6 F/ L2 r9 l- M9 i
9. if (verson >=0x0102)
     r! m, f8 j% T& _8 A
10. DWORD method_table_start;
    
11. string source_name; //0结尾字符串
    , y+ b! d# y% H
12. byte[]  code; //代码的字节码
    
13. 
    " P# g! R2 r5 Z, a7 n1 R$ N
14. struct {
      n; n# N) T3 f5 _
15. int num;
    
16. struct {
    
17. int pos;
    + o% a5 L, r0 y
18. string name;
    
19. } function[num];
    
20. }  function_table ;
    
21. struct {
    
22. int num;
    0 @. `$ }6 a! }, L7 o, C
23. struct {
    
24. int id;
    / W5 A2 q+ W1 \9 ]% v& w
25. string name;
    
26. } string [num];
    $ B- I. n. F0 O% C+ j6 ?& I6 G
27. }   string_table;
    
28. struct {
    
29. int num;
    2 b" U8 J0 U% ^' r5 \, w
30. struct {
    
31. int id;
    3 g3 U1 q' Y# U4 J- i6 {
32. string name;
    
33. } event [num];
    ; P+ P+ y; J6 _- U+ `2 m
34. 
    
35. }   event_table;
    
36. if (version >=0x0101)
    
37. struct {
    
38. int num;
    / X6 M7 b: [% \% z
39. struct {
    5 e2 M) \# \2 v9 I8 z, S
40. string dll;
    3 `& J+ s$ P) R( x- h
41. string name;
    
42. int call;
    ( P) S; P; w0 b; A3 c: J# {
43. int returns;
    - J- ~2 O+ Z  A# T1 k* _! U
44. int num_params;
    
45. int params[num_params];
    
46. } dll [num];
    4 @4 n, D/ _8 m" S% P2 t
47. 
    
48. } dll_table;
    ' E" }8 b* I* Z' M& p1 f9 H
49. if (version >=0x0102)
    
50. struct {
    5 z6 p$ O% H5 Y) Y) M) @6 g
51. int num;
    5 {: ?7 R  ?, p8 L- g
52. struct {
    
53. int pos;
      A- |4 V0 K/ `  f
54. string name;
    " x# P4 d% H4 o0 N" V
55. } method [num];
    * P* W. o+ ?( s7 Z( Y6 p
56. }  method table;
    
57. 
    

复制代码

音频：
- R6 F; m3 Q) o1 |% A$ R2 Y: p! c游戏音频格式是Ogg格式，Vorbis编码。
9 \+ a) N, @& r
8 W1 m$ o( W9 P( x$ k# {. X7 \" @  p视频：
游戏视频是ogv格式，theora编码。

# G- T( Y4 f6 D7 x7 I# E/ w汉化流程：
- R6 N) {6 \4 k" |6 {# x( I1.        如果有dcp包，先解包
, O* W: n( I+ F2.        翻译字符串表
! Z8 B+ {4 k  d( P; d3.        找到中文ttf字库放入游戏目录，并修改定义文件为ttf的定义，参数根据需要调整
4.        修改图片
) V6 H8 M0 R. O7 o# m% ]5.        改过的文件放到目录，或者打包
6.        测试

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

XYZ

感谢分享！沙发支持！

davidgbl

1 q7 p6 D1 F: x  ]& G4 m5 V" c; t
太好了 好好学习学习。avg用这个引擎开发的游戏很多。
, l5 ?, J% m1 t3 h; L不过遇到过一些问题，主要是一些动词在汉化文本中没有。比用use XXX with XXX
) {5 g: T3 k2 j9 @# v3 R& ?" U0 P其中的XXX在翻译文本中是有的，但那些动词不知道藏在什么地方了。始终没有找到。
- P+ K0 R- |/ T) E- ?+ @% o+ s比如之前汉化的：409号黑夜童话，有这个问题
/ }4 F7 t  i3 ^8 t' h（另外328号埃德娜&哈维：逃离疯人院也有类似问题，但我不记得是不是wme的游戏了，我几个应该是，老啦，呵呵呵）。
还有一点可能需要注意：
就是使用ttf的字库要用ttf字库的内部名称，尤其是中文的ttf字库。
不能简单用黑体.ttf啥的，最好用字库查看软件看一下字库的内部名称和字库名是否一致。

巴厘岛之夏

牛贴必顶，强人必赞

setsail615

" ]8 Y, }3 ~; X
不明觉厉啊~膜拜楼主~~
PS 友谊哥，328好像不是wme的，我也不太清楚……

seasonmonster

嗯，很详细，值得学习

myq495

支持楼主的处女贴

leahlee

不明觉厉。。。:D

欧兰妮

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

慕言思语

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