4B9uDwRH

1Foreword:
2We (some of the German section and me) were reading YukiTsukis Guide, and didn't agree in all points with her, so I wrote another guide about adding maps.
3Maybe it will help someone.
4
5You need:
6- rsw, gnd, gat & bmp file of your map
7- Mapcache-Tool[link] //if you don't want to upload your gat files
8
9
10Step 1: General
11
12A map is no file you can just play around with and rename as often as you want.
13To rename a map you have to use a Hex-Editor.
14You search for the map name in the files and change it.
15There will be a more easily way later.
16
17RSW: contains the models and the positions on the map
18GND: contains the textures and their hight
19GAT: tells eA and the client where a player can walk/snipe
20
21Step 2: What is eA/client needing:
22
23eA needs:
24- map_cache.dat / gat-file+resnametable.txt
25- maps_athena.conf
26- Map_Index.txt
27
28client needs:
29- rsw, gnd, gat & bmp
30- mapnametable.txt
31- mp3nametable.txt
32- fogparametertable.txt
33- resnametable.txt
34
35Step 3: Map Cache / grf
36
37There are two possibilitys to add your maps to eA.
38I prefer the map-cache, because I only takes about 1,5mb of your space!
39
40Now is a god time to add your custom map to a grf!
41You can place them like this:
42
43CODE
44data\map.gat
45data\map.rsw
46data\map.gnd
47data\Texture\�����������̽�\map\map.bmp
48
49Map-Cache version:
50Unpack the mapcache archiv.
51Open the file: \tools\mapcache\grf-files.txt
52That is the same file, as you can find in the eA/conf/ folder.
53Put in your path to your grfs.
54Normally this are data.grf, sdata.grf and a custom.grf.
55In the last one you could have put your map.
56CODE
57//-----------------------------------------
58// GRF files
59//-----------------------------------------
60grf: C:\Program Files\Gravity\RO\custom.grf
61grf: C:\Program Files\Gravity\RO\data.grf
62grf: C:\Program Files\Gravity\RO\sdata.grf
63
64//-----------------------------------------
65// Data folder for unpacked maps:
66//-----------------------------------------
67
68data_dir: Data\
69Otherwise you can put your map files (gat,rsw,gnd) into the data folder: mapcache\data\...
70Open the following file: \db\map_index.txt
71Scroll down and put in your custom map like this:
72CODE
73map 1000
74anothermap
75onemoremap
76The first time you are adding a custom map you have to add a number behind your map!
77These number has to be higher than the number of the last map added by Gravity.
78As we all know Gravity is still adding maps, so we just use 1000.
79Start the mapcache.exe
80A cmd window opens, and you can see your maps getting "cached".
81If you have got a slow system this could take a while, but normaly it just takes about one minute.
82
83After this the map_cache.dat appears into the \db\ folder.
84
85Grf version:
86
87If you think mapcache is too complicated, you can put your gat, and your rsw file into a grf like this:
88
89CODE
90data\map.gat
91Step 4: eAthena
92
93Open your eAthena and open the following file: conf\maps_athena.conf
94Scroll down, and put you custom maps in like this:
95CODE
96map: map
97map: anothermap
98map: onemoremap
99
100If you didn't usw the mapcache you have to open the following file: conf\grf_files.txt, otherwise you skip this little step.
101Add your custom.grf (with the gat file[s]) to the grf list like this:
102CODE
103grf: C:\Program Files\Gravity\RO\sdata.grf
104grf: C:\Program Files\Gravity\RO\data.grf
105grf: C:\Program Files\Gravity\RO\custom.grf
106
107Now you open your \db\ folder.
108Copy the following files from your mapcache\db\ folder and paste them here:
109- map_index.txt
110- map_cache.dat 
111If you didn't create a map_cache you only have to add your map(s) into the map_index.txt like this:
112CODE
113map 1000
114anothermap
115onemoremap
116The first time you are adding a custom map you have to add a number behind your map!
117These number has to be higher than the number of the last map added by Gravity.
118As we all know Gravity is still adding maps, so we just use 1000.
119
120Step 5: Client
121
122Open your data folder you are distribuating to your users.
123(You can add it to your custom.grf later)
124
125
126mapnametable.txt
127Here you can add a name to your maps, which will be displayed ingame.
128(If there is no entry, the client shows default [no map name])
129
130CODE
131map.rsw#myfirstmap#
132anothermap.rsw#mysecondmap#
133onemoremap.rsw#mythirdmap#
134
135Remember what happens if you are in prontera and type "/where".
136This is where the description is set:
137CODE
138prontera.rsw#Prontera City, Capital of Rune Midgard#
139
140
141mp3nametable.txt 
142Here you can add music, which is stored into the \RO\BGM folder, to your map.
143If no music is set, the client plays default (= 01.mp3)
144
145CODE
146map.rsw#bgm\\31.mp3#
147anothermap.rsw#bgm\\10.mp3#
148onemoremap.rsw#bgm\\13.mp3#
149
150
151fogparametertable.txt
152If you want to add special fog to your map you can use this table. Otherwise skip this step.
153(Quote from YukiTsukis Guide)
154CODE
155map.rsw#
1560.23#
1570.9#
1580xffffffff#
1590.3#
160It goes something like:
161Distance
162Intencity (I think and maybe not in that order, Intencity means how quickly it gets to it's thinkest)
163Hex Colour (Use >>this<< color table and just add 0x in front of it) 
164last setting I think is alpha or in other words how thick the fog is.
165
166
167Duplicating Maps
168resnametable.txt
169In the resnametable you have got the posibility to duplicate your maps.
170This means with this you can also rename your maps.
171
172You can add maps like this:
173
174QUOTE
175copy.gat#original.gat#
176copy.rsw#original.rsw#
177copy.gnd#original.gnd#
178�����������̽�\map\copy.bmp#�����������̽�\map\original.bmp#
179
180orginal is a map that exists into your data folder, or your grf.
181If you want to add a map to your map cache like this, you have to put the resnametable into the custom.grf, before catching.
182IMPORTANT: The map cache tool has to read YOUR resnametable as the last one, to overwrite the others, so you put your grf on the bottom of your grf list. (grf_files.txt)
183
184
185Now add these files to your custom grf and patch it!!
186Last step: Restarting your map server 
187
188GZ! You just added a custom map to your server!
189I hope this guide will help someone.
190I missed the mapcache in YukiTsukis' guide.
191Also I don't think you need to use the resnametable.
192*has got about 15 custom maps and didn't use the resnametable*
193
194If you have tipps to make it better you can write a pm.
195I am NOT English, so I suppose my Guide has got a lot of mistakes.
196If someone wants to corrige it, he can pm me 
197
198
199Regards KingKronos