Mods / Salty´s WayPoints

Tags:
Cosmetics QoL
Author:
SaltyWater
Side:
Client
Created:
Oct 21st 2025 at 7:56 PM
Last modified:
Apr 25th at 8:36 PM
Downloads:
3646
Latest release (for Vintage Story 1.22.0, potentially outdated):
WayPoint_0.2.1.zip  1-click install

image

Pet the floppa to buy me a coffee!

WayPoints

Guessing north

 

This tiny mod will render your map waypoints in world:

image

Simply create a new waypoint:

image

It also displays name and distance.

Use the K menu to filter your waypoints:

image

 

You can toggle ALL in world waypoints with the toggle key (Z by default).

 

 

Behaviors:

Pinned and unpinned waypoints behave different:

Pinned waypoints: Stick to the screen edges.

Unpinned waypoints: Only shows when looking at it´s direction.

 

imageLimitations:image

Sadly vanilla waypoints needs a packet from the server for clients to get the map data, since this mod is client only (And I intend to leave it that way) you'll have to open the map at least once for every session (entering/exiting world). It shouldn't be a problem if you play with minimap on all the time tho.

Also pinned waypoints may also freak out a little in the edge of the screen if you get too close to it, the math is probably wrong somewhere and I can't figure out yet, but I'm pretty sure the answer is changing a single number value and when I discover it, it'll make me feel dumb.

 

Q&A:

I did not test this in multiplayer or using other waypoint mods.

 

check out my other mods here:image

 

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
0.2.1 waypoint 877 Apr 25th at 8:36 PM WayPoint_0.2.1.zip 1-click install

Updated .net project version

Mod didn't need any changes.

0.2.0 waypoint 2395 Oct 25th 2025 at 12:20 AM WayPoint_0.2.0.zip 1-click install

Added Filter Menu.

0.1.0 waypoint 374 Oct 21st 2025 at 8:25 PM WayPoint_0.1.0.zip 1-click install

The “Works on My Machine” Certification Program 

seal of approval

 


28 Comments (oldest first | newest first) (threaded | flat)

Lephasme1000III, May 28th at 8:44 PM

here's a problem with the way points: I'm using Wanderlands cave system and the way point can't tell me where are the ores exactly, because they always float to the surface, causing me to be desoriented a lot (which isn't a good thing when there's a lot of bad things down there). So please allow them to not be 100% on the marker location for that.

JimmyMac, Jun 10th at 3:22 AM
@Lephasme1000III: here's a problem with the way points: I'm using Wanderlands cave system and the way point can't tell me where are the ores exactly, because they always float to the surface, causing me to be desoriented a lot (which isn't a good thing when there's a lot o

in my Waypoint Beacon mod I have code that adds a hotkey (B by default) It creates a waypoint at the exact block you are currently targeting. You don't have to open your map and right click. So you can place the waypoint below ground in a cave easily. Maybe that will help. 

TheJoyfulBell, May 28th at 1:39 PM

PLEASE add a way to filter/search waypoints in the K menu, I literally have 400+ waypoints on my map.. (also the "Show it?" should be turned off by default and manually turned on if you want to see it, it's quite annoying.)

NoizMakyr, May 24th at 12:49 AM

I can't seem to get this mod to work in a singleplayer world on 1.22.2 so it may be the most recent versions of VS broke something.  Bummer.  Have turned off all other client-side mods, configured waypoints for 10,000 blocks, pinned and marked "show" in the mod's window.  Nothing showing up at any distance unfortunately.

If there's anything else I should try or any logs I could pull, please let me know!

NoizMakyr, May 22nd at 11:57 PM

Does this read off the heightmap, or are the Z-values of the markers configurable?

SuperiorRice, Apr 26th at 10:36 PM

Waypoints created by Auto Waypoint mod seem to not be able to be hidden from the K menu. I deactivate the option to see them but when I close the menu and open it back up it's reselected to be seen.

Yrdo, Mar 19th at 8:49 PM

this is an amazing mod as is

but unfortunately i do add a waypoint to practically anything and everything i find

so having either

1 a way of sorting and/or filtering waypoints, this would make seting their draw distance much easier for me

2 even better if i could have draw distance set per either a symbol used or symbol and color combo used

either of those would great

thanks for all your work

RottenWater, Feb 20th at 3:52 PM (modified Feb 20th at 3:54 PM)

can you add a all toggle to make the distance the same/ be able to group waypoints together

 

noodlepfp, Feb 10th at 3:43 AM

could you make an option for waypoints to only appear after you X distance AWAY? in addition to X distance WITHIN?

I don't want my home waypoints to clutter my screen when I am within 100 blocks of them. I only need to know where they are when I am far away :)

FNXR, Jan 4th at 11:40 PM

A toggle all button for the filter window would be nice.

LordReems, Nov 16th 2025 at 11:50 PM

Very nice, this mod is super useful! Any chance you could add an option for "off by default" when a new map marker is added? Or maybe a UI button in the filter menu to turn all markers on or off? I use the auto map marker mod so I have tons of new markers popping up as I explore and it'd be nice to have them easily turned off by default.

TwelveWishes, Nov 9th 2025 at 12:04 PM

Not sure how feasible it would be, but I think a neat crossover between your mods would be if you could only see these waypoints when using the bird's eye view mod.

Ruina, Oct 28th 2025 at 7:54 PM

Great mod SaltyWater, Thanks you.

SaltyWater , Oct 25th 2025 at 10:50 AM

pTq

too much out of the scope of the mod

pTq, Oct 25th 2025 at 7:40 AM (modified Oct 25th 2025 at 7:41 AM)

SaltyWater

Awesome mod! But just after installing it it made me go through a list of 700+ waypoints to disable nearly all of them otherwise I had a very ugly horizont of icons and text. 

My suggestions:

  • add configurable global distance of disappearing. For example a range of 300-500m where unpinned waypoint starts to change their opacity from 1 to 0 gradually.
  • pinned waypoints stay at opacity 1 all the time.
  • sorting list of waypoints by their tabs asc/desc. It will make it easier to find things.
  • dynamic search by name could also be good to have.
  • Most of my waypoints are macro made so they are identical, showing at least ID on the list could be usefull, as editing on the map shows ID in the chat, that way we could find the waypoint by it on the list.
Simori, Oct 25th 2025 at 5:49 AM

Oh! I know it's probably impossible to achieve since this mod relies on the map function, but I could see it being useful in a mapless playthrough, maybe associated with a physical waypoint or something that you have to place down

SaltyWater , Oct 23rd 2025 at 2:53 PM

Narg

I have the perfect mod for you!

Mod Thumbnail

Narg, Oct 22nd 2025 at 7:49 PM

SaltyWater hey, already changed in my settings, but a though for the future, this and crawl and dive both default to Z, which means this does nothing until you go into the settings to change it.

KickingJoub, Oct 22nd 2025 at 4:48 PM

To expand on the previous suggestion, a configurable minimum distance for waypoints, so you can have them disappear once you get X meters close.

PapitoPapz, Oct 22nd 2025 at 1:43 PM

EnderWarlock porkbrick I also agree 

porkbrick, Oct 22nd 2025 at 1:41 PM

"A config setting that lets me determine the maximum distance a eaypoint can render would be amazing! Say, for example, any waypoint within 100 meters would render, and all more distant waypoints that aren't pinned would stay hidden till on range."

i second this suggestion!

XurxoMF, Oct 22nd 2025 at 1:06 PM

Another 10/10 mod by you beloved floppa! 💯

EnderWarlock, Oct 22nd 2025 at 1:16 AM

A config setting that lets me determine the maximum distance a eaypoint can render would be amazing! Say, for example, any waypoint within 100 meters would render, and all more distant waypoints that aren't pinned would stay hidden till on range.

JustaKobold, Oct 21st 2025 at 10:11 PM

can waypoints be filtered so only some appear? I dont want hundreds of waypoints appearings

MRGOOSE, Oct 21st 2025 at 9:08 PM

incompatible with Cartographer shared waypoints