---
id: amulet-core
version: "1.9.44"
license: unclear
license_treatment: unclear
maintenance: active
---

# amulet-core — A Python library for reading/writing Minecraft's various save formats.

License: unclear · Maintenance: active · Downloads: 499.4K/mo

## 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 above — 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

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

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 499.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

minecraft world data reader, minecraft save format parser, nbt data manipulation, minecraft level editing library, minecraft world file handler, minecraft dimension data access, minecraft schematic processor, minecraft, game-data, nbt-format

[View on SkillFed](https://skillfed.io/packages/amulet-core) · [View on PyPI](https://pypi.org/project/amulet-core/)