Shadows Above All - ENDLESS LEVELING

# Build changelog

## 0.3.6 — 2026-11-04
File: `ShadowsAboveAll-0.3.6.jar`.
- **Berserk reaches 96 blocks.** With berserk on, shadows attack any enemy up to 96 blocks away and keep chasing it out to that
  distance. They are pulled back to you only when you re-summon them or when they get more than 96 blocks away, in combat or not.
  The user asked for this. The range is set in `army.berserkRange` (96).
- With berserk off nothing changes: they engage at `autoEngageRadius` (12), drop a target at `brainLeashRange` (24) and come back
  under the old rules.
- The shadows' ally role now pulls them back only past `max(combatLeashRange, berserkRange)`.
- Tests: testbrain PASS. The other tests and the in-game test were skipped at the user's request.

## 0.3.5 — 2026-11-04
File: `ShadowsAboveAll-0.3.5.jar`.
- **Shadows deal damage inside Endless Leveling dungeons.** Test 23 showed that inside them EL drops all damage that doesn't come
  from a player. The normal hit, the fallback hit and Igris's skills all did 0. Now shadow hits and generals' skills are dealt in
  the owner's name with the shadow's full damage, but only in the `instance-*` and `el_gate_*` worlds (`army.ownerDamageInElDungeons`,
  `army.ownerDamageWorldPrefixes`). This was the user's choice.
- What follows from this:
  - EL XP and kill credit for EL and quests go to the owner, with no double payout.
  - The shadow still earns XP from damage and kills.
  - The Arise corpse belongs to the owner.
  - Mobs may target the owner.
  - Nothing changes outside EL dungeons or in the mod's own gates (`saa_gate_*`).
- `/saa manage brain` shows `owner-mode on|off` and `ownerHits` per shadow.

## 0.3.4 — 2026-11-04
File: `ShadowsAboveAll-0.3.4.jar`.
- **Shadows hit mobs in Endless Leveling dungeons.** In the catacombs (stairs, platforms, archers up high) the game's ally role
  gave up on the target because of the height difference and went idle, so no hit ever landed. Test 22 counted 0 hits in over
  1 min. Two fixes:
  1. A **fallback hit** from the mod, made when the target is within 2.5 blocks (height up to 2.5), in line of sight, and 1.5 s
     have passed without a hit (`army.meleeFallback*`).
  2. The role now tolerates ±4 blocks of height and waits 8 s before giving up.
- `/saa manage brain` got a third line per shadow. It shows the target, distance, height and line of sight, the state, how many
  times the shadow "bounced" between fighting and stopping, the health the target lost, and fallback hits.

## 0.3.3 — 2026-11-04
File: `ShadowsAboveAll-0.3.3.jar`.
- **Shadow damage scales with the mob's Endless Leveling level:** +5% per target level (`army.shadowDamagePerTargetElLevel`),
  up to x6 (`army.shadowDamageElFactorMax`). EL gives mobs more health per level (dungeons), but shadows were hitting as if the mobs were level 1.
- **A landed hit counts as progress:** a shadow no longer drops a target it is hitting because it thinks the target is unreachable.
- **Damage diagnostics** in `/saa manage brain` (a second line per shadow): hits, cancelled hits, damage before, after and final,
  the target's health and EL level, and any rejected target with the reason. `army.debugDamage: true` writes the same line to the log every 5 s.

## 0.3.2 — 2026-11-04
File: `ShadowsAboveAll-0.3.2.jar`.
- **The shadow effect no longer blinks.** Every 20 s the mod refreshed the effect by removing it and adding it back. For a quarter
  of a second in between, the shadow showed up without the cracks. The refresh now only re-sends the effect without removing it, so
  the effect stays continuous.

## 0.3.1 — 2026-11-04
File: `ShadowsAboveAll-0.3.1.jar`.
- **Order wheel (the "Shadow Command" item).** Right-click (or Q) with the item opens a wheel with these orders:
  - Follow;
  - Attack: what you aim at, or the nearest hostile with no target;
  - Defend here;
  - Patrol: mark point (patrol starts with 2 or more points) and Patrol: clear;
  - Focus;
  - Protect: the nearest player within 16 blocks;
  - Recall.

  The center holds Summon all, Recall all and Berserk ON/OFF. The wheel uses the same code as the `/saa order` commands, shows the
  same messages and closes after an order.
- You get the item when you become Shadow Monarch. If you are already Monarch, use `/saa menu wheelitem`. `/saa menu wheel` opens
  the wheel directly. Turn it off with `ui.orderWheelEnabled`.
- The item icon is a placeholder (a copy of the System Interface icon).

## 0.3.0 — 2026-11-04
File: `ShadowsAboveAll-0.3.0.jar`.
- **The shadow effect (glowing blue lines) no longer disappears on a single shadow.** Before, the server re-sent a shadow's look
  only when its other effects changed and in the full cycle every `army.shadowLookRefreshSeconds` (20 s). It now also re-sends it:
  - when the shadow's model is swapped (the dark skin is built after spawn, and swapping the model made the client clear the effect);
  - when a player starts seeing the shadow (it comes into view range);
  - after `/saa reload-config` (effects rebuilt).
- No new keys: the existing `army.shadowLookSettleSeconds` (0.75 s) sets how long to wait for the look to settle before re-sending.
- **Shadows fight again.** The game's ally role had a "leash" that made a shadow drop its target and stand still when the group had
  no leader. In Creative, or with no leader, this cancelled every attack. Now the leash applies only with a leader. Without one,
  the mod limits the distance itself (64 blocks in combat). A new "no leader" test requires real hits on the enemy.
- **Diagnostic command** `/saa manage brain` shows each shadow's order, target, state (Combat/Idle) and group.
- Reminder: with berserk off, on "follow" shadows only attack hostile mobs within 12 blocks of you on their own. Use
  `/saa order attack` or `focus` to send them after another target.

## 0.2.9 — 2026-11-04
File: `ShadowsAboveAll-0.2.9.jar`.
- **Shadows follow you in Creative.** Hytale keeps players outside Adventure out of NPC groups, so the game's "follow" doesn't
  work there. In Creative, shadows now teleport near you when they are more than 8 blocks away
  (`army.teleportToCommanderDistanceNoFlock`). In Adventure they walk behind you as before.
- Alt+9 still doesn't work in singleplayer, because the game doesn't pass keyboard commands through the packet filter. Use `/saa menu`
  or the "Open System" emote.

## 0.2.8 — 2026-11-04
File: `ShadowsAboveAll-0.2.8.jar`.
- **Shadows no longer vanish when you switch to Creative.** Changing game mode removes the player from every NPC "group", and
  Hytale's summoned-ally role deleted any ally with no player in its group. That rule is gone from the shadows' role. They rejoin
  your group on their own and keep following you in Creative too.
- **Alt+9 hotkey:** it now also works when the game sends the number key as a plain slot change (before, only one packet type was
  understood). With `ui.hotkeyDebug: true` the log shows each packet type the game sends, for diagnosis.

## 0.2.7 — 2026-11-04
File: `ShadowsAboveAll-0.2.7.jar`.
- **Bonus points on top of Endless Leveling.** In `EL_STATS` mode, System points (given with
  `/saa manage points <player> <amount>`) can now be spent in the Status tab (+1 / +5). They add to the attributes that come from
  EL, and this mod applies **only the extra part**: more health (VIT), speed (AGI), damage (STR) and crit chance (PER). As before,
  they also add Hunter Power, Necro Power, mana and skills. EL still applies its own, and bonus points don't show in `/lvl`.
- Bonus points are kept apart from the points of the mod's own mode (`OWN`), so switching modes doesn't mix them.

## 0.2.6 — 2026-11-04
File: `ShadowsAboveAll-0.2.6.jar`.
- **"Berserk: ON/OFF" button** in the Army tab of the System window, next to Summon all and Recall all. It toggles berserk like
  `/saa berserk`, and the button shows the current state.
- Includes everything from 0.2.5 (energy cracks as the default look).

## 0.2.5 — 2026-11-04
File: `ShadowsAboveAll-0.2.5.jar`.
- **New shadow look, "energy cracks"** (the user's pick in test 19): thin glowing blue lines all over the body, moving slowly, on
  top of the creature's own colors (purple in Domain and at level 100). The dark texture is off by default (`army.shadowSkin: false`),
  so sword and shield keep their original color. The old config migrates on its own (version 12), and values you changed are kept.
- **Fix:** transparency (`shadowTransparency`) was also applied in PostColor mode, where it wiped out the effect on the whole body.
  That is why some looks "didn't show". It now applies only in AlphaTransparency mode.

## 0.2.4 — 2026-11-04
File: `ShadowsAboveAll-0.2.4.jar`.
- **A glow that really pulses back and forth.** The shadow's body stays dark and a blue wave runs over the model and back, nonstop
  (purple in Domain and at level 100). In 0.2.3 it came out as almost flat blue. Values: `shadowVfxRangeMin` 0,
  `shadowVfxRangeMax` 0.45, `shadowVfxHighlightThickness` 3. The old config migrates on its own (version 11), and a value you changed is kept.

## 0.2.3 — 2026-11-04
File: `ShadowsAboveAll-0.2.3.jar`.
- **Outline cancelled**, at the user's request (Hytale is still in beta). Shadows go back to the **old look**: a dark body with a
  blue glow that pulses over the model (purple in Domain and at level 100). Weapons and armor stay dark. The old config migrates
  on its own (version 10).
- To turn the outline back on, set `army.shadowOutline: true`. The new code was kept: lines only on the edges of each part, without
  the back lines showing through the body (`shadowOutlineMode`: `edges`, `allEdges` or `hull`).
- Build fix: the version in `manifest.json` now always matches the jar version.

## 0.2.2 — 2026-11-04
File: `ShadowsAboveAll-0.2.2.jar`.
- **Thinner, cleaner outline:** the blue edge lines went from 1.5 to 0.8 (`army.shadowOutlineThickness`). An old config still at
  1.5 migrates on its own (version 9).
- Outline effect test done in the Hytale editor (`docs/qa/TESTE-2026-11-04-outline.md`). Hytale has no silhouette outline, only
  noise "veins". On shadows, edge lines are still what looks most like an outline.
- **Known:** in Creative mode, summoned shadows vanish at once (use Adventure). Some heads show no lines and turn gray.

## 0.2.1 — 2026-11-04
File: `ShadowsAboveAll-0.2.1.jar`.
- **Shadows' weapons, shields and armor get the shadow look**, from "shadow" copies of the items with the blue lines. Igris's
  sword and shield are no longer orange. Configurable: `army.shadowSkinWeapons`, `army.shadowSkinWeaponsOutline`.
- Textures are generated with sizes that are multiples of 32 (Hytale rejected some).
- **Tested in game:** Shadow Exchange no longer throws you out of the world, and the Shadow Chest opens (large grid).
- Known: for 2–4 s right after summoning, shadows show their original colors while the game prepares the new textures.

## 0.2.0 — 2026-11-04 (main `79f9f05` + version 0.2.0)
File: `ShadowsAboveAll-0.2.0.jar`. Installs the same way as 0.1.0. The old config migrates on its own up to version 8.

**New**
- **Shadow look:** a dark blue body at 50% transparency, with an **outline of glowing blue lines on the edges** (purple in Domain
  and from level 100), blue eyes and flames, and an aura by rank. Configurable (`army.shadowOutline*`, `shadowTransparency`, `shadowSkin*`).
- **ShadowBrain:** shadows hold their orders (follow, attack, defend, protect, patrol, focus, recall) and berserk. They never attack
  the owner, other shadows, the party or Endless Leveling summons. They fight up to 64 blocks from the owner.
- **Squads:** up to 16, each with its own order and priority target (`/saa squad ...`).
- **Generals:**
  - Igris: Sword Plant 16×16, Crimson Crescent, Phantom Blades.
  - **Ant King → Beru:** Paralyzing Strike, Frenzy Combo, unlimited ability theft.
  - **Abyssal Marshal → Bellion:** Blade Storm.

  Bosses have a health bar and a summoning item.
- **Gates:**
  - Random portals E..S (Red Gate 3%).
  - The interior is a Hytale instance, with Shale rooms and a Trork castle.
  - Mobs by rank with Arise, a boss, and XP for clearing.
  - **Dungeon Break** at 40 min.
  - Rank is capped at your level + 5.
  - Dying in a gate sends you back to the entrance.
- **Party** (`/saa party`), **army PvP** (off by default), and **lending/transferring shadows** (`/saa lend`, `/saa transfer`).
- **Endless Leveling:**
  - Stats come from EL (`EL_STATS`).
  - Necro Power comes from Sorcery (Perception) and Flow (mana).
  - Shadow damage gets +1% per Sorcery.

**Fixes since 0.1.0**
- Igris always appears on the last Arise attempt.
- Shadow Exchange checks the destination before spending mana.
- Shadows no longer die from suffocation or get stuck in a loop.
- The look no longer disappears in combat.
- Mod screens close on world change.
- `/saa manage level` warns when EL controls the level.

**Known / not yet seen in game:**
- Igris's sword and shield (and some mobs' accessories) still lack the shadow look.
- Shadow Exchange needs a retest in game.
- Shadow Chest, Grimoire and squads are untested on the client.
- Gate and boss balancing is still open.
- Possession stays planning-only.

## 0.1.0 — 2026-11-03 (main `416a02c`)
First playable build of the Hytale port (server 0.7.5). File: `ShadowsAboveAll-0.1.0.jar`.

**How to install:**
1. Copy the jar to `D:\Hytale Game\UserData\Mods\`.
2. Enable "Nyon:ShadowsAboveAll" in the world, from Mods in the world menu or with `scripts\deploy-singleplayer.ps1`.
3. The config is in `Saves\<world>\mods\Nyon_ShadowsAboveAll\config.json`. Apply changes with `/saa reload-config`.

- **System:** level, XP with anti-farm, 5 attributes, its own mana, Hunter/Necro Power, a HUD on the right, System-style notifications.
- **Endless Leveling:** with EL installed, `EL_STATS` mode uses EL's level, XP and attributes without doubling effects. Shadows are
  left out of EL's scaling and elites, and earn EL XP when they kill.
- **Arise:** a corpse on dead mobs (60 s, 3 attempts), chance from Necro Power, rank E..S, `/saa arise` or the Monarch's Sigil.
- **Army:**
  - Shadows are saved; you summon or recall them; they revive in 2 s for mana.
  - They are immune to suffocation, falls and drowning.
  - Orders: follow, attack, defend.
  - Ranks Soldier..Special with shadow XP (the owner earns the same).
  - Blue/purple shadow look with eyes and an aura by rank.
- **System window:** Status, Skills, Army, Quests, Settings (`/saa menu`, the System Interface item, or Alt+9 while walking).
- **Skills:** Shadow Exchange, Stealth, Ruler's Authority, Monarch's Domain, Shadow Chest (16×120), Grimoire with Q/E/R.
- **Quests:** the daily "Preparation to Become Powerful" with a penalty, 10 main quests, 5 secret quests, Random Box.
- **Job Change:** a private arena with 3 waves plus the Red Knight, leading to Shadow Monarch and Igris (last attempt guaranteed).
- **Everything configurable** (about 400 values), with automatic config migration.

**Not tested in game yet:**
- The full Job Change with a player.
- Stealth, Exchange, Authority, Domain and the Chest on the client.
- The Grimoire.
- Full quests.

Possession is left for later (planning only).