Skip to content

About

My attempt at making a simple puzzle and exporation game in the style of Myst

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

368 Commits

Folders and files

Repository files navigation

Lanternwright

An original first-person exploration and puzzle game for macOS, in the spirit of Myst. Swift, with a hand-built Metal renderer and procedural everything: no engine, no asset files.

Status: the vertical slice, The Isle of Varrow, is playable end to end. Wake on a dock at golden hour, follow the lantern path past three resonance stones, read the keeper's journal, strike the stones in the right order, and walk the causeway that rises from the sea to the islet. See docs/DESIGN.md for the vision and docs/TASKS.md for the work queue (M4 polish and M5, the second world The Glass Wood, are done; the choice at the end of the story is not built yet).

overview

Play

scripts/bundle.sh && open Lanternwright.app

Requires macOS 15+ and the Swift toolchain (Command Line Tools are enough; Xcode is not needed).

Control Action
W A S D Walk. The arrow keys ↑ ↓ also walk.
← → Turn.
Mouse Look around.
Shift Run (hold).
R Toggle auto-run.
Click Touch or use what the ring marks: stones, pages, the lens. The ring is quieter once a thing is finished.
Right mouse or Z Look closer (hold) to see distant detail.
J Open or close the journal. Pages you find are added by themselves.
J or Esc Close a page you are reading.
← → Turn pages.
Tab Switch between Pages and Notebook. In the Notebook, click a struck stone's rubbing to hear its tone again.
Esc Free the mouse and pause (settings, controls, new game). Press again to resume.
F Send feedback: saves your note, a screenshot and where you were.
Ctrl ⌘ F Full screen.

Developer tools

swift build -c release
.build/release/Lanternwright --selftest                      # 124 headless checks
.build/release/Lanternwright --screenshot shots/a.png --view dock --size 1600x900
.build/release/Lanternwright --screenshot shots/b.png --view dock --state solved
.build/release/Lanternwright --bench 60 --size 2560x1440      # GPU time per view
.build/release/Lanternwright --dump-audio shots/ambience.wav  # then: afplay shots/ambience.wav
.build/release/Lanternwright --dump-overlay shots/overlay     # journal / crosshair layouts
.build/release/Lanternwright --help

Feedback you send in-game is read back with .build/release/Lanternwright --feedback.

Debug views for the renderer: --debug depth|shadow|albedo|ambient.

The two worlds

The Isle of Varrow (golden hour): solve the stones, walk the causeway, touch the floating lens. The Glass Wood (moonlit): a crystal forest with a mirror puzzle (set the mirrors and glass so the beam meets tide, wind, stone in order) and a chime puzzle (strike the three glass chimes that match the stones' tones, by ear). Solving both wakes the altar of two accounts. The ring beside your arrival pad takes you back. Quick-jump flags for inspecting: --args --state solved (Varrow solved, at the start), --args --world glass, --args --state mirrors|chimes|both. See docs/INSPECT.md for everything worth trying yourself.

Settings and saves

The pause menu (Esc) has mouse sensitivity, volume, render resolution and invert-Y. Progress autosaves to ~/Library/Application Support/Lanternwright/save.json; start fresh with --new or the menu's New game….

Not yet verified by a human

Mouse capture feel, the new surf and footstep/run sounds (afplay shots/ambience.wav), the pause menu and title screen in the real window, and whether the puzzle can be deduced without hints. Everything else is covered by the self-tests or by looking at rendered frames.

About

My attempt at making a simple puzzle and exporation game in the style of Myst

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages