How Minelog works

Add waypoints by hand right in Minelog, or install the optional behavior pack (currently only available for Minecraft Bedrock) to capture your exact coordinates in-game and import them as a line of JSON. Here's the whole loop, step by step.

The add-on is optional.

You can add waypoints by hand at any time — open a world in Minelog and use the Add a Waypoint form to enter a name and coordinates. The Minelog Waypoints behavior pack below is the fastest way to capture lots of exact positions while you play, but it is not required to use Minelog.

Capture in-game (optional)

Install the Bedrock add-on, save positions with /wp: commands, and export your log as a line of JSON.

Add & share in Minelog

Add waypoints by hand or paste the export, enrich them with notes and screenshots, then map and share.

1. Capture coordinates with the Minecraft add-on (optional)

Skip this whole section if you'd rather add waypoints by hand — jump to step 2. Otherwise, Minelog ships with a Bedrock behavior pack called Minelog Waypoints. It records your exact position with a label and stores the log inside your world, so it survives restarts and works on Realms.

1a. Install the add-on

1
Download the add-on

Grab the latest minelog.mcpack from the Releases page on GitHub. No tools required — just download the file.

Prefer to build it yourself? Zip the contents of the addon/ directory so manifest.json sits at the zip root:
```
cd addon && zip -r ../minelog.mcpack . -x 'README.md' && cd ..
```
2

Import it into Minecraft

Double-click minelog.mcpack (or open it with Minecraft). Bedrock imports it as an available behavior pack.
3

Enable it on your world

For a local world: Create/Edit World → Behavior Packs → activate Minelog Waypoints. For a Realm: Realm settings → World → Behavior Packs. No experiments are required.
4

Turn on Cheats

World settings → Game → Cheats. Bedrock only exposes custom slash commands when cheats are on. Heads up: enabling cheats disables achievements for that world — a Minecraft limitation the add-on can't work around.

Requirements: Minecraft Bedrock 1.21.80+ with cheats enabled on the world. The add-on uses the @minecraft/server scripting API, which is Bedrock-only (it does not work on Java Edition).

1b. Save waypoints while you play

Open the in-game chat and type a command. When you save, the add-on records your exact coordinates, the dimension you're in, and the label you gave it.

Command	What it does
/wp:save "<label>"	Save your current position with a label.
/wp:list	List every saved waypoint with its number.
/wp:remove <n>	Remove waypoint number n (from /wp:list).
/wp:export	Print the full log as JSON to copy into Minelog.
/wp:clear true	Delete all saved waypoints.
/wp:help	Show the list of commands.

Example: standing at your base, type /wp:save "Main base" and Minelog confirms the saved coordinates in chat.

1c. Export the log from the game

When you're ready to bring your waypoints into Minelog, run:

/wp:export

The add-on prints your whole log as a single JSON line in chat. Select and copy that line.

Playing on Switch or a console? Some consoles can't copy chat text. Join the same Realm from a PC or phone Bedrock client (with the pack enabled), run /wp:export there, and copy the line. Your waypoints live inside the world, so they're available from any device on that Realm.

A note on limits: The log is stored in a single world property capped at about 250–270 waypoints. The add-on warns you in chat as you approach the limit — export and import into Minelog before it fills up.

2. Add waypoints in Minelog

1

Create a world

In My Worlds, create a world to hold your waypoints. Add a name, an optional description, and the world seed so others can reproduce it.
2

Add by hand, or paste an export

Open the world and press Add Waypoints. Use the "Add a Waypoint" form to type in a name and coordinates — no add-on needed — or, if you used the add-on, paste the exported line into "Import from Realm" and press Import waypoints. Re-importing is safe: Minelog updates existing waypoints instead of duplicating them.
3

Enrich & browse

Add notes, tags, and screenshots to each waypoint, filter by dimension, and switch to the interactive map to see everything in place.
4

Share it

Flip a world to Public and anyone with the link can browse its gallery, map, and seed — no account needed.

Ready to map your world?

Create a free account, spin up a world, and paste in your first export.

Start your log Explore public worlds ↓