tgui, moar documentation

Author: Ava

code/game/gamemodes/cult/runes/_rune.dm

@@ -1,3 +1,4 @@
+/// Runes are effectively "spell circles", and are the main source of abilities for cultists.
 /obj/effect/rune
 	name = "rune"
 	desc = "A strange collection of symbols drawn in what looks to be blood."
@@ -25,7 +26,7 @@
 	var/rune_shorthand
 	/// As `rune_name`, but for a description of what the rune actually does.
 	var/rune_desc
-	/// If FALSE, this rune won't appear on the tome's rune list.
+	/// If false, this rune won't appear on the tome's rune list.
 	var/can_write = TRUE
 
 /obj/effect/rune/Initialize()
@@ -59,8 +60,6 @@
 		to_chat(user, SPAN_NOTICE("The scratchings lose coherence and dissolve into puddles of blood that quickly sizzle and disappear."))
 		qdel(src)
 		return
-	else if (istype(I, /obj/item/soap) || istype(I, /obj/item/mop))
-		to_chat(user, SPAN_WARNING("No matter how hard you try, the scratchings just won't seem to come out."))
 	return
 
 /obj/effect/rune/attack_hand(mob/living/user)
@@ -152,7 +151,7 @@
 	return INITIALIZE_HINT_LATELOAD
 
 /obj/effect/rune/mapgen/LateInitialize()
-	var/list/words = cult.english_words
+	var/list/words = cult.english_words.Copy()
 	for (var/i in 1 to 3)
 		var/word = pick(words)
 		circle_words.Add(word)

code/game/gamemodes/cult/talismans/_talisman.dm

@@ -1,3 +1,4 @@
+/// Effectively portable runes, created with the Imbue Talisman rune. Talismans are usually similar to the runes they're created from.
 /obj/item/paper/talisman
 	icon_state = "paper_talisman"
 	info = "<center><img src='talisman.png'></center><br/><br/>"

code/game/gamemodes/cult/talismans/stun.dm

@@ -2,6 +2,7 @@
 	talisman_name = "Stun"
 	talisman_desc = "Forces the concentrated energy of a stun rune into a struck target, immediately knocking them to the ground. Humans will be prevented from speaking for a time."
 	invocation = "Dream sign 'Evil Sealing Talisman'!" // I think this is a touhou reference
+	whispered = FALSE
 
 /obj/item/paper/talisman/stun/attack_self(mob/living/user)
 	if (iscultist(user))

code/game/gamemodes/cult/talismans/supply.dm

@@ -1,3 +1,4 @@
+/// This is a unique talisman given to roundstart cultists, and is the only source of soul stones and construct shells for them until they make an artificer.
 /obj/item/paper/talisman/supply
 	talisman_name = "Supply"
 	talisman_desc = "A densely-scrawled talisman with several functions, used to start a new cult."

tgui/packages/tgui/interfaces/ArcaneTome.js

@@ -1,6 +1,6 @@
 import { Fragment } from 'inferno';
 import { useBackend, useLocalState } from '../backend';
-import { Box, Button, Flex, Section, Tabs } from '../components';
+import { Box, Button, Collapsible, Flex, Icon, Section, Tabs } from '../components';
 import { Window } from '../layouts';
 
 export const ArcaneTome = (props, context) => {
@@ -30,7 +30,40 @@ export const ArcaneTome = (props, context) => {
         <Section>
           {
             tabIndex === 0
-            && ("Nya")
+            && (
+              <Box>
+                <i>You are a cultist of <b>Nar-Sie</b>, the One who Sees, the Geometer of Blood. It has revealed to you the fact of Its existence by necessity, and graciously inducted you into Its followers so that you may better serve Its will.</i><br /><br />
+                <i>These archives serve as an <b>out-of-character</b> knowledge base for information about the cult, how your abilities work, and your ultimate goals. Refer back to it any time you're lost!</i><br/><br/>
+                <Collapsible
+                  title="What is this?">
+                  You're holding an <b>arcane tome</b>, a book that contains the rites and scriptures of the Geometer. <b>Every cultist should have a tome unless they have a good reason not to.</b> In addition to this informational page, you can browse <b>Runes</b> within a dedicated section of the tome, allowing you to see their functions or scribe them onto the ground.
+                  <br /><br />
+                  If need be, your tome can serve as a weapon as well. Simply switch to Harm intent and attack your foes with it to deal burn damage. Naturally, it'll be abundantly obvious to the target that you're doing something otherworldly and very harmful.
+                </Collapsible>
+                <Collapsible
+                  title="What are runes?">
+                  <b>Runes</b> are eldritch scrawlings, etched with precise shapes and words to invoke the power of Nar-Sie. They are the primary source of your power as a cultist, and they allow you to perform anomalous feats alike to magic. Some runes can be made into <b>talismans</b> that offer something akin to their abilities in a more portable form.
+                  <br /><br />
+                  There are many different types of rune, each with their own functions and methods of use. In order to create a rune, you use your own blood, meaning that you'll take a small amount of damage each time you create one. To invoke a rune, simply click on it with an empty hand.
+                  <br /><br />
+                  Runes are naturally very conspicuous, and you should be careful to keep them well-hidden to avoid drawing unnecessary suspicion. You can erase a rune by clicking on it with your tome - leaving no trace of its existence - or just mop it up like any regular spill.
+                  <br /><br />
+                  Notably, AIs can't perceive runes. Instead, they just see them as a regular pool of blood. That's still conspicuous in its own right, mind you!
+                </Collapsible>
+                <Collapsible
+                  title="What are talismans?">
+                  Runes are essential for success, but they can be difficult to lay down quickly. <b>Talismans</b> can be of use there; by invoking the <i>Imbue Talisman</i> rune with a blank sheet of paper on top and a relevant rune nearby, that rune can be "inscribed" onto the paper, which can then be consumed at any time to mirror its effects.
+                  <br /><br />
+                  Talismans' effects are usually equivalent to that of their respective rune, but weaker. Some, however, can be vastly different; the Stun talisman, for instance, causes a heavy stun to a single target struck with the talisman, instead of disorienting everyone nearby. Cultists starting aboard the station are equipped with a special Supply talisman that allows them to make certain talismans for free or to create soul shards and construct shells.
+                </Collapsible>
+                <Collapsible
+                  title="What should I do?">
+                  Depends! Stealth and infiltration are a cult's best ally, so unless you've already been ousted, it's never a bad idea to simply go back to what you were doing as if nothing had transpired. You can keep in touch with other cultists across distances and z-levels by using a <i>Communicate</i> rune, and coordinating in this manner is very important.
+                  <br /><br />
+                  When you feel ready to introduce more people to the fold, you should go about it carefully. The <i>Convert</i> rune is opt-in - the convertee can simply keep refusing to join the cult and will take increasing damage instead - so above all else, remember to <b>roleplay</b> and make it an interesting experience. Don't just stun someone and drag them to the rune - lead up to it. Talk to them, manipulate them. Make their conversion <i>mean</i> something.
+                </Collapsible>
+              </Box>
+            )
             || tabIndex === 1
             && (
               <Flex