From 7832c31f626813a3f85fdb41e91c647396e20611 Mon Sep 17 00:00:00 2001
From: Jared Miller <jared@smell.flowers>
Date: Mon, 16 Feb 2026 16:37:54 -0500
Subject: [PATCH] Add player help topics for getting started and interactive
 fiction

---
 content/help/getting-started.toml     | 28 +++++++++++++++++++++++++
 content/help/interactive-fiction.toml | 30 +++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 content/help/getting-started.toml
 create mode 100644 content/help/interactive-fiction.toml

diff --git a/content/help/getting-started.toml b/content/help/getting-started.toml
new file mode 100644
index 0000000..a5fca96
--- /dev/null
+++ b/content/help/getting-started.toml
@@ -0,0 +1,28 @@
+name = "getting-started"
+title = "getting started"
+body = """
+  welcome to the mud. here's how to play.
+
+  looking around
+    look                see the world around you
+    look <thing>        examine something in detail
+
+  moving
+    north / n           move north (also: south, east, west)
+    northwest / nw      diagonal movement (also: ne, sw, se)
+
+  finding commands
+    commands            list all available commands
+    skills              list combat moves
+    help <command>      get help on a specific command
+
+  basics
+    say <message>       talk to nearby players
+    tell <name> <msg>   private message a player
+    inventory           see what you're carrying
+    get <thing>         pick something up
+    drop <thing>        put something down
+
+  the world persists. your position and inventory save when you log out.
+  type 'quit' to disconnect safely.
+"""
diff --git a/content/help/interactive-fiction.toml b/content/help/interactive-fiction.toml
new file mode 100644
index 0000000..38997df
--- /dev/null
+++ b/content/help/interactive-fiction.toml
@@ -0,0 +1,30 @@
+name = "interactive-fiction"
+title = "interactive fiction"
+body = """
+  you can play classic text adventure games from inside the mud.
+  other players in the room will see your gameplay on a virtual terminal.
+
+  starting a game
+    play                list available games
+    play <game>         start a game (e.g. "play zork")
+
+  available games
+    zork1               the great underground empire
+    curses              a time-travel puzzle adventure
+    photopia            a story about light and memory
+    shade               a one-room mystery
+    anchor              a nautical puzzle game
+    tangle              a nature-themed exploration
+    lostpig             find the pig
+
+  escape commands
+    ::quit              exit the game (auto-saves first)
+    ::save              force save to disk
+    ::help              show escape commands
+
+  your progress saves automatically. when you return to a game,
+  it restores from where you left off.
+
+  game commands use normal IF syntax (open mailbox, go north, etc).
+  anything not starting with :: goes to the game interpreter.
+"""