Template:FFXIMap

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 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