VoxelMap

Minimap and world map for Minecraft. Clean, fast, no clutter.

About VoxelMap

VoxelMap always shows you where you are. The minimap runs alongside the game, and the fullscreen world map shows everything you've explored so far. On top of that: waypoints, radar, and a few tools that make exploring and building easier.

Client-side only — no server installation required. An optional server-side component lets server owners restrict and configure the map for everyone.

Features

Minimap & World Map

Compact minimap in the corner, fullscreen world map with a keypress. Zoom levels are freely adjustable, rotation with the player is optional.

Waypoints

Set your own markers, give them an icon and color, and toggle visibility per dimension. Waypoints can be shared with other players in chat.

Cave Mode

Underground, the map automatically switches to a cave view once the surface is blocked from view.

Radar

Shows nearby players and creatures. Names, helmets, and facing direction can be toggled individually, sneaking players can be hidden.

Biomes & Slime Chunks

Biomes are color-coded on the map or shown as an overlay. Slime chunks can be made visible, on multiplayer servers with the correct seed.

Deathpoints

A waypoint is automatically placed at your death location. Configurable to keep only the most recent one or all of them.

Server Identity

Networks with multiple addresses or proxies can send the client a fixed identity, so waypoints and map data stay the same across every address. Custom alias mappings can also be set manually.

For Server Owners

VoxelMap can be restricted and configured server-side, without players needing to install anything extra. This is not Paper-only — the exact same server-side feature set is available on every platform:

| Server software | What to install |
| --- | --- |
| Fabric | The regular VoxelMap mod jar — it contains the server part |
| Forge | The regular VoxelMap mod jar — it contains the server part |
| NeoForge | The regular VoxelMap mod jar — it contains the server part |
| Paper / Spigot-based | The separate VoxelMap Paper plugin |

The mod jar for Fabric, Forge, and NeoForge works on both client and dedicated server. On a dedicated server it activates its server-side part and behaves exactly like the Paper plugin — same options, same config file, same behavior. The Paper plugin exists only because Paper servers can't load mod jars.

Configurable options

• Allow or block minimap, world map, and waypoints individually
• Toggle radar for players and mobs separately
• Allow or disable cave mode
• Enable or disable deathpoints
• Custom teleport command for waypoints
• Fixed server identity, so waypoints and map data persist across multiple addresses or proxies
• Per-world setting overrides

Config file & reloading

| Platform | Config file |
| --- | --- |
| Fabric / Forge / NeoForge | config/voxelmap.json |
| Paper | plugins/VoxelMap/voxelmap.json |

The file is created with defaults on first start. /voxelmap reload applies changes at runtime and pushes the new settings to all online players — on every platform.

{
  "defaultConfig": {
    "radarAllowed": true,
    "radarMobsAllowed": true,
    "radarPlayersAllowed": true,
    "cavesAllowed": true,
    "minimapAllowed": true,
    "worldmapAllowed": true,
    "waypointsAllowed": true,
    "deathWaypointAllowed": true,
    "teleportCommand": "tppos",
    "worldNameSuffix": "",
    "serverIdentity": "MyNetwork"
  },
  "worldOverrides": [
    {
      "worlds": ["world_the_end"],
      "settings": {
        "radarAllowed": false,
        "cavesAllowed": false
      }
    }
  ]
}

Requirements

Runs on Fabric, Forge, and NeoForge. Client-side only — no server installation required to play. The server-side configuration is optional and only intended for server owners who want to restrict the map.