Avatar: Spirits of Convergence

 Harmonic Convergence

An add-on for **Avatar: Bending Arts** that brings Vaatu’s imprisonment, Harmonic Convergence, spiritbending, MCA spirit vessels, and spirit-tracking compasses into Minecraft.

Short description

Imprison Vaatu, unite the spirit portals, purify or corrupt spirits, choose an MCA vessel, and track Raava and Vaatu wherever their spirits reside.

Vaatu and the Tree of Time

Vaatu appears inside a red energy prison at the Tree of Time in the Spirit World. He remains visible inside the seal while movement, damage, and bonding are blocked.

Open both the northern and southern spirit portals to begin the countdown to Harmonic Convergence. After three Minecraft days, their light bends inward over approximately 16 seconds. Their upper ends meet above the Spirit World, completing a golden arch and releasing Vaatu.

Thunder and lightning-impact sounds repeat during the joining sequence. Their volume follows Minecraft’s Weather sound setting.

Harmonic Convergence repeats every three Minecraft days while both portals stay open. Closing either portal resets the countdown. Defeating a released Vaatu returns him to his red prison and starts a fresh countdown if both portals remain open.

The timer follows Minecraft’s world day time. Sleeping and time-changing commands can advance it. A manually triggered event still requires both portals to be open.

Spiritbending in the original bending scroll

Spiritbending appears as a water sub-bending branch inside the existing Avatar: Bending Arts scroll. Waterbenders and Avatars receive access automatically. Its techniques can be placed on the normal bending hotbar and use water and chi through the original mod’s systems.

Four techniques are available.

Spirit Purification turns a small spirit golden and makes it fade away after approximately three seconds.

 Spirit Corruption gives a small spirit a violet appearance and frightens it.
Quiet Waters calms a small spirit, gives it a golden appearance, and keeps it in the world.
Spirit Extraction channels water at a host for approximately two seconds to draw out Raava or Vaatu. Keep aiming at the same host throughout the channel.

The original Spirit Calming technique also supports extracting a spirit from an MCA host. Spirit Extraction supplies the dedicated channel for both player and MCA hosts.

Messages use the original mod’s spirit dialogue display, including its gradual text reveal. English and Arabic translations are included for the add-on’s text.

Choose an MCA vessel

The Vaatu Vessel Seal lets you choose an MCA villager as Vaatu’s host.

1. Release Vaatu through Harmonic Convergence.
2. Obtain the seal from the creative inventory.
3. In Creative mode, use it on a block to create a male MCA villager, or choose an existing male or female MCA villager.
4. Use the seal on the chosen character.

Vaatu must be free, with no existing host. The chosen character must be alive and must not already contain Raava or Vaatu.

When Vaatu’s MCA host dies, he transfers to another eligible, loaded MCA villager. The selection favors a nearby candidate in the previous host’s dimension. A character containing Raava is excluded. If no suitable character is loaded, the spirit waits until one becomes available.

This feature records the spirit’s vessel and succession. Additional Avatar combat abilities for MCA hosts are outside the current feature set.

 Track Raava and Vaatu

The **Compass of Raava** and **Compass of Vaatu** follow their respective spirits across changes of form.

* While the spirit is inside a player or MCA villager, the compass follows that host.
* After extraction, it follows the released spirit entity.
* While Vaatu is imprisoned, his compass points to the Tree of Time.
* After reincarnation, the target changes to the new host.

Right-click a compass to display the target’s dimension and coordinates. The needle operates when the target is in your dimension. For an unloaded host or spirit entity, the compass retains its last recorded position. A spirit that has no known location produces a message explaining that no location is available.

 Creative inventory and spirit eggs

The **Avatar: Spirits and Bending** creative tab collects registered Avatar: Bending Arts items and this add-on’s items in one place.

The tab includes the two compasses, vessel seal, existing small-spirit spawn eggs, and new eggs for Raava, Vaatu, and Koh.

Raava and Vaatu are unique spirits. Their eggs respect existing hosts and loaded spirit instances. Vaatu’s egg also respects his imprisonment, so release him through the convergence sequence before using it.

 Commands

| Command | Effect |
| — | — |
| `/harmonic start` | Starts convergence when both portals are open. Requires operator permission. |
| `/harmonic status` | Displays Vaatu’s state and convergence information. |
| `/harmonic spirit learn` | Unlocks the spiritbending branch for yourself. Requires operator permission. |
| `/harmonic spirit calm` | Selects purification for the original Spirit Calming technique. |
| `/harmonic spirit dark` | Selects corruption for the original Spirit Calming technique. |

## Requirements and installation

* Minecraft **1.21.1**
* Fabric Loader **0.16.0 or later**
* Java **21 or later**
* Fabric API
* Avatar: Bending Arts
* MCA Reborn for the vessel and MCA reincarnation features

The add-on was tested with the local Avatar: Bending Arts file named `avatarmod-0.2.0.jar`, whose internal mod metadata reports version `0.1.0`, and MCA `7.7.36-beta.3+1.21.1`.

Install the add-on JAR alongside its dependencies in the instance’s `mods` folder. Use one version of the add-on at a time. Back up worlds before updating. For multiplayer, install matching versions on the server and each client.

 Compatibility and testing

The mod uses integration hooks into the tested Avatar: Bending Arts implementation. Other releases may change those hooks and require an updated add-on.

Local integrated-server tests covered imprisonment, delayed portal contact, release, return after combat, spirit purification and corruption, MCA host selection, reincarnation excluding Raava’s host, extraction of both spirits, and compass target changes between hosted, free, and imprisoned states. Dedicated-server multiplayer has not been verified.

Removing the add-on also removes its custom items and techniques. Keep a world backup if you plan to uninstall it.

Credits

Avatar: Bending Arts and its original content are credited to **thesheriff1**. MCA Reborn and Fabric are credited to their respective developers.

This add-on was developed with assistance from OpenAI Codex using Universal Modder workflows. It uses Minecraft’s existing thunder and impact sounds, and references the installed mods’ assets at runtime.

This is an unofficial add-on inspired by the Avatar universe.

 Version 1.2.1

Updated both spirit compasses to track Raava and Vaatu themselves, including their host, released entity, and Vaatu’s prison location.