https://wiki.sasgaming.net/index.php?action=history&feed=atom&title=Minecraft%3AWaypoint_styleMinecraft:Waypoint style - Revision history2026-09-07T08:01:39ZRevision history for this page on the wikiMediaWiki 1.43.8https://wiki.sasgaming.net/index.php?title=Minecraft:Waypoint_style&diff=157034&oldid=prevSyncBot: Sync: new page from Minecraft2026-06-28T11:22:09Z<p>Sync: new page from Minecraft</p>
<p><b>New page</b></p><div>{{exclusive|java}}<br />
'''Waypoint styles''' are [[Minecraft:JSON]] files located in [[Minecraft:resource pack]]s that define styling used for changing waypoints' icon and specific distances they appear on the [[Minecraft:locator bar]]. They are used in {{cmd|waypoint modify ... style}} command for specific entities.<br />
<br />
== JSON format ==<br />
Waypoint styles are stored as JSON files on {{cd|assets/''<namespace>''/waypoint_style}} directory.<br />
<br />
<div class="treeview"><br />
* {{nbt|compound}}: The root object.<br />
** {{nbt|int|near_distance}}: The distance in blocks at which the waypoint icon begins its visual transition between sprites. The first sprite in the {{nbt|list|sprites}} list is always used for any distance less than this value, and for the [[#Sprite selection|0th sprite index]]. Default value is 128.<br />
** {{nbt|int|far_distance}}: The distance in blocks at which the waypoint icon completes its visual transition. It must be greater than {{nbt|int|near_distance}}. At this distance and beyond, the last sprite in the {{nbt|list|sprites}} list is used. Default value is 332.<br />
** {{nbt|list|sprites}}: A list of [[Minecraft:sprite]]s which cycle between the {{nbt|int|near_distance}} and {{nbt|int|far_distance}}.<br />
*** {{nbt|string}}: A sprite identifier, formatted as {{cd|''<namespace>'':''<sprite_id>''}}, which refers to a unique texture located in {{cd|assets/''<namespace>''/textures/gui/sprites/hud/locator_bar_dot/''<sprite_id>''.png}}. Specifying a nonexistent causes the [[Minecraft:missing texture]] to be used, rather than the default waypoint texture.<br />
</div><br />
<br />
== Sprite selection ==<br />
<br />
To determine which sprite is used based on the distances, the game uses {{w|linear interpolation}} on the player's distance between the near and far distance values, getting the index of which sprite is supposed to be shown in the {{nbt|list|sprites}} list. This calculation in the game is roughly equivalent to:<br />
<br />
<math>\text{Sprite index} = \lfloor \left( \frac{\text{Player distance} - \text{Near distance}}{\text{Far distance} - \text{Near distance}} \right) \times \text{Size of sprites list} \rfloor</math><br />
<br />
Noticeably, the second sprite does not appear until the first index is calculated, which until then, the game uses the first sprite for the 0th index calculated, and for any distance less than the near distance. This is due to the {{w|zero-based numbering}} for indexing the sprites list.<br />
<br />
The distance (in blocks) which a sprite appears between transition can be calculated from:<br />
<br />
<math>\text{Sprite distance between transition} = \frac{\text{Far distance} - \text{Near distance}}{\text{Size of sprites list}}</math><br />
<br />
== History ==<br />
{{HistoryTable<br />
|{{HistoryLine|java}}<br />
|{{HistoryLine||1.21.6|dev=25w17a<br />
|Added waypoint style, alongside {{cmd|waypoint modify ... style}} arguments.}}<br />
}}<br />
<br />
== Navigation ==<br />
{{Navbox Java Edition technical|resourcepack}}<br />
<br />
[[Minecraft:de:Wegpunktdarstellung]]<br />
[[Minecraft:ja:ウェイポイントのスタイル]]<br />
[[Minecraft:pt:Estilo do marcador]]<br />
[[Minecraft:zh:路径点样式]]</div>SyncBot