Waypointer
Fabric mod for Hypixel Skyblock that aims to be the best possible waypoint manager.
Features
- Ordered routes
- Per-island waypoints
- Subwaypoints
- Dungeon rooms support
- CH structure detection
- Metal detector solver
- Route Browser
- Waypoint Painting
- Extremely compact export format
- Importable from chat messages
- Keybindings
- Editor mode
- Waypoint skipping
- Chat coordinate detection
- Works with shaders
- Public API for other Fabric client mods

Demo Video
Waypoint Compatibility
- Coleweight/SkyHanni (I/E)
- Skytils 1.x V1 (I/E) and V2 (I)
- Skyblocker V1 (I/E)
- Soopy V1 (I)
- Firmament
FIRM_WAYPOINTS/(I) - Generic JSON (I)

Waypoint Painting

AI Generated Code Disclosure
This project contains code generated by large language models, though all code was reviewed, and approved, by me. It is not vibe coded.
For more information on this, you can contact me on discord, @ babbur.
License
GNU General Public License v3.0 only
How to Install Waypointer (Mod)
Waypointer by babbur is verified for Fabric across Minecraft versions 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2 (latest release: 1.13.0, file size: 2.6 MB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21.11, 26.1, 26.1.1, 26.1.2, 26.2) and platform (Fabric).
- Make sure you have the compatible loader or environment installed for Fabric.
- Move the downloaded Waypointer file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 14d ago | 1 | ||||
| 14d ago | 1 | ||||
| 16d ago | 1 | ||||
| 16d ago | 1 | ||||
| 17d ago | 1 | ||||
| 17d ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 |
- Update button in Settings, installs on restart
- Odin export for island waypoints and dungeon room packs
- Export option in the route right-click menu
- Label color setting, optionally applied to all label text
- Hex colors in waypoint names (
&#ff8800or<#ff8800>) - Live color preview for color codes and placeholders in the name editor
- Number unnamed waypoints setting
- Peek in Appearance settings
- Usage hints for incomplete commands
## Changed
- New share code format v11 with more compatibility for customization
- Export screen simplified to format and copy; export options moved to
Settings > Sharing > Exportsand on by default - Dungeon rooms use the regular export screen
- Community routes that need a newer version now say which one
- Route publishing now defaults to Public
- Crystal Hollows structure waypoints now hidden by default on new installs
- Single-route dungeon rooms show as one row to save precious vertical space
- Cursor changes over clickable elements and text fields now
## Removed
- 3D route preview and the Extras settings page (did anyone use ts)
## Fixed
- Dungeon item secrets completing when walking past instead of on pickup
- Bat secrets not counting when killed through walls
- Missing dungeon step labels (e.g. Item)
- Pathfinding not working in dungeon step routes
- Walking path drawing through walls and in the wrong color
- Pathfind to all waypoints doing nothing unless Pathfind to first waypoint was on
- Tracers missing for dungeon steps with Show tracers on
- Odin dungeon waypoints importing offset and without their colors
- Open link after importing a room not jumping to that room
- Crystal Hollows structure route looks not saving
- Contributor badge hiding the emblem in the tab list (thanks akura)
- Update button in Settings, installs on restart
- Odin export for island waypoints and dungeon room packs
- Export option in the route right-click menu
- Label color setting, optionally applied to all label text
- Hex colors in waypoint names (
&#ff8800or<#ff8800>) - Live color preview for color codes and placeholders in the name editor
- Number unnamed waypoints setting
- Peek in Appearance settings
- Usage hints for incomplete commands
## Changed
- New share code format v11 with more compatibility for customization
- Export screen simplified to format and copy; export options moved to
Settings > Sharing > Exportsand on by default - Dungeon rooms use the regular export screen
- Community routes that need a newer version now say which one
- Route publishing now defaults to Public
- Crystal Hollows structure waypoints now hidden by default on new installs
- Single-route dungeon rooms show as one row to save precious vertical space
- Cursor changes over clickable elements and text fields now
## Removed
- 3D route preview and the Extras settings page (did anyone use ts)
## Fixed
- Dungeon item secrets completing when walking past instead of on pickup
- Bat secrets not counting when killed through walls
- Missing dungeon step labels (e.g. Item)
- Pathfinding not working in dungeon step routes
- Walking path drawing through walls and in the wrong color
- Pathfind to all waypoints doing nothing unless Pathfind to first waypoint was on
- Tracers missing for dungeon steps with Show tracers on
- Odin dungeon waypoints importing offset and without their colors
- Open link after importing a room not jumping to that room
- Crystal Hollows structure route looks not saving
- Contributor badge hiding the emblem in the tab list (thanks akura)
- Toggle waypoints keybind, unbound by default
## Changes
- Crystal Hollows route names shortened in route browser
- Added new contributors
## Fixed
- Performance issues (now uses 0.002x as many draw calls; the last release had shoddy renderer work that wasn’t supposed to be released publicly)
- Various minor bugs
- Code quality
- Toggle waypoints keybind, unbound by default
## Changes
- Crystal Hollows route names shortened in route browser
- Added new contributors
## Fixed
- Performance issues (now uses 0.002x as many draw calls; the last release had shoddy renderer work that wasn’t supposed to be released publicly)
- Various minor bugs
- Code quality
- New UI refresh, including main UI, community routes, your routes, settings, appearances, everything!
- You can now modify all appearance settings on a cascading appearance section (Global > Zone > Route > [Room] > Waypoint), you can change appearance settings for an individual waypoint or all of your routes.
- You can classify dungeon actions as *Do in any order* from the waypoint menu. Mostly for dungeonbreaker blocks.
- Room completions can now be timed
- Dungeon routes now work in 'steps', where the step you're on shows its actions and its secret together, rather than just going from waypoint to waypoint.
- Doing a later action in a step skips ahead to it, and a secret you grab early is skipped when the route gets there. (no more getting stuck on a missed etherwarp lol)
- You can now import SecretRoutes f7 boss routes
- You can now give routes icons (right click -> Icon)
- Peek* in the route editor hides the waypoint list so you can watch your coordinate edits in the world.
- Menu opacity in Settings > System lets you see the world behind the menus while editing
- Add subwaypoint here* in the waypoint menu adds a new subwaypoint where you're standing
- Reset to route color* puts a colored waypoint back on the route's gradient color for that spot.
/wp targetshows/pins the route that new waypoints and commands go to.- Added more commands for almost everything in the menus: routes, waypoints, folders, appearance, publishing and more. See
/wp help. - Support for Odin's new Waypoints module.
- Routes uploaded to the mining cult discord (will) automatically go to Waypointer's route catalog with a new pretty purple tag! :D
## Changed
- New, better algorithm to recommend routes in the route browser.
- Master Mode / Normal Mode function the same in dungeon rooms for the most part now.
- Edit mode in a dungeon room shows the whole route including finished rooms
- New waypoints go to the route you are using: the one you last edited in that area, or the one drawn in a dungeon room. They no longer go to whichever route is listed first (weird that it did that in the first place, sorry command-first users! didn't know so many people would use them ngl...)
- Subwaypoints now fade in and out like main waypoints. "Skip fade time" is now called "Waypoint fade time".
- Less explanatory text in menus and settings.
- Translations updated for every language that had them.
- Improved debug output
## Fixed
- Waypoints added in a dungeon room no longer go to a hidden route.
- Add where looking now works in dungeon rooms.
- Blocks mined out of order no longer hold up dungeon routes.
/wpsuggestions work on Hypixel again. (i think ive finally fixed it!)- A known Crystal Hollows structure no longer turns into an 'approximate' waypoint when you walk into its area.
- Recoloring one waypoint no longer resets the rest of a gradient route.
- Unbound keybinds no longer show as conflicting with each other.
- Minimap area names move aside instead of d
- New UI refresh, including main UI, community routes, your routes, settings, appearances, everything!
- You can now modify all appearance settings on a cascading appearance section (Global > Zone > Route > [Room] > Waypoint), you can change appearance settings for an individual waypoint or all of your routes.
- You can classify dungeon actions as *Do in any order* from the waypoint menu. Mostly for dungeonbreaker blocks.
- Room completions can now be timed
- Dungeon routes now work in 'steps', where the step you're on shows its actions and its secret together, rather than just going from waypoint to waypoint.
- Doing a later action in a step skips ahead to it, and a secret you grab early is skipped when the route gets there. (no more getting stuck on a missed etherwarp lol)
- You can now import SecretRoutes f7 boss routes
- You can now give routes icons (right click -> Icon)
- Peek* in the route editor hides the waypoint list so you can watch your coordinate edits in the world.
- Menu opacity in Settings > System lets you see the world behind the menus while editing
- Add subwaypoint here* in the waypoint menu adds a new subwaypoint where you're standing
- Reset to route color* puts a colored waypoint back on the route's gradient color for that spot.
/wp targetshows/pins the route that new waypoints and commands go to.- Added more commands for almost everything in the menus: routes, waypoints, folders, appearance, publishing and more. See
/wp help. - Support for Odin's new Waypoints module.
- Routes uploaded to the mining cult discord (will) automatically go to Waypointer's route catalog with a new pretty purple tag! :D
## Changed
- New, better algorithm to recommend routes in the route browser.
- Master Mode / Normal Mode function the same in dungeon rooms for the most part now.
- Edit mode in a dungeon room shows the whole route including finished rooms
- New waypoints go to the route you are using: the one you last edited in that area, or the one drawn in a dungeon room. They no longer go to whichever route is listed first (weird that it did that in the first place, sorry command-first users! didn't know so many people would use them ngl...)
- Subwaypoints now fade in and out like main waypoints. "Skip fade time" is now called "Waypoint fade time".
- Less explanatory text in menus and settings.
- Translations updated for every language that had them.
- Improved debug output
## Fixed
- Waypoints added in a dungeon room no longer go to a hidden route.
- Add where looking now works in dungeon rooms.
- Blocks mined out of order no longer hold up dungeon routes.
/wpsuggestions work on Hypixel again. (i think ive finally fixed it!)- A known Crystal Hollows structure no longer turns into an 'approximate' waypoint when you walk into its area.
- Recoloring one waypoint no longer resets the rest of a gradient route.
- Unbound keybinds no longer show as conflicting with each other.
- Minimap area names move aside instead of d
- Create Crystal Hollows structure routes that move with their structure between lobbies.
- Track Crystal Hollows structures on a movable, resizable minimap. Edit it with
/wp minimap. - Edit published routes, replace their waypoints, or change visibility without changing their share links.
- SkySoft waypoint compatibility
- Undo and redo changes in the route editor and painter.
- Optional Skyblocker structure sharing, with nearby checks that hide inaccurate coordinates. (if you are on the skyblocker team and want this shut off please create an issue, i can shut it off immediately)
- Share known structure coordinates with one click when another player asks in chat.
- Send feedback in-game with screenshots (these go directly to my email pls dont spam)
- Use
{distance},{index},{total}, and{route}in waypoint names! (also, did you know you can use colors? try&aTEST!)
## Changed
- Browse My Routes in a searchable, full-screen grid.
- Fuzzy search for settings
- Adjust waypoint placement distance with the mouse wheel (can now be placed midair!)
- Open structure routes directly from the Structures folder
- Keep structure markers visible during focus mode
- Added more data to
/wp debug - Chat coordinate Block buttons are now optional and hidden by default.
## Fixed
- Closer waypoints and labels now draw in front of distant ones.
- Fixed crashes when changing player searches in the route catalog.
- Fixed missed area changes when sidebar information arrives late.
- Newly installed dungeon routes now activate without removing older packs.
- Wishing Compass checks now work between the Crystal Nucleus and surrounding areas.
- Fixed overlapping Wishing Compass labels.
- Local structure detections now replace unverified shared coordinates.
- Rejected publisher names now reopen Choose Publisher Name with the error visible.
## Performance
- Faster searches
- Create Crystal Hollows structure routes that move with their structure between lobbies.
- Track Crystal Hollows structures on a movable, resizable minimap. Edit it with
/wp minimap. - Edit published routes, replace their waypoints, or change visibility without changing their share links.
- SkySoft waypoint compatibility
- Undo and redo changes in the route editor and painter.
- Optional Skyblocker structure sharing, with nearby checks that hide inaccurate coordinates. (if you are on the skyblocker team and want this shut off please create an issue, i can shut it off immediately)
- Share known structure coordinates with one click when another player asks in chat.
- Send feedback in-game with screenshots (these go directly to my email pls dont spam)
- Use
{distance},{index},{total}, and{route}in waypoint names! (also, did you know you can use colors? try&aTEST!)
## Changed
- Browse My Routes in a searchable, full-screen grid.
- Fuzzy search for settings
- Adjust waypoint placement distance with the mouse wheel (can now be placed midair!)
- Open structure routes directly from the Structures folder
- Keep structure markers visible during focus mode
- Added more data to
/wp debug - Chat coordinate Block buttons are now optional and hidden by default.
## Fixed
- Closer waypoints and labels now draw in front of distant ones.
- Fixed crashes when changing player searches in the route catalog.
- Fixed missed area changes when sidebar information arrives late.
- Newly installed dungeon routes now activate without removing older packs.
- Wishing Compass checks now work between the Crystal Nucleus and surrounding areas.
- Fixed overlapping Wishing Compass labels.
- Local structure detections now replace unverified shared coordinates.
- Rejected publisher names now reopen Choose Publisher Name with the error visible.
## Performance
- Faster searches
- Crystal Hollows structure detection and automatic sharing with other Waypointer users.
- Wishing Compass solver and Crystal Nucleus waypoints.
- Fast metal detector solver
- A Structures folder and dedicated mining settings.
- Short published route codes and links.
- ChunkLogger route imports.
- Backward route progression when retracing your steps.
- Separate colors for previous, current, and upcoming waypoints, with smoother transitions between them.
- Optional smoothing for waypoint outlines, route lines, and tracers.
- More control over waypoint labels, including opacity and camera effects.
- A confirmation screen before importing configuration changes.
- A contributor badge and custom color for acidangels.
CHANGED
- The new waypoint renderer is now enabled by default.
- All new Waypointer share codes use the WP: prefix.
- Your publisher identity now carries across launcher profiles.
- Coordinates-only exports are now the default, with clearer controls for choosing what to export.
- Etherwarp notification sounds are configurable.
- Waypoint Painter and 3D route previews are grouped under Extras settings.
- Clearer settings navigation, import feedback, and export previews.
- Publishing warns when custom waypoint painting will not be included.
- Translation fixes and updated UI checkmarks.
FIXED
- SecretRoutes imports and incorrect Mineshaft targeting.
- Tracers becoming unexpectedly thin.
- Route-specific Paint appearance now takes priority over the global appearance setting.
- Focused temporary waypoint beacons stay visible when beacon mode is Off.
- Improved image import compatibility and painter behavior.
- Open Editor now opens the route you just imported.
- The route catalog resumes loading correctly after returning from another screen.
- Safer recovery from damaged configuration files.
- Turning off structure sharing or letting shared locations expire no longer loses your own discoveries.
PERFORMANCE
- Much faster rendering for waypoint clusters.
- More responsive route exports, publishing, and large-route previews.
- Faster paint previews and fewer repeated texture uploads.
- Less background traffic for structure sharing: 80% fewer routine snapshots under normal conditions, while new discoveries still share immediately.
- Crystal Hollows structure detection and automatic sharing with other Waypointer users.
- Wishing Compass solver and Crystal Nucleus waypoints.
- Fast metal detector solver
- A Structures folder and dedicated mining settings.
- Short published route codes and links.
- ChunkLogger route imports.
- Backward route progression when retracing your steps.
- Separate colors for previous, current, and upcoming waypoints, with smoother transitions between them.
- Optional smoothing for waypoint outlines, route lines, and tracers.
- More control over waypoint labels, including opacity and camera effects.
- A confirmation screen before importing configuration changes.
- A contributor badge and custom color for acidangels.
CHANGED
- The new waypoint renderer is now enabled by default.
- All new Waypointer share codes use the WP: prefix.
- Your publisher identity now carries across launcher profiles.
- Coordinates-only exports are now the default, with clearer controls for choosing what to export.
- Etherwarp notification sounds are configurable.
- Waypoint Painter and 3D route previews are grouped under Extras settings.
- Clearer settings navigation, import feedback, and export previews.
- Publishing warns when custom waypoint painting will not be included.
- Translation fixes and updated UI checkmarks.
FIXED
- SecretRoutes imports and incorrect Mineshaft targeting.
- Tracers becoming unexpectedly thin.
- Route-specific Paint appearance now takes priority over the global appearance setting.
- Focused temporary waypoint beacons stay visible when beacon mode is Off.
- Improved image import compatibility and painter behavior.
- Open Editor now opens the route you just imported.
- The route catalog resumes loading correctly after returning from another screen.
- Safer recovery from damaged configuration files.
- Turning off structure sharing or letting shared locations expire no longer loses your own discoveries.
PERFORMANCE
- Much faster rendering for waypoint clusters.
- More responsive route exports, publishing, and large-route previews.
- Faster paint previews and fewer repeated texture uploads.
- Less background traffic for structure sharing: 80% fewer routine snapshots under normal conditions, while new discoveries still share immediately.
Lots of attention to detail changes not mentioned here.
## Highlights
- Community routes! Publish a route in-game and browse other people's routes in game. You pick a publisher name once, and each route can be public or unlisted (unlisted means only people with the link can find it).
- To prevent spam, you can publish up to 3 routes per day, and submissions are checked automatically.
- Route folders! Group routes into colored folders, drag routes in and out, and collapse the folders you're not using right now.
- Right-click menus! Right-click a route or a waypoint to get every action in one place: edit, show/hide, move to another zone, rename, disable, and more.
- Undo for deleted routes! After deleting routes you get ten seconds to hit Undo and get them back, folders and ordering included. (This should've been in from day 0, really. Have hesitated on adding extra buttons since it clutters UI. Feedback is welcome, even if harsh!)
- Disabling waypoints! Disable without deleting them via middle click
- Waypointer now tells you in chat when a new version is out!
## Improved
- New "Previous waypoints" and "Next waypoints" settings control how much of a sequenced route is drawn around you (0-32 or All).
- New optional sound cue when your etherwarp target lines up with a waypoint. Enable it in Settings -> Appearance.
- Open the route browser from chat with
/wp routes. - Reorder routes! Drag them, use the new arrow buttons, whatever.
/wp exportnow exports your active route(s) instead of every route at once.- New Route and New Folder are now under a single New button.
- Press Space on a route in the list to show or hide it from the keyboard.
- Failed imports now tell you what actually went wrong.
- Made colors more consistent.
- Made some UI copy easier to read.
- Tons of alignment and ui cleanup.
- Waypointer now supports all 142 languages in Minecraft.
## Fixed
- Several import/export edge cases causing issues.
## Compatibility
- Supports Minecraft 26.1.2 and 26.2; both builds require Java 25.
plus fixes in 1.9.1
Lots of attention to detail changes not mentioned here.
## Highlights
- Community routes! Publish a route in-game and browse other people's routes in game. You pick a publisher name once, and each route can be public or unlisted (unlisted means only people with the link can find it).
- To prevent spam, you can publish up to 3 routes per day, and submissions are checked automatically.
- Route folders! Group routes into colored folders, drag routes in and out, and collapse the folders you're not using right now.
- Right-click menus! Right-click a route or a waypoint to get every action in one place: edit, show/hide, move to another zone, rename, disable, and more.
- Undo for deleted routes! After deleting routes you get ten seconds to hit Undo and get them back, folders and ordering included. (This should've been in from day 0, really. Have hesitated on adding extra buttons since it clutters UI. Feedback is welcome, even if harsh!)
- Disabling waypoints! Disable without deleting them via middle click
- Waypointer now tells you in chat when a new version is out!
## Improved
- New "Previous waypoints" and "Next waypoints" settings control how much of a sequenced route is drawn around you (0-32 or All).
- New optional sound cue when your etherwarp target lines up with a waypoint. Enable it in Settings -> Appearance.
- Open the route browser from chat with
/wp routes. - Reorder routes! Drag them, use the new arrow buttons, whatever.
/wp exportnow exports your active route(s) instead of every route at once.- New Route and New Folder are now under a single New button.
- Press Space on a route in the list to show or hide it from the keyboard.
- Failed imports now tell you what actually went wrong.
- Made colors more consistent.
- Made some UI copy easier to read.
- Tons of alignment and ui cleanup.
- Waypointer now supports all 142 languages in Minecraft.
## Fixed
- Several import/export edge cases causing issues.
## Compatibility
- Supports Minecraft 26.1.2 and 26.2; both builds require Java 25.
plus fixes in 1.9.1
Hopefully no issues occur!
Lots of attention to detail changes not mentioned here.
## Highlights
- New 3d route preview on the export screen. Enable in Settings -> Sharing -> Export screen.
- New appearance page in settings that consolidates all of the appearance options
- You can now choose dungeon waypoint types directly while adding or editing a waypoint, including secrets, Etherwarps, Dungeonbreaker, Superboom, pearls, items, and bats.
/wp importnow accepts route, settings, and (waypointer/odin) dungeon routes.- New icons painted by me in Aseprite. I'm no artist, so if you have any better do feel free to make a PR ^_^
## Improved
- Large imports and exports now process off of the game thread (improves performance)
- Dungeon routes are smaller, and codes from earlier Waypointer versions still import.
- Importing a single route now keeps the name stored in its share code.
- Route and waypoint lists are easier to search, scroll, navigate with a keyboard, and use with narration.
- Waypoints, tracers, and edit outlines now remain visible through glass and other translucent blocks.
- Waypoint commands now use the same one-based waypoint numbers shown by
/wp list. Route indices remain zero-based. - Numeric settings reject invalid or out-of-range values
- Dungeon rooms now complete from the actionbar secret count instead of a green checkmark from the dungeon map.
- The Everything settings preset has been replaced with Disable All.
## Removed
- Removed the one-click community dungeon-route downloader and its first-dungeon prompt. Manual file imports remain available through
/wpd import <file>. (Didn't feel right bundling someone else's hard work in my mod.) - Removed the in-game dungeon route recorder and its test, reset, room, and waypoint commands. (Too imprecise)
- Removed route timers and personal-best tracking. (Useless, but can readd if requested. Also a bit unpolished and haven't planned on improving it.)
- Removed the seven waypoint-editor shortcuts added in 1.8.6. (These were not supposed to make it to prod lol)
## Compatibility
- Supports Minecraft 26.1.2 and 26.2; both builds require Java 25. No 1.21.11 release for this version.