DAI 4.1 · HOW-TO INDEX

Build a DAI system from scratch.

Use this page when you know what you want to create but do not know which files, folders or DAI systems are involved.

Never made a datapack before?

Start with file/folder literacy, JSON and functions first.

Start From Zero →

All creation guides

scene_environmentsAnimated Scene Environments

Build data-defined animated backgrounds and camera paths.

Open guide →
screen_overridesScreen Overrides

Replace or skin vanilla, modded and DAI screens through JSON.

Open guide →
story_profilesStory Archives

Capture sessions/events and compile books, comics or journals.

Open guide →
input_profilesInput Profiles

Define contextual controls without hardcoding core keybindings.

Open guide →
[modules]Feature Modules

Disable unused DAI runtimes to reduce unnecessary initialization and ticking.

Open guide →
creator_schemas + creator_presetsExtend the Creator

Add authoring modules and presets without changing DAI Java.

Open guide →
dai_itemsCustom Items

Define item identity, components, fallback behavior and presentation.

Open guide →
dai_blocksCustom Blocks

States, collision, luminance, interaction and block lifecycle.

Open guide →
dai_weaponsWeapons & Combat Items

Server-authoritative melee/ranged weapons, costs and hit rules.

Open guide →
dai_armorArmor & Equipment

Equipment identity, attributes, abilities and presentation.

Open guide →
dai_attributesAttributes & Modifiers

Reusable numeric attributes and native/custom modifiers.

Open guide →
dai_effects + dai_potionsEffects & Potions

Status effects and potion application.

Open guide →
dai_projectilesProjectiles

Physics, collision, homing, ricochet and impacts.

Open guide →
dai_particlesParticles & Visual FX

Reusable particles and event-driven FX.

Open guide →
dai_entitiesNative Entities & AI

Entity dimensions, stats, movement, AI, portals and spawning.

Open guide →
dai_animationsAnimations & Render Profiles

Animation state and visual render profiles.

Open guide →
dai_sounds + dai_musicSounds & Music

Event-driven audio and music.

Open guide →
dai_hudHUD & Overlays

Responsive UI and state-driven overlays.

Open guide →
dai_screensData Screens

Datapack-authored screens and widgets.

Open guide →
dai_keybindsDatapack Keybinds & Raw Input

Remappable controls and raw-key logic.

Open guide →
components + block statePersistent Content State

Persistent item components and block entity state.

Open guide →
dai_structuresStructures & Modular Rooms

Bounds, anchors, sockets, placement and repair.

Open guide →
dai_features + dai_biomesFeatures & Biomes

Environmental generation and biome definitions.

Open guide →
dai_loot + dai_recipesLoot, Recipes & Processing

Rewards, crafting and processing.

Open guide →
currencies + shops + dialogue + quests + factionsEconomy & Social Systems

Currencies, shops, dialogue, quests and factions.

Open guide →
dimensions + timelinesDimensions & Timelines

Custom spaces, clocks, timelines and environments.

Open guide →
dai_rules + dai_physicsRules & Physics

World/entity rules, gravity and movement modifiers.

Open guide →
dai_vehiclesVehicles

Acceleration, steering, seats and safe exits.

Open guide →
portals + interactivesPortals & Interactive Volumes

Volumes, conditions, cooldowns and travel.

Open guide →
dai_fluidsFluids

Authored fluid behavior and interactions.

Open guide →
reactionsReactions & Event Gameplay

Respond to real gameplay events.

Open guide →
logic + objectivesLogic, Objectives & Sequences

Actions, conditions, phases and flow.

Open guide →
menus + inputMenus, Input & Keybind Gameplay

Menus, action routing and input.

Open guide →
recognitionRecognition & Perception

Identify targets, blocks, structures and regions.

Open guide →
automationAutomation

Perceive, choose, act and recover safely.

Open guide →
dai_experiences + dai_worldgenExperiences & Worldgen

MAIN experiences, owned saves and world bootstrap.

Open guide →
state + migrationsMultiplayer, Checkpoints & Migrations

Save-safe progression and update paths.

Open guide →
assets/<namespace>Resource Packs & Models

Optional/required presentation and fallbacks.

Open guide →
validation + release ZIPTesting, Performance & Packaging

Validate, test, migrate and release.

Open guide →
title + loadingBranding & Loading

Title, startup and loading presentation.

Open guide →
dai_stateState & Capabilities

Create typed state across client, player, entity, dimension, world and server scopes.

Open guide →
reference storeReferences

Remember entity/block/position targets and reuse them across later actions and conditions.

Open guide →
dai_skillsSkills

Build cooldown/resource/job/rank-gated skills with functions, commands or projectiles.

Open guide →
learning/agentsLearning Agents & Sapphire

Define observations, choices, rewards, imitation, dialogue, grounding and knowledge behavior.

Open guide →
dai_cinematicsERAS Cinematics

Play retained 2D/3D Simple Animation Designer projects through DAI cinematic actions.

Open guide →
dai_enchantmentsEnchantments

Author DAI enchantment content and choose when to use the native Mojang enchantment bridge.

Open guide →

Reference after you build

Use Complete Capabilities when you need the exact action/condition/registry inventory rather than a tutorial.