Famions

Famions are spirit companions drawn from Filipino mythology (a sub-IP integration from famions.com). Each bonds to a hero, grants a passive stat buff, and fights alongside them. Unlocks at Stage 3‑3.

---

Species & roster

5 species, each with a mythic realm:

The base set is 20 Famions (4 species × 5 variants each) plus Santelmo (season-exclusive, excluded from the bonding gacha). Elements used in data: nature, earth, fire, water, lightning, shadow. Each Famion has a rarity and a passive stat bonus, e.g. Stone Duwende (earth, epic, +25 DEF), Fire Adarna (fire, epic, +22 ATK), Lightning Sundo (lightning, epic, +22 SP.ATK).

---

Bonding Ritual (Famion gacha)

Costs karmic energy (not fragments), so the Famion loop never cannibalizes the hero gacha.

Rarity odds

(FAMION_RARITY_RATES — exported so the UI shows true odds. Legendary is not in the pool.)

Duplicates convert to ascension shards, scaled by rarity: Common +1 · Uncommon +2 · Rare +3 · Epic +5 · Legendary +8.

---

Affection

Affection (0–100) reflects the bond and multiplies the Famion's buff.

Let a Famion sit and affection drifts down (never below 10); care resets the clock.

---

Care mini-game

Four actions raise affection and grant care XP (for leveling):

---

Levels

Famions level 1 → 20 via care XP. Each level adds +5% to the buff.

care XP for next level = floor( 20 × 1.2^(level−1) )

The level cap is gated by ascension (see below).

---

Ascension

Four stars, gated by duplicate shards:

* Base shard cost, then multiplied by a rarity factor: Common/Uncommon 1× · Rare 1.5× · Epic 2× · Legendary 3×.

---

The passive buff

A bonded Famion grants its hero a flat stat bonus, scaled by everything above:

buff = flatBonus × affectionMult × levelMult × ascensionMult

  affectionMult = 0.5 + 0.5 × (affection / 100)      # 0.55 → 1.0
  levelMult     = 1 + (level − 1) × 0.05             # +5%/level
  ascensionMult = 1.0 / 1.2 / 1.5 / 2.0              # by star

One Famion per hero, equipped via the Famion panel in the hero detail modal.

---

Famions in battle

A bonded Famion appears as a targetable unit beside its hero:

• Positioning: front = targeted first, behind = targeted last.
• Famions carry their own element and take/deal advantage accordingly.
• If the Famion dies, its stat buff is stripped from the bonded hero for the rest of the fight — a real reason to position it behind.
• Battle HP/power scale with affection.

---

Veil Garden

An ambient habitat in the Famion tab where your collected Famions wander with directional facing — the "home" screen for the collection. Purely cosmetic/atmospheric.

---

On the roadmap

Famion evolution — advanced forms that transform a companion into a stronger creature — is designed and planned for a future update.