Anvil Stats

⚒️ Anvil Stats

Anvil Stats are permanent buffs that enhance player attributes throughout the game. They let players specialize their character and develop unique builds over time.

---

⭐ Features

• Permanent Buffs: Anvil Stats provide lasting improvements to player attributes.

• Selection Process: Players choose 1 of 3 random stats when offered.

• Reroll Option: Players can reroll if they’re not happy with the choices.

• Round Availability: Offered only on specific rounds (defined in Round Builder).

• Random Selection: If a player doesn’t choose, one is selected automatically.

---

🔧 Configuration

The main settings for Anvil Stats are located in game.yml under the roll.anvil-stats section.

# game.yml
roll:
  anvil-stats:
    base: 2
    high-stakes: 1
    choices: 3

Key	Type	Default	Description
base	integer	2	The base number of Anvil Stat rolls offered per game.
high-stakes	integer	1	Additional rolls offered if the "High Stakes" augment is active.
choices	integer	3	The number of random stats presented to the player to choose from.

The actual stats, their names, and modifiers are defined in gameplay/anvil-stats.yml.

---

🧮 Operations

Each modifier affects player attributes in different ways:

Operation	Description	Example
ADD_NUMBER	Adds a flat number to the base value.	Base = 10, +1 → 11
ADD_SCALAR	Adds a percentage of the base to the base.	Base = 10, +10% → 11
MULTIPLY_SCALAR_1	Adds a final percentage after all modifiers.	After = 11, +10% → 12.1

You can find all available attributes here: 📘Attribute Reference

---

💡 Example

The following is an excerpt from gameplay/anvil-stats.yml.

FLAT_DAMAGE:
  name: "Damage"
  modifiers:
    - "ATTACK_DAMAGE ADD_NUMBER{0.5;1.0}"

FLAT_HEALTH:
  name: "Health"
  modifiers:
    - "MAX_HEALTH ADD_NUMBER{2.0;4.0}"

SCALING_DAMAGE:
  name: "Scaling Damage"
  modifiers:
    - "ATTACK_DAMAGE ADD_SCALAR{0.05;0.1}"

DAMAGE_GAMBIT:
  name: "Damage Gambit"
  modifiers:
    - "ATTACK_DAMAGE ADD_SCALAR{-0.05;0.15}"

• Ranges: The values in {} represent minimum and maximum rolls (e.g., {0.5;1.0}). A random value is chosen within this range.

• Complexity: You can define multiple modifiers per stat for complex effects.

• Balance: Large values can quickly overpower gameplay, especially with SCALING operations.

---

Full Default gameplay/anvil-stats.yml

FLAT_DAMAGE:
  name: "Damage"
  modifiers:
    - "ATTACK_DAMAGE ADD_NUMBER{0.5;1.0}"

FLAT_HEALTH:
  name: "Health"
  modifiers:
    - "MAX_HEALTH ADD_NUMBER{2.0;4.0}"

FLAT_ATTACK_SPEED:
  name: "Attack Speed"
  modifiers:
    - "ATTACK_SPEED ADD_NUMBER{0.15;0.30}"

FLAT_MOVEMENT_SPEED:
  name: "Movement Speed"
  modifiers:
    - "MOVEMENT_SPEED ADD_NUMBER{0.01;0.02}"

FLAT_ARMOR:
  name: "Armor"
  modifiers:
    - "ARMOR ADD_NUMBER{1.0;2.0}"

FLAT_ARMOR_TOUGHNESS:
  name: "Armor Toughness"
  modifiers:
    - "ARMOR_TOUGHNESS ADD_NUMBER{1.0;2.0}"

FLAT_RANGE:
  name: "Range"
  modifiers:
    - "ENTITY_INTERACTION_RANGE ADD_NUMBER{0.15;0.30}"

SCALING_DAMAGE:
  name: "Damage"
  modifiers:
    - "ATTACK_DAMAGE ADD_SCALAR{0.05;0.1}"

SCALING_HEALTH:
  name: "Health"
  modifiers:
    - "MAX_HEALTH ADD_SCALAR{0.05;0.1}"

SCALING_ATTACK_SPEED:
  name: "Attack Speed"
  modifiers:
    - "ATTACK_SPEED ADD_SCALAR{0.05;0.1}"

SCALING_MOVEMENT_SPEED:
  name: "Movement Speed"
  modifiers:
    - "MOVEMENT_SPEED ADD_SCALAR{0.05;0.1}"

SCALING_ARMOR:
  name: "Armor"
  modifiers:
    - "ARMOR ADD_SCALAR{0.05;0.1}"

SCALING_ARMOR_TOUGHNESS:
  name: "Armor Toughness"
  modifiers:
    - "ARMOR_TOUGHNESS ADD_SCALAR{0.05;0.1}"

SCALING_RANGE:
  name: "Range"
  modifiers:
    - "ENTITY_INTERACTION_RANGE ADD_SCALAR{0.05;0.1}"

DAMAGE_GAMBIT:
  name: "Damage Gambit"
  modifiers:
    - "ATTACK_DAMAGE ADD_SCALAR{-0.05;0.15}"

HEALTH_GAMBIT:
  name: "Health Gambit"
  modifiers:
    - "MAX_HEALTH ADD_SCALAR{-0.05;0.15}"

ATTACK_SPEED_GAMBIT:
  name: "Attack Speed Gambit"
  modifiers:
    - "ATTACK_SPEED ADD_SCALAR{-0.05;0.15}"

SPEED_GAMBIT:
  name: "Speed Gambit"
  modifiers:
    - "MOVEMENT_SPEED ADD_SCALAR{-0.05;0.15}"

ARMOR_GAMBIT:
  name: "Armor Gambit"
  modifiers:
    - "ARMOR ADD_SCALAR{-0.05;0.15}"

ARMOR_TOUGHNESS_GAMBIT:
  name: "Armor Toughness Gambit"
  modifiers:
    - "ARMOR_TOUGHNESS ADD_SCALAR{-0.05;0.15}"

RANGE_GAMBIT:
  name: "Range Gambit"
  modifiers:
    - "ENTITY_INTERACTION_RANGE ADD_SCALAR{-0.05;0.15}"