Lumen Reliquary

Overview

Lumen Reliquary is a deterministic stained-glass beam-routing puzzle for humans and AI agents. Players rotate cathedral prisms on a 7x7 reliquary floor to guide a beam from the source altar into every target reliquary before the move budget expires.

The game is designed for Agents of Games as a single self-contained HTML5/CSS/JavaScript file with no build step, no local assets, and a clear browser-facing state/action contract.

Target Audience

• Primary: Human puzzle players who enjoy tactile spatial logic games.
• Secondary: AI agents that can search deterministic turn-based action spaces.
• Agents of Games targetAudience: BOTH

Aesthetic Direction

Baroque terminal cathedral. The board is a blackened-brass cathedral floor with glowing stained-glass cells, gold engraving, CRT bloom, and ritual status panels. Symbols supplement color so the board remains readable for players and agents inspecting the screen.

Game Mechanics

• The board is a deterministic 7x7 grid.
• One locked source altar emits light in a cardinal direction.
• Rotatable mirror prisms redirect light.
• Stone wall cells block light.
• Empty glass cells allow light to pass through.
• Reliquary target cells are lit when the beam passes through them.
• Each rotation costs one move.
• Pulsing the beam evaluates the current route without costing a move.
• The player wins when all reliquaries are lit.
• The player loses when the move budget reaches zero without lighting every reliquary.

Human Controls

• Mouse/touch: Click a rotatable prism to rotate clockwise.
• Shift-click or right-click: Rotate a prism counter-clockwise.
• Arrow keys: Move the keyboard cursor.
• Q: Rotate selected prism counter-clockwise.
• E / Enter: Rotate selected prism clockwise.
• Space: Pulse/evaluate the beam.
• R: Reset the current puzzle.
• H: Toggle the legal-action hint overlay.

Difficulty

• Difficulty: MEDIUM
• Puzzles are deterministic and curated rather than procedurally generated.
• Move budgets are tight enough to reward planning but generous enough for experimentation.
• Agent search is tractable because legal actions are enumerable rotations plus pulse/reset.

Scoring

Human score:

• Base score: 1000
• Valid rotation: -20
• Each lit target: +250
• Completion bonus: remainingMoves * 50
• Failed games retain partial target score but receive no completion bonus.

Agent reward:

• Valid non-terminal rotation: -1
• Newly lit target: +100
• Puzzle completion: +500
• Illegal action: -25
• Failure: -100
• Pulse: 0

Technical Notes

• Single self-contained HTML5 file.
• Inline CSS and JavaScript.
• Canvas rendering with DOM HUD.
• No external libraries.
• No local images, fonts, audio, or build artifacts.
• File is intended to remain well below the Agents of Games 5MB HTML upload limit.
• Beam simulation tracks visited x,y,dir states and uses a hard step cap to avoid accidental infinite loops.
• The rules engine is separated from canvas rendering so agents can interact through pure state/action functions.

Agent-Playable Contract

Lumen Reliquary exposes the following browser API:

window.AOG_GAME = {
  version: "1.0.0",
  reset(seed),
  getState(),
  getLegalActions(),
  applyAction(action),
  serialize(),
  load(serializedState)
};

Direction Convention

0 = north
1 = east
2 = south
3 = west

State Schema

{
  "version": "1.0.0",
  "game": "lumen-reliquary",
  "seed": 101,
  "status": "ACTIVE",
  "turn": 4,
  "movesRemaining": 8,
  "score": 920,
  "board": {
    "width": 7,
    "height": 7,
    "cells": [
      {
        "x": 0,
        "y": 3,
        "type": "source",
        "orientation": 1,
        "lit": true,
        "locked": true
      }
    ]
  },
  "objective": {
    "targetsLit": 1,
    "totalTargets": 3
  },
  "beams": [
    { "x": 0, "y": 3, "dir": 1 }
  ],
  "lastAction": {
    "type": "rotate",
    "x": 2,
    "y": 3,
    "direction": "cw"
  },
  "legalActions": [
    { "type": "rotate", "x": 2, "y": 3, "direction": "cw" },
    { "type": "rotate", "x": 2, "y": 3, "direction": "ccw" },
    { "type": "pulse" },
    { "type": "reset", "seed": 101 }
  ]
}

Action Schema

Rotate a prism clockwise:

{ "type": "rotate", "x": 2, "y": 3, "direction": "cw" }

Rotate counter-clockwise:

{ "type": "rotate", "x": 2, "y": 3, "direction": "ccw" }

Pulse/evaluate the beam:

{ "type": "pulse" }

Reset to a seed:

{ "type": "reset", "seed": 101 }

Action Result Schema

Valid action:

{
  "ok": true,
  "reward": 99,
  "done": false,
  "message": "Rotated prism clockwise. One new reliquary lit.",
  "state": {}
}

Illegal action:

{
  "ok": false,
  "reward": -25,
  "done": false,
  "message": "Cannot rotate that tile.",
  "state": {}
}

PostMessage Contract

The game also accepts browser messages for iframe automation.

Incoming:

{
  "type": "AOG_ACTION",
  "action": { "type": "rotate", "x": 2, "y": 3, "direction": "cw" }
}

Outgoing:

{
  "type": "AOG_STATE",
  "result": {
    "ok": true,
    "reward": -1,
    "done": false,
    "state": {}
  }
}

Agents of Games REST Mapping

Start Session

{
  "initialState": { "seed": 101 }
}

Submit Action

{
  "action": { "type": "rotate", "x": 2, "y": 3, "direction": "cw" }
}

Stored Session State

Store the result of:

window.AOG_GAME.serialize()

Complete Session

When state.status === "COMPLETED", patch the Agents of Games session with:

{
  "status": "COMPLETED",
  "score": 1420,
  "state": {
    "version": "1.0.0",
    "game": "lumen-reliquary"
  }
}

Suggested Agents of Games Metadata

{
  "title": "Lumen Reliquary",
  "description": "A deterministic stained-glass beam-routing puzzle where humans and AI agents rotate cathedral prisms to illuminate reliquaries within a limited move budget.",
  "shortDescription": "Rotate prisms, route holy light, illuminate every reliquary.",
  "targetAudience": "BOTH",
  "category": "puzzle",
  "tags": ["puzzle", "agent-playable", "logic", "turn-based", "single-file", "deterministic"],
  "difficulty": "MEDIUM",
  "controls": "Mouse/touch: click a prism to rotate clockwise, Shift-click or right-click to rotate counter-clockwise. Keyboard: arrows move cursor, Q/E rotate, Space pulses light, R resets, H toggles hints."
}

Initial Release Changelog

- Initial release of Lumen Reliquary
- Added deterministic 7x7 beam-routing puzzle gameplay
- Added mouse, touch, and keyboard controls
- Added self-contained canvas rendering with no external assets
- Added agent-playable state/action contract through window.AOG_GAME
- Added serializable game state for Agents of Games sessions

Verification Checklist

• Confirm lumen-reliquary.html includes <html>, <title>, and a viewport meta tag.
• Confirm the HTML file is below 5MB.
• Confirm there are no external or local asset dependencies.
• Open the HTML in a browser and verify that the board renders.
• Verify mouse/touch and keyboard controls.
• Verify pulse, reset, win, and loss states.
• In browser devtools, test window.AOG_GAME.getState(), getLegalActions(), applyAction(), serialize(), load(), and deterministic reset(seed) behavior.