Artu's Arcana

Artu's Arcana is an independent spell addon for **Iron's Spells 'n Spellbooks**,
adding five configurable spells designed for multiplayer adventures on Minecraft
1.20.1 with Forge.

It uses Iron's existing spell schools, spellbooks, casting flow, spell power,
cooldowns, mana settings, animations, particles, and per-spell configuration.

Current spells

Joyful Celebration — Evocation

Conjure a field of magical firecrackers over targeted ground. Bursts alternate
between unpredictable positions and locations near hostile creatures, while
per-target hit limits keep the celebration under control.

Summon Iron Golem — Evocation

Summon a temporary owner-bound Iron Golem that follows and protects its caster.
The golem attacks hostile creatures, avoids Creepers, respects allies and teams,
and can be repaired with iron ingots by its owner.

Galvanic Field — Lightning

Electrify a patch of ground and repeatedly shock enemies standing on its
surface. The effect does not create vanilla lightning, ignite blocks, change the
weather, or charge Creepers.

Buried Alive — Nature

Restrain one target inside a temporary earthen prison that progresses from dirt
to cobblestone and deepslate at higher levels. The shell deals in-wall damage,
can be broken by attacks, and allows trapped players to struggle free. It is a
temporary entity and does not place permanent blocks in the world.

Bloodbending — Blood

Temporarily control an eligible vanilla creature—or another player—while the
caster's real body remains stationary and vulnerable. Movement supports ground,
swimming, flying, and horse bodies; reviewed vanilla mobs receive validated
attacks or special abilities.

Controlled players can repeatedly press sneak to resist. Modded mobs and
unreviewed AI-only abilities are deliberately unsupported, and a released
Warden immediately turns against its former controller.

Designed for multiplayer

Gameplay effects and target validation are handled by the server. The spells
account for allies, teams, allied summons, invalid targets, disconnects,
dimension changes, anti-magic, and other interruption conditions.

Artu's Arcana must be installed on both the server and every connecting
client. It is not a server-only mod.

Requirements

- Minecraft: 1.20.1
- Mod loader: Forge 47.4.10
- Java: 17
- Required mod: Iron's Spells 'n Spellbooks 1.20.1-3.16.3 or a later 1.20.1 release

Iron's Spells 'n Spellbooks supplies its own required libraries through
CurseForge: Iron's Lib, GeckoLib, Curios API, and Player Animator. A correctly
configured CurseForge profile installs those transitive requirements
automatically.

The exact tested stack is Iron's Spells 3.16.3, Iron's Lib 2.1.0, GeckoLib
4.8.4, Curios API 5.14.1+1.20.1, and Player Animator 1.0.2-rc1+1.20.

Later Iron's Spells releases for Minecraft 1.20.1 are allowed to attempt
startup, but versions other than the tested baseline are not guaranteed
compatible. Artu's Arcana displays and logs a prominent warning when an
unverified Iron version is detected.

This release does not support Fabric, NeoForge, Minecraft 1.21, or other
Minecraft versions.

Installation

1. Create or select a Minecraft 1.20.1 Forge 47.4.10 profile.
2. Install Iron's Spells 'n Spellbooks and its required libraries.
3. Install Artu's Arcana in the same profile.
4. For multiplayer, install the same Artu's Arcana release on the server and
   every client.
5. Remove older duplicate Artu's Arcana JARs before starting the game.

No new world is required. The current release adds spells and temporary spell
entities, not world generation.

Configuration

Iron's generated per-spell JSON files control normal spell values such as
enabled state, crafting availability, rarity, maximum level, cooldown, mana
multiplier, and power multiplier.

Artu's Arcana also provides synchronized Forge server configuration for custom
mechanics such as damage, duration, radius, summon health, escape requirements,
targeting limits, and ability cooldowns.

Safety and privacy

Artu's Arcana contains no telemetry, advertising, account integration,
automatic updater, remote-download system, or external network client. It does
not transmit diagnostic information to the author. The mod uses normal
Minecraft networking only for gameplay communication between a modded client
and the Minecraft server it joined.

For authenticity, download releases only from this official CurseForge project.

Diagnostic logging

Each client and dedicated server creates a local diagnostic file under:

`/logs/ArtusArcana/`

Important entries also appear in Minecraft's normal `latest.log`. The logs
record low-frequency information such as versions, configuration values,
server lifecycle events, spell-controller events, and cleanup reasons; they are
not written every tick and are never uploaded automatically.

Diagnostic logs can contain Minecraft player or entity names, UUIDs,
dimensions, positions, and spell activity. Review them before sharing a bug
report publicly.

When reporting a problem, include the newest Artu's Arcana session log,
`latest.log`, the spell level, and whether the problem happened in single-player
or on a dedicated server.

Compatibility notes

- Bloodbending accepts eligible vanilla targets only; modded mobs are rejected.
- Every eligible vanilla body can be moved, but special attacks require an
  explicit tested adapter. An unavailable ability displays a clear message.
- Server owners can rebalance Iron's normal spell properties and Artu's custom
  mechanics through their respective generated configuration files.

Artu's Arcana is an independent addon and is not affiliated with or endorsed by
the creators of Iron's Spells 'n Spellbooks.

Required Dependency relation

Add exactly this project relation:

- Project: Iron's Spells 'n Spellbooks
- CurseForge slug: irons-spells-n-spellbooks
- CurseForge project ID: 855414
- Relation type: Required Dependency

Do not separately add Forge as a project dependency; select it as the mod loader.
Do not duplicate Iron's Lib, GeckoLib, Curios API, or Player Animator as direct
Artu's Arcana relations, because Iron's already requires them.