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 Y5 I) ^, j5 `; @ b
DWORD Magic1; // 0xDEC0ADDE DEADCODE. ]2 ]; C; y6 p4 I3 H
DWORD Magic2; // 0x4B4E554A "JUNK": `$ S$ J8 y5 R
DWORD PackageVersion; // 0x00000200 包版本
) o6 ^- ]$ t: m% V+ [
DWORD GameVersion; //游戏版本
& P3 I# H( a0 N; }3 U) [) V+ `- L
BYTE Priority; //优先级5 F( U% x7 [8 M
BYTE CD;
* R# B; I5 M1 z. R. B
bool MasterIndex;
7 W4 G4 |# H9 [! v$ Z6 q e: ^
__time32_t CreationTime;+ W% }# A! _* L: i3 U
char Desc[100]; //包描述* ~4 m. \4 G1 M: t% L0 V! O( w' ^
DWORD NumDirs; //目录数# S$ E6 h* P& l$ _
} PackageHeader;
2 S0 c5 n) j6 b
if (PackageHeader.PackageVersion >=0x200)$ {7 h7 f5 j7 E2 R: E
DWORD DirOffset //目录偏移量, e5 g2 B7 t0 q6 M5 g
struct Dir{
3 D, r2 ?& s# P$ f1 M# h
BYTE NameLength;
. U2 v" e6 B, F' t5 o: \
char Name [NameLength]; //文件名8 L1 J4 e/ O2 i; Y
BYTE CD;
+ q, T+ N4 A# b8 B! p/ Q7 w
DWORD NumEntries;//文件数, H& |# ^( n+ S! W
struct Entry{; e& ]4 K4 D; Z$ ^
BYTE NameLength;7 J) `8 D, Y: \$ w2 {
char Name [NameLength];: y6 l: V- I# s
DWORD Offset; //文件位置
/ b/ L, s, V, i y5 t, H1 S
DWORD Length;//文件大小$ |5 s/ r$ a' M! `% W2 e( s8 a; Y7 P
DWORD CompLength;//压缩大小
# X" n. O T/ p) C
DWORD Flags;
( b3 N6 c7 H! E% f8 d. o
if (PackageHeader.PackageVersion >=0x200)
& c0 |7 Y% t/ d! t# w
{ DWORD TimeDate1
5 `+ |, S! L# \# ^$ B/ B
DWORD TimeDate2 // not used5 ?: X( c' ]" x. `! ]
}+ s- m8 h" y) s+ U* L( q
} Entries[NumEntries];. c# G- V$ q, l w; a9 i7 Y4 e: X) ]
} 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- G* ?5 a8 i. j$ E0 Y) s+ U d% J2 b
DWORD version; //当前版本为0102
0 b2 p' ?7 F1 T4 B( v9 f6 n2 y
DWORD code_start ;//代码地址
. `1 K$ v& c$ r, x7 G, V6 v
DWORD function_table_start; //函数表地址7 y/ F. ^3 B4 e5 N$ q/ t
DWORD string_table_start; //字符串表地址，修改字符串表后需要更新后面的偏移
2 U" \" ]$ U/ ~' q1 p( ^
DWORD event_table_start; //函数表地址
9 u& S+ t1 B; D, S4 r
if (verson >=0x0101)! q$ D( W" ]5 z2 i2 N
DWORD dll_table_start;
# y- q$ U- [2 J1 h7 u+ G+ U
if (verson >=0x0102), Z+ g, l- }5 ]: D, @
DWORD method_table_start;
3 F) Z$ S, N2 B) E: F! Q# V% ? G
string source_name; //0结尾字符串' W& i& @/ @- X: {( f
byte[] code; //代码的字节码: X2 x6 V" Y1 w. I2 s" O5 }0 k
0 b4 H; L; u% d c. L9 y
struct {* o2 M+ S }" O, D/ w) g5 B& x
int num;
6 J: W Q% U9 M
struct {
: C4 D9 n6 x) {& c8 E" H# x
int pos;$ t1 ~ a. w# b' S+ U, D) B
string name;# ]# p6 L( L4 V! Q
} function[num];
$ k3 g2 b; y2 n2 b. S7 x0 f
} function_table ;
% i# r5 I& ]6 l/ A
struct {
6 k2 m( e7 Y4 x* L( J9 b
int num;
# @/ v1 ~6 A' R& T) a# o6 s. |
struct {( E4 ?' j" ?( k0 g5 N+ F6 E4 k
int id;
' ^. z1 s/ V, A
string name;, P. r2 c4 ? a1 }1 P5 @
} string [num];( C9 m0 h3 s, o' U+ A# u- [
} string_table;: F1 T" }0 A9 Z
struct {
& V: S2 v' U, Q2 B! Z4 ~: o( t
int num;7 F0 b0 @; h* h. p$ }
struct {/ v0 C+ q" M6 M) {- c7 f
int id;
! ] L! D2 o6 [' P% g
string name;# I8 e: T2 O- q5 v4 S2 B
} event [num];- H% k; G& i$ f
6 P& W- ^% ]9 l/ o3 ?% N
} event_table;
: a. _: a! L$ P# g ~
if (version >=0x0101)
' h: T5 `" v, z# [3 e! x# v: v
struct {
! f6 N1 `4 }! |. m- k+ l6 Y
int num;
& Z) w$ l4 U; p" g8 c
struct {# }3 t) O' i8 B5 l) A* z
string dll;! L6 {1 D$ u, H9 m
string name;. j2 o$ P" E# {9 y. G
int call;
, b, \+ i' p8 Z3 I
int returns;
- z; X1 u! _1 i
int num_params;: l6 b% t- K; S
int params[num_params];2 O9 V0 V9 Z7 C1 n+ ^8 P8 m
} dll [num]; & w9 _8 Q1 O& i4 ^3 D }/ S& w5 m& h9 l% [' x
- V0 F- D: v5 T# z8 Y6 X
} dll_table;
5 |8 h$ M4 A, q, |! u! U
if (version >=0x0102)
+ o) m# R7 @; |" T6 o
struct {1 Y4 l$ g! c5 s' U6 |( h6 P
int num; o" D6 `, b( D1 j' |8 d8 B2 p6 G
struct {9 P4 ?9 H7 b' r2 k- w0 u" `9 T3 [( l: Q
int pos;
9 X4 i1 f6 R0 [8 y. F) h3 t
string name;5 X5 F x R! b/ B% D$ \
} method [num]; , f8 y! N/ U- Q$ _3 [# p- T- E
} method table;/ V) V1 R" z1 e, J; h3 |
) w9 h. z. {: ~6 a" t9 ^9 `+ y! Z( V) G

复制代码

音频：
游戏音频格式是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字库。
$ t/ F; z Z# 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 汉化教程

楼主热贴

社区热点

浏览过的版块