Registry / data / pymctranslate

pymctranslate

library1.2.44pypypiunverified

PyMcTranslate is a Python library for translating Minecraft data files (e.g., block state mappings, item IDs) between different Minecraft versions. It automates the conversion of data structures used by tools and mods, supporting versioned translation maps. Current version 1.2.43, release cadence is irregular.

data serialization

pip install pymctranslate

package ↗homepage ↗

INSTALL

IMPORT

SIG · PYMCTRANSLATE

pymctranslate

datapythonv1.2.44

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TranslationManager

✓ from pymctranslate import TranslationManager

✗ from pymctranslate import Translator

The main class is TranslationManager, not Translator.

Initialize a TranslationManager and use .translate() to convert identifiers between versions.

from pymctranslate import TranslationManager manager = TranslationManager() # Translate block 'minecraft:stone' from version 1.12.2 to 1.16.5 translated = manager.translate('minecraft:stone', source='1.12.2', target='1.16.5') print(translated) # Output: 'minecraft:stone' (or block state data)

Debug

Known issues

breakingTranslation maps are stored in local cache. If cache is outdated or missing, translation may fail or return original identifier. Always call manager.update() to refresh maps before first use.

fix

Call manager.update() after initialization to ensure latest maps.

affects: all

gotchaThe library uses semantic versioning for Minecraft versions (e.g., '1.12.2'). Do not include 'minecraft:' prefix in the version string; only the numeric version.

fix

Use string like '1.12.2', not '1.12' or 'minecraft 1.12.2'.

affects: all

deprecatedThe method 'translate_slot' has been deprecated since v1.2.0, use 'translate' with appropriate slot parameter instead.

fix

Replace manager.translate_slot(...) with manager.translate(..., slot=...).

affects: >=1.2.0

Upgrade

Version history

1.2.44latest on PyPI · released Jun 17, 2026

Audit

Dependencies

nbtlibrequiredUsed for reading/writing NBT data in Minecraft save formats

Agent activity

9 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/pymctranslate/ ↗

homepagehttps://www.amuletmc.com ↗