aboutsummaryrefslogtreecommitdiff
path: root/worldbuilding_guide/items.md
diff options
context:
space:
mode:
authorhistoria <[not public]>2026-06-16 23:37:50 -0400
committerhistoria <[not public]>2026-06-16 23:37:50 -0400
commit389e307f205f9b7edf604fb9f86e1038ead736ef (patch)
tree595095b5877cc2b0513d31fb126303d8796cc311 /worldbuilding_guide/items.md
parent085e728d22a3369bd110b77409914cfbe9ebe611 (diff)
downloadthehouseoficarus-389e307f205f9b7edf604fb9f86e1038ead736ef.tar.gz
feat: major xterm256 color overhaul, see worldbuilding docs.
Diffstat (limited to 'worldbuilding_guide/items.md')
-rw-r--r--worldbuilding_guide/items.md17
1 files changed, 15 insertions, 2 deletions
diff --git a/worldbuilding_guide/items.md b/worldbuilding_guide/items.md
index 73f497b..e9e4352 100644
--- a/worldbuilding_guide/items.md
+++ b/worldbuilding_guide/items.md
@@ -3,6 +3,7 @@
```yaml
id: bronze_pickaxe
name: bronze pickaxe
+color: "178" # xterm-256 color index (0-255)
aliases: ["pick", "pickaxe"]
description: "A sturdy bronze pickaxe."
value: 10
@@ -17,6 +18,18 @@ tool_type: pickaxe # used by gather behaviors that require "tool: pic
tool_speed: 2 # reduces gather wait time
```
+### Color
+
+The `color` field accepts xterm-256 palette indices (0-255) with optional modifiers:
+
+```yaml
+color: "178" # bronze/gold
+color: "75 bold" # bold steel blue
+color: "g:196,208,226" # gradient red → orange → gold
+```
+
+In ANSI mode, extended colors (16-255) automatically downgrade to the nearest ANSI color. Use `colortable` in-game to see all 256 colors.
+
Key item (quest token, not equippable):
```yaml
id: pass_stub
@@ -43,7 +56,7 @@ burn_ticks: 24 # how long the fire burns
```yaml
id: bread
name: bread
-color: "fg=bright_yellow"
+color: "222"
description: "A fresh loaf of bread, still warm from the oven."
value: 5
heal_value: 5 # positive = heal, negative = damage
@@ -57,7 +70,7 @@ Define what items combine to make this item. Used by the `use` command.
```yaml
id: bread_dough
name: bread dough
-color: "fg=bright_yellow"
+color: "222"
made_from:
- items: [pot_of_flour]
qty: 1