World tool

Map Revealer

Put your world on the map.

Reveal terrain, create item-frame map walls, and keep them refreshed with labels and player markers.

  • Paper
  • Minecraft 1.20.4
  • Java 17+
  • MIT

What it does

Use themed palettes, fixed Y-level slices, and automatically refreshed map walls. Terrain renders progressively. Missing terrain stays transparent by default: explore or pregenerate it, then refresh. Use scale 0 or 1 for a local wall; a 10×10 scale-4 wall spans 20,480×20,480 blocks. Tune lookup and capture budgets for your server.

  • Renders all 128 × 128 pixels of the map held in the player's main hand
  • Supports all five Minecraft map scales (0–4), surface rendering, and fixed Y-level slices
  • Renders Overworld terrain, End islands with transparent void, and Nether slices below the bedrock roof
  • Includes normal colors and nine themed palettes

Features

  • Renders all 128 × 128 pixels of the map held in the player's main hand
  • Supports all five Minecraft map scales (0–4), surface rendering, and fixed Y-level slices
  • Renders Overworld terrain, End islands with transparent void, and Nether slices below the bedrock roof
  • Includes normal colors and nine themed palettes
  • Preserves terrain shading while applying themed colors
  • Automatically locks maps rendered with a themed scheme
  • Provides a separate command for locking any filled map
  • Creates complete map grids in connected empty item frames and glow item frames
  • Adopts correctly aligned maps already sitting in frames without replacing their map IDs
  • Refreshes managed walls automatically and writes only map pixels whose colors changed
  • Supports per-wall intervals, locked or unlocked maps, player markers, region labels, and optional expansion
  • Captures chunks safely, processes immutable terrain snapshots asynchronously, and applies map changes on the server thread
  • Refuses irregular layouts, non-map frame contents, mismatched existing maps, and ownership conflicts

Installation

  1. 1

    Check your server

    Run Paper with Java 17 or newer, built for Minecraft 1.20.4. No other plugins are required.

  2. 2

    Add the JAR

    Stop the server, download Map-Revealer-1.2.1.jar, and place it in plugins/. When upgrading, replace the previous JAR.

  3. 3

    Start and configure

    Start the server and check the console. Review the generated configuration with the release documentation.

First command
/revealmap

Hold a filled map in your main hand and run the command to render the terrain it covers.

Commands18

CommandDescription
/revealmap reveal [depth] [theme]Render the held map with explicit command structure. The shorter forms below remain supported.
/revealmapRender the held map at surface level with normal colors.
/revealmap <depth>Render from a specific Y-level within the current world's height bounds.
/revealmap <scheme>Render the surface with one of the listed schemes.
/revealmap <depth> <scheme>Combine a Y-level with a color scheme. The two arguments may be supplied in either order.
/revealmap lockLock the held map against normal exploration updates.
/revealmap schemesList all schemes in chat. /revealmap colors does the same.
/revealmap helpShow the in-game command summary.
/revealmap wall create <name> [scale]Create or safely adopt the connected rectangular frame wall being viewed.
/revealmap wall expand <name>Add connected empty frames around the managed frame being viewed.
/revealmap wall refresh <name|all>Force an immediate terrain refresh.
/revealmap wall set <name> theme <theme>Apply and save a wall theme, then refresh it.
/revealmap wall set <name> depth <Y|auto>Choose a slice or the dimension default, then refresh it.
/revealmap wall set <name> interval <minutes>Change the automatic refresh interval.
/revealmap wall set <name> <locked|markers|auto-expand> <on|off>Change a boolean wall option.
/revealmap wall set <name> label <text|off>Add or remove the origin-map region label.
/revealmap wall listShow stored wall sizes and settings.
/revealmap wall remove <name>Stop managing a wall without deleting its frames or maps.

Permissions2

PermissionDefaultDescription
maprevealer.revealOperatorsReveal or lock a filled map held in the main hand.
maprevealer.wall.manageOperatorsCreate, configure, expand, refresh, and remove managed map walls.

Configuration14

SettingDefaultDescription
rendering.generate-missing-chunksfalseAllow a reveal to generate terrain that does not exist yet
rendering.max-chunks-per-map16384Refuse a single map render above this terrain-chunk count
rendering.capture-chunks-per-tick16Maximum chunk captures requested per batch
rendering.lookup-chunks-per-tick256Maximum asynchronous chunk lookups per server tick; snapshots still obey the capture limit
rendering.nether-depth64Default downward slice in Nether worlds; avoids the roof
rendering.max-pending-maps256Maximum queued wall or held-map renders
map-walls.max-frames256Maximum maps managed by one wall
map-walls.max-scale4Largest scale accepted when creating or adopting a wall
map-walls.discovery-span24Maximum frame discovery distance from the selected frame
map-walls.minimum-refresh-minutes5Lowest per-wall interval accepted by commands
map-walls.defaults.refresh-minutes30Initial automatic refresh interval
map-walls.defaults.lockedtrueLock newly generated wall maps by default
map-walls.defaults.player-markersfalseShow online players on new walls
map-walls.defaults.auto-expandfalseAutomatically claim a newly placed adjacent empty frame

Release notes

Map Revealer v1.2.1

Map Revealer 1.2.1 fixes server stalls and unclear blank-map behavior when rendering large, high-scale walls.

Questions or an issue?

Bug reports, questions, and contributions go to this plugin’s GitHub repository.

Open an issue