gemdp 10.0.0

Fluent Python builders for Minecraft datapacks & resource packs — custom items, enchantments, mob AI, screen overlays, dialogs, worldgen — plus a headless pack simulator for testing without launching the game.

Gemdp

Python builders for Minecraft datapacks and resource packs.

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 (mc_sim interpreter)
• And much, much more!

Quick start

pip install gemdp

from gemdp import DataPack, ResourcePack, ItemComponent

dp = DataPack("demo_dp", "demo", "1.21.11")
rp = ResourcePack("demo_rp", "demo", "1.21.11")

ruby = rp.add_custom_item(
    namespace="demo",
    item_id="minecraft:clock",
    custom_name="ruby",
    texture_path="examples/ruby_family/assets/ruby.png",
    datapack=dp,
    components=ItemComponent().max_stack_size(64),
)

dp.build("out")
rp.build("out")

Check getting started for more information

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, goal routing.

examples/steve_mob/steve_mob.py

Rules Card

Small datapack that adds the Rules card item capable of creating rules in runtime

examples/rules_card/rules_card.py

More examples in:

examples/

Docs

• api.md — full lookup
• custom_blocks.md — how to make custom blocks
• events.md — events api
• custom_items.md — how to make custom items