A TypeScript framework for programmatic Minecraft Bedrock Add-On generation.

Quick Start

Get started with Jepia in three steps:

# Install dependencies
bun install
import { Addon, Item } from 'jepia';

const addon = new Addon('MyAddon', 'My first add-on');

const sword = new Item('Dragon Sword', 'myaddon:dragon_sword');
sword
  .setMaxStackSize(1)
  .addComponent('minecraft:durability', { max_durability: 250 })
  .addTexture('textures/items/dragon_sword.png');

addon.addItem(sword);
await addon.generate('./output');

Run with bun run your-script.ts and import the generated folder into Minecraft.

Documentation

API Reference

Complete reference of all classes, methods, and options. Covers Addon, Item, Block, Entity, Material, RenderController, TextureAtlas, Packager, and more.

Architecture

High-level design, component system, pack structure, rendering pipeline, and how Jepia maps to Minecraft's file format.

Examples

Practical code examples: tech mod items, PBR blocks, custom entities with render controllers, texture atlases, and packaging.

Component Reference

Complete reference of all Minecraft Bedrock components for Block, Item, and Entity — parameters, types, defaults, and Jepia usage examples.

Implementation

Development phases, implementation notes, and the rendering system roadmap from Phase 1 through Phase 5.

Project Resources