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{- W+ u" J: L" t% C
DWORD Magic1; // 0xDEC0ADDE DEADCODE
a# C, y0 k9 r
DWORD Magic2; // 0x4B4E554A "JUNK"4 z4 ?& x( b! J+ N% q C
DWORD PackageVersion; // 0x00000200 包版本! |( U" h# ?" B
DWORD GameVersion; //游戏版本0 D- b' r$ D7 s: F6 z8 i
BYTE Priority; //优先级7 C( C& ~0 ` B7 ~3 c0 O& |
BYTE CD;# V5 t T( E# B
bool MasterIndex;9 W- h- |+ O* e* ~
__time32_t CreationTime;
6 r+ ?' ^' Y. K; {! G' P
char Desc[100]; //包描述
& b6 u3 U" j8 @' H5 P
DWORD NumDirs; //目录数
8 C7 e# Z x9 N- h
} PackageHeader;
1 }4 N! h5 l I% j4 R
if (PackageHeader.PackageVersion >=0x200)
4 X3 ?. E2 @" l% ]4 M
DWORD DirOffset //目录偏移量' p' e4 x3 U4 [
struct Dir{) M4 P' v4 B8 x1 y& \( s) S
BYTE NameLength;
/ w8 E3 p$ ^5 ? d$ \* }
char Name [NameLength]; //文件名0 A4 c @! g, H3 p5 a
BYTE CD;
]& _/ \3 C# o d. L
DWORD NumEntries;//文件数+ g+ s. p0 @# u( p) {
struct Entry{1 `- N3 x0 |2 H* _ P9 Q, K
BYTE NameLength;
1 a. D) N' ?0 `' R7 P- s
char Name [NameLength];- U$ j2 g# M5 Q$ s3 N. D8 x; o& {8 t
DWORD Offset; //文件位置
W: D0 Q2 `* o+ x2 _% h5 i5 e5 @
DWORD Length;//文件大小* h/ v8 W2 _5 G/ c6 J
DWORD CompLength;//压缩大小
5 g4 X2 a- C% K" ~5 t8 K( c
DWORD Flags;
; P- i$ E y1 B1 I- b" {- T* |
if (PackageHeader.PackageVersion >=0x200)0 v7 E2 @1 r4 R% r
{ DWORD TimeDate1
" x6 K5 Z G6 y: [6 h% u" W
DWORD TimeDate2 // not used7 `* g% G& d1 X$ n5 _9 U
}
, x" {0 c# c, m ?; [# Z3 k6 e
} Entries[NumEntries];
( E0 V; e! K5 C; w5 q2 I0 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; //DEADC0DE
3 M+ B2 J& h: v) ?& v: V0 [6 t
DWORD version; //当前版本为01028 s4 [& R W# q
DWORD code_start ;//代码地址
9 f3 W/ v; X4 J
DWORD function_table_start; //函数表地址
* u: y/ ^. H; r# S8 m
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移
+ D' o% \1 J1 t" z, }
DWORD event_table_start; //函数表地址; ~3 w* H8 b. N. \, Q
if (verson >=0x0101)3 R+ G( Q( Z) v+ K' r/ W4 f
DWORD dll_table_start;
0 G8 W+ K5 W/ m6 ~$ N
if (verson >=0x0102)
% e* s6 O/ T' A/ W
DWORD method_table_start;$ z9 w) z# n1 Z/ d& {- I1 |
string source_name; //0结尾字符串& D- E' _- B: F: C i: G3 J* C
byte[] code; //代码的字节码
8 R% w2 s" R: l$ ]9 ~, L( T1 {
' E% Q' B9 ?0 U0 a9 Q# n3 U
struct {
; z) N! V( e. M
int num;3 Z8 N3 G8 Q/ S6 \5 Q# ^! p4 _5 M- \5 ^
struct {
+ Q' ]7 H, a& Q- d( u2 q
int pos;0 Z G: V u& V! {8 `6 v
string name;
9 x; s0 y: x" I; h, b* `
} function[num];
- M* \8 v1 o, D* M5 g/ ^
} function_table ;
. S+ i$ z$ h% S: c7 @5 t, A, y
struct {$ Z) q+ t" T6 C9 V/ q- l
int num;
7 Z# J! u. M$ w4 D: ?
struct {! ]- S: b% k! f8 F6 O
int id;
" t3 a7 x0 d: x" U! D$ Y+ t3 R
string name;
% Q4 h6 g% x+ F" c+ C
} string [num];
: v: ]7 z6 F# F. h0 [+ Z& \
} string_table;- d9 V& s- D3 i3 l
struct {* ?# ^9 i B d; N) \
int num;4 z. m( M) x) W, B7 E5 x1 |
struct {
& }# V& N. D& E- m0 O% m
int id;
9 ^$ L ^. q' z2 W$ a" V
string name;
& {' |2 d! C$ V, I+ k
} event [num];
/ `' J: W+ z( v. `) n. h' @2 y2 @7 w
+ l7 p7 M! n. a2 X+ k1 Q8 l
} event_table;
/ f) J- n" M( ^2 `9 }- i; G1 N
if (version >=0x0101), K7 i$ p6 u- G. F
struct { k# P( }2 y% q3 |0 @
int num;
: h( I9 a) O. t' W4 h" f0 t4 \
struct {
+ r5 v+ f+ C4 \, R
string dll;
" J6 c3 L& e" {* F; S+ k5 k
string name;
: ?/ W1 Y9 B V# z& @+ H/ ?
int call;$ u- c8 _# H% k( k4 A1 y
int returns;
! ]8 c# n# J( o: W+ y9 ^* J5 T. b
int num_params;) }, q- y E8 |
int params[num_params];
7 K/ V& t! P( I/ h$ F+ k
} dll [num]; 4 w1 A8 _8 F" i8 E* Q; U( i1 @- Y
1 q0 U4 ]+ M7 a! i- q3 a
} dll_table;
. Y; M T0 j, ]: p( A- |7 H
if (version >=0x0102)
3 g' O6 l* _5 l( S5 r/ c
struct {
: ~1 D4 s3 _, z) h3 @
int num;
/ g& t+ s7 }( O3 a4 D' U6 k Q
struct {9 f# F, ^% T" G* x! ~1 @: P
int pos;5 n! h2 [- |) l4 L/ l: z! o6 N
string name;
! _, j7 r# ?! A# z
} method [num];
; `. R8 l: p! G" h. b& o& f- d
} method table;
& U; }4 j" g/ X
1 V& `& K) w7 z1 f2 T

复制代码

音频：
游戏音频格式是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 Q" [3 h3 v* c
不能简单用黑体.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 汉化教程

楼主热贴

社区热点