{"id":24359,"library":"pymctranslate","title":"PyMcTranslate","description":"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.","status":"active","version":"1.2.43","language":"python","source_language":"en","source_url":"https://github.com/minecraft-data/pymctranslate","tags":["minecraft","translation","versioning","data-conversion"],"install":[{"cmd":"pip install pymctranslate","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Used for reading/writing NBT data in Minecraft save formats","package":"nbtlib","optional":false}],"imports":[{"note":"The main class is TranslationManager, not Translator.","wrong":"from pymctranslate import Translator","symbol":"TranslationManager","correct":"from pymctranslate import TranslationManager"}],"quickstart":{"code":"from pymctranslate import TranslationManager\n\nmanager = TranslationManager()\n# Translate block 'minecraft:stone' from version 1.12.2 to 1.16.5\ntranslated = manager.translate('minecraft:stone', source='1.12.2', target='1.16.5')\nprint(translated)\n# Output: 'minecraft:stone' (or block state data)","lang":"python","description":"Initialize a TranslationManager and use .translate() to convert identifiers between versions."},"warnings":[{"fix":"Call manager.update() after initialization to ensure latest maps.","message":"Translation 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.","severity":"breaking","affected_versions":"all"},{"fix":"Use string like '1.12.2', not '1.12' or 'minecraft 1.12.2'.","message":"The 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace manager.translate_slot(...) with manager.translate(..., slot=...).","message":"The method 'translate_slot' has been deprecated since v1.2.0, use 'translate' with appropriate slot parameter instead.","severity":"deprecated","affected_versions":">=1.2.0"}],"env_vars":null,"search_vec":"'1.2.43':40 'autom':23 'block':13 'cadenc':42 'convers':25,50 'current':38 'data':10,27,49 'data-convers':48 'differ':19 'e.g':12 'file':11 'id':17 'irregular':44 'item':16 'librari':6 'map':15,37 'minecraft':9,20,45 'mod':33 'pymctransl':1,2 'python':5 'releas':41 'state':14 'structur':28 'support':34 'tool':31 'translat':8,36,46 'use':29 'version':21,35,39,47","created_at":"2026-05-01T08:12:39.326401+00:00","updated_at":"2026-05-01T08:12:39.326401+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nModuleNotFoundError: No module named 'pymctranslate'"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.2.44","cli_name":"","cli_version":null,"type":"library","homepage":"https://www.amuletmc.com","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/pymctranslate/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"install_fail","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-09","install_tag":null}}