Rens Roosloot

Voxel URS

Volledige gerenderde weergave van URS.md.

Laatst gesynchroniseerd: 13 april 2026

URS - Voxel Cutaway World Generator

Version: 0.2.0
Date: 2026-03-08
Author: Rens Roosloot / Codex collaboration

1. Purpose

This document defines the user requirements for a small browser-based 3D procedural toy to be hosted on roosloot.com.

The goal is to create a stylized floating voxel world chunk that reads as a cutout sample from a larger world and exposes both terrain and underground composition.

2. Scope

In scope:

  • a standalone browser page
  • a single floating voxel chunk rendered in 3D
  • seeded procedural generation
  • visible surface and underground cut faces
  • desktop and mobile camera interaction
  • day and night lighting modes
  • simple user controls for regeneration and viewing

Out of scope for the initial release:

  • editable terrain
  • player avatars or movement
  • mining, crafting, combat, or inventory
  • infinite terrain streaming
  • backend services
  • accounts, saves, or persistence
  • multiplayer

3. Core Concept

The project shall present a small cubic world sample floating in space.

The top of the chunk shall show the terrain surface.

The exposed sides of the chunk shall reveal underground layers and features such as dirt, stone, ores, caves, and lava.

The chunk shall feel like a deliberate slice taken from a larger world, not a random cube sculpture.

4. User Interaction Requirements

  • The user shall be able to rotate the camera around the chunk.
  • The user shall be able to zoom in and out.
  • The experience shall work on desktop and mobile devices.
  • The user shall be able to regenerate the chunk.
  • The user shall be able to switch between day and night visual themes.
  • The default view shall clearly show the top surface and at least two exposed sides.

5. World Content Requirements

The generated world should support these surface features:

  • hills
  • water
  • trees
  • snow by elevation

The generated world should support these underground features:

  • dirt
  • stone
  • cave voids
  • ore/mineral deposits
  • lava at deeper levels

6. UX Requirements

  • The concept shall be understandable without extended instructions.
  • The interaction model shall remain simple and low-friction.
  • The visual presentation shall feel polished and intentional.
  • The mobile experience shall be treated as a primary target, not a fallback.
  • Motion and visual effects shall respect reduced-motion preferences where relevant.

7. Technical Constraints

  • The project shall run client-side in the browser.
  • The project shall be compatible with the static-site deployment model.
  • The runtime shall not depend on backend services.
  • The runtime shall not use client-side secrets or API keys.
  • Runtime-required files shall resolve from within site/.

8. Performance Requirements

  • The page should load quickly.
  • World regeneration should feel near-instant.
  • Interaction should remain responsive on modern desktop and mobile browsers.
  • The initial release should favor a modest chunk size over world scale.

9. Acceptance Criteria

  • URS-01: A user can open a standalone page and see a floating voxel cutaway chunk.
  • URS-02: The chunk shows both surface features and underground layers clearly.
  • URS-03: The user can rotate and zoom the chunk on desktop.
  • URS-04: The user can rotate and zoom the chunk on mobile.
  • URS-05: The user can regenerate the chunk.
  • URS-06: The user can switch between day and night themes.
  • URS-07: Different seeds produce clearly different but coherent worlds.
  • URS-08: The project runs without backend dependencies.
Terug naar home