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{
7 l+ |4 s. ^" ^& Z! @/ y# ^
DWORD Magic1; // 0xDEC0ADDE DEADCODE- {& ?3 s! B0 V0 q- J
DWORD Magic2; // 0x4B4E554A "JUNK"- X' t9 F& C0 Z" ~1 K# F2 l( h7 {
DWORD PackageVersion; // 0x00000200 包版本: @& k9 }. S7 B
DWORD GameVersion; //游戏版本
% I0 E5 ~6 q. S9 ]7 ~. H: u9 A; ]/ Z
BYTE Priority; //优先级) W) i b9 n/ z4 y
BYTE CD;2 R; N7 v' R" S& _2 N' C# O- h/ x5 R5 C
bool MasterIndex;
3 l" d0 ~) K2 m) Y5 j
__time32_t CreationTime;0 g7 A ~& I4 h
char Desc[100]; //包描述5 `( ?6 ^2 E: h" L
DWORD NumDirs; //目录数
: Y9 ~: i" P$ r7 @
} PackageHeader;3 a2 F1 N- F- u5 V
if (PackageHeader.PackageVersion >=0x200)* } m. V0 ]# A0 } [
DWORD DirOffset //目录偏移量
7 F0 A: M! V9 A
struct Dir{- | B1 X, I" `! x
BYTE NameLength;
; w6 J R) T$ P) x
char Name [NameLength]; //文件名
, m" H4 @* M @5 T$ U
BYTE CD;1 c# V; C$ k; U
DWORD NumEntries;//文件数
8 w/ D, ]5 p+ m2 ~9 `& r3 b
struct Entry{3 z- G2 V3 W2 G% m8 f
BYTE NameLength;
) U! a1 [3 s$ h
char Name [NameLength];
" i }$ n, o, i
DWORD Offset; //文件位置
5 U. d$ c! p1 K( ~4 T
DWORD Length;//文件大小
* q: V1 n1 i( d) N" G
DWORD CompLength;//压缩大小1 e" I$ q2 v; D _1 n5 M# Y1 l
DWORD Flags;
" G$ p1 T- J3 `0 t$ r C
if (PackageHeader.PackageVersion >=0x200)6 i0 |0 x. s) k$ p9 J4 O' g
{ DWORD TimeDate1
V- Y8 m7 K+ `* o. ^3 X% E
DWORD TimeDate2 // not used
/ s$ I, n$ F% R) S$ r1 m1 U
}# l% t6 W& b/ p/ c# y$ P
} Entries[NumEntries];
6 ?& U+ T9 c7 k
} 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; //DEADC0DE5 ^4 R# x, f2 Z4 {0 d
DWORD version; //当前版本为01023 b9 ?! P0 t1 r9 a( a
DWORD code_start ;//代码地址* g) X# C+ i+ d8 X& O
DWORD function_table_start; //函数表地址; h( Q8 _! D8 Z
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移
4 o4 T x/ N0 C7 f( O- j. _
DWORD event_table_start; //函数表地址
# N6 U9 h& @ {/ W s
if (verson >=0x0101)
$ {0 B: H& v1 ^9 g3 _- f$ \: r
DWORD dll_table_start;
$ v1 ~: E$ P4 j; j2 i. n
if (verson >=0x0102)
4 k0 W# {% n) \& s, a2 U
DWORD method_table_start;
9 p* H! [; q" S, O. b. ], }6 H
string source_name; //0结尾字符串: ~& U2 g+ K( v+ }3 V) L4 I% x
byte[] code; //代码的字节码9 y0 D0 _/ W/ A$ J1 s* Q% W# b. D
: z$ l3 X% b e8 k
struct {
0 o+ t B& ^9 \( o- K% M
int num; [, x; Q/ g5 ~: q5 X7 W: |
struct {/ m' G- W" Y! }0 f( e8 ]
int pos;
" {0 g' d: F* M. b# G7 k- a
string name;
6 S# D& U; k- O- b+ S2 h. q: l
} function[num];& q/ n4 r0 I" |! N q% U& p+ A
} function_table ;: j, R9 o0 y: C1 e( o0 X1 E
struct {" @* w! z, b# ^5 u
int num;
$ n. A0 G9 u2 _. L
struct {
7 q7 G0 P: B6 ] p6 C
int id;6 t$ N7 } P' I
string name;
4 B2 {: ]0 ]4 X4 Z, L) C9 y7 g
} string [num];
& Z; z( |0 `) t" R, J
} string_table;) v# i, K/ U x/ |$ w! x
struct {
2 ?- D7 Q: B. Q
int num;
: D' N/ t0 F" Y+ q
struct {
5 M. Y8 b" G6 M6 |) ]
int id;/ i2 I% Y4 J# d, Q' C1 S* v
string name;! @8 H* h) U) |. U
} event [num];3 S, [* U' }* O" l- a7 S
( x6 b: H/ t6 @5 V+ y3 _* Z) I
} event_table;
' I7 N$ \. r2 z5 @$ M! W
if (version >=0x0101)1 _: T- J, k8 J2 u& x, M
struct {
( x4 e) y; b' ^2 {3 r2 \$ ~( m
int num;2 [! O4 K: Q. K( e5 g8 c F& o
struct {/ Q2 `6 r! ?/ V" q5 X: d- R
string dll;
" }* L3 v- g- r O& {
string name;
2 x+ }1 \1 ~% `: B3 O) r
int call;
2 D7 k* t% w0 [) W {
int returns;
. \5 l1 S! k$ e
int num_params;$ m9 C# i' L8 H& c6 \% }6 o/ n
int params[num_params];, [* ^4 A* z6 K( R0 P2 E- `
} dll [num]; 6 ~( h7 k. g' L( w3 h& e' s9 ]. J
* l3 O# m- M5 [
} dll_table;. {0 R6 [6 p6 x9 d- r T) U# i
if (version >=0x0102)
, N; J$ J) X6 w" @3 z& E' M$ }
struct {
~: w3 y7 u. }
int num;9 r$ Y, u3 h- T0 M
struct {
% u5 W. Q' }6 J( t% \1 z
int pos;' q4 ^( x( B: B% u9 b
string name;% H* d- f; U+ [
} method [num]; : b! V# P4 P0 H% e1 l8 n$ R
} method table;0 t$ A) N4 u. u& h8 R$ F: b0 z* N
) T; ]7 ? m+ K$ V- c

复制代码

音频：
游戏音频格式是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字库。
" o" B1 W4 t: ?不能简单用黑体.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 汉化教程

楼主热贴

社区热点

浏览过的版块