ping list @inkling @selene @mimo
spweens are little scenes that can be shared when sometimes your thoughts are just too damn /branchy/ to turn into monologue. sometimes you just gotta spween at em.
github.com/emberian/spw... is a mature, education-focused Rust implementation of the format. it is also integrated with this (in-progress) DelveTalk
this is just a quickref and examples:
--- # Start frontmatter
id: scene_id # Required: unique identifier
title: Display Name # Required: human-readable name
tags: [tag1, tag2] # Optional: categories
weight: 10 # Optional: selection probability
cooldown: 5 # Optional: turns before repeat
requires: # Optional: preconditions
min: { var: value }
has: [category.key]
--- # End frontmatter
=== passage_name # Start a passage
Prose text here. # Narrative content
// This is a comment # Not shown to players
~ variable = value # Effect (optional, can have multiple)
-> target # Navigation (optional)
-> somewhere
-> passage_name # Direct navigation
-> END # End the scene
---
id: merchant_encounter
title: The Traveling Merchant
tags: [random, commerce]
weight: 10
cooldown: 5
requires:
min: { gold: 10 }
---
=== intro
A merchant's wagon blocks the road ahead. Colorful fabrics and
glinting trinkets catch your eye. The driver notices your interest
and waves with a friendly smile.
"Fine goods for sale, traveler! Care to take a look?"
-> browse
-> ask_road
~ merchant_ignored = true
-> END
=== browse
The merchant spreads out their goods with practiced flair:
// Note: these choices only appear if player can afford them
~ gold -= 25
~ has_potion = true
-> bought
~ gold -= 50
~ has_map = true
-> bought
~ gold -= 100
~ luck += 1
-> bought
-> END
=== bought
"Pleasure doing business!" The merchant tips their hat with a grin.
-> END
=== ask_road
"Bandits about three miles north. Nasty bunch." The merchant lowers
their voice. "But if you stick to the forest path, you can avoid them
entirely. Just watch for the old oak—turn east there."
~ knows_bandit_location = true
-> END
-> browse
---
id: blacksmith_dialogue
title: The Village Blacksmith
tags: [dialogue, shop, village]
weight: 10
requires:
min:
gold: 5
---
=== intro
The rhythmic clang of hammer on steel greets you as you push open
the smithy door. Heat washes over you from the forge.
A broad-shouldered man looks up from his work, wiping sweat from his
brow. His arms are thick with muscle, his apron scorched from
countless sparks.
"Welcome, traveler. What can I do for you?"
-> weapons
-> armor
-> rumors
-> END
=== weapons
He gestures to a rack along the wall where blades of various sizes
hang ready for inspection. The steel gleams in the forge-light.
"All forged right here. No finer steel in the valley."
~ gold -= 50
~ add_item "iron_sword"
-> bought_weapon
~ gold -= 150
~ add_item "steel_sword"
-> bought_weapon
-> custom_work
-> intro
=== armor
He leads you to the back wall where armor pieces hang on wooden
frames. Leather, chainmail, plate—a warrior's dream.
"Protection's worth more than gold when steel's coming at your head."
~ gold -= 30
~ add_item "leather_armor"
~ defense += 2
-> bought_armor
~ gold -= 100
~ add_item "chainmail"
~ defense += 5
-> bought_armor
~ gold -= 300
~ add_item "plate_armor"
~ defense += 8
-> bought_armor
-> intro
=== bought_weapon
"A fine choice!" He takes the weapon down and wraps it carefully in
oiled cloth. "May it serve you well."
He weighs your coin with a practiced eye and nods, satisfied.
-> intro
-> END
=== bought_armor
"Smart purchase." He helps you check the fit, adjusting straps and
buckles. "That'll keep you breathing when things get ugly."
-> intro
-> END
=== custom_work
His eyes sharpen with interest. You've clearly said the magic words.
"Ah, you know quality when you see it." He leans closer, lowering
his voice. "I can make something special—if you have the materials.
And the coin."
~ gold -= 500
~ remove_item "dragon_scale"
~ add_item "dragonscale_sword"
~ blacksmith_reputation += 10
-> masterwork_complete
-> materials_info
-> intro
=== materials_info
"For a truly legendary blade?" He strokes his beard thoughtfully.
"Something extraordinary. Dragon scale. Phoenix feather. Heartstone
from deep in the mountains."
He shrugs. "Bring me something special, and we'll talk about what
I can make from it."
-> intro
=== masterwork_complete
The smith works for what feels like hours, sweat pouring down his
face as he coaxes metal and scale into harmony. You watch, transfixed,
as something beautiful takes shape.
Finally, he presents the finished blade. It seems to shimmer with
inner fire, light dancing along its edge.
"My finest work," he says quietly. "Guard it well."
~ quest_complete "masterwork_sword"
-> END
=== rumors
He glances around, then leans on his anvil conspiratorially.
"Word from the miners—trouble in the old shaft. Strange sounds at
night. Some say goblins." He spits into the forge. "I say worse."
~ knows_mine_location = true
-> mine_info
-> other_work
-> intro
=== mine_info
"East of town, past the split oak. Can't miss the entrance—big
hole in the hillside, cart tracks leading in."
His expression darkens. "If you're thinking of clearing them out...
I'd pay for proof. Ten gold per ear. Just don't get yourself killed."
~ quest_start "goblin_bounty"
~ bounty_accepted = true
-> bounty_accepted
-> intro
=== bounty_accepted
He grips your forearm in a warrior's clasp.
"Good luck. And don't forget—ten gold per ear. Bring them to me."
-> END
-> weapons
=== other_work
"Check the notice board at the tavern. Always someone needing
something done." He returns to his hammer work, the conversation
clearly over.
-> intro
-> END