mcanvil 0.9.7.2

A Minecraft bedrock content development framework.

Anvil Documentation

Introduction to Anvil

Anvil is a comprehensive development toolkit designed for creating Minecraft Bedrock Edition content with ease and flexibility. Anvil aims to simplify the creation of custom Minecraft entities, blocks, commands, and more by leveraging Python and embracing a modular, component-based design philosophy.

Whether you're a seasoned Minecraft modder or just starting your journey in content development, Anvil provides you with the tools to make your creations come to life. Its features are designed to streamline workflows, enforce consistency, and offer a robust framework for handling the complexities of Minecraft content.

Community Contributions

Anvil is intended to grow as a community-driven project. Contributions are very much encouraged, whether that's fixing bugs, improving documentation, or adding support for new Minecraft Bedrock features. If you have ideas or want to help build the toolkit, we want you involved.

Key Features

• Modular Development: Design blocks, entities, and features in a reusable manner to make your content scalable and easy to manage.
• Schema Management: Automate JSON schema creation and validation for Minecraft packs to eliminate manual errors.
• Report Generation: Generate detailed reports about the contents of your project, including entities, blocks, and other assets, for easy tracking and management.
• Project Validation: Validate your project before submission to the Minecraft Marketplace, raising any errors or warnings that need to be addressed to meet Marketplace standards.
• Multi-Format Packaging: Package your project into multiple formats, worlds, addons, templates and more.

Getting Started with Anvil

Prerequisites

To use Anvil, ensure you have the following installed:

• Python 3.13 or higher.
• Windows OS: Anvil is designed specifically for Windows, as Minecraft Bedrock development is primarily done on this platform.

Installation

To install Anvil, you can use pip:

pip install mcanvil

This will install the latest version of Anvil along with its dependencies.

Creating Your First Project

To create a new Minecraft development project with Anvil, open your terminal and run the following command:

anvil create <namespace> <project_name> [options]

• namespace: A unique identifier for your project. The namespace minecraft is reserved and cannot be used.
• project_name: The name of your project.

Optional flags include:

• --preview: Set up the project for Minecraft Preview.
• --scriptapi: Adds support for Script API dependencies.
• --pbr: Adds Physically Based Rendering (PBR) dependencies for enhanced graphics.
• --random_seed : Adds support for Random Seed Worlds, allowing for randomized world generation.
• --addon: Marks the package as an addon, enforcing relevant constraints.

Example

anvil create my_ns awesome_project --scriptapi --pbr

This command will:

• Create a folder named awesome_project in your working directory.
• Set up the initial project structure, including JSON and Python files.
• Generate .github/workflows/release.yml so version bumps in anvilconfig.json can build archives and publish a GitHub release.

Project Structure

Once you create your project, the structure will look like this:

awesome_project/
├── .github/
│   └── workflows/
│       └── release.yml
├── assets/
│   ├── bbmodels/
│   ├── particles/
│   ├── textures/
│   ├── sounds/
│   └── structures/
├── marketing/
├── output/
├── scripts/
│   ├── javascript/
│   └── python/
├── world/
├── .gitignore
├── CHANGELOG.md
├── anvilconfig.json
├── esbuild.js
├── package.json
└── tsconfig.json

Running Your Project

To test your project in Minecraft, navigate to your project folder and use the following command:

anvil run

This command will run your python script and generates the necessary files for your project.

---

Links & Resources

• Documentation - Official docs for anvil.
• Bedrock Learn Portal - Official Minecraft Bedrock Documentation.

Projects made with Anvil