From 4fe48ec3cc868ef7bb8d42b3228664fdb3bae10f Mon Sep 17 00:00:00 2001
From: Hitlinemoss <209321380+Hitlinemoss@users.noreply.github.com>
Date: Thu, 18 Dec 2025 14:20:38 -0500
Subject: [PATCH] Adds debug wizard's grimoire (#41900)

---
 .../Entities/Objects/Magic/books.yml          | 47 +++++++++++--------
 1 file changed, 28 insertions(+), 19 deletions(-)

diff --git a/Resources/Prototypes/Entities/Objects/Magic/books.yml b/Resources/Prototypes/Entities/Objects/Magic/books.yml
index db0d3c8d51..55bb7e5582 100644
--- a/Resources/Prototypes/Entities/Objects/Magic/books.yml
+++ b/Resources/Prototypes/Entities/Objects/Magic/books.yml
@@ -1,8 +1,8 @@
 - type: entity
+  abstract: true
+  parent: [ BaseItem, BaseMagicalContraband ]
   id: BaseSpellbook
   name: spellbook
-  parent: [ BaseItem, BaseMagicalContraband ]
-  abstract: true
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -19,13 +19,14 @@
       tags:
       - Spellbook
 
-# For the Wizard Antag
+# For the Wizard antagonist
 # Do not add discounts or price inflation
 - type: entity
+  parent: [ BaseItem, StorePresetSpellbook, BaseMagicalContraband ]
   id: WizardsGrimoire
-  name: wizards grimoire
+  name: wizard's grimoire
   suffix: Wizard
-  parent: [ BaseItem, StorePresetSpellbook, BaseMagicalContraband ]
+  description: A heavy tome containing complicated arcane formulae for preparing magic spells and conjuring supernatural equipment. Decades of study went into researching this collection of mystical secrets; now go use them to ruin someone's day.
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -45,36 +46,44 @@
       key: enum.StoreUiKey.Key
     - type: Store
       refundAllowed: true
-      ownerOnly: true # get your own tome!
+      ownerOnly: true # Lesser minds cannot comprehend the arcane secrets within
       balance:
         WizCoin: 10 # prices are balanced around this 10 point maximum and how strong the spells are
 
-# Not meant for wizard antag but meant for spawning, so people can't abuse refund if they were given a tome
+# No-refund version meant for manual spawning, so people can't abuse refund if they were given a tome. Not meant for wizard antag proper!
 - type: entity
+  parent: WizardsGrimoire
   id: WizardsGrimoireNoRefund
-  name: wizards grimoire
-  suffix: Wizard, No Refund
-  parent: [ WizardsGrimoire, StorePresetSpellbook ]
+  suffix: Wizard, no refunding
   components:
     - type: Store
       refundAllowed: false
-      ownerOnly: true # get your own tome!
+
+# For debugging purposes only! Or spawn this for an admeme so a wizard can have every spell at once, I can't stop you.
+- type: entity
+  parent: WizardsGrimoire
+  id: WizardsGrimoireDebug
+  suffix: Wizard, DEBUG
+  description: A heavy tome containing complicated arcane formulae for preparing magic spells and conjuring supernatural equipment. Someone wrote "FOR EXPERIMENTAL USE ONLY" on the inside cover.
+  components:
+    - type: Store
+      ownerOnly: false # For ease of debugging.
       balance:
-        WizCoin: 10 # prices are balanced around this 10 point maximum and how strong the spells are
+        WizCoin: 99999
 
 - type: entity
+  parent: BaseSpellbook
   id: SpawnSpellbook
   name: spawn spellbook
-  parent: BaseSpellbook
   components:
     - type: Spellbook
       spellActions:
         ActionSpawnMagicarpSpell: null
 
 - type: entity
+  parent: BaseSpellbook
   id: ForceWallSpellbook
   name: force wall spellbook
-  parent: BaseSpellbook
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -95,9 +104,9 @@
         ActionForceWall: null
 
 - type: entity
+  parent: BaseSpellbook
   id: BlinkBook
   name: blink spellbook
-  parent: BaseSpellbook
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -116,9 +125,9 @@
         ActionBlink: null
 
 - type: entity
+  parent: BaseSpellbook
   id: SmiteBook
   name: smite spellbook
-  parent: BaseSpellbook
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -139,9 +148,9 @@
         ActionSmiteNoReq: null
 
 - type: entity
+  parent: BaseSpellbook
   id: KnockSpellbook
   name: knock spellbook
-  parent: BaseSpellbook
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -161,9 +170,9 @@
         ActionKnock: null
 
 - type: entity
+  parent: BaseSpellbook
   id: FireballSpellbook
   name: fireball spellbook
-  parent: BaseSpellbook
   components:
     - type: Sprite
       sprite: Objects/Misc/books.rsi
@@ -185,9 +194,9 @@
         ActionFireball: null
 
 - type: entity
+  parent: BaseSpellbook
   id: ScrollRunes
   name: scroll of runes
-  parent: BaseSpellbook
   components:
   - type: Item
     size: Normal
-- 
2.52.0