amulet-core
A Python library for reading/writing Minecraft's various save formats.
Decision gist · record as of 2026-08-14
Yes, if you need to read or write Minecraft world data programmatically. The package is actively maintained, installs with low friction, and has no known vulnerabilities. However, verify the license terms before use in proprietary or redistributed projects, as the license status is unclear in the metadata. Requires Python 3.11+.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; depends on numpy and platform-specific database libraries (amulet-leveldb, amulet-rocksdb).
- Low friction install with a wheel distribution.
- Active maintenance with a release 4 days ago.
License · maintenance · safety
(unclear) — License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or redistributed work.
last release 2026-08-10 (4 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 499,386 downloads/mo, #6,324 on PyPI
Alternatives
Verify before relying
pip install amulet-core
import amulet_core
# Access Minecraft world data structures via the library's API- Specific API surface and which Minecraft versions/formats are supported
- Whether the library handles Java Edition, Bedrock Edition, or both
- Performance characteristics for large worlds or batch operations
- Actual license terms (SPDX and raw license text are both absent from metadata)
What it is and what it does
Amulet Core is a Python library that reads and writes Minecraft world save data across different formats and versions. It exposes NBT structures, level metadata, and dimension information as programmatic objects, allowing developers to inspect, modify, or extract data from Minecraft worlds without manually parsing binary formats. The library is the foundation for the Amulet Map Editor and is designed for world editing workflows.
The package depends on numpy for numerical operations, amulet-nbt for NBT serialization, pymctranslate for version translation, and platform-specific database backends (leveldb and rocksdb). It requires Python 3.11 or later and installs as a pure Python wheel with low friction. Maintenance is active, with recent releases indicating ongoing development.
Use it for
- Programmatically read and modify Minecraft world NBT data for automated world generation or editing
- Extract player data, structures, or biome information from saved Minecraft worlds for analysis
- Build custom world editing tools or plugins that need to parse and write Minecraft save formats
- Convert or migrate Minecraft worlds between different versions or formats
- Integrate Minecraft world data into data pipelines or analysis workflows
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to read or write Minecraft world data programmatically.
The package is actively maintained, installs with low friction, and has no known vulnerabilities. However, verify the license terms before use in proprietary or redistributed projects, as the license status is unclear in the metadata. Requires Python 3.11+.
Install
amulet-core on PyPI
Before you install
Low friction install with a wheel distribution. Active maintenance with a release 4 days ago. Requires Python 3.11 or later. Eight runtime dependencies including numpy, NBT handling, and database libraries are automatically installed.
Requires Python 3.11 or later; depends on numpy and platform-specific database libraries (amulet-leveldb, amulet-rocksdb).
License in practice
License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or redistributed work.
Quickstart
pip install amulet-core
import amulet_core
# Access Minecraft world data structures via the library's API
Verify before relying
- Specific API surface and which Minecraft versions/formats are supported
- Whether the library handles Java Edition, Bedrock Edition, or both
- Performance characteristics for large worlds or batch operations
- Actual license terms (SPDX and raw license text are both absent from metadata)
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 8 packagesnumpyamulet-nbtpymctranslateportalockeramulet-leveldbplatformdirslz4amulet-rocksdb |
| Maintenance | Actively maintained 4 days since the last release |
| First released | |
| Downloads | 499,386 / month, #6,324 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Operating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: amulet_core-1.9.44-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “minecraft world data reader”
- amulet-coreAmulet Core reads and writes Minecraft world data in various save…
- mcpylibMCPyLib is a Python client library for remotely controlling Minecraft…
- amulet-leveldbProvides a Cython wrapper around Mojang's modified LevelDB library…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also amulet-leveldb · nbtlib · mcpylib · mcstatus · pyaaf2 · pytiled-parser · EditorConfig · editor · reflex-components-dataeditor