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
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