Anvil Documentation

Anvil is a Python-first toolkit for creating Minecraft Bedrock content. This site keeps the top-level pages short and puts repeated setup details in one canonical place.

Start Here

• Anvil Overview for the workflow and project layout.
• CLI Reference for anvil init / anvil create, anvil build, and the rest of the command set.
• Project Configuration for anvilconfig.json.
• API Reference for classes, functions, and modules.

Tutorials

Start with the three basics, then pick the topics your pack needs. Every snippet in the guides is taken from a project that compiles.

• Add a Custom Entity
• Add a Custom Block
• Add a Custom Item
• Animating an Entity: animations, animation controllers, render controller arrays.
• Block States, Permutations and Traits: a lit lantern that faces its placement.
• Spawn Rules and Loot: natural spawning and drops.
• Particles and Sounds: particles, sound definitions, sound events, music.
• Recipes and the Item Catalog: shaped, shapeless, smelting, stonecutter, creative groups.
• NPC Dialogues
• Trade Tables
• Wearables and Attachables: armor rendered on the player.
• Creating a Biome: generation and Vibrant Visuals.
• Generating Features: ores, scattered blocks, trees.
• Using Jigsaw: procedural structures.
• Custom Components: Script API logic on blocks and items.
• Custom Camera
• PBR
• Localization

Quick Workflow

1. Run anvil init <namespace> <project_name> (or anvil create) to scaffold a project.
2. Put gameplay code in scripts/python/ and assets under assets/.
3. Run anvil build to build and export your packs.