# Waypointer 1.8.0-beta (Minecraft 26.1.2 and 26.2)
This is Waypointer’s largest update yet. It adds the first beta version of Dungeon Routes, support for Minecraft 26.1.2 and 26.2, major route editor upgrades, shorter and safer share codes, broader import/export compatibility, config sharing, new visual settings, improved commands, and many fixes.
**Dungeon Routes are still in beta. Issues are most likely around room detection and orientation!**
Please report any unexpected behavior on the Issues page.
## Highlights
- Added beta Dungeon Routes with automatic Catacombs room detection and room-specific progression.
- Added separate support for Minecraft 26.1.2 and 26.2.
- Added route creation and editing for zones and dungeon rooms outside of hypixel
- Added shorter and safer Waypointer share codes.
- Added current import/export support for several popular waypoint mods.
- Added config sharing with `WPC:` codes.
- Rebuilt the main Waypointer GUI, route editor, export screen, and settings screen.
- Added Edit Mode, tiny subwaypoints, route connector lines, and dungeon pathfinding.
- Removed owo-lib as a dependency.
## Added
### Dungeon Routes
- Added beta Dungeon Route support.
- Added recognition data for all 140 Catacombs rooms.
- Added automatic room orientation and origin detection.
- Added manual room rotation commands:
- `/wpd rotate nw`
- `/wpd rotate ne`
- `/wpd rotate sw`
- `/wpd rotate se`
- `/wpd rotate auto`
- Added a `Dungeon Rooms` section to the main Waypointer GUI.
- Added room-local dungeon routes.
- Added dungeon route sharing with `WPD:` codes.
- Added dungeon route importing for:
- Waypointer `WPD:` codes.
- Waypointer dungeon room JSON.
- SecretRoutes `routes.json`.
- Odin waypoint-pack JSON.
- Odin Base64+GZIP share strings.
- Added SecretRoutes conversion.
- Secret positions become ordered route waypoints.
- Etherwarp, stonk, Superboom, lever, ender-pearl, bat, item, interact, and exit actions are converted where possible.
- Added Odin route conversion.
- Added a one-click community route installer.
- Available through `/wpd routes download`. (Note: These probably do not convert properly. Looking for a community-made route pack! Will credit in the official mod, of course.)
- Route source attribution is shown.
- Added automatic dungeon route progress.
- Added commands for manually advancing, completing, and resetting dungeon routes.
- Added an optional ground path to the active dungeon waypoint.
- Added optional dungeon diagnostics to help report room-detection and route-progression problems.
### Route management
- Added offline route creation
- Added route previewing and editing outside Hypixel
- Added offline dungeon room route creation.
- Added a complete selectable zone list.
- Added Safari and Torrhus Canyon mappings
- Added Lotus Atoll and current Crystal Mineshaft variants to the zone list.
- Added route search.
- Added route multi-selection.
- Added `Shown` and `Hidden` controls to route rows.
- Added `Hide All`.
- Added double-click route editing.
- Added automatic `Route N` naming using the lowest unused number.
- Added clearer guidance for empty routes.
- Added route and waypoint counts to route-selection screens.
### Edit Mode and route editing
- Added Edit Mode for moving waypoints directly in the world.
- Renamed “Reposition Mode” to “Edit Mode.”
- Added optional Edit Mode sounds.
- Added an optional persistent `EDIT MODE` HUD indicator.
- Added keybinds for:
- Add Subwaypoint Where Looking.
- Add Small Subwaypoint Where Looking.
- Go Back Waypoint.
- Enter Edit Mode.
- Exit Edit Mode.
- Toggle Edit Mode.
- Added tiny subwaypoints.
- Support precise 1/16-block placement.
- Small and filled styles can be selected independently.
- Added an information hover (i) explaining the route editor’s controls.
- Added more command-based route and waypoint editing.
- Move and insert waypoints.
- Rename waypoints and routes.
- Change colors and radii.
- Change subwaypoint styles.
- Change route zones and modes.
- Enable or disable routes.
- Configure skip-ahead.
- Change route color modes.
- Added `/wp route` as the primary route command.
- `/wp group` remains available as a compatibility alias.
- Added `/wp skipto`.
- Added `/wp reset`.
- Added `/wp editmode` and `/wp edit mode`.
### Share codes and config sharing
- Added Waypointer codec v8.
- Route codes are shorter than in Waypointer 1.7 (wow)
- Current codes can detect corruption or accidental modification.
- Invalid or unexpectedly large codes are rejected safely.
- Added better subwaypoint sharing.
- Small and filled subwaypoint styles are preserved.
- Precise 1/16-block subwaypoint placement is preserved.
- Restored importing of old v1 Waypointer codes.
- Waypointer now imports route codes from every codec version from v1 through v8.
- Added support for importing codes copied from Markdown code blocks.
- Added config sharing with `WPC:` codes.
- Requires confirmation before replacing the current settings.
### Import and export compatibility
- Added current Skyblocker V1 import and export.
- Added current Skytils support.
- Added current SkyHanni ordered-route JSON support.
- Added Soopy V1 share-code importing.
- Added Firmament absolute waypoint-share importing.
- Added generic JSON waypoint importing.
- Added export targets for:
- Waypointer.
- Skyblocker.
- Skytils.
- SkyHanni.
- Added route selection to the export screen.
- Added warnings when the selected export format cannot preserve a feature.
- For example, subwaypoints may become normal waypoints in another mod.
- Added clearer errors when another mod’s format cannot represent a route’s zone.
- Added export labels.
- Added character-count and chat-fit warnings.
- Added a scrollable export preview.
### Settings and visuals
- Added a completely rebuilt settings screen.
- Waypoints.
- Labels.
- Tracers.
- Beacon Beams.
- Routes & Progression.
- Dungeons.
- Chat.
- Sharing.
- System.
- Added settings search.
- Added collapsible settings that depend on another option.
- Added indicators for modified settings.
- Added individual setting reset buttons.
- Added Minimal, Default, and Everything presets.
- Added confirmation for `Disable All` and `Reset to Defaults`.
- Added a built-in performance test.
- Tests Waypointer with a large temporary route.
- Measures the impact of individual visual features.
- Restores the previous settings and removes the test route afterward.
- Produces a copyable performance report.
- Added route connector lines.
- Added a route-line color setting.
- Added waypoint label scale.
- Added waypoint label height.
- Added an option to hide labels near the player without hiding the waypoint itself.
- Added sharp waypoint edges.
- Added vanilla-textured beacon beams.
- The simpler flat beam remains available as a more performant option.
- Added a default color for new waypoints.
- Added imported-route color options:
- Use one configured color.
- Create an automatic gradient.
- Keep the imported colors.
- Added a default imported-route color.
- Added `Only skip to visible waypoints`.
- Added contributor badges in chat and the player list. (Currently only me, `Babbur`)
- Can be disabled in Settings.
- Added manual update checks and verified update downloads from Settings.
- Restarting Minecraft is still required after downloading an update.
### Commands and chat
- Reworked `/wp help` into topic-based pages with examples.
- Added clearer command suggestions for waypoints, routes, zones, modes, insertion positions, colors, and subwaypoints.
- Added more useful `/wp debug` information
- Changed chat imports to use short clickable handles instead of placing an entire route code inside a command.
- Added better feedback after importing through a command.
## Changed
### Compatibility and requirements
- Updated Waypointer from Minecraft 1.21.11 to Minecraft 26.1.2 and 26.2.
- Minecraft 26.1.2 and 26.2 now receive separate jars.
- Updated the required Java version from 21 to 25.
- Updated the minimum Fabric Loader version from 0.18.2 to 0.19.3.
- Changed Hypixel Mod API from optional to required.
- owo-lib is no longer required.
- Documented more lenient minimum Fabric API versions:
- Minecraft 26.1.2: `0.145.4+26.1.2` or a newer compatible 26.1.2 release.
- Minecraft 26.2: `0.147.1+26.2` or a newer compatible 26.2 release.
- Hypixel Mod API 1.0.2 or newer is required.
### Main GUI and editor
- Reworked the main Waypointer GUI for larger route collections and dungeon room routes.
- Reorganized the GUI to fit correctly at GUI scales 4 and 5.
- Moved Settings into the main header.
- Moved Delete to the end of the action row.
- Made empty zones less visually prominent.
- Kept Dungeon Rooms visible when installed secrets are available.
- Changed user-facing “group” terminology to “route.”
- Reworked short editor layouts to prevent controls from overlapping.
- Changed static route color mode so it recolors existing and newly added waypoints.
- Changed temporary waypoint durations from minute-only values to second precision.
- Existing settings are migrated automatically.
- Changed the default maximum number of visible labels to 32 for better performance with large routes.
- Setting it to `0` still allows unlimited labels.
- Changed the GUI key so it can hide and resume the current Waypointer screen.
- Only the main Waypointer GUI key is bound by default.
- Route-changing keybinds must be assigned manually.
- Changed Crystal Mineshaft variants to share one `Mineshaft: Crystal` route section.
- Zone IDs are now handled case-insensitively.
There's probably more but I'm bad at doing changelogs because I don't break my commits up enough.
## Requirements
- Minecraft 26.1.2 or 26.2.
- Java 25 or newer.
- Fabric Loader 0.19.3 or newer.
- Fabric API:
- Minecraft 26.1.2: `0.145.4+26.1.2` or a newer compatible 26.1.2 version.
- Minecraft 26.2: `0.147.1+26.2` or a newer compatible 26.2 version.
- Hypixel Mod API 1.0.2 or newer.
## Beta notes
- The bundled 140-room catalog contains room recognition data, shapes, and room information. **It does not contain secret routes by default!**
- Dungeon Routes remain in beta, especially:
- Room identification.
- Room orientation.
- Multi-part and L-shaped rooms.
- Automatic secret triggers.
- Green-checkmark syncing.
- SecretRoutes and Odin imports.
- `WPD:` sharing.
- Community route downloads.
- Please include `/wp devmode report` output when reporting room-detection problems where possible.
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }