Avatar Addon — 2.0.0 Overhaul

01Introduction

About the addon

Avatar Addon is a Minecraft Bedrock addon that implements the four element bending system from Avatar: The Last Airbender as a playable survival gameplay. Players choose an element (or start as a nonbender), bind moves to their hotbar, and progress through a skill tree by using their bending in combat and traversal. The 2.0.0 Overhaul update is a broad rework of the addon's combat, progression and admin systems.

Features overview

Installation requirements and guide

• Both the Behavior Pack and Resource Pack must be applied to the world the addon will not function correctly with only one installed.
• After installing, an operator should run /function op once to receive the staff tag required to open the admin menu.

Supported Minecraft versions

02Getting Started

Choosing your element

On first spawn, players open the Choose Bending menu to pick Air, Water, Earth, Fire, Avatar, Dark Avatar or Nonbender. Two world settings change how this works:

• Bending Choice Final — once toggled on, a player's element choice is locked in permanently.
• Bending Choice Random — assigns a random element automatically instead of letting the player pick.

If the Avatar path is enabled for the server (Avatar Publicly Selectable), a player who becomes the Avatar or Dark Avatar additionally chooses a starting element; the remaining three elements are then unlocked in the traditional cycle order (Air → Water → Earth → Fire) as they progress.

Becoming a bender

Choosing an element immediately grants that element's base moveset at level 1. From there, bending level rises through use (see Progression System), of bending moves. The Avatar State itself only becomes available at level 75, and is a distinct on/off ability rather than a permanently active form unless the server admin enables Avatar State Permanent Duration.

Non-bender gameplay

Players who don't choose an element play as Nonbenders. Nonbenders are not left without tools, they get four moves built around chi blocking rather than bending force, like reflecting bending damage back at attackers, a plain dash, a short-range time-rewind that undoes recent damage, and detection of invisible entities. See Nonbenders in the Bending System section for the full list.

Controls & menus

03Bending System

04Ability Reference

Every move in the addon, filter by element or search by name. Damage is shown at both level 1 (base) and level 100 (max), in raw damage points and in hearts (1 heart = 2 damage points), since the two aren't the same number.

05Progression System

XP & Levels

Bending level runs from 1 to 100 and increases by landing hits, using moves, and engaging in combat all feed level progress. Two admin configurable multipliers control the pace server-wide:

• Bending Level Speed — multiplier on how fast players gain bending levels (default 1.0).
• Bending Speed — multiplier on chi regeneration per tick (default 1.0).

Damage scaling

Every damage dealing move belongs to a damage tier, and that tier's output scales with the player's bending level a fresh level 1 bender hits noticeably softer than a level 100 bender using the exact same move:

Skill trees

Each element has its own skill tree of passive perks and unlockable moves (for example, Air's tree branches from a Core node through Warrior's Spirit, Chi Infusion, Twinkle Toes and Airflow branches, ending in leaf perks like Redirection, Wind Dash, or Air Spirit). Some perks apply passive gameplay changes directly, such as disabling fall damage or hunger, or turning off mob aggro.

Admins can toggle Skill Tree Fully Unlockable to let players unlock every node regardless of level, which is also what the built-in Combat Features world preset does automatically for everyone on the server.

Unlocking abilities

Most moves unlock by progressing through the relevant element's skill tree and bending moves. A handful of high-level techniques unlock purely by bending level instead, this is how the Avatar's Super moves and the Dark Avatar's signature techniques are level gated:

Mastery

The Avatar State itself is unlocked as a distinct skill_required gate (avatar_state) at level 75, and its duration scales between the server's configured minimum (at level 75) and maximum (at level 100) unless Avatar State Permanent Duration is enabled, in which case it no longer expires on its own. Server admins can also enable an Avatar State Resurrection effect with its own cooldown, acting as a totem style save while the Avatar State is active.

06Armour & Equipment

Bending armour

Each of the four core elements has a full armour set (helmet, chestplate, leggings, boots) themed and designed to that element. Wearing a complete set of four pieces from the same bending armour grants a passive effect dependin on the bending type. Mixing bending armour with any vanilla or unrelated piece breaks the set bonus.

Crafting recipes

Every bending armour piece is crafted at a crafting table:

For example, the Earth Helmet uses a shaped recipe of Obsidian around a Diamond Helmet. An Airbender's Glider item also has its own dedicated crafting recipe.

Tea & consumables

The addon also adds a full tea-brewing item set (crafted using a Water Cup as a base ingredient), with dozens of variants, each carrying a different buff:

07Admin Guide

Server admins run /function op once to receive the staff tag, which grants access to the Admin Settings menu. Everything below is configured through the in-game UI so no commands required after the initial setup.

Admin commands

Configuration options (Basic World Settings)

Player settings

Ban moves, elements & zones

World presets

Debug tools

The admin menu includes a debug damage that can be turned on in the Admin Settings.

08Developer Documentation

Script structure

All gameplay logic lives under BP/scripts/avatar/:

avatar/
  index.js            entry point: subscribes every world/system event
  utils.js            shared helpers (vectors, damage, tracing, block sets)
  damageTiers.js       DAMAGE_TIERS constants used by every move
  core/
    elements/
      import.js         aggregates all element definitions
      <element>/
        <element>.js    element definition: name, moves[], skillTree, runtime
        moves/*.js        one file per move
        trees/main.js     skill tree definition
        runtimes/*        per-tick element runtime logic
    player/
      bender.js         per-tick bender runtime (chi, cooldowns, level gating)
      setup.js          player data initialization, level/state persistence
      load.js           load hooks
      hud.js            HUD rendering
    events/             one file per subscribed Minecraft script event
    scroll/             all server-ui menu screens (admin, skill tree, slots...)
    quests/             quest definitions
    tutorial/           in-game tutorial steps

Adding new moves

Every move file exports a single move object with a consistent shape:

const move = {
    name: { translate: 'elements.<element>.moves.<key>.name' },
    description: { translate: 'elements.<element>.moves.<key>.description' },

    cost: 25,          // chi cost
    cooldown: 10,       // seconds
    type: 'standard',   // standard | duration | charge | dragon
    id: 29,             // unique numeric id across the whole addon

    tier: 'HEAVY',      // key into DAMAGE_TIERS
    damage: {
        base: DAMAGE_TIERS.HEAVY,
        multiplied: 0
    },

    // optional gating, used mainly by Avatar / Dark Avatar moves:
    // level_required: 70,
    // skill_required: 'avatar_state',

    activate(player, PLAYER_DATA) {
        // move logic: particles, entity queries, applyBendingDamage, etc.
    }
}

export default move;

New moves are registered by importing them into the relevant <element>.js file's moves array, and adding matching name/description keys to en_US.lang (and any other supported languages).

Adding elements

An element is defined the same way dark_avatar.js composes borrowed moves from other elements alongside its own: an object with name, description, breakdown, color, icon, a chiCode/chiCodeOverflow pair, a moves array, a skillTree, and a runtime function called every tick. New elements are then registered in core/elements/import.js.

API usage

The addon subscribes to the following @minecraft/server world/system events from index.js:

Shared utility functions in utils.js include vector helpers (calcVectorOffset, calculateDistance, calculateKnockbackVector, normalizeVector), a groundBlocks set used by earth-affecting moves, applyBendingDamage, ray tracing (traceLine, isRayClear), bending-resistance calculation, and a delayedFunc tick-delay helper used throughout the move files.

09Troubleshooting

Common errors

Known issues

• No Current Known Issues.

10Credits & Community

These folks make all this possible so a big shout out to them.

Wiki ran and updated by IBk and DeathBot.