Map Creation Guide

This page covers how to create custom maps.
For auto-generated maps, see the Terrain Generation Guide.

There are two primary ways to create maps:

  • Image-based: Create an image where each pixel represents a block on the map.
  • In-game editing: Build the map manually within the game on a private server.

Important: Map dimensions must be multiples of 32x32 pixels/blocks.
Examples: 96x96, 192x96, etc.
The game uses a chunk-based loading system, so ensure both width and height are divisible by 32.

Image-Based Maps

You can use any image editor (e.g., Photoshop, GIMP) to design maps.
Each pixelโ€™s color corresponds to a specific block type.
For a list of block colors and codes, refer to the Blocks.

Note: For team-based PvP maps (such as Bedwars, TDM, or CTF), include a small bunker surrounding each spawn point. Refer to the sample maps below for examples.

Sample Maps

BedwarsParaNeighbourHood.png BedwarsParaPyramidWar.png BedwarsParaSector3.png BedwarsParaSpawnTank.png BedwarsParaSteelBridge.png BedwarsParaTreasureCastle.png BedwarsParaTreeWorld.png BedwarsParaTunnelBuszaldor.png BedwarsParaUpHill.png BedwarsParaWoodCross.png

Tips

  • The sample maps above are 96x96px (3x3 chunks). Larger maps are allowed as long as both dimensions are multiples of 32.
  • Use a vertical mirror tool to edit both sides of the map at the same time.
  • Use a background layer for the sky color.
  • Save maps as PNG to prevent color loss.

In-Game Map Editing

Once your image map is created, it can be imported into the game and saved in the Lurkers map format.
Alternatively, you can build a map from scratch directly in-game by placing blocks manually.

Prerequisite: Use a private server for in-game editing.

The following guide demonstrates creating a new Bedwars map:

-- create a new empty map
/lua changeScript("bedwars", "maps/MyMapName")

-- load png (URL's are supported too)
/imagetoblocks "map_structures/maps/BedwarsParaTunnelBuszaldor.png" -32 63

-- place chests, doors
-- TODO (they can be placed manually, just change teams and place the entities)

-- set configs
-- (you can see coordinates by pressing `F3`)
/mapconfig red_spawn_position 45,-28
/mapconfig red_protected_area 42,16,8,8
-- (you can find the entity ID's in the Inspect Tool if you have the `dev` role)
/mapconfig red_bed_id 758118866

/mapconfig blue_spawn_position -15,19
/mapconfig blue_protected_area -22,12,10,10
/mapconfig blue_bed_id 458555685

-- optional: override map size (default 3x3 chunks / 96x96 blocks)
-- you must reload the map to update the map size!
/mapconfig map_chunk_width 5
/mapconfig map_chunk_height 5

-- save map
/savemap maps/MyMapName