Clickable Words in Interactive Fiction: Distinguishing Extra Reading from Actions
Give reading notes, examining objects, and taking action distinct labels that tell readers what to expect. Then use an inline link promise table to check each result, return path, and effect on world state. A fictional greenhouse passage demonstrates how to revise links with mixed behaviors.
Introduction
Clickable words in a passage should tell readers, before they click, whether they will get extra reading, examine an object, or act immediately. The most direct fix is to give each link an accurate verb, then check its result, return path, and effect on world state. A noun can identify an object, but it usually cannot tell readers that clicking will move, hand over, or destroy it.
Below, we revise a greenhouse passage and provide a reusable “inline link promise table.” This is an original, fictional teaching example, not a real user case, a measurement result, a hands-on test, or a DramaFork product feature. All interactions are stipulated for this example; they do not represent any platform’s default behavior.
Identify different consequences behind the same appearance
The passage to revise reads: “【Silvervein】 grows in the greenhouse. An 【old flowerpot】 by the window blocks a gap. You reach out and touch the 【rim】.” Here, 【】 marks text intended to become a link; it does not provide an actual destination.
Suppose the author has assigned these results: clicking silvervein expands a plant note; clicking the old flowerpot displays its appearance; clicking the rim immediately moves the pot to the floor, revealing the gap by the window. All three labels are nouns, yet the last performs an action. The first two clicks establish an expectation that clicking a word means seeing a little more. The third breaks it.
“Reach out and touch” does not adequately communicate moving the pot, either. Readers might interpret it as narration of something that has already happened, or as a lead-in to examining how the pot feels. The problem is not a failure to explain the link rules. It is a mismatch between the action the label promises and the action that occurs.
Start the revision by listing every link, without rushing to standardize their colors. Complete this sentence for each one: “Clicking here will immediately…” If the sentence includes both “display an explanation” and “consume an item,” the link cannot be treated solely as an explanation link.
Use three kinds of wording to distinguish reading, examining, and acting
For this example, supplementary reading uses “Read the note on…,” object examination uses “Examine…,” and world actions use a specific verb and object. The three labels become 【Read the note on silvervein】, 【Examine the old flowerpot】, and 【Move the flowerpot to the floor】.
Supplementary reading explains terms or setting details. Object examination presents observable details of the current object. World actions change an object’s location, a character’s situation, or other story conditions. Classification depends on what clicking does, not the word count or how important the content sounds.
To make the example checkable, first define the rules for this passage: reading the note and examining the pot do not advance time, trigger events, or change objects. Moving the pot changes its location and makes the window gap visible. Examination displays “There are mud marks on the bottom of the clay pot”; it does not automatically make the character pick it up.
This convention adds a little length. “Examine the old flowerpot” makes the interaction more explicit than “old flowerpot,” but preserves the intent to explore. If a label becomes too long, first revise the sentence so the action phrase fits naturally. Do not remove the verb that determines the consequence.
Bare nouns are not always unsuitable. If a passage contains only glossary notes and that convention is clearly established, noun-only links can remain. Once actions appear in the same passage, check again whether those labels could cause confusion.
Make the promise table specific enough to check row by row
This table records both what a link says it will do and what it has no right to do without saying so. When using it with your own passage, keep all five columns and give each clickable location its own row.
| Link text | Link type | Click result | Return path | Effect on world state |
|---|---|---|---|---|
| Read the note on silvervein | Supplementary reading | Expands an explanation of the name after the original sentence | Click “Collapse note” and continue from the original sentence | None |
| Examine the old flowerpot | Object examination | Displays appearance details, including mud marks on the bottom, after the original sentence | Click “Collapse examination” and continue from the original sentence | None |
| Move the flowerpot to the floor | World action | Moves the pot to the floor and reveals the window gap | Remain in the updated greenhouse passage | Pot location changes; window gap becomes visible |
The sample note reads: “Silvervein is a plant in this fictional greenhouse, with pale markings on its leaves.” The examination text reads: “The old flowerpot has a rough surface, with traces of dried mud on the bottom.” Both provide only the content this example needs.
The response to moving the pot reads: “You set the flowerpot on the floor, revealing a narrow gap beneath the window frame.” The original move link is then removed, and the pot’s location in the passage is updated at the same time, so the same action is not repeatedly presented as still awaiting execution.
“Return” in the table does not always mean undo. Collapsing a note only closes the text. Remaining in the greenhouse after an action does not mean the pot returns to the window. This example includes no link for moving it back. If restoring its position becomes necessary later, write a separate 【Put the flowerpot back by the window】 link and specify its effects separately.
Rewrite the mixed links as a passage readers can anticipate
Using the table, the revised passage could read:
Silvervein grows in the greenhouse; you can 【Read the note on silvervein】. An old flowerpot by the window blocks a gap. You can 【Examine the old flowerpot】 first, or simply 【Move the flowerpot to the floor】, clearing the space by the window.
This wording does not require examination before moving the pot, nor does it secretly turn examination into a prerequisite for action. Readers choose examination to see more detail. Only choosing to move the pot authorizes the character to change its location.
When expanding a note, place its contents after the relevant sentence and provide a clearly named collapse link. After collapsing it, readers should be able to return to “Silvervein grows in the greenhouse,” rather than having the explanation close while they are sent to the end of the paragraph. Use the same return convention for examination so the two non-action links remain consistent.
Adjacent links each need a complete promise. Do not shorten them to “【Examine】 or 【Move】 the old flowerpot” and then let their clickable areas become indistinguishable. Keep the object in each label and leave a visually distinguishable gap between the links. If one sentence contains too many links, split it.
Whether to add a confirmation step depends on the work’s design. In this example, clicking the move link executes the action, so the label states the action directly. If clicking only opens a confirmation step, change the label to wording that matches what comes next, such as 【Choose where to move the flowerpot】, and record in the table where execution actually occurs.
Walk through each link to catch broken promises and boundary cases
Before handing over the draft, hide the results, look only at each link label, and write down what you expect. Then reveal the promise table and compare. In this example’s walkthrough, reading the note should produce an explanation, examining should produce appearance details, and moving should produce a change of location. This checks the draft’s internal consistency; it does not establish that reader behavior has been validated.
Next, check each return path: can readers resume from the original sentence after collapsing the text? Is the action still available after examination? Does the description of the old location disappear after the pot is moved? Watch especially for a link renamed “Examine” whose underlying behavior still moves the pot. Renaming cannot replace changing the result.
Another failure is examination that secretly consumes time. If other chapters establish that “examining closely advances the patrol,” use a label such as 【Spend one turn inspecting the flowerpot】, classify it as an action that changes world state, and state its cost. Text-only output does not make an interaction supplementary reading.
A reader gaining knowledge need not mean a change in character state. But if opening a note unlocks dialogue or triggers a story event, record that honestly in the table and reconsider the link wording. This method applies to hypertext passages whose click results can be clearly described. It can preserve the mystery of what lies beyond the window gap, but it should not also make “Will clicking move the flowerpot?” a puzzle.
