GemDP

Python builders for Minecraft data packs and resource packs.

It's in BETA! Please consider reporting any bugs you may find

Features

• Custom items, tools, weapons & armor
• Custom blocks & ores
• Custom mobs
• Fullscreen overlays
• Book systems
• Advanced events system
• Event-driven AI for mobs
• Projectiles & raycasting
• Enchantments
• Dialogs & triggers
• NBT & storage
• Testing with the mc_sim interpreter

Quick start

Install GemDP, then create a project with this layout:

pip install gemdp

my_pack/
├── first.py
└── assets/
    └── ruby.png

ruby.png can be any PNG; use 16×16 for a vanilla-style item texture.

from pathlib import Path
from gemdp import DataPack, ItemComponent, ResourcePack

ROOT = Path(__file__).resolve().parent
ASSETS = ROOT / "assets"

# Use different names: these become the data-pack and resource-pack folders.
dp = DataPack("ruby_dp", "Ruby demo data", "1.21.11")
rp = ResourcePack("ruby_rp", "Ruby demo resources", "1.21.11")

ruby = rp.add_custom_item(
    namespace="demo",
    item_id="minecraft:clock",
    custom_name="ruby",
    texture_path=str(ASSETS / "ruby.png"),
    datapack=dp,
    item_name={"text": "Ruby", "color": "red"},
    components=ItemComponent().max_stack_size(64).rarity("uncommon"),
)

print(ruby.get_give_command("@s"))
dp.build(ROOT / "out")
rp.build(ROOT / "out")

Install out/ruby_dp in a world's datapacks/ folder and enable out/ruby_rp from Minecraft's resource-pack screen. Then run /reload and use the printed /give command.

See Getting started for output-folder behavior and the exact install steps.

Examples

Ruby datapack

Full material set: ruby, ore, tools, sword, armor set, recipes.

examples/ruby_family/ruby_family.py

Ore spawns underground in veins.

Steve mob datapack

Segmented display mob, keyframe animations, MobAI with patrol, hit reactions, and goal routing.

examples/steve_mob/steve_mob.py

Rules Card

A datapack item that creates server rules at runtime.

examples/rules_card/rules_card.py

More runnable examples are in examples/.

Docs

Start here

• Getting started — install, first item, output folders, and Minecraft install steps
• API reference — complete class and method lookup

Build pack content

• Custom items — items, components, recipes, tools, weapons, armor, and item events
• Custom blocks — blocks, ores, block hooks, loot, and give commands
• Events — EventApp, block, inventory, entity, and structure rules
• Projectiles — hit hooks and firing from an item event
• Conditions — reusable execute if fragments and predicates

Advanced systems and tests

• ScreenFX — fullscreen effects
• Custom mobs — display entities and MobAI
• Animations — rigs, keyframes, and playback
• mc_sim — run generated data packs in Python tests