Template:FFXIMap: Difference between revisions

From HorizonXI Wiki
No edit summary
No edit summary
Line 62: Line 62:
|''text [ true/false ]''
|''text [ true/false ]''
|Displays mouse coordinates on bottom left of window. When mouse is clicked on map the coordinates of the mouse are printed to a new <div> below the map. <div> is reset if mouse clicks a new zone connection in map. This is primarily used for editors to help grab coordinate arrays quickly.  
|Displays mouse coordinates on bottom left of window. When mouse is clicked on map the coordinates of the mouse are printed to a new <div> below the map. <div> is reset if mouse clicks a new zone connection in map. This is primarily used for editors to help grab coordinate arrays quickly.  
|-
|showconnections
|false
|''text [ true/false ]''
|Displays all polygons associated with connections to other maps. Very helpful for editors when quickly putting together new connections or identifying improperly placed connections. 
|}
|}



Revision as of 06:07, 27 December 2023

Description

This is an interactive FFXI map. This extension is designed specifically to work with the HorizonXI Wiki (https://horizonffxi.wiki/), and is built using the Leaflet library (https://leafletjs.com/).

The project was started to give players a more intuitive FFXI map tool. Basic functionality includes displaying a zone map (ie: Upper Jeuno) in a custom sized window, zoom controls, and clickable links for all zone connections. Advanced functionality includes displaying pulsating icons on the map for user defined things, for instance NPCs in a city or Treasure Coffers in a zone. The advanced functions work in a local testing environment and are currently being migrated to the Wiki for editors to evaluate.


The Basics

To have an interactive map displayed on a wiki page you would add the following tk a page

<FFXIMap />

to the page. Every parameter added to the tag is "optional" and by omitting any particular parameter the extension will just apply a default value in it's place (see Parameters table below for details).

This is an example of a working tag with some commonly used parameters for displaying a map:

<FFXIMap mapid=62 zoom=1 width=512 height=512 />

In this example we have chosen to display the "Upper Jeuno" map, with a desired width and height and a particular zoom level.

  • For v1 of this extension, please always include the "mapID" parameter with a desired map number, and ensure it is not 0. MapID 0 is saved for "world map" features set to be released at a later date.

Coordinate Systems

General rules of thumb:

  • You must know if the map you are adding to is using IN-GAME or BASIC coordinates. This is how you would do that:
<FFXIMap mapID=62 zoom=1 width=800 height=800 showdetails=true/>
  • IN-GAME coordinates are based on the coordinates in-game. Simply target an NPC/entity you wish to create a marker for, and use those X and Y values for the mapx and mapy listed below.
  • BASIC coordinates are based on a 0-256 pixel grid, where the bottom left of the map is [0,0] and the top right of the map is [256,256]. In order to get these coordinates you need to add the 'showdetails=true' attribute to your instance of FFXIMap. With this set as true you can see the coordinates as you move your mouse on the map, and clicking the map will post those coordinates below the map for you to copy paste.

Background / Context

Before proceeding you must take a second to understand and appreciate the coordinate systems available. In Vana'diel every zone has its own [X,Y, Z] based coordinate system. At the inception of this interactive maps project we did not anticipate using the actual in-game coordinates for any map, because putting markers on the map was never really part of the plan. So from the beginning each map used the same [X,Y] coordinate system, where the bottom left of the map was [0,0] and the top right of the map was [256,256]. Most maps are still on this coordinate system. We have only recently begun to add the actual in-game coordinates to each map, and this is a lengthy process.

When adding markers to the map you must know exactly which coordinate system the zone map is using. You can determine this by editing the FFXIMap tag and adding the 'showdetails=true' attribute. This is an example of what the map will display. In this case, it is Upper Jeuno and this particular map is using the IN-GAME coordinates:
In-game-coords-example.png
IN-GAME coordinates are based on latitude and longitude, so when you see these coordinates in this info box on the bottom left they will be displayed as [LAT,LNG] which is actually [Y,X]. Hovering over any marker with your mouse will display the coordinates properly as [X,Y].

Tag Parameters

parameter default type description
mapid 0 number mapid corresponds with the map name, listed below. See table "Map ID Data" below for details on these values. As of release of this map feature, please use values > 0. The World Map feature is being released at a later date and is not currently working.
zoom 1 number Values range from 0-6, with 0 being very "zoomed out" and 6 being very "zoomed in".
width 512 number Width of window displaying the map. All testing has been with "square" maps where width and height matched values. Rectangular shaped windows appear to work with current settings.
height 512 number Height of window displaying the map. All testing has been with "square" maps where width and height matched values. Rectangular shaped windows appear to work with current settings.
showdetails false text [ true/false ] Displays mouse coordinates on bottom left of window. When mouse is clicked on map the coordinates of the mouse are printed to a new
below the map.
is reset if mouse clicks a new zone connection in map. This is primarily used for editors to help grab coordinate arrays quickly.
showconnections false text [ true/false ] Displays all polygons associated with connections to other maps. Very helpful for editors when quickly putting together new connections or identifying improperly placed connections.

Advanced Features

This map was designed with the intent of giving wiki users/editors the ability to add things to the maps. To understand more about how to add these features to the maps, please see this page Template:FFXIMap Markers.

Known Issues

Hardly an "issue": after adding the <FFXIMap> tag to a page, and "saving changes", it is likely the map will not render properly. This issue is only present immediately after editing a page and saving changes. Refresh the page to fix. -- As of 01 Nov 23, This issue appears to have been resolved. If you see this issue again please let us know in discord !

Broken Map links (needs updating)

Map Issue
Metalworks doesnt have a direct connection listed on the map, add a custom image overlay?
Lower Delkfutt's Tower: Map 4: Add connections to Embassy links?
Mhaura: Add Ferry?
Selbina: Add Ferry?
Kazham: Add Ferry?
Delkfultts Tower teleports can take you to more than one place...
Middle Delkfutt's Tower: Map 2 where does that go? [G-6]
Pso'Xja: Map 20 stone door and other exit?
Upper Delkfutt's Tower: Map 3 #5 connection?
Upper Delkfutt's Tower: Map 4-6 need connections
All Crags need Al'Taieu added
All Apollyon zone maps
All Burning Circles connections purposefully left out
All Promys no connections inside
Ru'Aun Gardens need to add layers that depict the teleporters
Uleguard Range underground connections not listed on map 1; need to adjust hover/pulse coordinates when graphics updated
Inner Horu add West Saruta[205]
Yuhtunga Jungle 3/4/5 into Ifrit's Cauldron? Not listed on Ifrit Cauldron maps...
Grand Palace of Hu'Xzoi - maps 1 and 2 no connections
The Shrine of Ru'Avitau: Map 1 e & f are not connected
Castle Oztroja: Map 4 K connection broken ? probably linked to Map 4 incorrectly
Crawlers Nest -> Rolanberry Fields recheck connections 1 and 2, 2 is incorrect
Alzadaal Undersea Ruins: Map 5 Multiple telelports
Alzadaal Undersea Ruins: Map 11 & 12 Maps missing form database
Nyzul Isle: Maps 319 to 326 Teleports are random
Caedarva Mire: Map 1 Connection 3 to Underseas Ruins not connected(Ruins map 12 missing)
Caedarva Mire: Map 2 Connection 2 to Underseas Ruins not connected(Ruins map 12 missing)
Aht Urhgan Whitegate Add Ferry?
Caedarva Mire: Map 3 no connections? Unsure if CS zone or has links

Map ID Data

Map images downloaded from FFXI-Atlas or the Remapster project. Remapster images were prioritized. Attribution to both projects are listed on the bottom right of each map.

Map ID Map Name
0 World Map
1 Bastok Market
2 Bastok Mines
3 Battalia Downs
4 Beaucedine Glacier
5 Chateau d'Oraguille
6 Konschtat Highlands
7 La Theine Plateau
8 Lower Delkfutt's Tower: Map 1
9 Lower Delkfutt's Tower: Map 2
10 Lower Delkfutt's Tower: Map 3
11 Lower Delkfutt's Tower: Map 4
12 Lower Jeuno
13 Metalworks
14 Mhaura
15 Middle Delkfutt's Tower: Map 1
16 Middle Delkfutt's Tower: Map 2
17 Middle Delkfutt's Tower: Map 3
18 Middle Delkfutt's Tower: Map 4
19 Middle Delkfutt's Tower: Map 5
20 Middle Delkfutt's Tower: Map 6
21 Norg
22 Northern San d'Oria
23 Port Bastok
24 Port Jeuno
25 Port San d'Oria
26 Port Windurst
27 Pso'Xja: Map 1
28 Pso'Xja: Map 2
29 Pso'Xja: Map 3
30 Pso'Xja: Map 4
31 Pso'Xja: Map 5
32 Pso'Xja: Map 6
33 Pso'Xja: Map 7
34 Pso'Xja: Map 8
35 Pso'Xja: Map 9
36 Pso'Xja: Map 10
37 Pso'Xja: Map 11
38 Pso'Xja: Map 12
39 Pso'Xja: Map 13
40 Pso'Xja: Map 14
41 Pso'Xja: Map 15
42 Pso'Xja: Map 16
43 Pso'Xja: Map 17
44 Pso'Xja: Map 18
45 Pso'Xja: Map 19
46 Pso'Xja: Map 20
47 Qufim Island
48 Rolanberry Fields
49 Ru'Lude Gardens
50 Sauromugue Champaign
51 Southern San d'Oria
52 Tahrongi Canyon
53 Tavnazian Safehold: Map 1
54 Tavnazian Safehold: Map 2
55 Tavnazian Safehold: Map 3
56 Upper Delkfutt's Tower: Map 1
57 Upper Delkfutt's Tower: Map 2
58 Upper Delkfutt's Tower: Map 3
59 Upper Delkfutt's Tower: Map 4
60 Upper Delkfutt's Tower: Map 5
61 Upper Delkfutt's Tower: Map 6
62 Upper Jeuno
63 Valkurm Dunes
64 Windurst Walls
65 Windurst Waters: North
66 Windurst Waters: South
67 Windurst Woods
68 Al'Taieu
69 Altar Room
70 Apollyon: Map 1
71 Apollyon: Map 2
72 Apollyon: Map 3
73 Apollyon: Map 4
74 Apollyon: Map 5
75 Apollyon: Map 6
76 Apollyon: Map 7
77 Apollyon: Map 8
78 Attohwa Chasm
79 Beadeaux: Map 1
80 Beadeaux: Map 2
81 Behemoth's Dominion
82 Bibiki Bay: Map 1
83 Bibiki Bay: Map 2
84 Bostaunieux Oubliette: Map 1
85 Bostaunieux Oubliette: Map 2
86 Bostaunieux Oubliette: Map 3
87 Buburimu Peninsula
88 Castle Oztroja: Map 1
89 Castle Oztroja: Map 2
90 Castle Oztroja: Map 3
91 Castle Oztroja: Map 4
92 Castle Oztroja: Map 5
93 Castle Oztroja: Map 6
94 Castle Oztroja: Map 7
95 Castle Zvahl Baileys: Map 1
96 Castle Zvahl Baileys: Map 2
97 Castle Zvahl Baileys: Map 3
98 Castle Zvahl Baileys: Map 4
99 Castle Zvahl Keep: Map 1
100 Castle Zvahl Keep: Map 2
101 Castle Zvahl Keep: Map 3
102 Castle Zvahl Keep: Map 4
103 Crawler's Nest: Map 1
104 Crawler's Nest: Map 2
105 Crawler's Nest: Map 3
106 Dangruf Wadi
107 Davoi
108 East Ronfaure
109 East Sarutabaruta
110 Fort Ghelsba
111 Garlaige Citadel: Map 1
112 Garlaige Citadel: Map 2
113 Garlaige Citadel: Map 3
114 Garlaige Citadel: Map 4
115 Ghelsba Outpost: Map 1
116 Ghelsba Outpost: Map 2
117 Giddeus: Map 1
118 Giddeus: Map 2
119 Gusgen Mines: Map 1
120 Gusgen Mines: Map 2
121 Gusgen Mines: Map 3
122 Gusgen Mines: Map 4
123 Gustav Tunnel: Map 1
124 Gustav Tunnel: Map 2
125 Inner Horutoto Ruins: Map 1
126 Inner Horutoto Ruins: Map 2
127 Inner Horutoto Ruins: Map 3
128 Inner Horutoto Ruins: Map 4
129 Jugner Forest
130 Korroloka Tunnel: Map 1
131 Korroloka Tunnel: Map 2
132 Korroloka Tunnel: Map 3
133 Korroloka Tunnel: Map 4
134 Korroloka Tunnel: Map 5
135 Kuftal Tunnel: Map 1
136 Kuftal Tunnel: Map 2
137 Kuftal Tunnel: Map 3
138 Kuftal Tunnel: Map 4
139 Lufaise Meadows
140 Meriphataud Mountains
141 Misareaux Coast
142 Monastic Cavern
143 North Gustaberg
144 Palborough Mines: Map 1
145 Palborough Mines: Map 2
146 Palborough Mines: Map 3
147 Pashhow Marshlands
148 Promyvion Dem
149 Promyvion Holla
150 Promyvion Mea
151 Promyvion Vahzl
152 Qulun Dome
153 Riverne Site #A01
154 Riverne Site #B01
155 Ru'Aun Gardens
156 Sea Serpent Grotto: Map 1
157 Sea Serpent Grotto: Map 2
158 Sea Serpent Grotto: Map 3
159 Sea Serpent Grotto: Map 4
160 Sea Serpent Grotto: Map 5
161 Selbina
162 South Gustaberg
163 Temenos North: Map 1
164 Temenos North: Map 2
165 Temenos North: Map 3
166 Temenos North: Map 4
167 Temenos North: Map 5
168 Temenos North: Map 6
169 Temenos North: Map 7
170 Temenos East: Map 1
171 Temenos East: Map 2
172 Temenos East: Map 3
173 Temenos East: Map 4
174 Temenos East: Map 5
175 Temenos East: Map 6
176 Temenos East: Map 7
177 Temenos West: Map 1
178 Temenos West: Map 2
179 Temenos West: Map 3
180 Temenos West: Map 4
181 Temenos West: Map 5
182 Temenos West: Map 6
183 Temenos West: Map 7
184 Temenos Center: Map 1
185 Temenos Center: Map 2
186 Temenos Center: Map 3
187 Temenos Center: Map 4
188 Temenos Center: Basement
189 Temenos Entrance
190 Temple of Uggalepih: Map 1
191 Temple of Uggalepih: Map 2
192 Temple of Uggalepih: Map 3
193 Temple of Uggalepih: Map 4
194 The Boyahda Tree: Map 1
195 The Boyahda Tree: Map 2
196 The Boyahda Tree: Map 3
197 The Boyahda Tree: Map 4
198 The Eldieme Necropolis: Map 1
199 The Eldieme Necropolis: Map 2
200 The Eldieme Necropolis: Map 3
201 The Santuary of Zi'Tah
202 Uleguerand Range: Map 1
203 Uleguerand Range: Map 2
204 West Ronfaure
205 West Sarutabaruta
206 Windurst Walls
207 Xarcabard
208 Yhoator Jungle
209 Yughott Grotto: Map 1
210 Yughott Grotto: Map 2
211 Yuhtunga Jungle
212 Zeruhn Mines
213 Eastern Altepa Desert
214 Western Altepa Desert
215 Rabao
216 Quicksand Caves: Map 1
217 Quicksand Caves: Map 2
218 Quicksand Caves: Map 3
219 Quicksand Caves: Map 4
220 Quicksand Caves: Map 5
221 Quicksand Caves: Map 6
222 Quicksand Caves: Map 7
223 Quicksand Caves: Map 8
224 Sacrarium: Map 1
225 Sacrarium: Map 2
226 Carpenter's Landing: Map 1
227 Carpenter's Landing: Map 2
228 Sealion's Den
229 Phomiuna Aqueducts: Map 1
230 Phomiuna Aqueducts: Map 2
231 Phomiuna Aqueducts: Map 3
232 Fei'Yin: Map 1
233 Fei'Yin: Map 2
234 Ranguemont Pass
235 Ordelle's Caves: Map 1
236 Ordelle's Caves: Map 2
237 Ordelle's Caves: Map 3
238 Maze of Shakhrami: Map 1
239 Maze of Shakhrami: Map 2
240 Grand Palace of Hu'Xzoi: Map 1
241 Grand Palace of Hu'Xzoi: Map 2
242 Grand Palace of Hu'Xzoi: Map 3
243 Labyrinth of Onzozo
244 King Ranperres Tomb: Map 1
245 King Ranperres Tomb: Map 2
246 Outter Horutoto: Map 1
247 Outter Horutoto: Map 2
248 Outter Horutoto: Map 3
249 Outter Horutoto: Map 4
250 Outter Horutoto: Map 5
251 Oldton Movalpolos
252 Cape Teriggan
253 Toraimarai Canal: Map 1
254 Toraimarai Canal: Map 2
255 Hall of the Gods
256 Ve'Lugannon Palace: Map 1
257 Ve'Lugannon Palace: Map 2
258 Ve'Lugannon Palace: Map 3
259 Ve'Lugannon Palace: Map 4
260 Ve'Lugannon Palace: Map 5
261 Ve'Lugannon Palace: Map 6
262 Ve'Lugannon Palace: Map 6
263 Ve'Lugannon Palace: Map 7
264 Ve'Lugannon Palace: Map 8
265 Ve'Lugannon Palace: Map 9
266 The Shrine of Ru'Avitau: Map 1
267 The Shrine of Ru'Avitau: Map 2
268 The Shrine of Ru'Avitau: Map 3
269 The Shrine of Ru'Avitau: Map 4
270 The Shrine of Ru'Avitau: Map 5
271 The Shrine of Ru'Avitau: Map 6
272 Den of Rancor: Map 1
273 Den of Rancor: Map 2
274 Den of Rancor: Map 3
275 Den of Rancor: Map 4
276 Den of Rancor: Map 5
277 Den of Rancor: Map 6
278 Den of Rancor: Map 7
279 Den of Rancor: Map 8
280 Den of Rancor: Map 9
281 Dragon's Aery
282 Ro'Maeve
283 Ifrit's Cauldron: Map 1
284 Ifrit's Cauldron: Map 2
285 Ifrit's Cauldron: Map 3
286 Ifrit's Cauldron: Map 4
287 Ifrit's Cauldron: Map 5
288 Ifrit's Cauldron: Map 6
289 Ifrit's Cauldron: Map 7
290 Ifrit's Cauldron: Map 8
291 Kazham
292 Newton Movalpolos
293 Valley of Sorrows
294 Al Zahbi
295 Aht Urhgan Whitegate
296 Bhaflau Thickets: Map 1
297 Bhaflau Thickets: Map 2
298 Wajaom Woodlands
299 Aydeewa Subterrane: Map 1
300 Aydeewa Subterrane: Map 2
301 Aydeewa Subterrane: Map 3
302 Aydeewa Subterrane: Map 4
303 Aydeewa Subterrane: Map 5
304 Aydeewa Subterrane: Map 6
305 Aydeewa Subterrane: Map 7
306 Mamook: Map 1
307 Mamook: Map 2
308 Mamook: Map 3
309 Alzadaal Undersea Ruins: Map 1
310 Alzadaal Undersea Ruins: Map 2
311 Alzadaal Undersea Ruins: Map 3
312 Alzadaal Undersea Ruins: Map 4
313 Alzadaal Undersea Ruins: Map 5
314 Alzadaal Undersea Ruins: Map 6
315 Alzadaal Undersea Ruins: Map 7
316 Alzadaal Undersea Ruins: Map 8
317 Alzadaal Undersea Ruins: Map 9
318 Alzadaal Undersea Ruins: Map 10
319 Nyzul Isle: Map 1
320 Nyzul Isle: Map 2
321 Nyzul Isle: Map 3
322 Nyzul Isle: Map 4
323 Nyzul Isle: Map 5
324 Nyzul Isle: Map 6
325 Nyzul Isle: Map 7
326 Nyzul Isle: Map 8
327 Mount Zhayolm
328 Nashmau
329 Caedarva Mire: Map 1
330 Caedarva Mire: Map 2
331 Caedarva Mire: Map 3
332 Caedarva Mire: Map 4
333 Arrapago Reef: Map 1
334 Arrapago Reef: Map 2
335 Arrapago Reef: Map 3
336 Arrapago Reef: Map 4
337 Arrapago Reef: Map 5
338 Arrapago Reef: Map 6
339 Arrapago Reef: Map 7
340 Arrapago Reef: Map 8
341 Arrapago Reef: Map 9
342 Arrapago Reef: Map 10
343 Arrapago Reef: Map 11
344 Mamool Ja Training Grounds: Map 1
345 Mamool Ja Training Grounds: Map 2
346 Mamool Ja Training Grounds: Map 3
347 Mamool Ja Training Grounds: Map 4
348 Mamool Ja Training Grounds: Map 5
349 Mamool Ja Training Grounds: Map 6
350 Mamool Ja Training Grounds: Map 7
351 Mamool Ja Training Grounds: Map 8
352 Mamool Ja Training Grounds: Map 9
353 Mamool Ja Training Grounds: Map 10
354 Talacca Cove
355 Silver Sea Remnants: Map 1
356 Silver Sea Remnants: Map 2
357 Silver Sea Remnants: Map 3
358 Silver Sea Remnants: Map 4
359 Silver Sea Remnants: Map 5
360 Arrapago Remnants: Map 1
361 Arrapago Remnants: Map 2
362 Arrapago Remnants: Map 3
363 Arrapago Remnants: Map 4
364 Arrapago Remnants: Map 5
365 Arrapago Remnants: Map 6
366 Arrapago Remnants: Map 7
367 Zhayolm Remnants: Map 1
368 Zhayolm Remnants: Map 2
369 Zhayolm Remnants: Map 3
370 Zhayolm Remnants: Map 4
371 Zhayolm Remnants: Map 5
372 Zhayolm Remnants: Map 6
373 Zhayolm Remnants: Map 7
374 Lebros Cavern: Map 1
375 Lebros Cavern: Map 2
376 Lebros Cavern: Map 3
377 Lebros Cavern: Map 4
378 Lebros Cavern: Map 5
379 Lebros Cavern: Map 6
380 Lebros Cavern: Map 7
381 Lebros Cavern: Map 8
382 Lebros Cavern: Map 9
383 Lebros Cavern: Map 10
384 Halvung: Map 1
385 Halvung: Map 2
386 Halvung: Map 3
387 Halvung: Map 4
388 Periqia: Map 1
389 Periqia: Map 2
390 Periqia: Map 3
391 Periqia: Map 4
392 Periqia: Map 5
393 Periqia: Map 6
394 Periqia: Map 7
395 Periqia: Map 8
396 Periqia: Map 9
397 Periqia: Map 10
398 Leujaoam Sanctum: Map 1
399 Leujaoam Sanctum: Map 2
400 Leujaoam Sanctum: Map 3
401 Leujaoam Sanctum: Map 4
402 Leujaoam Sanctum: Map 5
403 Leujaoam Sanctum: Map 6
404 Leujaoam Sanctum: Map 7
405 Leujaoam Sanctum: Map 8
406 Leujaoam Sanctum: Map 9
407 Leujaoam Sanctum: Map 10
408 Ilrusi Atoll: Map 1
409 Ilrusi Atoll: Map 2
410 Ilrusi Atoll: Map 3
411 Ilrusi Atoll: Map 4
412 Ilrusi Atoll: Map 5
413 Ilrusi Atoll: Map 6
414 Ilrusi Atoll: Map 7
415 Ilrusi Atoll: Map 8
416 Ilrusi Atoll: Map 9
417 Ilrusi Atoll: Map 10