Anexim/Mana-Loop
1
1
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

[High] [Bug] [Spec-Inconsistency] Golem count: AGENTS.md says 12, golemancy-spec says 10, spire-combat-spec says 12 #268

New Issue
Closed
opened 2026-06-05 02:06:08 +02:00 by Anexim · 2 comments
Anexim commented 2026-06-05 02:06:08 +02:00
Owner
Copy Link
Copy Source

Type: Spec / Spec inconsistency
Priority: High

AGENTS.md says:

12 golems total: 1 base (Earth) + 3 elemental (Steel, Crystal, Sand) + 6 hybrid (Lava, Galvanic, Obsidian, Prism, Quicksilver, Voidstone) + 2 advanced

golemancy-spec.md §4 says:

All 10 Golem Types (and lists: 1 base + 3 elemental + 6 hybrid = 10)

spire-combat-spec.md §9 references 12 golems but the data files only have 10.

GAME_BRIEFING.md §Golemancy System also says:

Golem Types (10 Total)

So we have:

  • AGENTS.md: 12 (1+3+6+2 advanced)
  • golemancy-spec: 10 (1+3+6)
  • spire-combat-spec: references 12
  • GAME_BRIEFING: 10

The "2 advanced" golems mentioned in AGENTS.md don't exist in any spec or data file. The golem data files (data/golems/) only define 10 golems.

Recommendation: Either create the 2 missing advanced golems, or update AGENTS.md and spire-combat-spec to say 10 golems total.

**Type:** Spec / Spec inconsistency **Priority:** High **AGENTS.md** says: > 12 golems total: 1 base (Earth) + 3 elemental (Steel, Crystal, Sand) + 6 hybrid (Lava, Galvanic, Obsidian, Prism, Quicksilver, Voidstone) + **2 advanced** **golemancy-spec.md §4** says: > All **10 Golem Types** (and lists: 1 base + 3 elemental + 6 hybrid = 10) **spire-combat-spec.md §9** references 12 golems but the data files only have 10. **GAME_BRIEFING.md §Golemancy System** also says: > Golem Types (**10 Total**) So we have: - AGENTS.md: 12 (1+3+6+2 advanced) - golemancy-spec: 10 (1+3+6) - spire-combat-spec: references 12 - GAME_BRIEFING: 10 The "2 advanced" golems mentioned in AGENTS.md don't exist in any spec or data file. The golem data files (`data/golems/`) only define 10 golems. **Recommendation:** Either create the 2 missing advanced golems, or update AGENTS.md and spire-combat-spec to say 10 golems total.
Anexim added the ai:todo label 2026-06-05 02:06:08 +02:00
n8n-gitea was assigned by Anexim 2026-06-05 02:06:08 +02:00
Anexim commented 2026-06-05 12:55:59 +02:00
Author
Owner
Copy Link
Copy Source

ultimate truth: this entire system should be redesigned to be more modular.
I want this system to be changed.

the golemancy system should be redesigned so that the player "designs" the golems.
initially this means the fabricator only can make a pure earth golem, below is a detailed description of how the new golemancy construction system should behave.

Golem Construction

Every golem consists of three mandatory components and one optional component:

  1. Core
  2. Frame
  3. Mind Circuit
  4. Enchantments (optional)

the summonning cost for a golem is determined by each of these components (ex Basic core adding earth mana cost to summoning), and the upkeep is determined by the Core (mana regen * 2)

Core

The Core acts as the golem's power source.

A core determines:

  • Mana Types Available
  • Mana Capacity
  • Mana Regeneration
  • Summon Duration
  • Player Upkeep Cost

Player upkeep is equal to:

Mana Regen × 2

Core Tiers

Core Tier Mana Types Cost
Basic Core 1 Earth Mana
Intermediate Core 2 Crystal Mana
Advanced Core 3 Crystal Mana
Guardian Core Guardian-specific Guardian-Specific

Guardian Core

Requirements:

  • Invoker Attunement 5

Properties:

  • Provides all mana types granted by the chosen Guardian.
  • Massive mana capacity.
  • Required for Guardian Constructs.

Frame

The frame determines the golem's physical combat characteristics.

Frame Statistics

  • Damage
  • Speed
  • Armor Pierce
  • Magic Affinity (a percentage - determines how efficient spells cast by this golem are, ex 50% affinity: a spell would deal 50% of the damage it normally does)
  • Special Effect
Frame Damage Speed Armor Pierce Magic Affinity Special
Earth Very Low Medium Very Low Very Low None
Sand Low-Medium Slow Very High Medium Attacks deal AoE damage
Frost Medium Medium Medium High Attacks apply Slow
Crystal High Fast Medium-Low Very High None
Steel Very High Fast High Medium None
Shadowglass Very High Very Fast Very High Very High AoE
Crystal-Steel Hybrid Very High Very Fast Very High Highest Supports Guardian Constructs

Crystal-Steel Hybrid

Requirements:

  • Fabricator Attunement 5

Properties:

  • Only frame capable of housing a Guardian Construct.
  • Required for all Guardian Constructs.

Mind Circuit

The Mind Circuit controls the golem's behavior and spell usage.

Simple Logic Circuit

Cost:

  • Earth Mana

Behavior:

  • Performs basic attacks only.
  • Targets nearby enemies.

Requirements:

  • None

Intermediate Logic Circuit

Requirements:

  • Enchanter Attunement 2
  • Fabricator Attunement 3

Cost:

  • Crystal Mana

Behavior:

  • Player selects 1 spell from unlocked Spell (from caster pool) Enchantments.
  • Golem attempts to cast the spell whenever enough mana is available.
  • Otherwise performs basic attacks.

Advanced Logic Circuit

Requirements:

  • Enchanter Attunement 3
  • Fabricator Attunement 4

Cost:

  • Crystal Mana

Behavior:

  • Player selects 2 spells.

  • Golem alternates between them:

    • Spell A
    • Spell B
    • Spell A
    • Spell B

  • If unable to cast, performs basic attacks.

Guardian Circuit

Requirements:

  • Invoker Attunement 5
  • Fabricator Attunement 5

Behavior:

  • Required for Guardian Constructs.
  • Player selects 1 spell for each mana type available to the Guardian.
  • Functions like an Advanced Circuit but cycles through all selected spells.

Enchantments (Optional)

Requirements:

  • Enchanter Attunement 5
  • Fabricator Attunement 5

Enchantments add sword effects to a golem's basic attacks.
Enchantment capacity is determined by the frames Magic Affinity & the core tier.

Examples

Enchantment Effect
Sword_Fire Applies Burn
Sword_Frost Applies additional Slow
Sword_Lightning Chance to Shock
Sword_Shadow Chance to Weaken

When applied:

Summon Cost += Enchantment Base Cost
ultimate truth: this entire system should be redesigned to be more modular. I want this system to be changed. the golemancy system should be redesigned so that the player "designs" the golems. initially this means the fabricator only can make a pure earth golem, below is a detailed description of how the new golemancy construction system should behave. # Golem Construction Every golem consists of three mandatory components and one optional component: 1. Core 2. Frame 3. Mind Circuit 4. Enchantments (optional) the summonning cost for a golem is determined by each of these components (ex Basic core adding earth mana cost to summoning), and the upkeep is determined by the Core (mana regen * 2) --- # Core The Core acts as the golem's power source. A core determines: * Mana Types Available * Mana Capacity * Mana Regeneration * Summon Duration * Player Upkeep Cost Player upkeep is equal to: ``` Mana Regen × 2 ``` ### Core Tiers | Core Tier | Mana Types | Cost | | ----------------- | ----------------- | ----------------- | | Basic Core | 1 | Earth Mana | | Intermediate Core | 2 | Crystal Mana | | Advanced Core | 3 | Crystal Mana | | Guardian Core | Guardian-specific | Guardian-Specific | ### Guardian Core Requirements: * Invoker Attunement 5 Properties: * Provides all mana types granted by the chosen Guardian. * Massive mana capacity. * Required for Guardian Constructs. --- # Frame The frame determines the golem's physical combat characteristics. ### Frame Statistics * Damage * Speed * Armor Pierce * Magic Affinity (a percentage - determines how efficient spells cast by this golem are, ex 50% affinity: a spell would deal 50% of the damage it normally does) * Special Effect | Frame | Damage | Speed | Armor Pierce | Magic Affinity | Special | | -------------------- | ---------- | --------- | ------------ | -------------- | ---------------------------- | | Earth | Very Low | Medium | Very Low | Very Low | None | | Sand | Low-Medium | Slow | Very High | Medium | Attacks deal AoE damage | | Frost | Medium | Medium | Medium | High | Attacks apply Slow | | Crystal | High | Fast | Medium-Low | Very High | None | | Steel | Very High | Fast | High | Medium | None | | Shadowglass | Very High | Very Fast | Very High | Very High | AoE | | Crystal-Steel Hybrid | Very High | Very Fast | Very High | Highest | Supports Guardian Constructs | ### Crystal-Steel Hybrid Requirements: * Fabricator Attunement 5 Properties: * Only frame capable of housing a Guardian Construct. * Required for all Guardian Constructs. --- # Mind Circuit The Mind Circuit controls the golem's behavior and spell usage. ## Simple Logic Circuit Cost: * Earth Mana Behavior: * Performs basic attacks only. * Targets nearby enemies. Requirements: * None --- ## Intermediate Logic Circuit Requirements: * Enchanter Attunement 2 * Fabricator Attunement 3 Cost: * Crystal Mana Behavior: * Player selects 1 spell from unlocked Spell (from caster pool) Enchantments. * Golem attempts to cast the spell whenever enough mana is available. * Otherwise performs basic attacks. --- ## Advanced Logic Circuit Requirements: * Enchanter Attunement 3 * Fabricator Attunement 4 Cost: * Crystal Mana Behavior: * Player selects 2 spells. * Golem alternates between them: * Spell A * Spell B * Spell A * Spell B * If unable to cast, performs basic attacks. --- ## Guardian Circuit Requirements: * Invoker Attunement 5 * Fabricator Attunement 5 Behavior: * Required for Guardian Constructs. * Player selects 1 spell for each mana type available to the Guardian. * Functions like an Advanced Circuit but cycles through all selected spells. --- # Enchantments (Optional) Requirements: * Enchanter Attunement 5 * Fabricator Attunement 5 Enchantments add sword effects to a golem's basic attacks. Enchantment capacity is determined by the frames Magic Affinity & the core tier. ### Examples | Enchantment | Effect | | --------------- | ----------------------- | | Sword_Fire | Applies Burn | | Sword_Frost | Applies additional Slow | | Sword_Lightning | Chance to Shock | | Sword_Shadow | Chance to Weaken | When applied: ``` Summon Cost += Enchantment Base Cost ```
Anexim added ai:done and removed ai:todo labels 2026-06-05 14:30:25 +02:00
Anexim commented 2026-06-05 14:30:25 +02:00
Author
Owner
Copy Link
Copy Source

✅ RESOLVED — Updated AGENTS.md golem count from 12 to 10 (matching golemancy-spec and GAME_BRIEFING). The 2 advanced golems mentioned in the old AGENTS.md don't exist in any data file. Added note about the ongoing redesign (see issue #268 comment for the new component-based system design).

✅ RESOLVED — Updated AGENTS.md golem count from 12 to 10 (matching golemancy-spec and GAME_BRIEFING). The 2 advanced golems mentioned in the old AGENTS.md don't exist in any data file. Added note about the ongoing redesign (see issue #268 comment for the new component-based system design).
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai:blocked
ai:done
ai:in-progress
ai:priority:high
priority
 ai:review
ai:todo
No Label ai:done
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
n8n-gitea zhipu Anexim
No Assignees n8n-gitea
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Anexim/Mana-Loop#268
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?