Template:FFXIMap Markers - Revision history

Starfox9507: /* Usage */

2024-02-08T14:15:40Z

Usage

@@ Line 48: / Line 48: @@
 |''number''
 |There are "types" of markers (ie: NPC, Seasonal NPC, ???, Standard Merchant, etc...). These types are bundled in layers on the FFXIMap where the user is able to turn on/off a particular layer they want to see.
 |-
 |'''image''' ''[optional]''

Starfox9507 at 15:04, 15 January 2024

2024-01-15T15:04:04Z

← Older revision		Revision as of 15:04, 15 January 2024
Line 4:		Line 4:
	\|mapy=Float		\|mapy=Float
	\|entitytype=List (,) of Page		\|entitytype=List (,) of Page
			\|minlevel=Integer
			\|maxlevel=Integer
	\|image=File		\|image=File
	}}		}}
Line 15:		Line 17:
	\|mapy=		\|mapy=
	\|entitytype=		\|entitytype=
			\|minlevel=
			\|maxlevel=
	\|image=		\|image=
	}}		}}
Line 70:		Line 74:
	\|mapy={{{mapy\|}}}		\|mapy={{{mapy\|}}}
	\|entitytype={{{entitytype\|}}}		\|entitytype={{{entitytype\|}}}
			\|minlevel={{{minlevel\|}}}
			\|maxlevel={{{maxlevel\|}}}
	\|image={{{image\|}}}		\|image={{{image\|}}}
	}}[[Category:FFXIMap Markers]]</includeonly>		}}[[Category:FFXIMap Markers]]</includeonly>

Starfox9507 at 06:22, 27 December 2023

2023-12-27T06:22:40Z

← Older revision		Revision as of 06:22, 27 December 2023
Line 33:		Line 33:
	\|''none''		\|''none''
	\|''float''		\|''float''
	\| The X position for the marker. Please read [[Template:FFXIMap#Coordinate Systems\|Coordinate Systems]] ~~below~~ for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.		\| The X position for the marker. Please read [[Template:FFXIMap#Coordinate Systems\|Coordinate Systems]] for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''mapy''' ''[required]''		\|'''mapy''' ''[required]''
	\|''none''		\|''none''
	\|''float''		\|''float''
	\| The Y position for the marker. Please read [[Template:FFXIMap#Coordinate Systems\|Coordinate Systems]] ~~below~~ for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.		\| The Y position for the marker. Please read [[Template:FFXIMap#Coordinate Systems\|Coordinate Systems]] for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''entitytype''' ''[required]''		\|'''entitytype''' ''[required]''
Line 62:		Line 62:
	}}		}}
	</pre>		</pre>


	</noinclude><!--		</noinclude><!--

Starfox9507 at 06:05, 27 December 2023

2023-12-27T06:05:32Z

@@ Line 62: / Line 62: @@
 }}
 </pre>
 </noinclude><!--

Starfox9507 at 06:04, 27 December 2023

2023-12-27T06:04:22Z

← Older revision		Revision as of 06:04, 27 December 2023
Line 33:		Line 33:
	\|''none''		\|''none''
	\|''float''		\|''float''
	\| The X position for the marker. Please read [[#Coordinate Systems\|Coordinate Systems]] below for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.		\| The X position for the marker. Please read [[Template:FFXIMap#Coordinate Systems\|Coordinate Systems]] below for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''mapy''' ''[required]''		\|'''mapy''' ''[required]''
	\|''none''		\|''none''
	\|''float''		\|''float''
	\| The Y position for the marker. Please read [[#Coordinate Systems\|Coordinate Systems]] below for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.		\| The Y position for the marker. Please read [[Template:FFXIMap#Coordinate Systems\|Coordinate Systems]] below for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''entitytype''' ''[required]''		\|'''entitytype''' ''[required]''

Starfox9507 at 06:02, 27 December 2023

2023-12-27T06:02:55Z

← Older revision		Revision as of 06:02, 27 December 2023
Line 8:		Line 8:

	==Usage==		==Usage==
	Add this tag to an entity you wish displayed on the FFXIMap.		Add this tag to an entity you wish displayed on the FFXIMap. If the map already has the entity listed, then anything added using this template will overwrite what is currently on the map.
	<pre>		<pre>
	{{FFXIMap Markers		{{FFXIMap Markers

Starfox9507 at 05:58, 27 December 2023

2023-12-27T05:58:20Z

← Older revision		Revision as of 05:58, 27 December 2023
Line 6:		Line 6:
	\|image=File		\|image=File
	}}		}}

	~~==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:
	~~<pre><FFXIMap mapID=62 zoom=1 width=800 height=800 showdetails=true/></pre>~~
	* '''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:<br>~~
	~~[[File: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].

	==Usage==		==Usage==
	Add this tag to an entity you wish displayed on the FFXIMap.		Add this tag to an entity you wish displayed on the FFXIMap.
	<pre>		<pre>
	{{FFXIMap Markers		{{FFXIMap Markers
Line 49:		Line 33:
	\|''none''		\|''none''
	\|''float''		\|''float''
	\| ~~'' ''~~The ~~in-game~~ X position for the marker. ~~Values~~ for this can be integers or decimals (ie: 17.134). Map positioning for all markers used within the FFXIMap extension have a coordinate system that starts at 0,0 for the bottom left and 256,256 for the top right. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.		\| The X position for the marker. Please read [[#Coordinate Systems\|Coordinate Systems]] below for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''mapy''' ''[required]''		\|'''mapy''' ''[required]''
	\|''none''		\|''none''
	\|''float''		\|''float''
	\|~~''[value must be between 0-256]''~~ The Y position on the ~~FFXIMap~~. ~~Values~~ for this ~~should~~ be ~~decimals (ie: 17~~.~~134). Description is~~ the ~~same as~~ the ~~mapx position above~~.		\| The Y position for the marker. Please read [[#Coordinate Systems\|Coordinate Systems]] below for details if you are unfamiliar with this. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''entitytype''' ''[required]''		\|'''entitytype''' ''[required]''
Line 65:		Line 49:
	\|''text''		\|''text''
	\|This is the filename of the image. Do not use wikitext in this field.		\|This is the filename of the image. Do not use wikitext in this field.
	\|-
	~~\|'''displayposition''' ''[optional]''~~
	~~\|''none''~~
	~~\|''text''~~
	\|This is a simple line of text. This is the in-game x,y coordinates tor this marker. There are many HorizonXI approved addons/plugins that provide this information. Format should include the parenthesis, ie: (x,y)
	\|}		\|}

Line 82:		Line 61:
	\|image=Guslam.png		\|image=Guslam.png
	}}		}}
	</pre></noinclude><!--		</pre>

			==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:
			<pre><FFXIMap mapID=62 zoom=1 width=800 height=800 showdetails=true/></pre>
			* '''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:<br>
			[[File:In-game-coords-example.png]]
			<br>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].


			</noinclude><!--
	--><includeonly>{{#cargo_store:_table=ffximapmarkers		--><includeonly>{{#cargo_store:_table=ffximapmarkers
	\|mapid={{{mapid\|}}}		\|mapid={{{mapid\|}}}

Starfox9507 at 05:51, 27 December 2023

2023-12-27T05:51:23Z

@@ Line 1: / Line 1: @@
 <noinclude>{{#cargo_declare:_table=ffximapmarkers
 |mapid=Integer
@@ Line 7: / Line 6: @@
 |image=File
 }}
 ==Usage==
 Add this tag to an entity you wish displayed on the FFXIMap.
@@ Line 18: / Line 34: @@
 }}
 </pre>
 {| class="wikitable"
 |+

Starfox9507 at 04:52, 27 December 2023

2023-12-27T04:52:34Z

← Older revision		Revision as of 04:52, 27 December 2023
Line 6:		Line 6:
	\|entitytype=List (,) of Page		\|entitytype=List (,) of Page
	\|image=File		\|image=File
	~~\|displayposition=String~~		}}
	}}~~<!-- ==THIS IS STILL UNDER CONSTRUCTION - DO NOT ATTEMPT USING THIS YET PLEASE== -->~~
	==Usage==		==Usage==
	Add this tag to an entity you wish displayed on the FFXIMap.		Add this tag to an entity you wish displayed on the FFXIMap.
Line 17:		Line 16:
	\|entitytype=		\|entitytype=
	\|image=		\|image=
	~~\|displayposition=~~
	}}		}}
	</pre>		</pre>
			Before proceeding you must
	{\| class="wikitable"		{\| class="wikitable"
	\|+		\|+
Line 35:		Line 34:
	\|''none''		\|''none''
	\|''float''		\|''float''
	\|''~~[value must be between 0-256]~~'' The X position on the ~~FFXIMap~~. Values for this ~~should~~ be decimals (ie: 17.134). Map positioning for all markers used within the FFXIMap extension have a coordinate system that starts at 0,0 for the bottom left and 256,256 for the top right. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.		\| '' ''The in-game X position for the marker. Values for this can be integers or decimals (ie: 17.134). Map positioning for all markers used within the FFXIMap extension have a coordinate system that starts at 0,0 for the bottom left and 256,256 for the top right. A marker position must be within those bounds to be visible on the map. In order to get these numbers you must view an FFXIMap with the added parameter 'showdetails=true' and use the mouse to determine the coordinates of a specific location. See [[Template:FFXIMap]] for more details.
	\|-		\|-
	\|'''mapy''' ''[required]''		\|'''mapy''' ''[required]''
Line 63:		Line 62:
	{{FFXIMap Markers		{{FFXIMap Markers
	\|mapid=141		\|mapid=141
	\|mapx=25.9		\|mapx=-4.23
	\|mapy=~~157~~.72		\|mapy=49.75
	\|entitytype=NPC		\|entitytype=NPC
	\|image=Guslam.png		\|image=Guslam.png
	~~\|displayposition=(179,-216.8)~~
	}}		}}
	</pre></noinclude><!--		</pre></noinclude><!--
Line 76:		Line 74:
	\|entitytype={{{entitytype\|}}}		\|entitytype={{{entitytype\|}}}
	\|image={{{image\|}}}		\|image={{{image\|}}}
	~~\|displayposition={{{displayposition\|}}}~~
	}}[[Category:FFXIMap Markers]]</includeonly>		}}[[Category:FFXIMap Markers]]</includeonly>

Starfox9507 at 13:33, 16 November 2023

2023-11-16T13:33:29Z

← Older revision		Revision as of 13:33, 16 November 2023
Line 77:		Line 77:
	\|image={{{image\|}}}		\|image={{{image\|}}}
	\|displayposition={{{displayposition\|}}}		\|displayposition={{{displayposition\|}}}
	}}</includeonly>		}}[[Category:FFXIMap Markers]]</includeonly>