McpeTool
github.com
What it is
McpeTool is a free, offline utility for reading and writing Minecraft Bedrock Edition world data. Its command-line interface and local HTTP API provide get, put, and delete operations. Database commands list, retrieve, write, and delete key/value pairs in a world’s LevelDB store. Level-data commands retrieve or replace level.dat contents using JSON, YAML, hex dump, base64, or binary formats. NBT data can be converted to JSON and YAML, and relevant commands accept or produce base64 and binary data. The API starts a local HTTP server and handles GET, PUT, and DELETE requests for database keys. The tool runs on Linux, macOS, and Windows and can be self-hosted or used through its API. It is MIT-licensed and intended as a basic access layer for people building more capable world editors. McpeTool cannot be used while Minecraft is running the world because LevelDB allows only one process at a time. The maker calls it a work in progress, says input validity is not currently checked, and advises backing up worlds before changes.
Spec sheet
- Purpose
- McpeTool reads and writes world data from Minecraft Bedrock Edition.Read 9 Oct 2026 · github.com
- Intended users
- The maker describes the tool as a basic access tool for other people building more intelligent or user-friendly world editors.Read 9 Oct 2026 · github.com
- License
- The repository includes the MIT License, which grants permission to use, copy, modify, distribute, sublicense, and sell copies subject to its conditions.Read 9 Oct 2026 · github.com
- API behavior
- The API runs a local HTTP server and supports GET, PUT, and DELETE requests for database keys.Read 9 Oct 2026 · github.com
- CLI and HTTP API
- It provides get, put, and delete operations through a command-line interface and HTTP API.Read 9 Oct 2026 · github.com
- Data formats
- The tool supports JSON and YAML conversion for NBT data, as well as base64 and binary inputs or outputs for relevant commands.Read 9 Oct 2026 · github.com
- Data validation
- The tool does not currently validate whether input data is valid for the game.Read 9 Oct 2026 · github.com
- Integration
- The README identifies nbt2json as the module used for NBT-to-JSON and YAML formatting.Read 9 Oct 2026 · github.com
- Level data
- The leveldat commands retrieve or replace level.dat contents in JSON, YAML, hex dump, base64, or binary formats.Read 9 Oct 2026 · github.com
- Maker affiliation
- The author says they are not affiliated with Minecraft, Mojang, or Microsoft.Read 9 Oct 2026 · github.com
- Not for active worlds
- The maker says McpeTool cannot be used while Minecraft is running the world because LevelDB permits only one process at a time.Read 9 Oct 2026 · github.com
- Offline operation
- The maker describes McpeTool as an offline tool.Read 9 Oct 2026 · github.com
- Work in progress
- The maker describes the tool as a work in progress and advises backing up worlds before modifying them.Read 9 Oct 2026 · github.com
- World database
- Its database commands list, retrieve, write, and delete key/value pairs in the world's LevelDB store.Read 9 Oct 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Free MIT-licensed software
- Works offline on Linux, macOS, and Windows
- Command-line and local HTTP API access
- Reads and writes LevelDB world data
- Supports JSON, YAML, base64, and binary formats
Limits
- Cannot run while Minecraft has the world open
- Input data is not currently validated
- Described as a work in progress
- Backups are advised before modifications
Who it suits
It suits developers building world editors or scripts for Minecraft Bedrock world data. Users should be comfortable with command-line or local HTTP operations.
Verdict
McpeTool offers low-level access to Bedrock world databases and level data through CLI and HTTP interfaces. Its format support is broad, but editing requires stopping the active world and handling unvalidated input carefully.
Where Specifiction places it
- Minecraft World Editors#11 of 357.9
- Code Snippet Managers#13 of 338.0
- Minecraft Add-on Editors#13 of 267.8