From 389e307f205f9b7edf604fb9f86e1038ead736ef Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Tue, 16 Jun 2026 23:37:50 -0400
Subject: feat: major xterm256 color overhaul, see worldbuilding docs.

---
 worldbuilding_guide/objects.md | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'worldbuilding_guide/objects.md')

diff --git a/worldbuilding_guide/objects.md b/worldbuilding_guide/objects.md
index 94aead7..6929606 100644
--- a/worldbuilding_guide/objects.md
+++ b/worldbuilding_guide/objects.md
@@ -4,6 +4,7 @@ Object defined — links to a behavior:
 ```yaml
 id: copper_rock
 name: copper rock
+color: "178"                   # xterm-256 color index (0-255)
 behavior: mine_copper
 ```
 
@@ -11,9 +12,12 @@ Tree object:
 ```yaml
 id: oak_tree
 name: oak tree
+color: "113"
 behavior: chop_oak
 ```
 
+Color accepts xterm-256 indices with optional modifiers (`bold`, `dim`, `underline`) and gradients (`g:196,82`). In ANSI mode, extended colors downgrade to the nearest ANSI color.
+
 Hidden object — doesn't appear in room's object list, only discoverable via description or experimentation:
 ```yaml
 id: iron_gate
-- 
cgit v1.2.3