CFPAOrg · ChuijkYahus · Jan 4, 2025 · Jan 4, 2025 · Jan 5, 2025 · Jan 5, 2025
diff --git a/projects/1.21-fabric/assets/trickster/trickster/lang/en_us.json b/projects/1.21-fabric/assets/trickster/trickster/lang/en_us.json
diff --git a/projects/1.21-fabric/assets/trickster/trickster/lang/en_us.yml b/projects/1.21-fabric/assets/trickster/trickster/lang/en_us.yml
diff --git a/projects/1.21-fabric/assets/trickster/trickster/lang/zh_cn.json b/projects/1.21-fabric/assets/trickster/trickster/lang/zh_cn.json
diff --git a/...c/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/concepts.md b/...c/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/concepts.md
@@ -0,0 +1,9 @@
+```json
+{
+  "title": "Concepts",
+  "icon": "trickster:top_hat",
+  "ordinal": -1
+}
+```
+
+This category contains some useful conventions and concepts used in common magics.
diff --git a/...ickster/trickster/lavender/categories/tome_of_tomfoolery/delusions_ingresses.md b/...ickster/trickster/lavender/categories/tome_of_tomfoolery/delusions_ingresses.md
@@ -0,0 +1,15 @@
+```json
+{
+  "title": "Delusions & Ingresses",
+  "icon": "trickster:mirror_of_evaluation",
+  "ordinal": 1,
+  "parent": "trickster:tricks"
+}
+```
+
+Delusion tricks generate a value based on context, with no input given. 
+These usually make up the leaf nodes of a spell tree.
+
+
+Ingress tricks gather information based on the input given. 
+Unlike distortions however, they aren't guaranteed to always return the same result.
diff --git a/...ssets/trickster/trickster/lavender/categories/tome_of_tomfoolery/distortions.md b/...ssets/trickster/trickster/lavender/categories/tome_of_tomfoolery/distortions.md
@@ -0,0 +1,11 @@
+```json
+{
+  "title": "Distortions",
+  "icon": "trickster:scroll_and_quill",
+  "ordinal": 2,
+  "parent": "trickster:tricks"
+}
+```
+
+Distortions are tricks that purely manipulate data. 
+When given the same set of inputs, these will always give the same output.
diff --git a/...bric/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/items.md b/...bric/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/items.md
@@ -0,0 +1,9 @@
+```json
+{
+  "title": "Items",
+  "icon": "trickster:macro_ring",
+  "ordinal": 0
+}
+```
+
+Entries in this category go over some of the items available to the aspiring magician.
diff --git a/...bric/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/ploys.md b/...bric/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/ploys.md
@@ -0,0 +1,14 @@
+```json
+{
+  "title": "Ploys",
+  "icon": "trickster:wand",
+  "ordinal": 3,
+  "parent": "trickster:tricks"
+}
+```
+
+Ploys are a subset of tricks that perform actions and either alter the world, or something less substantial.
+
+
+Often, ploys will have a mana cost. This is denoted by a swirl icon under the pattern.
+Hover over the icon to see how mana cost is calculated.
diff --git a/...ric/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/tricks.md b/...ric/assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/tricks.md
@@ -0,0 +1,12 @@
+```json
+{
+  "title": "Tricks",
+  "icon": "trickster:written_scroll",
+  "ordinal": 1
+}
+```
+
+Tricks are the base unit that spells are constructed from.
+
+
+A trick takes inputs and/or outputs and either performs an operation on them, or creates side effects.
diff --git a/.../assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/tutorials.md b/.../assets/trickster/trickster/lavender/categories/tome_of_tomfoolery/tutorials.md
@@ -0,0 +1,10 @@
+```json
+{
+  "title": "Tutorials",
+  "icon": "minecraft:filled_map",
+  "ordinal": 2
+}
+```
+
+Start learning circle-based magic here. 
+This category contains a set of linear tutorials to take you through the most important concepts.
diff --git a/...ts/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/concepts.md b/...ts/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/concepts.md
@@ -0,0 +1,9 @@
+```json
+{
+  "title": "概念",
+  "icon": "trickster:top_hat",
+  "ordinal": -1
+}
+```
+
+本分类主要涉及普通魔术中一些有用的惯例和概念。
diff --git a/...r/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/delusions_ingresses.md b/...r/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/delusions_ingresses.md
@@ -0,0 +1,13 @@
+```json
+{
+  "title": "错觉术与辑流术",
+  "icon": "trickster:mirror_of_evaluation",
+  "ordinal": 1,
+  "parent": "trickster:tricks"
+}
+```
+
+错觉术会根据上下文生成值，无需输入。通常作为法术树的叶节点存在。
+
+
+辑流术会根据输入收集信息。此类戏法与错觉术不同，它们多次执行产生的结果不一定一致。
diff --git a/...trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/distortions.md b/...trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/distortions.md
@@ -0,0 +1,10 @@
+```json
+{
+  "title": "曲变术",
+  "icon": "trickster:scroll_and_quill",
+  "ordinal": 2,
+  "parent": "trickster:tricks"
+}
+```
+
+曲变术是仅对数据进行操作的戏法。给定相同的输入，必定得出同样的输出。
diff --git a/...ssets/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/items.md b/...ssets/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/items.md
@@ -0,0 +1,9 @@
+```json
+{
+  "title": "物品",
+  "icon": "trickster:macro_ring",
+  "ordinal": 0
+}
+```
+
+本分类下的条目介绍了各式物品，任诸位雄心壮志的魔术师和戏法师们挑选。
diff --git a/...ssets/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/ploys.md b/...ssets/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/ploys.md
@@ -0,0 +1,13 @@
+```json
+{
+  "title": "技巧术",
+  "icon": "trickster:wand",
+  "ordinal": 3,
+  "parent": "trickster:tricks"
+}
+```
+
+技巧术是一类戏法，能够执行特定操作，并对世界造成影响，或至少对一些事物造成影响。
+
+
+通常来说，技巧术会消耗魔力。有消耗的图案下方画有一个涡旋。将鼠标悬停在其上以查看消耗量的计算方式。
diff --git a/...sets/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/tricks.md b/...sets/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/tricks.md
@@ -0,0 +1,12 @@
+```json
+{
+  "title": "戏法",
+  "icon": "trickster:written_scroll",
+  "ordinal": 1
+}
+```
+
+戏法是法术的基本构成单元。
+
+
+戏法会接收输入、输出、或二者均取，并对其执行一定的操作，或是产生些许副作用。
diff --git a/...s/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/tutorials.md b/...s/trickster/trickster/lavender/categories/tome_of_tomfoolery/zh_cn/tutorials.md
@@ -0,0 +1,10 @@
+```json
+{
+  "title": "教程",
+  "icon": "minecraft:filled_map",
+  "ordinal": 2
+}
+```
+
+圆环魔术就此开始。
+本分类下有若干按序排布的教程，以手把手教导最为重要的概念。
diff --git a/...ssets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/macro.md b/...ssets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/macro.md
@@ -0,0 +1,30 @@
+```json
+{
+  "title": "Macros",
+  "icon": "trickster:macro_ring",
+  "category": "trickster:concepts"
+}
+```
+
+Macros allow you to create your own revisions to aid with spell scribing. 
+
+
+A [map](^trickster:distortions/map) that links a set of patterns to a set of spells is used to define macros.
+These maps, when inscribed into any ring and worn in a ring slot, will be checked for keys matching any drawn patterns.
+
+;;;;;
+
+A simple [Macro Ring](^trickster:items/ring) can be used for this purpose if no other rings are available.
+
+
+If a macro for a drawn pattern is found, the associated spell will be cast and given one argument:
+A copy of the circle it is drawn in. 
+The spell is then expected to return a new spell fragment to replace the fragment given.
+
+
+This effectively lets anyone create their own set of revisions.
+
+;;;;;
+
+Note: Macro spells are not capable of [long casting](^trickster:concepts/multi_tick). 
+This means they do not take a spell slot, but also can't run more than about 64 circles.
diff --git a/...assets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/mana.md b/...assets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/mana.md
@@ -0,0 +1,30 @@
+```json
+{
+  "title": "Mana",
+  "icon": "minecraft:glow_ink_sac",
+  "category": "trickster:concepts"
+}
+```
+
+Mana is what fuels ploys. It is the cost of manipulating the world.
+
+
+As is tradition, amounts of Mana are measured in Gandalfs, or G, named after a certain famous wizard.
+One Gandalf being defined as the amount of magical energy required to light a candle.
+
+;;;;;
+
+Any amount of Mana that is lesser than one kiloGandalf, or kG is generally considered negligible.
+
+
+Draw rate, or any change in Mana, is measured in Merlins, or M.
+Merlins are defined as Gandalfs per Tick,
+Ticks being the smallest unit of meaningful time, at 1/20th of a second.
+
+
+For example, a spell drawing 50 M would consume 1 kiloGandalf per second.
+
+;;;;;
+
+Mana can be persistently stored and acquired via Knots.
+See [this entry](^trickster:items/knots) for more information on those.
diff --git a/.../trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/multi_tick.md b/.../trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/multi_tick.md
@@ -0,0 +1,37 @@
+```json
+{
+  "title": "Long Spells",
+  "icon": "minecraft:clock",
+  "category": "trickster:concepts"
+}
+```
+
+Spells do not all execute instantly. Unless cast through a mirror, a big enough spell limits execution to a certain amount of circles per second. 
+It may even run forever, 
+provided its caster remains alive, the spell does not blunder, and it never runs out of circles to execute.
+
+;;;;;
+
+To cast a spell capable of running long, a free spell slot is required, even if the spell completes within one twentieth of a second. 
+
+
+Without an empty spell slot, no spells can be cast except through a mirror. Spell slots may be viewed from the caster's inventory.
+
+;;;;;
+
+Spell slots have the following states: 
+
+- inactive (collapsed)
+- inactive and blundered (red)
+- active and okay (green)
+- active and at maximum executions per second (orange)
+- active but waiting (white)
+
+;;;;;
+
+Patterns that execute spell fragments create sub-spells within their current spell. 
+A spell may not have a sub-spell more than 255 spells deep, 
+and will blunder if such a thing is attempted. 
+
+
+If a so-called forking pattern is *effectively* the final pattern in the current spell, **this limit is ignored**.
diff --git a/.../trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/signatures.md b/.../trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/signatures.md
@@ -0,0 +1,9 @@
+```json
+{
+  "title": "Trick Signatures",
+  "icon": "minecraft:writable_book",
+  "category": "trickster:concepts"
+}
+```
+
+Coming soon! Ask for help in Discord if you get stuck!
diff --git a/...ssets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/trace.md b/...ssets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/trace.md
@@ -0,0 +1,27 @@
+```json
+{
+  "title": "Stack Traces",
+  "icon": "minecraft:tripwire_hook",
+  "category": "trickster:concepts"
+}
+```
+
+Spell failures are referred to as *blunders*. When a spell blunders, a stack trace is printed out, 
+signifying *where* in the spell the failure occurred. Stack traces are colon-separated lists of characters of three varieties: 
+
+- # (pound/hashtag) 
+- \> (chevron/angle bracket)
+- any number
+
+;;;;;
+
+The numbers are input indexes, 
+while both the chevrons and hashtags indicate a change of context into a different spell fragment.
+The former indicates a fragment provided by the current spell, 
+while the latter means the fragment came from elsewhere.
+
+;;;;;
+
+<|page-title@lavender:book_components|title=Note: Indexes|>Each circle in a spell has a number, an *index*, 
+that states its position relative to its parent. The purple pin on the parent circle is always counter-clockwise of the first subcircle, 
+which has an index of zero. Each subcircle clockwise of the first subcircle has an index one greater than the one before it.
diff --git a/...er/trickster/lavender/entries/tome_of_tomfoolery/concepts/tricks_explanation.md b/...er/trickster/lavender/entries/tome_of_tomfoolery/concepts/tricks_explanation.md
@@ -0,0 +1,22 @@
+```json
+{
+  "title": "Trick Types",
+  "icon": "minecraft:oak_leaves",
+  "category": "trickster:concepts"
+}
+```
+
+All tricks fit in the following categories:
+
+- Delusion: no-input value-generating tricks
+- Distortion: fixed-input pure tricks
+- Ingress: tricks that gather information based on input
+- Ploy: input-only and/or mana-consuming tricks
+
+;;;;;
+
+- Revision: scribing patterns
+- Stratagem: any trick that operates on a variable amount of inputs
+
+These categories are roughly followed, but in many cases, 
+tricks will be sorted based more on intention than rigid definition.
diff --git a/...ickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/trigger_items.md b/...ickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/trigger_items.md
@@ -0,0 +1,26 @@
+```json
+{
+  "title": "Trigger Items",
+  "icon": "minecraft:diamond_sword",
+  "category": "trickster:concepts"
+}
+```
+
+While the [Wand](^trickster:items/wand) is the most common, and most versatile, way of quickly casting spells, it is not the only one available. 
+Other items may cast their inscribed spell upon certain criteria being met. These items and their criteria are described here. 
+
+;;;;;
+
+<|page-title@lavender:book_components|title=Warrior's Rage|>On tools and melee weapons, 
+the Warrior's Rage executes the inscribed spell when bringing harm to an entity. The targeted entity is received as the first argument.
+
+;;;;;
+
+<|page-title@lavender:book_components|title=Prospector's Glee|>Prior to destroying a block, 
+the Prospector's Glee begins the spell inscribed on the held tool. The position of the breaking block is received as the first argument.
+
+;;;;;
+
+<|page-title@lavender:book_components|title=Performer's Grace|>Moments before touching down on a block, 
+the Performer's Grace triggers a spell inscribed in footwear. The distance that the wearer fell is passed as the first argument. 
+When held back by water, there is no Grace to the Performer.
diff --git a/...assets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/ward.md b/...assets/trickster/trickster/lavender/entries/tome_of_tomfoolery/concepts/ward.md
@@ -0,0 +1,20 @@
+```json
+{
+  "title": "Wards",
+  "icon": "minecraft:shield",
+  "category": "trickster:concepts"
+}
+```
+
+Wards are defensive spells that are cast when you are the target of a ploy. 
+Your ward receives the caster, and a list containing the inputs the caster is passing to the triggering glyph. 
+The expected signature for a ward is the following: 
+
+---
+
+entity | vector, any[] ->
+
+;;;;;
+
+The ward used is retrieved from the combined maps of all charms worn by the target, where the key is the triggering glyph. 
+The triggered ward requires an empty spell slot to be run, but begins prior to the execution of the triggering glyph.