Files
settled-reach/wiki/authoring/environmental-text-examples.md
T
jpmschweitzerandClaude Opus 4.6 b672b9c269 feat(docs): restructure wiki taxonomy with templates and Krenn System entry (#301, #319)
Move wiki from docs/wiki/ to root wiki/. Add 14 category templates with
YAML frontmatter, governance model, hierarchical spatial structure
(system > station > district > location). Populate Krenn System entry
as first concrete star system. Update cross-references in workshop and
sprint docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 00:58:45 +01:00

16 KiB

title, slug, category, status, created, updated, tags, decision_refs, cross_refs
title slug category status created updated tags decision_refs cross_refs
Environmental Text Examples environmental-text-examples authoring-guide canonical 2026-02-13 2026-02-13
v0.1
authoring
environmental-text
D-016
D-032
D-036
monologue-guide
the-last-shift
the-terminal
maintenance-corridors

Environmental Text Examples

Worked examples of diegetic environmental text for Sova Transit District. Each example is Krenn-voiced (working-class, direct, compact) with cultural notes explaining the choices, followed by monologue pairings showing how the smuggler and detective read the same text differently.

Environmental text is not decoration. It is world-state that the player reads through their character's perspective. The same sign on the same wall tells two different stories.


1. Bar Menu — The Last Shift

Mounted behind the bar counter. Hand-lettered on a metal panel in Lera's handwriting. Prices in station credits. Menu changes rarely — when an item runs out, Lera crosses it off and writes the replacement below.

The Text

LERA'S

Grain spirit (Sova-brewed)     4
Grain spirit, double            7
Station lager                   5
Imported lager (Krenn Prime)   12
Synth ale (cold)                3

Fried protein + bread           6
Stew (ask what's in it)         5
Bread + spread                  3

No tabs. No arguments.
Last call 01:30.

Cultural Notes

  • Pricing tells a story. Imported lager at 12 credits — five shifts' disposable income for a logistics worker earning 200 credits margin per month. Ordering one is a status display. The smuggler knows who can afford it and who's showing off. The detective notes the financial tell.
  • "Ask what's in it" — Krenn directness. Lera doesn't pretend the stew is gourmet. The regulars don't care. This is food for people who need to eat, not a dining experience.
  • "No tabs. No arguments." — Lera has been burned. The two-rule footer is social infrastructure: it prevents the awkward conversation where a colleague can't pay, which would damage the bar's function as a place where status is temporarily suspended.
  • Hand-lettered — not Meridian-displayed. This is deliberate. A printed menu could be updated remotely. A hand-lettered one means Lera stood here and wrote it. It says: this is mine.
  • No cocktails, no wine, no elaboration. The menu matches the clientele: shift workers who want a drink, food, and to be left alone. Complexity would be pretension.

Monologue Pairings

Smuggler (on entering The Last Shift, sees menu):

Same menu. Same prices. Lera hasn't changed the stew description in three years.

Tags: [environmental, atmospheric]. Trigger: enter_location. This is comfort. Sameness is safety.

Detective (on entering The Last Shift, sees menu):

Imported lager at twelve credits. On these wages, that's a weekly luxury. Note who orders it.

Tags: [environmental, investigation]. Trigger: enter_location. The detective reads the menu as economic data.

Smuggler (on observing Torek ordering imported lager):

Torek's buying the good stuff again. That's three times this week.

Tags: [npc, torek, concern]. Trigger: observe_npc. The smuggler sees financial exposure — Torek's spending beyond what his official income explains.

Detective (on observing Torek ordering imported lager):

Lintar, T. Third imported lager this rotation. Spending pattern inconsistent with pay grade.

Tags: [npc, torek, investigation, evidence]. Trigger: observe_npc. Same observation, institutional framing. Surnames, initials, pay grade — the language of a case file.


2. Safety Notice — The Terminal

Mounted on the wall near Scanner Bay 3. Concordat Standard official text with Krenn vernacular annotation added by a worker in marker. The notice is slightly peeling at the bottom-left corner. Nobody has replaced it in months.

The Text

[Official — Concordat Standard, printed]

SOVA TRANSIT LOGISTICS — BAY 7-C
SCANNER BAY 3: OPERATIONAL ADVISORY

Spectral calibration drift detected (Report #ST-4471).
Maintenance scheduled. Refer non-critical cargo
to Bays 1 or 2 pending recalibration.

— Station Maintenance Division

[Annotation — hand-written in marker below the notice]

"scheduled" — four months ago. still waiting.

Cultural Notes

  • Institutional vs. vernacular — the two voices on this sign are the two voices of Sova. The printed notice is how the institution talks: passive voice, report numbers, procedures. The marker annotation is how the workers talk: direct, sardonic, lowercase.
  • "Pending recalibration" is doing heavy narrative work. The calibration drift in Bay 3 is real — it produces less reliable scan results. Station maintenance hasn't fixed it because it's low-priority. The ring routes flagged containers through Bay 3 precisely because of this drift. An institutional failure becomes criminal infrastructure.
  • The peeling corner — nobody maintains the notice because nobody cares about the notice. The institutional voice has lost authority through inaction. The hand-written annotation has more social force than the printed text.
  • Report #ST-4471 — bureaucratic specificity that makes the notice feel real and gives the detective something to query.

Monologue Pairings

Smuggler (passing Scanner Bay 3):

Bay 3 still drifting. Four months and counting. Works for us.

Tags: [environmental, operational]. Trigger: enter_location. The smuggler reads institutional failure as operational advantage. "Works for us" — possessive, casual, no guilt.

Detective (examining the safety notice):

Report ST-4471. Four months, no resolution. Cross-reference with scan rejection rates.

Tags: [environmental, investigation]. Trigger: observe_anomaly. The detective reads the same failure as a lead. The report number is actionable data — pull it, check which containers went through Bay 3, look for patterns.

Detective (after correlating scan data — knowledge-gated):

Bay 3 scan reliability: 73%. Every flagged container in my dataset was routed here. Not coincidence.

Tags: [investigation, evidence, breakthrough]. Trigger: time_idle. Prerequisites: fact_id: scanner_drift_pattern, min_confidence: knows_of. This is the payoff — the safety notice becomes evidence.


3. News Ticker Cycle — Meridian Feed at The Last Shift

Displayed on the Meridian feed screen mounted above the bar. Scrolling text, standard news format. The cycle repeats every 8-10 minutes. Nobody watches it directly — it's ambient information, absorbed peripherally. Occasionally a headline makes someone look up.

The Cycle (6 Headlines)

1. KRENN PRIME SURFACE DEPOT: FREIGHT BACKLOG ENTERING THIRD DAY.
   TRANSIT AUTHORITY CITES SCHEDULING DISPUTES.

2. CONCORD ASSEMBLY SESSION 1147: LATTICE STANDARDIZATION
   AMENDMENT PASSES SECOND READING. IMPLEMENTATION TBD.

3. SOVA STATION: VENTILATION UPGRADE FOR SECTORS 2-4
   APPROVED IN NEXT FISCAL CYCLE. TIMELINE NOT CONFIRMED.

4. MEDICAL SUPPLY ADVISORY: NEURAL INTERFACE REPLACEMENT
   COMPONENTS ON 6-WEEK BACKORDER. CONTACT YOUR PROVIDER.

5. COMMISSION ADVISORY: ROUTINE COMPLIANCE ASSESSMENT
   SCHEDULED FOR KRENN SYSTEM STATIONS. DATES TO FOLLOW.

6. KRENN PRIME DOCKWORKERS LEAGUE VS. ORBITAL 3 UNITED:
   MATCH DAY 7. BROADCAST 19:00 MERIDIAN STANDARD.

Cultural Notes

  • Headline 1 (freight backlog) — affects every worker in the room. Backlog means overtime or schedule disruption. It's the one headline people actually respond to. Lera turns up the volume when freight news scrolls.
  • Headline 2 (lattice standardization) — Assembly politics. Most workers ignore it. But "lattice standardization" has a chill to it: tighter standards mean tighter inspections, which means the grey market gets harder. The smuggler hears threat. The detective hears institutional support.
  • Headline 3 (ventilation upgrade) — the universal safe topic. "Approved in next fiscal cycle" means "probably never." Workers have been complaining about ventilation for months. This headline generates eye-rolls and muttered commentary that fills conversational space.
  • Headline 4 (neural interface backorder) — the one that matters most and says least. Neural interface replacements are essential medical supplies. A 6-week backorder on legitimate channels is exactly why the smuggling ring exists: people need these components, the legal supply chain can't deliver, and someone fills the gap. The headline is the ring's business case, printed on a news ticker.
  • Headline 5 (Commission assessment) — "routine" is a word that means nothing and everything. Routine for the Commission. Not routine for a district that hasn't had a liaison in three months and has been operating in the gap. "Dates to follow" means: start worrying now.
  • Headline 6 (sports) — normalcy. The match is what most people in the bar actually care about. It's the headline that makes Sova feel like a place where people live, not just a setting for a crime story.

Monologue Pairings

Smuggler (headline 4 scrolls — medical backorder):

Six weeks. Six weeks without replacement parts, and they wonder why people come to us.

Tags: [environmental, moral, operational]. Trigger: observe_anomaly. The smuggler sees validation. The ring isn't criminal — it's necessary.

Detective (headline 4 scrolls — medical backorder):

Neural interface components on backorder. Supply gap creates demand for unlicensed alternatives. Motive.

Tags: [environmental, investigation]. Trigger: observe_anomaly. Same headline, institutional analysis. "Motive" — the detective is building a case, not feeling sympathy.

Smuggler (headline 5 scrolls — Commission assessment):

Routine assessment. Right. Nothing routine about Commission attention when we've had three months clear.

Tags: [environmental, concern, caution]. Trigger: observe_anomaly. Fear disguised as sarcasm. Three months without oversight was the operational window. It's closing.

Detective (headline 5 scrolls — Commission assessment):

Compliance assessment incoming. Good. Institutional pressure may loosen cooperation.

Tags: [environmental, investigation, operational]. Trigger: observe_anomaly. The detective sees leverage. An announced inspection makes people nervous, and nervous people talk.


4. Corridor Graffiti — Maintenance Corridors

Found at three points along Corridor B-7. The graffiti exists in layers: old maintenance worker marks (decades old, institutional), informal worker tags (years old, social), and recent ring-related marks (weeks to months old, operational). The layers tell the corridor's history.

The Text

Location: Near south entry (Terminal break room hatch), on the right wall

[Marker, faded, ~30 years old:]
VNT-7 JUNCTION 40M →

[Scratched into the wall, ~15 years old:]
kosse was here. day 1171.

[Chalk, recent, small, low on the wall:]
—||—

Location: Junction room (midpoint), on the overhead cable tray support

[Marker, faded, institutional:]
CAUTION: OVERHEAD CLEARANCE 2.1M

[Paint pen, ~10 years old, on the cable tray itself:]
N.T. + someone who deserved better

Location: Near ventilation hub (90m from south entry), wall niche

[Scratched, old, barely legible:]
shift 3 crew '94

[Chalk, recent, deliberate — three short vertical lines:]
|||

Cultural Notes

  • VNT-7 JUNCTION — institutional remnant. This corridor used to be on the maintenance map. The directional marking is from the era when workers were dispatched here officially. It's a ghost of the corridor's legitimate past.
  • "kosse was here. day 1171." — a maintenance worker who counted their shifts. Krenn naming convention (compact, consonant-heavy). Day 1171 is roughly 3.2 years of shift cycles. Someone who spent long enough in these corridors to mark their territory. Kosse is probably retired or transferred. The name persists.
  • "N.T. + someone who deserved better" — a small human moment in infrastructure space. The initials could be anyone. The sentiment is universal. It humanizes the corridor — people have always come here for privacy, long before the ring did.
  • The chalk marks—||— and ||| — are ring operational markers. They're meaningless to anyone who doesn't know the system. The double-bar mark near the south entry indicates "route active." The three vertical lines near the ventilation hub indicate a count — possibly dead drop cycles, possibly something else. The ring's internal signaling is deliberately ambiguous: even if you find the marks, you can't read them without context.
  • Chalk, not marker — the ring uses chalk because it can be wiped. Marker is permanent. The choice of medium is operational security.
  • Low on the wall — at shin height. You'd have to be looking for it. Standing upright, your eyes pass over it. Crouching to inspect the corridor — as a detective might — you find it.

Monologue Pairings

Smuggler (passing the chalk mark near south entry):

Mark's fresh. Route's active. Renn was through here recently.

Tags: [environmental, operational]. Trigger: enter_location. The smuggler reads the chalk like a message — because it is one. No emotional response. It's a status indicator.

Detective (discovering the chalk mark near south entry):

Chalk mark. Recent, deliberate placement, low visibility. Not maintenance notation — wrong format.

Tags: [environmental, investigation, evidence]. Trigger: observe_anomaly. The detective notices the mark is wrong: wrong height, wrong material, wrong format for institutional use. The anomaly IS the evidence.

Detective (discovering "kosse was here" scratch):

Personal marking, years old. Workers used this corridor regularly before it dropped off the map.

Tags: [environmental, investigation]. Trigger: observe_anomaly. The detective reads history. If workers used this corridor before, someone remembers it. Someone could still use it.

Smuggler (passing "N.T. + someone who deserved better"):

Still there. Been there longer than most of us.

Tags: [environmental, atmospheric]. Trigger: enter_location. A moment of human recognition. The smuggler has seen this graffiti dozens of times. It's part of the corridor's texture — familiar, not investigated.

Detective (finding the three chalk lines near ventilation hub — knowledge-gated):

Three marks. Three operations since the last Commission liaison rotated out. They're counting.

Tags: [investigation, evidence, breakthrough]. Trigger: observe_anomaly. Prerequisites: fact_id: ring_operational_timing, min_confidence: suspects. The detective connects the marks to a timeline. Three marks, three months without oversight. The graffiti becomes a logbook.


Writing Principles for Environmental Text

  1. The text exists before the player arrives. It was written by someone for a reason that has nothing to do with the player. Write it for the character who put it there, not the character who reads it.

  2. Krenn voice is direct. No flourishes, no unnecessary words, no corporate warmth. "No tabs. No arguments." not "We kindly request that all patrons settle their accounts at time of service."

  3. Institutional text and vernacular text coexist. The tension between them IS the setting. The printed notice says what the institution wants. The hand-written annotation says what the workers know.

  4. Environmental text creates monologue triggers. Every piece of readable text in the world should produce a different internal response from each character. If it doesn't, it's decoration, not world-building.

  5. Layers tell history. Graffiti, notices, menus — they accumulate over time. A wall with one mark is a surface. A wall with three marks from three eras is a story.

  6. The player reads through their character. The text doesn't change. The interpretation does. Design the text so both readings are valid, and neither is complete.


Cross-References:


Status: Canonical Created: 2026-02-13 Updated: 2026-02-13