Skip to content

Instantly share code, notes, and snippets.

@misode
Last active November 13, 2026 10:52
Show Gist options
  • Select an option

  • Save misode/f29952a2ae7ba90d308a98f358239367 to your computer and use it in GitHub Desktop.

Select an option

Save misode/f29952a2ae7ba90d308a98f358239367 to your computer and use it in GitHub Desktop.
Upgrade script for updating data packs from 26.2 to 26.3 - IMPORTANT: Take a backup or use git, because this upgrades files in-place! DONT run the script multiple times!
import copy
import json
import glob
import os
import sys
from typing import Any, Callable
def main():
if len(sys.argv) < 2:
print("Usage: python upgrade_26_3.py <pattern>")
sys.exit(1)
targets = [
("loot_table", fix_loot_table),
("predicate", fix_predicate_root),
("item_modifier", fix_item_modifier_root),
("advancement", fix_advancement),
("enchantment", fix_enchantment),
("recipe", fix_recipe),
]
fixed_count = 0
for pattern in sys.argv[1:]:
for target, fixer in targets:
for filepath in glob.glob(os.path.join(pattern, "data", "*", target, "**", "*.json"), recursive=True, include_hidden=True):
result = process_file(filepath, fixer)
if result:
fixed_count += 1
print(f"Fixed {fixed_count} files!")
def process_file(filepath: str, fixer: Callable[[Any], Any]) -> bool:
with open(filepath, "r", encoding="utf-8") as f:
content = f.read()
try:
data = json.loads(content)
indent = detect_indent(content)
new_data = copy.deepcopy(data)
new_data = fixer(new_data)
except json.JSONDecodeError as e:
print(f"ERROR Parsing file {filepath}: {e}")
return False
except Exception as e:
print(f"ERROR Processing file {filepath}: {e.__class__.__name__} {e}")
raise e
if data != new_data:
with open(filepath, "w", encoding="utf-8") as f:
json.dump(new_data, f, indent=indent, ensure_ascii=False)
f.write("\n")
return True
return False
def detect_indent(content: str):
for line in content.splitlines():
if line.startswith("\t"):
return "\t"
elif line.startswith(" ") and line.strip():
spaces = len(line) - len(line.lstrip())
return spaces
return 2
def fix_loot_table(data: Any) -> Any:
if "pools" in data:
data["pools"] = [fix_loot_pool(p) for p in data["pools"]]
if "functions" in data:
data["modifier"] = fix_item_modifier(data["functions"])
del data["functions"]
return data
def fix_loot_pool(data: Any) -> Any:
data["rolls"] = fix_context_int(data["rolls"])
if "bonus_rolls" in data:
data["bonus_rolls"] = fix_context_int(data["bonus_rolls"])
if "entries" in data:
data["entries"] = [fix_loot_entry(e) for e in data["entries"]]
if "conditions" in data:
data["condition"] = fix_predicate(data["conditions"])
del data["conditions"]
if "functions" in data:
data["modifier"] = fix_item_modifier(data["functions"])
del data["functions"]
return data
def fix_loot_entry(data: Any) -> Any:
match get_id(data["type"]):
case "tag":
data["items"] = "#" + data["name"]
del data["name"]
case _: pass
if "children" in data:
data["children"] = [fix_loot_entry(c) for c in data["children"]]
if "conditions" in data:
data["condition"] = fix_predicate(data["conditions"])
del data["conditions"]
if "functions" in data:
data["modifier"] = fix_item_modifier(data["functions"])
del data["functions"]
return data
def fix_predicate_root(data: Any) -> Any:
data = fix_predicate(data)
if isinstance(data, str):
return {
"type": "minecraft:all_of",
"terms": data,
}
return data
def fix_predicate(data: Any) -> Any:
if isinstance(data, str):
return data
if isinstance(data, list):
if len(data) == 1: # type: ignore
return fix_predicate(data[0])
return {
"type": "minecraft:all_of",
"terms": [fix_predicate(t) for t in data], # type: ignore
}
type = data["condition"]
del data["condition"]
match get_id(type):
case "all_of":
data["terms"] = [fix_predicate(t) for t in data["terms"]]
case "any_of":
data["terms"] = [fix_predicate(t) for t in data["terms"]]
case "block_state_property":
type = "minecraft:match_block"
data["blocks"] = data["block"]
del data["block"]
if "properties" in data:
data["state"] = data["properties"]
del data["properties"]
case "damage_source_properties":
data["predicate"] = fix_damage_source_predicate(data["predicate"])
case "entity_properties":
data["predicate"] = fix_entity_predicate(data["predicate"])
case "inverted":
data["term"] = fix_predicate(data["term"])
case "reference":
return data["name"]
case "value_check":
type = "minecraft:int_value_check"
data["value"] = fix_context_int(data["value"])
data["test"] = data["range"]
del data["range"]
case _: pass
return {
"type": type,
**data,
}
def fix_item_modifier_root(data: Any) -> Any:
data = fix_item_modifier(data)
if isinstance(data, list):
return { # type: ignore
"type": "sequence",
"functions": data
}
return data
def fix_item_modifier(data: Any) -> Any:
if isinstance(data, str):
return data
if isinstance(data, list):
if len(data) == 1: # type: ignore
return fix_item_modifier(data[0])
return [fix_item_modifier(t) for t in data] # type: ignore
type = data["function"]
del data["function"]
match get_id(type):
case "enchant_with_levels":
data["levels"] = fix_context_int(data["levels"])
case "filtered":
if "on_pass" in data:
data["on_pass"] = fix_item_modifier(data["on_pass"])
if "on_fail" in data:
data["on_fail"] = fix_item_modifier(data["on_fail"])
case "limit_count":
if "min" in data["limit"]:
data["limit"]["min"] = fix_context_int(data["limit"]["min"])
if "max" in data["limit"]:
data["limit"]["max"] = fix_context_int(data["limit"]["max"])
case "looting_enchant":
data["count"] = fix_context_float(data["count"])
case "enchanted_count_increase":
data["count"] = fix_context_float(data["count"])
case "modify_contents":
data["modifier"] = fix_item_modifier(data["modifier"])
case "reference":
if "conditions" in data:
condition = fix_predicate(data["conditions"])
return {
"type": "minecraft:sequence",
"functions": data["name"],
"condition": condition,
}
return data["name"]
case "set_attributes":
data["modifiers"] = [fix_attribute_modifier(m) for m in data["modifiers"]]
case "set_contents":
data["entries"] = [fix_loot_entry(e) for e in data["entries"]]
case "set_count":
data["count"] = fix_context_int(data["count"])
case "set_custom_model_data":
if "floats" in data:
data["floats"]["values"] = [fix_context_float(v) for v in data["floats"]["values"]]
if "colors" in data:
data["colors"]["values"] = [fix_context_int(v) for v in data["colors"]["values"]]
case "set_damage":
data["damage"] = fix_context_float(data["damage"])
case "set_enchantments":
data["enchantments"] = {k: fix_context_int(v) for k, v in data["enchantments"].items()}
case "set_loot_table":
del data["type"]
data["loot_table_id"] = data["name"]
del data["name"]
case "set_ominous_bottle_amplifier":
data["amplifier"] = fix_context_int(data["amplifier"])
case "set_random_dyes":
data["number_of_dyes"] = fix_context_int(data["number_of_dyes"])
case "set_stew_effect":
if "effects" in data:
data["effects"] = [fix_stew_effect(e) for e in data["effects"]]
case "sequence":
data["functions"] = [fix_item_modifier(f) for f in data["functions"]]
case _: pass
if "conditions" in data:
data["condition"] = fix_predicate(data["conditions"])
del data["conditions"]
return {
"type": type,
**data,
}
def fix_attribute_modifier(data: Any) -> Any:
data["amount"] = fix_context_float(data["amount"])
return data
def fix_stew_effect(data: Any) -> Any:
data["duration"] = fix_stew_effect(data["duration"])
return data
def fix_context_int(data: Any) -> Any:
if not isinstance(data, dict):
return data
if "type" not in data:
data = { # type: ignore
"type": "minecraft:uniform",
**data,
}
match get_id(data["type"]):
case "binomial":
data["n"] = fix_context_int(data["n"])
data["p"] = fix_context_float(data["p"])
case "sum":
return {
"type": "minecraft:add",
"inputs": [fix_context_int(s) for s in data["summands"]]
}
case "uniform":
if "min" in data:
data["min"] = fix_context_int(data["min"])
if "max" in data:
data["max"] = fix_context_int(data["max"])
case _: pass
return data # type: ignore
def fix_context_float(data: Any) -> Any:
if not isinstance(data, dict):
return data
if "type" not in data:
data = { # type: ignore
"type": "minecraft:uniform",
**data,
}
match get_id(data["type"]):
case "binomial":
data["n"] = fix_context_int(data["n"])
data["p"] = fix_context_float(data["p"])
case "score":
if "scale" in data:
scale = data["scale"]
del data["scale"]
else:
scale = 1
data = {
"type": "minecraft:from_int",
"input": fix_context_int(data),
}
if scale == 1:
return data
return { # type: ignore
"type": "minecraft:mul",
"inputs": [
data,
scale,
]
}
case "sum":
return {
"type": "minecraft:add",
"inputs": [fix_context_float(s) for s in data["summands"]]
}
case "uniform":
data["min"] = fix_context_float(data["min"])
data["max"] = fix_context_float(data["max"])
case _: pass
return data # type: ignore
def fix_advancement(data: Any) -> Any:
data["criteria"] = {k: fix_criterion(v) for k, v in data["criteria"].items()}
return data
def fix_criterion(data: Any) -> Any:
if "conditions" not in data:
return data
conditions = data["conditions"]
if "player" in conditions:
conditions["player"] = fix_entity_or_predicate(conditions["player"])
if "entity" in conditions:
conditions["entity"] = fix_entity_or_predicate(conditions["entity"])
if "parent" in conditions:
conditions["parent"] = fix_entity_or_predicate(conditions["parent"])
if "child" in conditions:
conditions["child"] = fix_entity_or_predicate(conditions["child"])
if "villager" in conditions:
conditions["villager"] = fix_entity_or_predicate(conditions["villager"])
if "zombie" in conditions:
conditions["zombie"] = fix_entity_or_predicate(conditions["zombie"])
if "projectile" in conditions:
conditions["projectile"] = fix_entity_or_predicate(conditions["projectile"])
if "cause" in conditions:
conditions["cause"] = fix_entity_or_predicate(conditions["cause"])
if "victims" in conditions:
conditions["victims"] = [fix_entity_or_predicate(v) for v in conditions["victims"]]
if "location" in conditions:
conditions["location"] = fix_predicate(conditions["location"])
if "damage" in conditions:
conditions["damage"] = fix_damage_predicate(conditions["damage"])
if "killing_blow" in conditions:
conditions["killing_blow"] = fix_damage_source_predicate(conditions["killing_blow"])
match get_id(data["trigger"]):
case "bee_nest_destroyed" | "enter_block" | "placed_block" | "slide_down_block":
if "block" in conditions:
conditions["blocks"] = conditions["block"]
del conditions["block"]
case "brewed_potion":
if "potion" in conditions:
conditions["potion"] = {
"potions": conditions["potion"]
}
case "crafter_recipe_crafted" | "recipe_crafted":
conditions["recipes"] = conditions["recipe_id"]
del conditions["recipe_id"]
case "player_generates_container_loot":
conditions["loot_tables"] = conditions["loot_table"]
del conditions["loot_table"]
case "recipe_unlocked":
conditions["recipes"] = conditions["recipe"]
del conditions["recipe"]
case _: pass
data["conditions"] = conditions
return data
def fix_entity_or_predicate(data: Any) -> Any:
if isinstance(data, list):
return fix_predicate(data)
return {
"type": "minecraft:entity_properties",
"entity": "this",
"predicate": fix_entity_predicate(data),
}
def fix_entity_predicate(data: Any) -> Any:
return {k: fix_entity_sub_predicate(k, v) for k, v in data.items()}
def fix_entity_sub_predicate(key: str, data: Any) -> Any:
match get_id(key):
case "predicates":
data = {k: fix_data_component_predicate(k, v) for k, v in data.items()}
case "equipment" | "slots":
data = {k: fix_item_predicate(v) for k, v in data.items()}
case "passenger" | "targeted_entity" | "vehicle":
data = fix_entity_predicate(data)
case "type_specific/lightning":
if "entity_struck" in data:
data["entity_struck"] = fix_entity_predicate(data["entity_struck"])
case "type_specific/player":
if "looking_at" in data:
data["looking_at"] = fix_entity_predicate(data["looking_at"])
case _: pass
return data
def fix_item_predicate(data: Any) -> Any:
if "predicates" in data:
data["predicates"] = {k: fix_data_component_predicate(k, v) for k, v in data["predicates"].items()}
return data
def fix_data_component_predicate(key: str, data: Any) -> Any:
match get_id(key):
case "potion_contents":
return {
"potions": data,
}
case _: pass
return data
def fix_damage_predicate(data: Any) -> Any:
if "source_entity" in data:
data["source_entity"] = fix_entity_predicate(data["source_entity"])
if "type" in data:
data["type"] = fix_damage_source_predicate(data["type"])
return data
def fix_damage_source_predicate(data: Any) -> Any:
if "tags" in data:
data["tags"] = [fix_damage_tag_predicate(t) for t in data["tags"]]
if "source_entity" in data:
data["source_entity"] = fix_entity_predicate(data["source_entity"])
if "direct_entity" in data:
data["direct_entity"] = fix_entity_predicate(data["direct_entity"])
return data
def fix_damage_tag_predicate(data: Any) -> Any:
if not data["id"].startswith("#"):
data["id"] = "#" + data["id"]
return data
def fix_enchantment(data: Any) -> Any:
data["effects"] = {k: fix_effect(k, v) for k, v in data["effects"].items()}
return data
def fix_effect(key: str, data: Any) -> Any:
if isinstance(data, list):
return [fix_effect(key, e) for e in data] # type: ignore
if "requirements" in data:
data["requirements"] = fix_predicate(data["requirements"])
return data
def fix_recipe(data: Any) -> Any:
match get_id(data["type"]):
case "smelting" | "blasting" | "smoking":
if "cookingtime" not in data:
data["cookingtime"] = 200
case "campfire_cooking":
if "cookingtime" not in data:
data["cookingtime"] = 600
case _: pass
return data
def get_id(data: Any):
if isinstance(data, str):
return data.removeprefix("minecraft:")
return data
if __name__ == "__main__":
main()
@bungasynek

Copy link
Copy Markdown

Hello,
would you be able to provide some support for me? I'm unable to run this without errors.
thank you!

@CototonYT

Copy link
Copy Markdown

Hi! Please excuse any inaccuracies in this translation—I’m using a standard translation tool. THIS CODE IS AN ABSOLUTELY AMAZING TOOL! I spent days struggling to migrate data to a new version, until I stumbled upon this little script. I am incredibly grateful to you—I could practically bow down at your feet lol

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment