Hytale mod

BetterMap

The most downloaded Hytale mod: persistent exploration, cave maps, waypoints, shared mapping, and fast weekly compatibility updates.

Role
Original idea owner / core developer / maintainer
Team
Core maintainers plus contributors
When
Jan 2026 — Present
Status
released
824,090
CurseForge downloads
49
GitHub stars
12
GitHub forks
293
GitHub commits
1.1K
CurseForge comments
20,000+
User base handled

BetterMap is a quality-of-life Hytale mod designed to solve the problem of the default map forgetting explored areas. It records visited map data across sessions, adds cave visualization, improves waypoint workflows, provides admin configuration, supports linked/shared exploration, and includes performance strategies for chunk loading and map quality settings.

The problem

The default Hytale map only shows a local circular area and forgets where players have been after they move away.

The solution

Persist exploration data per world, add cave-specific mapping, improve waypoint management, and optimize rendering/loading so exploration remains useful at scale.

Explore the actual map

This is a real world map rendered by BetterMap — drag to pan, scroll or pinch to zoom, exactly like players do in game.

BetterMap world mapCharting the world…

Cave mode

Underground exploration gets its own map layer — cave chunks and a configurable fog of war. Watch the fog lift as you scroll.

Cave mode map rendering
Cave chunks revealed while spelunking
Cave mode with fog of war
Configurable cave fog of war

Waypoints, evolved

Waypoint menu
Waypoint menu
Waypoint creation dialog
Creation with icons & colors
Waypoint context menu
Context editing on the map

Built to perform at scale

Dynamic chunk loading plus LOW / MEDIUM / HIGH map quality keep the map smooth on every machine — essential at 20,000+ users.

Map at LOW quality
LOW — fastest
Map at MEDIUM quality
MEDIUM — balanced

Every detail configurable

BetterMap configuration UI
In-game configuration UI
BetterMap help UI
Built-in help

Features

  • Persistent exploration map
  • Cave mode
  • Better waypoint system
  • Shared map functionality
  • Configurable UI
  • Performance-oriented rendering
  • Community support workflow

What I did

  • Defined the original product idea: improving the Hytale map with persistent exploration and quality-of-life map tooling.
  • Implemented the base persistent map system and core mod behavior.
  • Reviewed pull requests from contributors and validated changes before release.
  • Handled user tickets and feedback from a large user base, including 10+ tickets per day at peak usage.
  • Managed release communication, beta testing phases, and release validation.
  • Designed and implemented cave mode and the improved waypoint system.
  • Shipped frequent compatibility patches for weekly Hytale pre-release updates that often broke the mod.

Project timeline

From the original persistent-map idea at Hytale release to major releases, community support, and weekly compatibility patches.

  1. Jan 2026 ~ Idea

    Original persistent-map idea

    Started BetterMap around the Hytale release period with the core idea of improving the default map through persistent exploration.

  2. Jan 2026 ~ Development

    Base persistent map system implemented

    Implemented the first core system for saving explored areas and making map exploration useful across sessions.

  3. Jan 2026 Release / Delivery

    Version 1.2.0 released

    Released BetterMap 1.2.0, an important early release in the mod lifecycle.

  4. Feb 2026 ~ Development

    Cave mode and better waypoints

    Designed and implemented cave mode and an improved waypoint system to make exploration and navigation more useful.

  5. Feb 2026 ~ Impact / Result

    Large user-support workflow

    Handled support and tickets from a large user base, reaching around 10+ tickets per day at peak usage.

  6. Feb 2026 Release / Delivery

    Version 1.3.0 released

    Released BetterMap 1.3.0, described as the biggest update of the project so far.

  7. 2026 ~ Impact / Result

    Most downloaded Hytale mod

    BetterMap became the most downloaded Hytale mod and reached a large player base.

  • Weekly Hytale pre-release compatibility patches · weekly, since Jan 2026

    Shipped regular patches after weekly Hytale pre-release updates broke mod behavior or required adaptation.

Built with

  • Java
  • Hytale modding
  • Config systems
  • Performance optimization
  • GitHub PR review
  • Community support
  • Release management