+ Play World Explorer 3D + · Controls + · What’s new + · Roadmap +
+ + + +*Baltimore’s Inner Harbor, with the mapped USS Constellation identified as a +sloop-of-war museum ship.* + +## A world you can play in + +Select a city, landmark, airport, harbor, or coordinates and enter a bounded 3D +world shaped by available terrain, roads, buildings, water, land cover, and +places. Walk the streets, cross bridges and rooftops, enter mapped or eligible +generated interiors, drive, fly, sail, fish, survey habitats, build, or meet +other players in a room tied to that location. + +The same Explorer connects your Backpack, quick slots, Journal, Field Guide, +activities, Expeditions, specialties, companions, and seasonal surveys. The +World Editor holds both reviewed overlays and persistent Blocks, so creating a +place remains part of the world instead of a separate building game. + +| Water and shore | Flight | +| :--: | :--: | +|  |  | +| **Fish from shore, pilot boats, dive, and explore ports** | **Use a personal aircraft or board aircraft at mapped airports** | + +| Deep space | Explorer progression | +| :--: | :--: | +|  |  | +| **Fly manually or use optional Wayfinder assistance** | **Choose an activity and carry the result into one Explorer record** | + + + +*A playable cargo ship underway near Rotterdam, with the shoreline kept in the +active world.* + +## What you can do + +- Explore on foot, by car, drone, plane, helicopter, boat, ship, rover, + astronaut, or spacecraft, or use optional Live GPS play while walking. +- Visit supported mapped airports to board aircraft, choose pilot or passenger + travel, search for destinations, or take a local sightseeing flight. +- Search for places by familiar names, including cities, landmarks, airports, + and other expected location searches. +- Use configurable Backpack quick slots for field tools, fishing gear, + equipment, and ranged actions. +- Photograph, inspect, survey, identify, fish, follow tracks and signs, and + record finds in the Journal and Field Guide. +- Care for companions, build trust and levels, and travel with eligible + domestic, bird, and livestock companions. +- Enter persistent multiplayer rooms with presence, chat, activities, shared + Blocks, and room vehicles. +- Build with Blocks inside the World Editor and return to supported local or + shared creations later. +- Leave Earth for the Moon, planets, the solar system, and selected deep-space + destinations, with manual flight always available. + +## Version 5.1 + +Version 5.1 brings the Explorer systems into one clearer experience and expands +the sandbox across Earth, oceans, airports, and space. It includes distinct +vehicle handling, visible damage, enterable responder vehicles, aviation and +skydiving, playable maritime fleets, regional field guides, companion growth, +configurable quick slots, improved place search, a redesigned First Journey, +rooftop traversal, and a more capable Wayfinder. + +Eleven regional Field Guide packs provide 180 attainable entries across the +built-in Earth destinations. Field leads are game opportunities: they do not +claim that a real animal is physically present at the player’s location. + +Read the full [5.1 release notes](RELEASE_NOTES_5.1.0.md) and the current +[known issues](KNOWN_ISSUES.md). + +## Multiplayer and building + +Multiplayer uses bounded rooms rather than one continuous MMO world. A room +shares one location, player presence, chat, activities, persistent vehicles, +and player-built Blocks. Private rooms use invite codes; public rooms can be +found by city. + +Blocks are part of the World Editor. Existing supported local and room Blocks +remain on that shared persistence path, with one owner for placement, +permissions, saving, and recovery. + +## World data and accuracy + +Earth scenes use OpenStreetMap-derived geometry and other attributed public or +licensed sources. Coverage, freshness, height information, and provider +availability vary by location. Mapped, observed, modeled, reference, and +game-created content stay visibly distinct. + +World Explorer 3D is a game. It is not a navigation, appraisal, surveying, +wildlife-presence, or safety service. - [Data sources](DATA_SOURCES.md) - [Attribution](ATTRIBUTION.md) -- [Known issues and limitations](KNOWN_ISSUES.md) +- [Known issues](KNOWN_ISSUES.md) - [Acknowledgements](ACKNOWLEDGEMENTS.md) -Required attribution: `© OpenStreetMap contributors` +Required map attribution: `© OpenStreetMap contributors` -## Run Locally +## Run locally Requirements: Node.js 22+, Java 21, and a browser with WebGL support. @@ -82,43 +129,31 @@ python3 -m http.server --directory dist 4173 Open `http://127.0.0.1:4173/app/`. -Core exploration can run locally without production credentials. Account, multiplayer, moderation, and other backend-dependent features require an authorized environment and are not configured by public repository secrets. - -## Verify a Change - -```bash -npm run build:hosting -- --firebase-env staging -npm run verify:hosting -npm run audit:reachability -npm run runtime:verify -npm run release:verify -``` - -`runtime:verify` is the fast pull-request gate. The full release gate additionally covers Firestore rules, mobile controls, editor and multiplayer surfaces, planetary round trips, provider fallbacks, ocean and biome behavior, and a representative global location matrix. - -## Repository Layout +Keyboard and touch controls support browser zoom, visible focus, higher +contrast, larger text, and reduced motion. -- `app/` - canonical browser runtime -- `dist/` - ignored, generated hosting artifact -- `functions/` - authorized backend functions -- `scripts/` - verification and release tooling -- `tests/` - security and runtime test fixtures -- `assets/` - landing and documentation media -- `github-pages/` - static project explainer for GitHub Pages +Core exploration can run without production credentials. Accounts, +multiplayer, moderation, and other online features require an authorized +environment. Secrets are not included in the repository. -Edit canonical source only. `npm run build:hosting` creates a fresh, content-hashed hosting artifact; generated `dist/` files are never edited or committed. -`npm run audit:reachability` rejects hosted JavaScript or CSS that is no longer reachable from a declared page/runtime entrypoint. - -## Project Documents +## Project guide +- [Release notes](RELEASE_NOTES_5.1.0.md) - [Changelog](CHANGELOG.md) - [Roadmap](ROADMAP.md) +- [System inventory](docs/SYSTEM_INVENTORY.md) +- [Architecture](docs/ARCHITECTURE_MAP.md) - [Controls](CONTROLS_REFERENCE.md) -- [DeFlock Hunt](docs/DEFLOCK_MODE.md) -- [Data sources and attribution](DATA_SOURCES.md) - [Contributing](CONTRIBUTING.md) - [Security policy](SECURITY.md) ## License -This repository is source-available under the custom terms in [LICENSE](LICENSE). It is not licensed as OSI open-source software. Third-party data and assets remain subject to their respective licenses. +Copyright © 2026 Steven Reid / World Explorer 3D. All Rights Reserved. + +This repository is publicly viewable under the custom source-available terms +in [LICENSE](LICENSE). It is not licensed as OSI open-source software, and +attribution alone does not grant permission to copy, redistribute, publish, +host, or create derivative works. Third-party data, software, and assets remain +subject to their respective terms in [ATTRIBUTION.md](ATTRIBUTION.md) and +[ACKNOWLEDGEMENTS.md](ACKNOWLEDGEMENTS.md). diff --git a/RELEASE_NOTES_4.2.1.md b/RELEASE_NOTES_4.2.1.md new file mode 100644 index 00000000..f39548b9 --- /dev/null +++ b/RELEASE_NOTES_4.2.1.md @@ -0,0 +1,90 @@ +# World Explorer 3D 4.2.1 + +World Explorer 3D 4.2.1 is a visual-polish and public-showcase update for the +4.2 release. It replaces the simplest player and traversal models with a +cohesive, performance-bounded expedition style while preserving the fixed-world +architecture, movement behavior, physics, collision, cameras, water ownership, +and planetary controls from 4.2.0. + +## Improved player and vehicle presentation + +- The player is now the Field Navigator, with a more intentional outdoor + exploration silhouette and the same four-limb walking animation contract. +- The road vehicle is now the Classic Utility car, with a readable matte-green + body, practical proportions, rotating wheels, and the existing two-headlight, + collision, suspension, and chase-camera behavior. +- Boat travel uses the Harbor Scout expedition boat with a shaped hull, + enclosed cabin, work deck, rails, navigation equipment, radar mast, and + outboard presentation. +- Flight uses the Trailblazer expedition plane with a high wing, bracing, + bush gear, cockpit glazing, navigation lights, and the existing animated + propeller hook. +- Space flight uses the Wayfinder expedition spacecraft with a central cabin, + swept surfaces, twin engine pods, running lights, and shared cool-blue thrust + effects. + +These are procedural runtime meshes. They add no external model download and +do not introduce another renderer, world stream, animation loop, physics body, +or gameplay controller. + +## Public visual overview + +The README, landing page, and GitHub Pages overview now include direct browser +captures of expanded New York, Baltimore, Monaco, San Francisco, the Golden +Gate Bridge, Los Angeles, London, Tokyo, Dubai, and phone-sized DeFlock gameplay. +The DeFlock copy continues to state that virtual camera disabling is fictional +gameplay and cannot affect real equipment. A developer-facing system inventory +documents the current runtime and reconstruction boundaries without changing +game behavior. + +## Performance budgets + +The visual upgrade remains deliberately small: + +- Field Navigator: 628 triangles. +- Classic Utility car: 1,060 triangles. +- Harbor Scout boat: 889 triangles, 33 meshes, 13 materials, no transparency. +- Trailblazer plane: 1,098 triangles, 29 meshes, 10 materials, no transparency. +- Wayfinder spacecraft: 1,288 triangles, 24 meshes, 10 materials; transparency + is limited to three shared thrust-effect materials. + +Boat and plane meshes are created only when their travel mode is used. The +spacecraft remains in the separate lazy Space scene. Inactive Earth travel +actors stay hidden, and none of these presentation changes starts provider +queries or reloads the selected world. + +## Verification + +Automated coverage enforces the mesh, triangle, material, transparency, actor +footprint, propeller, engine-glow, and exhaust budgets. Existing controller, +module-identity, maintainability, asset, CSS, hosting, and release contracts +remain part of the production gate. + +Installed Google Chrome completed the full DeFlock desktop/mobile journey and +aircraft motion capture with no fatal browser errors. A real-input Golden Gate +boat journey stayed attached to the authoritative mapped-water registry, moved +under throttle, and exited normally. The space-control suite completed 1,680 +multi-axis steering samples with a normalized flight quaternion and bounded +camera motion. Representative locations worldwide remain covered by the +existing fixed-world release matrix. + +## Data and attribution + +The visual meshes are project-authored procedural geometry and add no new data +or third-party asset license. Existing OpenStreetMap, terrain, imagery, weather, +space, and DeFlock-related attribution remains unchanged; see +[DATA_SOURCES.md](DATA_SOURCES.md), [ATTRIBUTION.md](ATTRIBUTION.md), and +[ACKNOWLEDGEMENTS.md](ACKNOWLEDGEMENTS.md). + +## Compatibility and limitations + +This update intentionally does not change vehicle handling, aircraft +performance, boat navigation rules, collision dimensions, or space-flight +physics. Map detail still depends on source coverage and provider availability. +See [KNOWN_ISSUES.md](KNOWN_ISSUES.md). + +## Rollback + +Rollback target: immutable release `v4.2.0` at commit +`993ab660255bff3abf5bc4f9b544972402adeec4`. Promote its retained artifact; +do not rebuild historical source. diff --git a/RELEASE_NOTES_4.3.0.md b/RELEASE_NOTES_4.3.0.md new file mode 100644 index 00000000..ab0a93ae --- /dev/null +++ b/RELEASE_NOTES_4.3.0.md @@ -0,0 +1,80 @@ +# World Explorer 3D 4.3.0 + +> This release has been superseded by 4.3.1, the corrected 4.3 release. + +World Explorer 3D 4.3.0 is the Explorer Experience release. It integrates +contextual discovery, field interaction, wildlife, geology, companions and AR +into the existing fixed-location world rather than presenting them as separate +or permanently open systems. + +## Explorer experience + +- Discover context-aware wildlife, geology, natural-history specimens and + detector finds while walking through real-world locations. +- Use visible field equipment including the detector, hand trowel, specimen + brush, camera, binoculars and sediment tools. +- Review observations in the Field Journal and Field Guide, keep acquired + virtual specimens in Collection, and advance Explorer rank, specialties, + goals and regional progress. +- Keep gameplay readable through collapsible, task-focused Explorer panels. + +## Wildlife, companions and AR + +- Wildlife uses distinct bounded procedural models and licensed reference media + for identification context; generated encounters are never presented as proof + of a real animal at the selected coordinate. +- Companion choices include three dogs, three cats, two birds and a virtual fox + with species-aware scale and grounded or airborne following behavior. +- AR supports owned companions, tabletop recorded specimens and a habitat-gated + virtual wildlife photo challenge through WebXR, camera overlay or interactive + 3D fallback according to device capability. + +## World, accounts and multiplayer + +- Regional bridge and tunnel handling preserves visible JFX, Bay Bridge, Fort + McHenry, Yerba Buena and Monaco structure continuity without city-specific + duplicate renderers. +- Building exteriors now combine the existing high-resolution facade atlases + with deterministic ground-level doors, frames, handles, thresholds, lights, + canopies and storefront side panes. Contextual entry activates only at the + published doorway and works through keyboard and touch controls. +- Living-world pedestrians and vehicles have broader visual variety with bounded + population and rendering budgets. +- Account and administrator surfaces are consolidated around conventional user, + moderation, room, content, analytics and operations tasks. +- Firestore rules and Cloud Functions cover trusted Discovery inventory/trading, + accounts, rooms, shared edits, chat and admin claims. + +## Verification + +- Firestore emulator security suite: 77/77 assertions. +- Two independent authenticated multiplayer browsers: 8/8 synchronization and + shared-edit assertions. +- Installed-Chrome Discovery journey: detector, excavation, wildlife, Guide, + Progress, dog, bird, AR and mobile presentation passed with human-reviewed + screenshots. +- Installed-Chrome structure journeys visibly verified Baltimore, San Francisco + and Monaco bridge/tunnel systems. +- Moon, Earth, Mars, Space and Ocean lifecycle journeys passed without duplicate + renderer or world ownership. +- Strict reachability passed 532/532 production modules with zero orphans; all + 93 hosted assets and 27 dynamic PBR assets are owned. +- Installed-Chrome facade acceptance publishes 112 entrances with three opaque + instanced detail draw calls, verifies desktop entry and a 390x844 touch entry, + rejects entry at an arbitrary wall, and retains one world publication. +- The latest repaired dense New York lifecycle measured 541.4 MB post-GC, + released to 150.9 MB at the title and reloaded at 585.7 MB. The former 2.02 GB + editable-world rebuild path no longer rebuilds the provider world. + +The release matrix exercises representative locations worldwide. This candidate +is not approved for deployment: Baltimore and New York building-enrichment +fallback coverage, Miami and Tokyo outage landcover, Everglades far-horizon +fallback, and Lake Tahoe and Panama Canal water-start vehicle selection must be +corrected and rerun. Manual phone and integrated-GPU acceptance also remains +open. Production therefore remains on the verified 4.2.1 rollback artifact. + +## Rollback + +Rollback target: commit `74f1a47d437027bae5d7bd5745e35d1db0bbfe3e`, +the previous `stable` production source for version 4.2.1. Retain and promote its +existing artifact when available; do not rebuild historical source as 4.3.0. diff --git a/RELEASE_NOTES_4.3.1.md b/RELEASE_NOTES_4.3.1.md new file mode 100644 index 00000000..c2a4b141 --- /dev/null +++ b/RELEASE_NOTES_4.3.1.md @@ -0,0 +1,79 @@ +# World Explorer 3D 4.3.1 + +World Explorer 3D 4.3.1 is the corrected Explorer and Urban Sandbox release. It +supersedes 4.3.0 without rewriting its published tag and brings the release +record back in line with the production source. + +## Explorer and urban experience + +- Discover contextual wildlife, geology, natural-history specimens and detector + finds while exploring real-world locations. +- Use field tools, review observations in the Field Journal and Field Guide, + maintain a Collection and advance Explorer specialties and regional progress. +- Choose grounded or airborne companions and use capability-aware AR through + WebXR, camera overlay or interactive 3D fallback according to the device. +- Interact with richer pedestrian roles, vehicle families, street furniture, + wildlife and bounded civic-response scenarios through one contextual action + system and a six-slot equipment loadout. +- Enter eligible buildings through deterministic street-oriented doors and + storefronts that belong to the existing facade renderer. Generated interiors + can include stable floors, walkable stairs and a proximity elevator. + +## Geospatial world + +- Mapped building height and identity now survive footprint selection, + deduplication, batching and every near/far LOD. Quality settings do not rewrite + authoritative skyline height or replace distant mapped detail. +- At-grade roads, solid junction footprints, final terrain, building clearance + and vehicle wheel contact share the same published surface authority. +- Bridge, ramp, overpass, elevated-road and tunnel endpoints are resolved inside + the shared transport compiler. The release does not add city-specific + structure renderers or claim measurements that are not present in source data. +- Earth remains a bounded, deterministic selected-location experience. Player, + vehicle and camera movement does not create a continuously streaming world. +- Water, wake, sky and bathymetry presentation is richer while observations, + models, mapped features and visual fallbacks remain explicitly distinct. + +## Reliability, memory and security + +- Returning to the title releases location-owned terrain, provider staging, + accepted-ground state and scene resources instead of rebuilding or retaining a + second world. +- Production packaging preserves one root Firebase/module instance across the + application shell, account, multiplayer and shared-edit entry points. +- Firestore authorization covers current account, room, discovery, trade, + shared-edit, condition-impact and deletion paths. +- Strict hosted-source reachability and asset ownership reject orphaned runtime + modules and undeclared release media. + +## Verification + +- Root and Cloud Functions dependency audits report zero known vulnerabilities. +- Firestore emulator security suite: 79/79 assertions. +- Two authenticated multiplayer browsers completed private-room presence and + shared-artifact synchronization. +- Packaged Earth, Moon, Mars, Space, Ocean and Live GPS journeys completed with + one renderer and no application or browser errors. +- Complete assembled-world checks cover Baltimore/JFX, Golden Gate, London, + Monaco, Manhattan, rural Iowa and Tokyo with terrain, water, buildings, + transport, population, atmosphere, HUD, collision and player control active + together. +- The hosted artifact contains 563 reachable modules with zero orphans, 95 + declared hosted assets and 27 owned dynamic PBR assets. + +## Compatibility and limitations + +Map and structure detail still depends on mapped source coverage and provider +availability. Incomplete layer or connection tags can make a bridge, ramp, +overpass or tunnel shorter or less detailed than its real counterpart. Dense +urban scenes can remain demanding on lower-memory devices. These are disclosed +limitations, not permission to lower mapped building height or silently remove +distant world detail. See [KNOWN_ISSUES.md](KNOWN_ISSUES.md), +[DATA_SOURCES.md](DATA_SOURCES.md) and [ATTRIBUTION.md](ATTRIBUTION.md). + +## Rollback + +Rollback target: immutable production build +`4.2.1+74f1a47d4370.be7d9ff364590461.production` at commit +`74f1a47d437027bae5d7bd5745e35d1db0bbfe3e`. Promote its retained artifact; +do not rebuild historical source as 4.3.1. diff --git a/RELEASE_NOTES_5.0.0.md b/RELEASE_NOTES_5.0.0.md new file mode 100644 index 00000000..e1dd4467 --- /dev/null +++ b/RELEASE_NOTES_5.0.0.md @@ -0,0 +1,69 @@ +# World Explorer 3D 5.0.0 + +World Explorer 3D 5.0 connects field exploration, progression, fishing, +multiplayer building, and creator tools while preserving the bounded world and +travel systems established in 4.x. + +## Overview + +This release unifies systems that previously felt separate. Walking and Live +GPS now feed the same field activities and progression; shore, boat, and +underwater fishing share the same records; and persistent Blocks now live +inside the World Editor instead of a competing standalone builder. It also +includes the first regional ecology pack, expanded recurring activities, room +building and vehicle persistence, accessibility improvements, and substantial +mobile play and launch fixes. + +## Highlights + +- Explore on foot, by car, drone, plane, boat, submarine, rover, astronaut, or + spacecraft with improved mobile controls and camera behavior. +- Use the unified World Editor for reviewed overlays and persistent local or + multiplayer Blocks. +- Build a shared Backpack, Journal, Field Guide, regional life lists, and + specialties through Field Today activities, Expeditions, and seasonal + surveys. +- Explore a 60-taxon Baltimore ecology pack spanning plants, wildlife, birds, + insects and arachnids, freshwater fish, and marine fish. +- Use the same field activities during normal walking and optional Live GPS + play. +- Fish from shore, from a boat, or underwater, with catches and losses recorded + through the same field systems. +- Create or join bounded multiplayer rooms with presence, chat, activities, + shared building, and persistent room vehicles. +- Use expanded keyboard, touch, zoom, focus, contrast, text-size, and + reduced-motion options. + +## Player-facing fixes + +- The loading image now fully covers the transition into the world. +- The globe’s selected-location marker stays attached while zooming. +- Mobile walking left and right match the direction of the thumb gesture. +- The walking camera follows behind the character during movement. +- Field and interaction prompts clear while a bottom menu is open. +- Speed displays use consistent physical units for walking and vehicles; drone + height appears in the secondary readout rather than the speed field. + +## Upgrading from 4.x + +The standalone Block Builder entry has moved into the World Editor. Open +**Build → World Editor → Blocks** to continue building. Supported local and room +Blocks are retained. + +Existing Backpack data is upgraded automatically on first use, with a local +recovery backup retained in case the upgrade cannot be completed. + +## Scope and limitations + +- The ecology pack is a Baltimore regional slice, not worldwide completeness. +- Field leads and virtual wildlife are game opportunities; they do not report + that a real animal is present at a precise location. +- Terrain, buildings, interiors, water, and live data depend on source coverage + and provider availability. +- Large-room capacity, worldwide ecology, promoted creature models, and broader + physical-device performance coverage remain roadmap work. +- Live GPS is optional, foreground-only, and subject to browser permission and + signal quality. + +See [CHANGELOG.md](CHANGELOG.md), [KNOWN_ISSUES.md](KNOWN_ISSUES.md), and +[ROADMAP.md](ROADMAP.md) for additional detail. diff --git a/RELEASE_NOTES_5.1.0.md b/RELEASE_NOTES_5.1.0.md new file mode 100644 index 00000000..d1579da9 --- /dev/null +++ b/RELEASE_NOTES_5.1.0.md @@ -0,0 +1,115 @@ +# World Explorer 3D 5.1.0 + +World Explorer 3D 5.1 brings the Explorer systems into one clearer experience +and expands the sandbox across Earth, oceans, airports, and space. + + + +## Your Explorer + +- Keep one Journal across Fieldwork, Games, Making, Travel, Community, and + Companions. +- Use one Backpack with categories, item history, inspection, equip and use + actions, and six configurable quick slots. +- Move between Field Today, the Journal, Field Guide, Backpack, Expeditions, + specialties, life lists, companions, and seasonal surveys without creating + separate progress records. +- Download a Journal backup and restore it in the browser. +- Raise eligible domestic animals, birds, and livestock through individual + care, trust, and levels. Compatible companions travel aboard vehicles. + +## Earth and field play + +- Explore eleven regional Field Guide packs with 180 attainable plants, + animals, birds, insects and arachnids, freshwater fish, and marine fish. +- Search the current regional Guide or the World Guide, review unidentified + entries, and follow regional life-list progress. +- Share field leads and activity records between ordinary walking and optional + Live GPS play. +- Fish from shore, a boat, or underwater through the same Journal and Field + Guide records. +- Search for cities, landmarks, airports, and other familiar place names + without requiring an exact text match. +- Follow a new First Journey that responds to the current mode and can be + postponed, replayed, or turned off. + +Field leads are game opportunities based on broad regional, habitat, and +seasonal context. They do not claim that a real organism is physically present +at the selected location. + +## Roads, air, and water + +- Drive vehicle families with distinct handling, a 120 MPH car ceiling, + visible condition changes, and clearer collision response. +- Enter eligible responder vehicles and use their lights and siren after + claiming them. +- Board aircraft at mapped airports and helipads, fly planes and helicopters, + exit in the air, and deploy the Explorer parachute while skydiving. +- Find gates, stands, taxiing aircraft, runway activity, a control tower, and a + ticket hall at supported mapped airports. Choose a pilot or passenger journey, + search for a destination, or take a local sightseeing flight. +- Pilot boats and ships from mapped marinas, harbors, and ports. Nearby land + remains visible, and large ships use a tighter camera in channels and + harbors. +- Keep mapped ships separate from generated fleet activity. USS Constellation + is identified as a sloop-of-war museum ship. +- Land or climb onto eligible roofs and continue walking across them. + +| Aviation | Maritime | +| :--: | :--: | +|  |  | + +## Equipment and city play + +- Use visible Hands, field-tool, melee, ranged, and thrown-equipment actions + from the shared Backpack and quick slots. +- Recover eligible weapons and ammunition, and exchange game items at mapped + convenience stores. +- Meet civilians who can flee, report an incident, defend themselves, or + respond through the bounded civic system. +- Remove expired projectiles, spent charges, unclaimed loot, downed actors, and + disabled vehicles through bounded cleanup or recovery rules. + +Ranged actions have a reticle and camera-directed projectiles, but precision +aiming and presentation remain continuing work. See [Known Issues](KNOWN_ISSUES.md). + +## Space + +- Fly manually or use optional Wayfinder assistance without losing manual + control. +- Select planets, moons, small bodies, stars, and featured deep-space + destinations, then see the active course and local guidance. +- Collide with rendered celestial bodies instead of passing through them. +- Enter accepted solid-world surfaces, traverse them, return to orbit, and + return to Earth. Atmospheric destinations use their own journey rules. + + + +## Multiplayer and creation + +- Join bounded public or private rooms with presence, chat, activities, shared + Blocks, published overlays, and persistent room vehicles. +- Build with Blocks inside the World Editor so local and shared construction + uses one placement and persistence path. +- Compete through game-specific leaderboards connected to supported activities + and the Explorer profile. + +## Access and performance + +- Enter Earth and Live GPS play sooner on mobile while retaining the playable + district and recovery boundary. +- Use keyboard, touch, gamepad, browser zoom, visible focus, larger text, + increased contrast, reduced motion, and larger touch targets. +- Keep mobile entry, action, exit, and recovery usable at a 390×844 layout. +- Release superseded world, provider, scene, and temporary gameplay resources + when changing locations or ending a session. +- Use the same airport travel and aircraft system wherever mapped airport data + is available; density scales down on touch devices without changing the + travel, boarding, or flight experience. + +The complete Journal, Guide, companion history, and local Backpack history stay +in the current browser. Backup and restore are included. Complete cross-device +Journal sync is not yet available. + +See [CHANGELOG.md](CHANGELOG.md), [ROADMAP.md](ROADMAP.md), and +[KNOWN_ISSUES.md](KNOWN_ISSUES.md) for more detail. diff --git a/ROADMAP.md b/ROADMAP.md index d7e994aa..29de6c3e 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -1,44 +1,448 @@ -# Roadmap - -This roadmap describes the current product direction. Priorities may change as performance, data licensing, and platform requirements are evaluated. - -## Completed in 4.1.2 - -- Activated integrity-checked accepted-ground artifacts with explicit datum, - provenance, coverage, uncertainty, and fail-closed behavior. -- Made one compiled OSM transport graph/surface authoritative for rendering, - collision, navigation, bridges, tunnels, ramps, and stacked structures. -- Added provenance-owned building and water publication with stable identity, - mapped/inferred fields, accepted-ground foundations, and navigable-surface - boat selection. -- Made controller transitions and space/ocean renderer lifecycles - deterministic, measurable, and repeatable without resource-owner growth. -- Added outcome-based production gates, real-input journeys, sustained - controller evidence, lifecycle stress tests, and immutable artifact hashes. - -## Completed in 4.1.1 - -- Removed Continuous World and its duplicate streaming renderers. -- Consolidated selected-location loading, cancellation, and world publication. -- Unified terrain and traversal queries for walking, driving, flying, placement, and camera behavior. -- Added structure-aware bridge, ramp, elevated-road, underpass, and tunnel compilation. -- Reworked building exteriors around mapped materials, restrained fallbacks, and improved roof geometry. -- Expanded worldwide regression coverage for dense cities, mountains, coasts, deserts, rural areas, landmarks, and stacked transportation. -- Restored My Places behavior and consistent Earth, Ocean, Moon, Mars, and Space destination access. - -## Version 5.0 Priorities - -- Improve terrain source accuracy and regional bare-earth coverage while preserving one global surface contract. -- Expand licensed landmark, facade, roof, vegetation, hydrology, and land-cover data. -- Improve complete-route performance on desktop and mobile hardware. -- Refine ocean traversal, shorelines, boat handling, underwater environments, and fishing. -- Expand mapped indoor support and generated interior variety. -- Strengthen multiplayer presence, moderation, reconnect behavior, and shared activities. -- Improve world-building tools, games, progression, and accessibility. - -## Future Exploration - -- Licensed rail, bicycle, and hiking route experiences. -- Additional scientifically grounded planetary surfaces and catalog-backed space destinations. -- Improved astronomical navigation, flight handling, encounters, and scale communication. -- Historical or reconstructed environments only where data provenance and licensing support them. +# World Explorer 3D Roadmap + +Last updated: 2026-08-30. + +World Explorer 3D is growing toward a connected world sandbox: choose a real +place, build an Explorer, travel by land, water, air, or space, and make a +persistent life in the game. New systems must deepen that shared world instead +of adding another disconnected menu or duplicate version of an existing +feature. + +## Product direction + +The long-term game is organized around five connected parts: + +1. **Explore:** go anywhere the available world data and game environments can + support, from a city street to a regional field site, an ocean, or another + world. +2. **Do:** drive, fly, sail, fish, survey, photograph, collect, trade, build, + care for companions, play activities, and share a room with other players. +3. **Grow:** develop an Explorer identity, specialties, equipment, companions, + vehicles, homes, and expedition capabilities. +4. **Belong:** establish homes and base camps, decorate them, return to familiar + places, and contribute to persistent local or multiplayer worlds. +5. **Create:** use one World Editor and Blocks workflow to make structures, + interiors, activities, and shared places without competing building systems. + +Real-world context makes the sandbox recognizable, but it does not turn the +game into a navigation, appraisal, ownership, wildlife-presence, or safety +service. Unknown source data remains unknown. + +## Current release: 5.1 + +Version 5.1 connects the systems introduced in 5.0 and substantially expands +travel and sandbox play. + +| Area | 5.1 capability | Continuing work | +| --- | --- | --- | +| Explorer | One Profile, Journal, Field Guide, Backpack, quick-slot loadout, Field Today, Expeditions, specialties, and seasonal surveys | Cross-device progression and more ways to use specialties | +| Regional field play | Eleven regional packs with 180 attainable entries across every built-in Earth destination | Independent scientific review, more regions, and more promoted creature models | +| Character and companions | Attributes, skills, condition, equipment, companion care, trust, levels, livestock, and vehicle travel | Player-selectable Explorer identities, richer appearance, training, and ability growth | +| Earth travel | Walking, distinct road vehicles, responder vehicles, drone, personal aircraft, airport aircraft, boats, ships, and skydiving | More vehicle classes, facilities, damage presentation, and physical-device tuning | +| Water | Shore visibility, mapped vessel identity, marinas, ports, playable boat and ship classes, shore/boat/underwater fishing | Wider port coverage, water traffic, maritime activities, and reviewed bathymetry | +| Space | Manual and assisted flight, selectable courses, celestial collision, planetary entry, accepted surfaces, landing, and return | Optional long-distance Expeditions, more complete planetary activities, destinations, spacecraft, and visual review | +| World construction | One World Editor containing persistent local and room Blocks | Terrain shaping, building materials, interiors, decoration, and creator publishing | +| Community | Bounded rooms, presence, chat, activities, shared Blocks, persistent room vehicles, and public game leaderboards | Larger-room review, moderation depth, clubs, events, and shared settlements | +| Access and performance | Keyboard, touch, mobile layouts, accessibility settings, bounded loading, and lifecycle cleanup | Broader phone, browser, assistive-technology, battery, and thermal review | + +The 5.1 release is complete when the exact release build passes owner review on +desktop and phone, its account and public leaderboard paths are available, and +that approved build is published without being rebuilt. + +## Next foundation: persistent player life + +These systems come before a larger virtual property economy because they define +who owns progress and how it remains recoverable. + +### Explorer identities and character growth + +- Let players choose an Explorer style such as naturalist, field researcher, + navigator, builder, pilot, mariner, photographer, or generalist. +- Keep one shared Character model. An Explorer style changes starting strengths, + assistance, activities, and growth paths; it does not create separate movement, + inventory, vehicle, or fieldwork systems. +- Add player-selectable avatars, appearance options, clothing, equipment display, + animation quality, and accessibility choices. +- Connect attributes, skills, specialties, companion bonds, licenses, equipment, + and vehicles to clear milestones and visible next steps. +- Avoid permanent early mistakes: players can keep a generalist path, learn + outside their specialty, and revise their focus without losing their history. + +### Account-backed progression + +- Add recoverable account sync for the Character, Backpack, Journal, Guide, + companions, homes, base camps, vehicles, and supported creations. +- Preserve local-first play and export/restore while making conflict resolution, + migration, rollback, and account deletion understandable. +- Keep rewards and shared ownership server-authorized. A visible client state is + never sufficient proof of ownership. +- Connect public competition to clear categories: fieldwork, games, making, + travel, community, companions, and seasonal programs. + +Completion means a player can sign in on another supported device, recover the +same supported progression, understand any conflict, and continue without a +duplicate profile. + +## Homes, base camps, and virtual real estate + +Property will become a progression system built on the existing mapped building, +interior, Editor, Blocks, room, and account systems. It will not be a second +building game. + +### Stage 1: homes and base camps + +- Let a player choose one primary home and establish a limited number of base + camps for longer expeditions. +- A home provides storage, companion rest, a vehicle return point, decoration, + activity planning, and a recognizable place to return to. +- A base camp supports field equipment, route planning, sample review, companion + care, and expedition recovery without pretending the player owns real land. +- Home and camp placement must respect mapped access, protected places, + sensitive-species rules, room permissions, world bounds, and collision. +- Decoration uses the World Editor and Blocks object authority, with furniture, + materials, placement limits, undo, persistence, and room sharing. +- Interiors retain stable floor and building identity so saved decoration does + not move to another structure after a later world load. + +Completion means a home or camp can be entered, decorated, saved, revisited, +shared when permitted, migrated, and recovered after an interrupted session. + +### Stage 2: virtual property market + +- Create virtual property records from stable mapped building identity and + licensed property data where coverage permits. A game property is never a + claim to legal title, access, tenancy, or control of the real property. +- Support buying, selling, and upgrading with game currency only. The first + release will not include cash-out, real-money speculation, mortgages, or a + promise that virtual holdings retain value. +- Use a licensed valuation source only when the provider permits the intended + display and storage. Show the source date, coverage, confidence or range, and + whether a number is an assessment, listing price, sale record, automated + estimate, or game value. +- Never substitute random prices for fair market value. If usable valuation data + is missing, show that it is unavailable and use a clearly named game-price + model that does not claim to represent the real market. +- Keep private owner, mortgage, and other personal records out of ordinary game + play. Property identity and valuation are separate from personal ownership + information. +- Start with regions where licensing, parcel identity, valuation coverage, and + update policy can be verified. Elsewhere, homes and base camps can still use + the game economy without a fair-market-value claim. +- Add economic sinks and safeguards through maintenance, decoration, travel, + storage, services, and bounded resale rules so progression is rewarding and + resistant to inflation or abuse. + +Completion means every displayed value has an understandable source and date, +every transaction is authorized and recoverable, and no game screen can be +mistaken for a real listing, appraisal, deed, or offer. + +### Stage 3: neighborhoods and shared places + +- Let invited players visit homes, contribute within explicit permissions, and + use shared storage or activities without gaining ownership authority. +- Add clubs, settlements, expedition headquarters, marinas, hangars, workshops, + farms, and research stations as extensions of rooms and homes. +- Connect local businesses and services to travel, repairs, equipment, supplies, + companion care, and trade while retaining exact source and place identity. +- Add community showcases and discovery without making private locations or + sensitive real-world details public by default. + +## World depth and realism + +World depth will expand by strengthening shared simulation owners rather than +adding city-specific exceptions. + +### Earth and built environments + +- Improve reviewed roads, bridges, tunnels, rail, ports, airports, shorelines, + terrain, roofs, entrances, interiors, elevators, lighting, and collision. +- Expand building materials, architectural families, usable rooms, rooftop + access, furnishings, weather response, and day/night activity. +- Add more playable vehicles and vessels through shared catalogs, handling, + damage, repair, entry, storage, and facility rules. +- Expand airports as playable travel centers through the existing airport + layout and flight owners: richer mapped terminals, gates, ticket halls, + ground service, traffic sequencing, takeoff/landing activity, and regional + airport character without city-specific controller forks. +- Connect airport arrivals, routes, cities visited, flight roles, Expeditions, + Journal history, and optional competition through the existing Explorer + progression and leaderboard authorities. Labels must describe game journeys, + not claim live schedules, ticket sales, or real-world airport operations. +- Keep the personal mode-switch vehicles distinct from heavier world vehicles. +- Extend city-switch and memory cleanup so repeated travel remains playable on + supported desktop and mobile hardware. +- Give projectiles, spent charges, dropped items, downed actors, wrecks, and + unmanned vehicles bounded lifetimes or recovery rules. Cleanup must dispose + rendering and physics resources, not merely hide them. + +### Natural world and field play + +- Publish more reviewed ecology packs through the same taxonomy, habitat, + seasonality, provenance, licensing, attribution, localization, migration, + rollback, and sensitive-species requirements. +- Improve creature anatomy, scale, behavior, animation, LOD, sound, tracks, + habitat signs, and mobile budgets by quality tier. +- Expand regional geology, weather, water, insects, fish, marine life, farms, + livestock, and seasonal change without claiming generated play is a live + observation. +- Develop companion training and roles that connect to fieldwork, travel, homes, + and specialties without turning wildlife encounters into real-world capture + claims. + +### Ocean and space + +- Expand marinas, harbors, large ports, ships, navigation, research, rescue, + cargo, fishing, diving, and oceanography through one maritime lifecycle. +- Expand planetary and deep-space destinations with body-appropriate surfaces, + atmospheres, hazards, activities, visuals, and return journeys. +- Preserve manual control. Assistance remains optional, visible, local to the + selected destination, and interruptible by the player. + +## Interstellar Expeditions + +Interstellar Expeditions will make the journey between distant destinations a +game of its own without replacing the current space sandbox. Players will keep +three choices through the same universe and destination catalog: + +1. **Free flight:** enter a personal spacecraft, fly manually, orbit, land, + leave the craft, and explore with the existing Character, geology, building, + and planetary systems. +2. **Assisted travel:** select a destination and use the current optional, + interruptible travel assistance. +3. **Interstellar Expedition:** deliberately plan and provision a persistent + long-range ship, manage the voyage, and return to ordinary local exploration + on arrival. + +Mars, a discovered world, a player base, and an outpost remain the same places +regardless of how the player reaches them. Expedition work will extend the +existing body catalog, world addresses, Space Flight, Character, Backpack, +Journal, geology, World Editor, Blocks, rooms, and persistence. It will not +create Expedition-only copies of those systems. + +### Stage 1: research and system decisions + +- Produce one primary `INTERSTELLAR_EXPEDITION_SYSTEM.md` before broad + implementation. It will make decisions about propulsion, relativity, + strategic time, crew, closed life support, ship interiors, resources, + failure, multiplayer, persistence, performance, and the boundary with + ordinary Space. +- Base physical claims on authoritative scientific and engineering sources. + Distinguish catalog observations, established physics, modeled values, + speculative engineering, game-generated content, and fictional technology. +- Retain known physical distance while presenting simulated mission duration + and expected player time separately. One travel calculator will own route + feasibility, acceleration and deceleration, propellant, external elapsed + time, crew-experienced time when relativity matters, and play-time + compression. +- Use hierarchical world addresses and reference frames so nearby flight stays + precise while the same architecture can address planets, stars, nebulae, and + galaxies. Catalog objects take precedence; deterministic generated objects + fill appropriate gaps without being presented as observed fact. +- Separate Expedition chronology from contemporary Earth context. A voyage + representing centuries will not silently move the live Earth world into a + fictional future. + +This stage is complete when the design names one owner for every shared state, +resolves the scientific and gameplay decisions needed for implementation, and +defines schema migration and rollback. It will not remain an open list of +alternatives. + +### Stage 2: one complete journey foundation + +- Add one Expedition planner with a small set of understandable realism and + survival presets plus an advanced custom choice. The planner covers + destination, ship, propulsion, crew role coverage, resources, route stops, + risk, and a clear Ready, Marginal, or Insufficient assessment. +- Create data-driven ship and propulsion profiles whose mass, thrust, range, + crew, cargo, power, life support, maintenance, and interior requirements + produce meaningfully different journeys. Real, speculative, and fictional + drives retain honest classifications and explanations. +- Keep personal equipment in the Backpack, voyage supplies in ship cargo, and + outpost resources in settlement storage. Every transfer is explicit and + conservation-checked. +- Use one versioned Expedition record for the ship, route, current leg, + strategic time, crew, supplies, system condition, cargo, discoveries, major + events, and mission state. Stable ship identity includes its class, + configuration, upgrades, condition, crew association, and history. +- Add an interim mission allocation for initial provisioning without embedding + a temporary currency throughout the game. It must be replaceable by the + future shared World Explorer economy. + +The first implementation proves a complete representative journey: prepare, +board, depart, advance time, consume supplies, respond to a real ship problem, +record a discovery, arrive, leave the Expedition ship, and continue as the same +Explorer through the existing local Space and planetary systems. + +### Stage 3: the ship, crew, and voyage + +- Make each Expedition ship a bounded, high-quality, walkable place assembled + from validated class-specific layouts. Required rooms must exist, remain + reachable, fit the exterior, support collision, and perform real functions; + unused decorative labels do not count as systems. +- Connect bridge, engineering, life support, medical, cargo, fabrication, + science, crew, food production, cryogenic, and vehicle spaces only when the + selected ship requires them. Room and deck visibility, shared assets, + bounded lighting, and crew detail levels keep interiors playable in a + browser and on supported phones. +- Use the existing Explorer as a crew member. NPC crew have names, ages, + health, fatigue, experience, assignments, and overlapping technical roles. + They work, rest, repair, treat, and perform science in the visible ship with + purposeful bounded behavior. Routine schedules and maintenance are automatic + unless the player chooses deeper control. +- Track a focused set of consequential supplies: food, water and life support, + power, propulsion resources, medical supplies, maintenance material, + fabrication feedstock, and mission cargo. Forecast consumption, recycling + losses, production, uncertainty, and safety margin before departure. +- Give propulsion, power, life support, navigation, thermal control, medical, + fabrication, food production, sensors, and hull systems condition that can + degrade, warn, fail, and recover. Repairs use crew skill, time, spares, or + valid fabrication; temporary repairs restore limited capability. +- Advance months or centuries through an analytical strategic clock rather + than faster render frames. The player can run normal time, choose a faster + rate, or advance to the next event or milestone; local exploration pauses + long-travel compression. +- Generate quiet travel and bounded state-driven events as well as contextual + uncertainty. Every event changes actual crew, resources, route, or ship state, + and unresolved problems can form an understandable failure chain. A prepared + Expedition normally has backups, warnings, repair, diversion, and rescue + opportunities before it can be lost. +- Record departures, arrivals, repairs, losses, discoveries, route changes, + resupply, rescue, outposts, and outcomes in a Captain's Log presentation + backed by the existing Journal and progression authority. + +### Stage 4: stops, discoveries, and long-duration missions + +- Let a route include known planets, moons, small bodies, bases, outposts, and + stable game-generated destinations. Reachability comes from distance, ship, + propulsion, supplies, and valid stops rather than an arbitrary player level. +- Make resource recovery use the existing planetary flight, geology, mining, + rover, Backpack, and cargo paths. A player may land and gather, deploy a + capable rover, trade with a stocked location, salvage a valid object, or + receive a trusted transfer; no menu may create supplies from nothing. +- Let sensors progress an unknown object from detection to a better supported + classification. Generated discoveries retain a stable identity, designation, + seed, and truth label across save, reload, departure, and return. Known + catalog objects are never presented as player-created discoveries. +- Support cryogenic missions with reserve specialists who can be awakened when + needed. Treat human long-term suspension as speculative, with costs and + limitations rather than a cosmetic label. +- Support generation voyages with bounded population continuity, aging, + training, role succession, knowledge preservation, food, life support, + medical capability, and maintenance. This is not a politics, relationship, + or civilization simulator, and it will not store individual genetic data. +- Apply established Special Relativity to ships reaching meaningful fractions + of light speed, including acceleration, deceleration, external time, and + crew-experienced time. Explicitly fictional faster-than-light travel remains + available only under its honest game classification. + +### Stage 5: shared Expeditions and persistent outposts + +- Extend the current room and backend authority so one human with NPC crew or + multiple humans can share one ship, route, clock, crew, cargo, resource, and + system state. Clients do not independently award or consume shared supplies. +- Synchronize players walking through the same interior while leaving routine + NPC animation and effects local where they do not affect authority. Time + compression requires a clear host or consent decision and remains safe when + a player disconnects and rejoins. +- Allow a compatible player Expedition to answer a distress request only when + route and time make a rendezvous possible. Trusted transfers remove the exact + cargo from the assisting ship before adding it to the receiving ship, and + both Captain's Logs record the rescue. +- Let a suitable Expedition establish a bounded outpost at an existing + planetary destination using the existing World Editor and Blocks. Its crew, + habitat, power, food, water, life support, medical capacity, maintenance, + production, and storage determine what survives or becomes available later. +- Keep an outpost present for ordinary Free-Roam visits and future Expeditions. + It is a persistent resupply node, not a separate colony-management game or a + duplicate planetary world. + +### Completion and release gates + +Interstellar Expeditions are complete only when the following connected +journeys work from planning through persistence, not merely as menus or meters: + +- unchanged Free-Roam flight, assisted travel, landing, planetary exploration, + geology, building, takeoff, and return with no Expedition requirements; +- one complete Expedition with a functional walkable ship, active crew, + consequential resources and systems, a repair, a discovery, arrival, local + exploration, and continuation; +- a real multi-stop resupply using existing planetary or rover gameplay; +- cryogenic crew replacement, a multigenerational voyage, and numerically + validated relativistic travel; +- shared human crew, disconnect and reconnect, coordinated strategic time, and + a resource-conserving multiplayer rescue; +- one persistent outpost that advances within its bounded model and is the same + place in Expedition and Free-Roam play; +- a recoverable and an unrecoverable multi-stage failure with a causal report; +- a stable generated discovery that survives save, reload, departure, and + return; and +- a full active-journey save and restore with the same Explorer, ship layout, + crew, ages, supplies, systems, route, time, cargo, discoveries, log, and + outposts. + +A deterministic non-rendering simulation will exercise representative short, +interplanetary, nearby-star, cryogenic, generation, relativistic, fictional, +multi-stop, rescue, and outpost journeys across long simulated durations. It +will test conservation and deliberately reproduce failure chains rather than +only successful missions. Actual desktop and mobile gameplay review will still +verify planning, ship interiors, crew activity, cruise, emergencies, arrival, +local exploration, visual quality, audio, accessibility, lifecycle cleanup, +and the unchanged ordinary Space experience. + +The initial system stops at this complete loop. It does not add a technology +tree, politics, romance, factions, alien civilizations, diplomacy, banking, a +manufacturing empire, or a full city, colony, or interstellar-market simulator. +Galaxy-scale addressing does not claim that every destination is handcrafted +or reachable by every ship. + +## Creation and community + +- Extend the World Editor with terrain-safe voxel and material tools while + retaining Blocks as its immediate persistent construction workflow. +- Add reusable interiors, decoration sets, vehicles, activities, routes, and + field programs through reviewed catalogs and clear rights metadata. +- Improve drafts, validation, version history, moderation, rollback, discovery, + attribution, and creator profiles. +- Add cooperative Expeditions, races, surveys, building projects, port and + airport activities, seasonal events, and community challenges. +- Carry transport, equipment, damage, recovery, and cleanup into multiplayer + through the existing room authority. The room service decides shared entity + state and retirement so one client cannot erase or retain objects for + everyone else. +- Add an in-game multiplayer map showing the current online player count, + discoverable rooms, and privacy-safe approximate activity areas. Precise + player coordinates remain visible only inside a room when its permissions + allow them, and players can opt out of public discovery. + +### Combat and action feel + +- Improve sight alignment, camera-to-muzzle agreement, hit feedback, recoil, + spread, projectile speed, throwing arcs, animation, sound, and mobile aiming. +- Keep one equipment and projectile authority across the Backpack, quick slots, + NPC response, damage, pickups, rooms, and cleanup. +- Treat the current ranged-action system as a playable foundation, not the + final standard for precision shooting or finished weapon presentation. + +Completion means a creation has one owner, one persistence path, clear +permissions, a recoverable history, and predictable behavior in solo and room +play. + +## Ongoing release standards + +Every release must: + +- preserve supported player state and provide migration and rollback where the + schema changes; +- test the changed gameplay path in the browser on the exact release build; +- retain usable keyboard and 390×844 touch entry, action, exit, and recovery; +- distinguish mapped, observed, modeled, reference, and game-created content; +- document data source, license, attribution, age, coverage, and uncertainty; +- avoid duplicate movement, inventory, building, progression, property, or + multiplayer authorities; +- compare public notes with the previous production tag so substantial player + changes are not omitted; +- publish only the build that completed owner review. + +Worldwide completeness will not be claimed from a set of regional packs, +provider fallbacks, or generated visuals. The roadmap advances when each new +capability works as part of the game players already have. diff --git a/account/account-center.js b/account/account-center.js new file mode 100644 index 00000000..2acf7ecf --- /dev/null +++ b/account/account-center.js @@ -0,0 +1,44 @@ +(() => { + const SECTION_META = Object.freeze({ + overview: ['Overview', 'Account status, access, and the actions you use most.'], + profile: ['Profile', 'Private identity and the public creator card are kept clearly separated.'], + social: ['Friends & Rooms', 'Manage friends and room invitations without mixing them into account security.'], + support: ['Support & Receipts', 'Optional donations, billing controls, and receipt history.'], + security: ['Security & Privacy', 'Review sign-in details and use sensitive account actions deliberately.'] + }); + + const buttons = [...document.querySelectorAll('[data-account-target]')]; + const views = [...document.querySelectorAll('[data-account-view]')]; + const title = document.getElementById('accountPageTitle'); + const subtitle = document.getElementById('accountPageSubtitle'); + + function setSection(section, options = {}) { + const next = Object.hasOwn(SECTION_META, section) ? section : 'overview'; + const [nextTitle, nextSubtitle] = SECTION_META[next]; + views.forEach((view) => { view.hidden = view.dataset.accountView !== next; }); + buttons.forEach((button) => { + const active = button.dataset.accountTarget === next; + button.classList.toggle('active', active); + button.setAttribute('aria-current', active ? 'page' : 'false'); + }); + if (title) title.textContent = nextTitle; + if (subtitle) subtitle.textContent = nextSubtitle; + document.title = `${nextTitle} · World Explorer Account Center`; + if (options.history !== false) { + const url = new URL(window.location.href); + if (next === 'overview') url.searchParams.delete('section'); + else url.searchParams.set('section', next); + window.history.replaceState({ accountSection: next }, '', url); + } + document.querySelector('.wrap')?.scrollTo?.({ top: 0, behavior: options.instant ? 'auto' : 'smooth' }); + } + + buttons.forEach((button) => button.addEventListener('click', () => { + setSection(String(button.dataset.accountTarget || 'overview')); + })); + window.addEventListener('popstate', () => { + setSection(new URL(window.location.href).searchParams.get('section') || 'overview', { history: false, instant: true }); + }); + + setSection(new URL(window.location.href).searchParams.get('section') || 'overview', { history: false, instant: true }); +})(); diff --git a/account/admin.html b/account/admin.html index c6a7fec3..2f622e55 100644 --- a/account/admin.html +++ b/account/admin.html @@ -3,7 +3,7 @@ -Retention, engagement, and onboarding are measured in the linked Google Analytics property. Player coordinates and free-form text are not included in the product event contract.
+Runtime ready, world start/end, duration, travel-mode changes, environment changes, and multiplayer state.
+GA4 recommended tutorial events plus bounded step outcomes make completion and abandonment measurable.
+Activity, catalog family, discipline, context band, and result only—never exact player location.
+Board views, score destinations (shared or device), and bounded outcomes reveal where competitive progress succeeds or disappears.
+Room outcomes, artifact shares, friend additions, and Explorer progress are measured without room codes, names, chat, or artifact text.
+Analytics storage requires the player's explicit choice. Advertising storage, user data, and personalization remain denied.
+Use Realtime or DebugView after a candidate build; normal dashboard reporting is delayed and aggregated.
+Use cohorts and funnels, not raw event counts, when deciding whether onboarding improved return behavior. Compare equivalent release windows and traffic sources.
+Manage your account, optional monthly donations, and multiplayer profile settings.
+Account status, access, and the actions you use most.
+Sign in to manage account details, optional donations, and multiplayer identity.
@@ -553,7 +741,12 @@Add a short bio so people know who built these activities and world edits.
+Add a short bio for room-scoped activities, attribution, and published world overlays.
0
0
0
0
0
0
This is the public identity shown from activities, creator attribution, and published world edits.
+This public identity is used for room activities, attribution, and moderated published world overlays. Device activity drafts are not public.
Signing out ends this browser session. It does not remove saved account data.
+ +Permanently removes the account and associated stored data after a separate confirmation.
+ +npm run dev