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{" [ s) m- F: N1 U( _ i! w: ]
DWORD Magic1; // 0xDEC0ADDE DEADCODE
. h/ x1 }0 P: [* T4 ^
DWORD Magic2; // 0x4B4E554A "JUNK"4 x, O# V9 G, U. m) [& a. h
DWORD PackageVersion; // 0x00000200 包版本
. w+ v' ?9 d& r, w- {4 e; p
DWORD GameVersion; //游戏版本6 _, w5 ^/ C3 B# h# w& _
BYTE Priority; //优先级
/ n1 L( M0 L1 H; B" }% g" Z' g
BYTE CD;
; q* l( z" E. B" m# z* \2 ]
bool MasterIndex; X( ~. Z$ g1 ?% ^
__time32_t CreationTime;7 G- i3 w( ?! K- D
char Desc[100]; //包描述
4 P* R- S. k# ]5 j( m5 I
DWORD NumDirs; //目录数
4 ]6 ~9 C. _# K5 T4 Q
} PackageHeader;
) L4 g) ?! j7 r: c) }
if (PackageHeader.PackageVersion >=0x200)9 L" z) X7 f7 A4 G
DWORD DirOffset //目录偏移量
" ~* m- S3 u; Z
struct Dir{
* {# B" {4 t( [
BYTE NameLength;& w) K) \* o& E9 L( M R' L; K
char Name [NameLength]; //文件名
' r( Q) X8 R; z1 r$ \% ?5 e% ]2 `! b
BYTE CD;
9 u" x) k* \7 b
DWORD NumEntries;//文件数' O3 z. V' A9 L8 i& L3 b
struct Entry{& j# B' {1 o# d- V$ m, h, N
BYTE NameLength;
- Q# c3 J5 Y9 r
char Name [NameLength];
+ V# g5 W4 r3 P) c' d
DWORD Offset; //文件位置" j4 o* m+ Z7 {) c1 a2 Y
DWORD Length;//文件大小
+ w( V) }- W% _
DWORD CompLength;//压缩大小4 d8 b. p+ q) G F
DWORD Flags;
4 ~0 ?& D9 u; ]" H" E0 f0 p
if (PackageHeader.PackageVersion >=0x200)/ Y% e& @" }; H
{ DWORD TimeDate1
* d1 E- N$ R/ n' W
DWORD TimeDate2 // not used
3 n8 O( M+ t- X7 g- p
}
* ]" S9 ~, D J9 y
} Entries[NumEntries];" Q2 K0 X, |+ x k. ~, b
} 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
i9 | r: Q5 F0 c
DWORD version; //当前版本为0102
; M9 f/ t4 ~2 {$ [
DWORD code_start ;//代码地址$ \/ R/ c( d) W: K' ~" `
DWORD function_table_start; //函数表地址
: \7 Q' t1 [* ^3 x/ l& o+ H
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移
9 t1 J& D d$ e% j7 B% z) b
DWORD event_table_start; //函数表地址; f( R" c' L0 K; V( u7 A. {- y
if (verson >=0x0101)
$ D: T; d* F6 L+ d c
DWORD dll_table_start;
! e7 L% p9 R' _+ e$ v
if (verson >=0x0102)
9 I- M# q$ @( H: J0 E8 n2 i% n
DWORD method_table_start;
O* q+ `5 `0 s2 F# _2 z0 X9 j2 f
string source_name; //0结尾字符串
: |( F( A( ` T% I+ }
byte[] code; //代码的字节码9 E1 w* m3 I3 |5 c9 a+ |
$ I- @, e% F, G
struct {
! p) K3 L: X8 S4 Y) Q4 p
int num;# m# D" b. {$ ~" @& ~
struct {6 r) A5 V$ B& z* S& s& m( Q. Y1 A
int pos;: g+ N6 @7 k! R' o7 i5 x- E8 ^4 W
string name;; @1 R* ?2 K+ ^
} function[num];) i" Z0 [. {# x& o4 @0 o
} function_table ;7 T" L' B, o3 b L4 \( V
struct {
7 X0 K* s% S% ` j. N# `
int num;, Q( `7 d. v3 _% ]$ {
struct {
- ^; Y# R$ A7 g/ M
int id;
7 V2 P5 }+ T% R1 |2 ]
string name;
3 H" d; W/ W y4 l
} string [num];
. M* [# b4 p( Y
} string_table;# I- y: \; ~: `: K8 t
struct {) z3 E+ M O0 ~6 \! u6 @$ W
int num;
1 w- p' `7 [* s+ z
struct {0 C( |5 E/ Z/ S
int id;$ K, [/ I2 b4 C% ~( ^# f- ~" s
string name;
! Q: g/ v1 R8 [5 g1 I
} event [num];: a- R* n& H) L
4 b1 X1 H. w. ^0 D3 W! C7 t
} event_table; M* e, @/ x9 k* r* W2 q- O* x
if (version >=0x0101), r6 T2 T) v3 |8 v; N
struct {
' p9 `+ f: ~1 Q/ R0 G( a7 x; @0 N
int num;. v, }4 T( p! `
struct {
" P, R$ E; B, C! H& Q
string dll;
0 @( S0 }# q( e) G
string name;
& c% U4 m( V1 Y; E7 L1 a5 H7 t
int call;
4 _) C& ~; Q6 y( H3 ^
int returns;: z) d, S3 q' \0 m* b: q
int num_params;% h6 H0 c4 b, @. [
int params[num_params];
8 Z) a; t8 Q3 p" P+ i/ e- z
} dll [num];
4 U- Z; y- t" _' n; Z+ W0 M/ l
4 A' X! y5 l2 |+ x4 ~) v
} dll_table;3 d" E) `; @2 B9 s( y( H
if (version >=0x0102)8 |4 c) ?" X: ~4 [) g! {' B/ S& `* }
struct {. ?1 L; G4 ^6 p- g$ n. d
int num;& U# m8 |3 u2 C, a' Q% i
struct {( k0 {3 A2 @8 N! J, n% m
int pos;
t& {% R' W* m% j6 q( Y+ i6 z1 Y! X
string name;
1 g+ A) u; C# O8 s; t1 \& e
} method [num];
: a' f4 k: o4 _
} method table;0 ~( x) d% n& ~# V5 i( q" k" p' G
+ f, w( H4 r5 B5 i; \. h

复制代码

音频：
游戏音频格式是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字库。2 J. V8 s( |; V$ r& [
不能简单用黑体.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 汉化教程

楼主热贴

社区热点