amulet-core

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

Amulet Core reads and writes Minecraft world data in various save formats, providing programmatic access to NBT structures, level data, and dimension information for world editing and analysis.

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

pip install amulet-core

uv add amulet-core

poetry add amulet-core

Installing amulet-core

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.

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

Requires Python 3.11 or later; depends on numpy and platform-specific database libraries (amulet-leveldb, amulet-rocksdb).

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

Evidence: amulet_core-1.9.44-py3-none-any.whl

Tags

More Utilities packages