Back to mods
Custom Waypoints project artwork

CurseForge · Minecraft mod

Custom Waypoints

This mod allows you to create custom waypoints with extensive customization and utilities using commands.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Custom Waypoints release should I use?

Updated last month
Latest stable file CustomWaypointsPLUGIN-PAPER-1.0.6.jar
Game version 1.21.8, 1.21.5, 1.21.4
Loader neoforge

Custom Waypoints CustomWaypointsPLUGIN-PAPER-1.0.6.jar targets 1.21.8, 1.21.5, 1.21.4. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Custom Waypoints required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release No loader listed
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Custom Waypoints CustomWaypointsPLUGIN-PAPER-1.0.6.jar need?

CustomWaypointsPLUGIN-PAPER-1.0.6.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Custom Waypoints without breaking your instance.

Built for Custom Waypoints CustomWaypointsPLUGIN-PAPER-1.0.6.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use CustomWaypointsPLUGIN-PAPER-1.0.6.jar. It targets 1.21.8, 1.21.5, 1.21.4; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside CustomWaypointsPLUGIN-PAPER-1.0.6.jar. It opens that exact file at the source.

About this project

What does Custom Waypoints add?

# Custom Waypoints

Create **waypoints, timers, counters, follow labels and mission markers** anywhere in the world, with backgrounds, animations, movement, live distance and more. Use client commands, the new **visual editor**, or control everything from a server with the **Custom Waypoints plugin**.

**Supported versions**

Loader Versions
**Fabric** 1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2
**NeoForge** 1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2 *(NEW)*
**Forge** 1.20.1 · 1.20.4

**Base command**

/waypoint  

On **1.21.8 → 26.2** use **/customwaypoint** instead, because vanilla Minecraft already has its own /waypoint. Everything else is the same.

**Features**

  • Display **waypoints** with text at any position, scale and rotation
  • Display **timers** (countdown) and **counters** (count up, optional decimals) with tick sounds, **any sound id** from vanilla or resource packs *(NEW)*
  • **Follow waypoints** that stay on a player or entity, and come back when the target loads again *(NEW)*
  • **Figures**: GTA-style **mission markers** on the ground (circle, star, arrow, heart...) or any text/number, with walls that fade up or down, and **pitch/roll** to put them on walls *(NEW)*
  • **Visual editor** with live preview, sliders, color wheel, undo/redo and history *(NEW)*
  • **Move** any waypoint to another position with interpolation presets and custom time
  • **Backgrounds** with 4 styles, **opacity** and **fade out** control *(NEW)*
  • **Entry / exit animations**: scale, slide, bounce, spin, pixelate, glitch
  • **Live distance** {distance}, **look-to-reveal text** {on_view_radius:N} *(NEW)*
  • **Inline items and textures** inside text, **HEX colors**, multiline text
  • Waypoints are **saved per world and per dimension** *(NEW)*
  • **Server control** with the Custom Waypoints plugin (Paper): waypoints for all players, synced timers and **actions when a player reaches or removes a waypoint** *(NEW)*

**Visual editor** *(NEW)*

![Editor 1]
Press **M** (Controls → Custom Waypoints) or run /waypoint editor. Press **N** to open the **Displays** tab directly.

  • Edit every waypoint type (text, timer, counter, follow and figure) with **sliders, a color wheel and a live preview** in the world
  • **Displays** tab: every active waypoint of your dimension, nearest first, to **Edit** or **Delete**
  • The bottom bar shows the **equivalent command**: click it or **Copy command** to use it in chat, command blocks or datapacks
  • **Ctrl+Z / Ctrl+Y** undo and redo, and **History** keeps the last 8 saved, overwritten or deleted waypoints (also after restarting)
  • The **↺** button puts a slider back to its default value, and holding **Shift** snaps sliders in steps of 5
  • **Placeholders** button: click one to insert it in the text
  • **Save** creates or updates the waypoint, **New** starts a fresh one at your position with the next free ID
  • Works like an overlay: you can **keep walking** while the editor is open

**Examples**

**Shop with distance:**

/waypoint set shop 464.49 -51.71 -724.91 9 follow far\_front false 20 scale\_in scale\_out false &eShop/n{distance}m  

![Shop Waypoint Without Background]

**Text with a rounded background, only revealed when you look at it** *(NEW)*:

/waypoint set shop 100 70 100 1 follow behind true black 0.4 1 rounded 10 scale\_in scale\_out false &6Shop{on\_view\_radius:2}/n&7Open 24/7{/on\_view}  

**Timer with a sound:**

/waypoint timer set raid 100 70 100 1 follow front true black 0.45 1.2 rounded 10 scale\_in scale\_out block.note\_block.pling false Time: &c"01:00:00"  

**Stopwatch counter with decimals:**

/waypoint counter set stopwatch 100 70 100 1 follow behind false 10 scale\_in scale\_out none true true Time: &a{counter}s/nDistance: {distance}  

**Label that follows a player** *(NEW: autocompletes online players)*:

/waypoint follow boss Steve 0 2.5 0 1 far\_front true black 0.5 1 rounded 10 scale\_in scale\_out false &c{entity\_displayname}/n&7{distance}m  

**Mission marker on the ground** *(NEW)*:

/waypoint figure mission1 circle 100 64 100 0 1.5 2 gold 20  

**Number "2" that turns to face you** *(NEW)*:

/waypoint figure step2 2 110 64 100 follow 1 1.5 "#55FFFF" 10  

**Arrow on a wall, with animations and fade out** *(NEW)*:

/waypoint figure door arrow 100 66 100 0 1 0.3 "#FFAA00" 10 20 0.9 scale\_in scale\_out 90 0  

**Move a waypoint and bring it back:**

/waypoint move shop 470 -50 -720 9 follow smooth 40  
/waypoint move\_reset shop bounce 20  

**Remove a waypoint when you walk into it:**

/waypoint remove\_radius mission1 2 20  

**Commands**

Base command: /waypoint (1.21.8 → 26.2: /customwaypoint)

Text:  
/waypoint set <id> <x> <y> <z> <scale> <rotation> <render> true <bgcolor> <bgopacity> <bgscale> <bgstyle> <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <textbackground> <text>  
/waypoint set <id> <x> <y> <z> <scale> <rotation> <render> false <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <textbackground> <text>

Timer (counts down):  
/waypoint timer set <id> <x> <y> <z> <scale> <rotation> <render> true <bgcolor> <bgopacity> <bgscale> <bgstyle> <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <sound> <textbackground> <text + "HH:MM:SS">  
/waypoint timer set <id> <x> <y> <z> <scale> <rotation> <render> false <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <sound> <textbackground> <text + "HH:MM:SS">  
/waypoint stoptimer <id>  
/waypoint resumetimer <id>

Counter (counts up):  
/waypoint counter set <id> <x> <y> <z> <scale> <rotation> <render> true <bgcolor> <bgopacity> <bgscale> <bgstyle> <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <sound> <decimals> <textbackground> <text + {counter}>  
/waypoint counter set <id> <x> <y> <z> <scale> <rotation> <render> false <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <sound> <decimals> <textbackground> <text + {counter}>  
/waypoint stoptimer <id>  
/waypoint resumetimer <id>

Follow:  
/waypoint follow <id> <player|UUID> <offsetX> <offsetY> <offsetZ> <scale> <render> true <bgcolor> <bgopacity> <bgscale> <bgstyle> <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <textbackground> <text>  
/waypoint follow <id> <player|UUID> <offsetX> <offsetY> <offsetZ> <scale> <render> false <fade\_in> [<fade\_out> <opacity>] <anim\_in> <anim\_out> <textbackground> <text>

Figure (NEW):  
/waypoint figure <id> <shape> <x> <y> <z> <rotation> <radius> <height> <color> <fade\_in> [<fade\_out> <opacity> [<anim\_in> <anim\_out> [<pitch> <roll> [<width\_x> <width\_z>]]]]

Move:  
/waypoint move <id> <x> <y> <z> <scale> <rotation> <interpolation> <time>  
/waypoint move\_reset <id> <interpolation> <time>

Other:  
/waypoint remove <id|all> [fadeout]  
/waypoint remove\_radius <id> <radius> <fadeout>  
/waypoint list  
/waypoint editor  

**Options**

Option Values
**scale** Size of the waypoint
**rotation** follow (faces the camera) · follow_horizontal · follow_vertical / follow_vertical_<yaw> · a fixed yaw like 0 90 180 270
**render** behind (hidden by blocks) · front (through blocks) · far_behind · far_front (stay readable from far away)
**bgcolor** BLACK DARK_BLUE DARK_GREEN DARK_AQUA DARK_RED DARK_PURPLE GOLD GRAY DARK_GRAY BLUE GREEN AQUA RED LIGHT_PURPLE YELLOW WHITE or HEX #RRGGBB
**bgopacity / opacity** 0–1
**bgscale** Size of the background around the text
**bgstyle** square square_small rounded rounded_small
**fade_in / fade_out** Ticks (20 ticks = 1 second). fade_out and opacity are optional and go together *(NEW)*
**anim_in** none scale_in left_in right_in up_in down_in bounce_in spin_in pixelate_in glitch_in
**anim_out** none scale_out left_out right_out up_out down_out bounce_out spin_out pixelate_out glitch_out
**textbackground** true / false (vanilla shadow/background behind each letter)
**sound** none or any sound id: block.note_block.pling, or "mypack:tick" with a namespace (in quotes)
**decimals** true / false (tenths of a second)
**interpolation** smooth linear step bounce
**time** (move) Ticks
**shape** (figure) circle square star triangle diamond pentagon hexagon octagon heart plus cross arrow lightning moon crown check question exclamation pin, or any text like 1, A, "10"
**rotation** (figure) A fixed yaw, follow (turns with your position) or follow_<yaw> (follow_180 points an arrow at you)
**radius / height** (figure) Blocks. A **negative height** fades the walls downward
**color** (figure) A color name or "#RRGGBB"
**pitch / roll** (figure) Degrees. pitch 90 stands the figure up like a sign on a wall, roll turns it in its own plane
**width_x / width_z** (figure) Stretch a shape to that many blocks instead of 2 × radius

**Tips**

**Text formatting**

  • &a, &l... = Minecraft color and format codes
  • &#RRGGBB, <#RRGGBB>, #RRGGBB or #(RRGGBB) = HEX color
  • /n = new line
  • | = space

**Timers and counters**

  • Timer time goes in quotes: "01:00:00". Text around it is kept: Time: &c"00:10:00" !!!
  • Hours hide under 1 hour (59:59) and minutes under 1 minute (59)
  • In counters, {counter} (or counter) marks where the value goes

**Inline items**

{"diamond"}  
{"diamond\_sword,scale:1.5"}  
{"diamond,scale:1.5,nbt:3"} ← nbt = CustomModelData  
{"diamond,s:1.5,n:3"} ← short version  

**Inline textures**

{"assets/minecraft/textures/item/apple.png,s:1"}  
{"resourcepack MyPack/assets/minecraft/textures/custom/skull.png,scale:2.5"}  

**Per world and dimension** *(NEW)*

  • Waypoints are saved per singleplayer world or server, and only show in the dimension they were created in
  • The same ID can exist in the Overworld and in the Nether
  • Figures only render over loaded chunks inside your render distance

**Long texts**

  • Chat only allows 256 characters, so use **command blocks** for very long waypoints

**Placeholders**

Placeholder Description
{distance} Distance to the waypoint in whole blocks
{distance_decimal} Distance with 1 decimal
{counter} Live counter value (counters)
"HH:MM:SS" Live remaining time (timers)
{entity_displayname} Name of the followed player or entity (follow)
{on_view_radius:N} Hides the text after it until your crosshair aims within N blocks of the waypoint *(NEW)*
{/on_view} Ends the {on_view_radius:N} section *(NEW)*

**Custom Waypoints Plugin (servers)** *(NEW)*

With the plugin on a **Paper** server, send waypoints to players with the mod (Fabric, Forge or NeoForge). Players without the mod can still join normally.

  • Every client command, as /waypointplugin (alias **/wpl**) with a target before the ID: **@a** or a **player name**
  • Waypoints are **saved on the server** and sent again when players join
  • **Timers and counters stay in sync**
  • **Waypoint actions**: run console commands when a player walks into a waypoint (on_step) or when it is removed (on_remove), with radius, waits and **PlaceholderAPI** support, all from the config
  • Permission: customwaypoints.admin (default: OP)

**Plugin commands**

/wpl set &lt;@a|player&gt; &lt;id&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; ...  
/wpl timer set &lt;@a|player&gt; &lt;id&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; ...  
/wpl counter set &lt;@a|player&gt; &lt;id&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; ...  
/wpl follow &lt;@a|player&gt; &lt;id&gt; &lt;target&gt; ...  
/wpl figure &lt;@a|player&gt; &lt;id&gt; &lt;shape&gt; &lt;x&gt; &lt;y&gt; &lt;z&gt; ...  
/wpl move &lt;@a|player&gt; &lt;id&gt; ...  
/wpl move\_reset &lt;@a|player&gt; &lt;id&gt; ...  
/wpl stoptimer &lt;@a|player&gt; &lt;id&gt;  
/wpl resumetimer &lt;@a|player&gt; &lt;id&gt;  
/wpl remove &lt;@a|player&gt; &lt;id|all&gt; [fadeout]  
/wpl remove\_radius &lt;@a|player&gt; &lt;id&gt; &lt;radius&gt; &lt;fadeout&gt;  
/wpl list &lt;@a|player&gt;  
/wpl reload  

**Plugin examples**

/wpl set @a spawn 0 70 0 1.5 follow far\_front true black 0.5 1 rounded 10 scale\_in scale\_out false &6&lSpawn/n&7{distance}m  
/wpl timer set @a event 0 72 0 2 follow front true black 0.5 1.2 rounded 10 scale\_in scale\_out block.note\_block.hat false &eEvent starts in &f"00:05:00"  
/wpl figure Steve mission1 star 150 64 -30 0 2 3 gold 20 20 1 scale\_in scale\_out  
/wpl follow @a king Steve 0 2.5 0 1 far\_front false 10 scale\_in scale\_out false &6King: &f{entity\_displayname}  
/wpl remove\_radius Steve mission1 2 20  
/wpl remove @a event 20  

**Waypoint actions (plugins/CustomWaypoints/config.yml)**

Everything is set per waypoint id, or * for every waypoint. Apply changes with /wpl reload.

waypoint-actions:  
mission1: # waypoint id, or "\*" for every waypoint  
remove\_radius: 4 # removed when a player gets this close  
remove\_only\_for\_player: true # true: only for that player / false: for everyone who has it  
on\_remove:  
- "console\_command: say %player% completed the mission!"  
- "wait: 1" # seconds  
- "console\_command: give %player% minecraft:diamond 3"  
- "wait\_ticks: 10" # ticks  
- "console\_command: title %player% title {\"text\":\"Mission complete\",\"color\":\"gold\"}"  
checkpoint:  
step\_radius: 5 # runs on\_step without removing the waypoint  
execute\_only\_once: true # on\_step only runs once per player  
on\_step:  
- "console\_command: title %player% actionbar {\"text\":\"Checkpoint!\",\"color\":\"aqua\"}"  
- "console\_command: playsound minecraft:entity.experience\_orb.pickup master %player%"  
  • **remove_radius**: removes the waypoint when a player walks into it, no extra command needed. on_remove runs for the player who reached it.
  • **remove_only_for_player**: true (default) removes it only for that player, false removes it for every player
  • **on_remove** also runs with /wpl remove, when a timer ends or when a followed entity dies (once per player that loses the waypoint)
  • **step_radius + on_step**: runs every time a player enters the radius, **without removing the waypoint**
  • **execute_only_once**: true runs on_step only once per player, even if they leave and come back (until /wpl reload, a restart or setting the waypoint again)
  • console_command: <command> runs a command as the console
  • wait: <seconds> / wait_ticks: <ticks> wait before the next action
  • Placeholders: %player%, %waypoint% and every **PlaceholderAPI** placeholder

**Mission example:** send the marker, and the config above rewards the player who reaches it:

/wpl figure @a mission1 circle 150 64 -30 0 1.5 2 gold 20  

Project description from CurseForge.

Pick your setup

Custom Waypoints by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

31 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Custom Waypoints versions and loaders

49 of 49 releases match

Looking for an older file? The official CurseForge project page is in Resources.