🧭 The 2-Lane System

Narrrf’s World is built so people can join before they understand every technical detail. The ecosystem has two clear lanes: one for players and one for Genesis holders.

Lane 1 — Discord Player Lane

This is the open entry lane. A player can start with Discord login, games, weekly events, missions, rewards, and DSPOINC activity. This lane builds community identity before NFT ownership is required.

• Discord login creates the daily player identity.
• Games create scores, leaderboard history, and activity.
• Events like Cheese Rumble, Cheese Race, bingo, poker, spaces, and VR moments create community loops.
• DSPOINC connects rewards, activity, staking, and future utility.
• The profile becomes the player passport for scores, roles, rewards, missions, and future RPG direction.

Lane 2 — Genesis Holder Lane

This is the deeper Lab lane. It starts when a player owns or mints a Genesis Mouse and verifies holder access. The Mouse becomes a long-term identity object inside Narrrf’s World.

• Genesis Mouse ownership opens deeper holder access.
• Mouse names personalize the holder identity.
• Trait upgrades create NFT-bound progression direction.
• Timed Lab research turns progression into a system, not only a static image.
• Future ability direction starts from verified Genesis identity.

Why this matters

Players can build activity and community identity in Lane 1. Holders can go deeper in Lane 2. This structure makes onboarding easier and protects Genesis value because the Genesis Mouse remains the core holder identity.

🧀 The Cheese Engine

The Cheese Engine is the symbolic name for the connected system behind Narrrf’s World. It is not one single button or file. It is the way games, profiles, roles, rewards, DSPOINC, Lab upgrades, admin tools, and future gameplay are designed to work together.

Simple flow

• Player acts: plays a game, opens a reward, joins an event, upgrades a trait, or checks profile progress.
• Backend validates: checks session, season, user identity, score rules, reward logic, wallet/holder state, and Lab conditions.
• World updates: scores, DSPOINC, rewards, profile history, Lab progress, and admin visibility stay connected.

What it connects

• Discord identity and player sessions.
• Game scores and active season logic.
• Leaderboards, missions, and rewards.
• DSPOINC ledger and staking direction.
• Genesis Lab trait progression and Mouse identity.
• Reward Chamber boxes and claim routing.
• Admin tools and audit visibility.

Long-term direction

The goal is symbolic cross-game recognition. Over time, roles, Genesis traits, Mouse names, ability direction, rewards, and profile history can matter across multiple experiences without confusing seasonal leaderboards with permanent progression.

🎮 Season 12 Game Overview

Games are the action layer of Narrrf’s World. They create activity, competition, DSPOINC flow, profile history, missions, role value, and future RPG signals.

Season 12 ecosystem surfaces

• Tetris — classic score ladder, game key tetris.
• Snake — classic score ladder, game key snake.
• Space Cheese Invaders — arcade shooter score ladder, game key space_invaders.
• Cheese Runner — player-facing runner game, backend game key cheeseman.
• Labyrinth Blast — newest highlighted action game, backend game key labyrinth_blast.
• Glyph Memory — memory/time-trial system using its own Glyph table path.
• Cheese Hunt — hidden cheese / click activity layer.
• Discord Cheese Race — Discord event game lane.
• Cheese Rumble — Discord battle / community chaos lane.

Important technical split

Not every game uses the same database table. Classic score-ladder games use the seasonal score system. Glyph Memory uses a separate time-trial path. Discord event games can be persistent/event systems unless a future reset explicitly changes that.

🧩 Tetris

Tetris is one of the core arcade score games inside Narrrf’s World. It is part of the seasonal competition layer.

Customer explanation

Players play Tetris, save a score, and climb the seasonal leaderboard. The score contributes to the competitive arcade identity.

Technical facts

• Game key: tetris
• Season source: active season from tbl_seasons
• Score table: tbl_tetris_scores
• Leaderboard API: api/dev/get-leaderboard.php
• General score API: api/dev/save-score.php

Reset behavior

Tetris is seasonal. Its leaderboard rows can be archived/reset during a season reset after backup and archive verification.

🐍 Snake

Snake is a core arcade score game and part of the seasonal leaderboard race.

Customer explanation

Players collect cheese, grow the snake, and try to place high on the seasonal board. It is simple to understand, fast to play, and easy for new members to join.

Technical facts

• Game key: snake
• Season source: active season from tbl_seasons
• Score table: tbl_tetris_scores
• Leaderboard API: api/dev/get-leaderboard.php
• General score API: api/dev/save-score.php

Reset behavior

Snake is a seasonal score-ladder game. Its leaderboard can reset after the season is safely archived.

👾 Space Cheese Invaders

Space Cheese Invaders is the arcade shooter layer of Narrrf’s World.

Customer explanation

Players defend the cheese, defeat invaders, and compete for the highest seasonal score.

Technical facts

• Game key: space_invaders
• Season source: active season from tbl_seasons
• Score table: tbl_tetris_scores
• Leaderboard API: api/dev/get-leaderboard.php
• General score API: api/dev/save-score.php

Reset behavior

Space Cheese Invaders is part of the seasonal archive/reset scope together with the classic score games.

🧀 Cheese Runner

Cheese Runner is the player-facing name for the game that the backend tracks with the key cheeseman.

Customer explanation

Players run through the cheese chaos, collect points, and create seasonal activity. The public game name can stay fun, while the backend key must stay stable for APIs and leaderboards.

Technical facts

• Player-facing name: Cheese Runner
• Backend game key: cheeseman
• Score API: api/dev/save-cheeseman-score.php
• Score table: tbl_tetris_scores
• DSPOINC ledger: tbl_user_scores
• Season source: active season from tbl_seasons

Reset behavior

Cheese Runner / Cheeseman is now part of the seasonal score archive scope.

💥 Labyrinth Blast

Labyrinth Blast is the newest highlighted Season 12 game surface. It adds maze action, enemies, traps, mobile controls, and backend-tracked DSPOINC reward flow.

Customer explanation

Players enter a maze, survive hazards, face Mouseverse pressure, collect score, and create leaderboard activity. It is designed as a more modern action surface compared with the classic arcade stack.

Confirmed system details

• Player-facing name: Labyrinth Blast
• Do not call it publicly: FOX. FOX is only the local source/build folder name.
• Game key: labyrinth_blast
• Public wrapper: public/labyrinth-blast.html
• Public build folder: public/labyrinth-blast/
• Score API: api/dev/save-labyrinth-blast-score.php

Backend writes

• tbl_tetris_scores — seasonal leaderboard source.
• tbl_user_scores — DSPOINC ledger source.
• tbl_score_adjustments — audit/source trail.

Reward rules

• Frontend sends raw gameplay data.
• Backend validates the request and user identity.
• Backend calculates DSPOINC.
• Frontend does not decide the final DSPOINC reward.

Current gameplay direction

• Dynamic board scaling by level.
• Cheeseman Mouseverse enemy.
• Cheese traps and control reversal.
• Mobile controls.
• Pause system.
• Role multiplier reward direction.

Status wording

Labyrinth Blast is the new Season 12 highlighted game surface. Final public claims should still be validated on live Render before saying the complete 9/9 ecosystem is fully verified live.

🔮 Glyph Memory

Glyph Memory is the memory and symbol layer of Narrrf’s World. It supports lore, focus, pattern recognition, and future riddle-direction thinking.

Customer explanation

Players match glyphs and compete through memory/time-trial style runs. It is different from raw score arcade games.

Technical facts

• Game key / mode: glyph_memory
• Main score table: tbl_glyph_memory_scores
• Historical archive table: tbl_historical_glyph_stats
• Admin data mode: all-time time-trial style, not the same as classic arcade scoring.

Important reset rule

Glyph Memory must not be assumed to behave like Tetris, Snake, Space Invaders, Cheese Runner, or Labyrinth Blast. It needs its own archive/reset verification because it uses its own Glyph table path.

🧀 Cheese Hunt

Cheese Hunt is the hidden-cheese / discovery activity layer of Narrrf’s World.

Customer explanation

Players hunt for hidden cheese moments and interact with the world outside normal arcade leaderboards. It supports exploration, events, community activity, and fun seasonal moments.

Technical direction

• Cheese Hunt can have snapshot/archive behavior where applicable.
• It should not automatically be treated the same as classic score-ladder games.
• Reset behavior should be explicit before each season reset.

Reset behavior

Cheese Hunt should be preserved as an event/activity system unless a season plan explicitly says to archive or reset a defined snapshot.

🏁 Discord Cheese Race

Discord Cheese Race is an event lane. It lives closer to community activity than classic browser arcade scoreboards.

Customer explanation

Members join Discord race events, compete together, and create weekly community energy. This is part of the living Narrrfs community, not only the website.

Technical direction

• Discord event systems can use different persistence rules than browser games.
• Race participants and event history should not be blindly wiped during normal arcade leaderboard resets.
• Future ability systems can use Discord fights/events as safer test lanes before deeper game-engine integration.

Reset behavior

Preserve Discord Cheese Race as an event/community system unless a future reset plan explicitly changes the rule.

💣 Cheese Rumble

Cheese Rumble is the Discord battle / community chaos lane of Narrrf’s World.

Customer explanation

Cheese Rumble brings the community together through text-based battle energy, Friday chaos, events, and reward moments. It is one of the best places to test future role and ability ideas.

Technical direction

• Rumble data is event-style activity, not a classic browser score ladder.
• Rumble participants/history should not be blindly reset with monthly arcade leaderboards.
• Future Genesis traits and abilities can first be tested in Discord fight/event systems.

Reset behavior

Preserve Cheese Rumble as a community/event system unless a future season plan explicitly changes its reset rules.

👤 Player Profile System

The profile is the player passport of Narrrf’s World. It should become the readable RPG dashboard for normal players and Genesis holders.

What profile connects

• Discord session identity.
• Scores and seasonal competition.
• Mini leaderboards and current-season stats.
• All-time activity.
• Roles and holder access.
• Reward Chamber actions.
• DSPOINC activity and economy direction.
• Genesis Lab visibility and future Mouse progression.

Important technical behavior

Profile session hydration syncs Discord identity into page/local storage for page usage. That makes Discord the daily player identity layer while wallet/NFT verification adds deeper holder identity.

Customer explanation

Profile is where the player should understand: who am I, what did I play, what did I earn, what roles do I have, what rewards can I open, and how deep am I inside the ecosystem?

🏆 Role System

Roles show identity, status, access, and activity inside the Narrrfs community. They connect Discord, games, rewards, profile visibility, and future ability direction.

Main role meaning

• Holder / VIP Holder: Genesis ownership and deeper ecosystem access.
• Champion / Tester / Hunter: activity, testing, contribution, and community identity.
• Monthly legends: seasonal competition recognition.
• Event roles: participation in special campaigns, events, or partner activities.

Why roles matter

Roles make the community readable. They can support multipliers, rewards, access, events, and future RPG profile direction.

Safety rule

Role power should be communicated as ecosystem access and reward direction, not as guaranteed financial return.

🧬 Genesis Lab

Genesis Lab is the holder progression layer of Narrrf’s World. It turns a verified Genesis Mouse into a long-term identity object instead of leaving it as static art only.

What the Lab does

• Loads verified Genesis Mouse ownership.
• Displays Mouse identity and traits.
• Supports custom Mouse names as player-facing labels.
• Tracks trait upgrade state.
• Uses timed research cycles and manual claim flow.
• Supports DSPOINC-powered Lab actions.
• Prepares the foundation for future ability-based gameplay.

NFT-bound upgrade direction

The unique idea is that a Genesis Mouse becomes a long-term game identity. Names, traits, Lab history, and upgrade state become part of the holder lane.

Important safety rule

Custom names are display-only player labels. They must not replace token ID, metadata name, upgrade identity, marketplace identity, or ownership checks. Marketplace actions should not be described as mutating the Genesis Mouse. NFT-bound progression stays controlled through verified Lab paths.

🎁 Reward Chamber

Reward Chamber is the public reward layer inside the profile flow. It gives players clear reward actions while the backend keeps reward rules controlled.

The 3-box structure

• Box 1 — Free DSPOINC Box: daily/free reward loop with cooldown logic.
• Box 2 — Lucky Cheese Loot: paid DSPOINC box with weighted reward pools.
• Box 3 — Royal Cheese Mystery: premium claim route that can require admin/mod follow-up.

What it connects

• Profile actions.
• DSPOINC usage.
• Lootbox rewards.
• Store and inventory direction.
• Premium claim routing.
• Admin configuration and support visibility.

Technical surfaces

• /api/user/get-reward-boxes.php
• /api/user/open-reward-box.php
• /api/user/get-player-lab.php
• /api/user/get-user-genetic-items.php
• /api/user/get-lab-booster-inventory.php
• /api/store/purchase.php
• /api/user/buy-genetic-marketplace-listing.php

Reset behavior

Reward Chamber is permanent progression/economy state. It must not be wiped by normal seasonal leaderboard resets.

🧊 DSPOINC Staking

DSPOINC staking lets players freeze DSPOINC for a selected duration and earn a reward based on the staking system rules.

Customer explanation

Staking turns DSPOINC from a simple game reward into a longer-term ecosystem resource. Players choose to freeze DSPOINC, wait through the selected period, and claim according to the live rules.

System meaning

• Staking supports long-term economy loops.
• Frozen DSPOINC should not be treated as spendable until unstaked or completed.
• Staking connects profile, economy, and permanent progression direction.

Reset behavior

Staking is permanent economy state. It must not reset with seasonal leaderboards.

🗄️ Database Layer

The database is the memory of Narrrf’s World. It stores seasons, scores, users, roles, DSPOINC movement, Lab progress, reward history, and admin/audit trails.

Season control

The active season is controlled by tbl_seasons, where one season should be marked active. APIs should read the active season dynamically and use Season 12 as the fallback where updated.

Seasonal data

• Leaderboard score records.
• Current season competition state.
• Game rows tied to season names.
• Historical archive rows after a season reset.

Permanent data

• DSPOINC balances and ledger history.
• Staking balances and staking state.
• Genesis Lab progression.
• Genetic inventory.
• Marketplace state.
• Reward Chamber persistent/economy state.
• Wallet, user, role, and NFT identity.

Plain explanation

Scoreboards can reset for fresh competition. Player identity, Lab progress, DSPOINC economy, staking, inventory, and holder access should not reset like monthly scoreboards.

🔄 Season Reset / Archive Logic

Season resets are designed to create fresh competition while preserving the permanent Narrrfs ecosystem.

Reset process in plain language

• Backup the database first.
• Archive the current season before deleting or resetting score rows.
• Activate the new season in tbl_seasons.
• Reset only the planned seasonal leaderboard data.
• Verify every game saves under the new active season.
• Verify profile, leaderboard, admin, Lab, Reward Chamber, and economy systems still work.

Season-based archive scope

• tetris
• snake
• space_invaders
• cheeseman
• labyrinth_blast
• Cheese Hunt snapshot where applicable.
• Glyph Memory through its separate archive path.

Never reset in normal leaderboard reset

• DSPOINC balances.
• Staking.
• Genesis Lab progression.
• Genetic inventory.
• Marketplace.
• Reward Chamber persistent/economy state.
• User, wallet, role, and NFT identity.

Customer explanation

A new season means a fresh race on the boards. It does not mean players lose Lab progress, DSPOINC, staking, inventory, Mouse names, or Genesis identity.

🌐 Frontend Layer

The frontend is what players see: home page, profile, leaderboard, Lab, mint info, roles, Reward Chamber, project updates, whitepapers, and game pages.

Customer purpose

The frontend should explain the ecosystem clearly and guide users to the right action: play, verify, mint, enter Lab, open rewards, stake DSPOINC, or read deeper docs.

Important frontend rules

• Do not hardcode outdated active-season text.
• Use Season 12 as current public context.
• Keep Season 11 only as frozen / previous / historical when mentioned.
• Preserve existing IDs, scripts, API paths, and onclick handlers during theme changes.
• Frontend displays data; backend should remain authoritative for rewards, score saves, and season state.

Pages in the Season 12 sync wave

• index.html
• get-roles.html
• mint.html
• whitepaper.html
• whitepaper-pro.html
• project-updates.html
• nerd-lab.html

⚙️ Admin Interface

The Admin Interface is the control and visibility layer for trusted operators. It helps monitor users, scores, roles, missions, games, Lab systems, Reward Chamber, claims, bugs, partners, and support workflows.

Customer-friendly explanation

Players see games and rewards. Admins need tools to verify, support, correct, and monitor the ecosystem. The admin interface is how the team keeps the live system understandable and supportable.

Current Season 12 admin direction

• Admin game stats should use the active season.
• Labyrinth Blast is prepared as a Game Management surface through shared game stats.
• Reward Chamber has dedicated configuration/visibility direction.
• Player Profiles and Lab / Trait System tabs support deeper user support.
• Mission, points, store, quest, Twitter, bug, and partner tools remain operational areas.

Important safety rule

Admin pages are function-heavy. Theme changes should be careful and should not remove IDs, tabs, fetch paths, auth logic, or existing operational tools unless explicitly planned.

🤖 Discord Bot Layer

Discord is not only a chat room for Narrrf’s World. It is a major player identity, event, role, onboarding, and community-game layer.

What Discord connects

• Login identity for player sessions.
• Roles and holder recognition.
• Community events and partner activity.
• Cheese Race and Cheese Rumble style gameplay.
• Onboarding for new players and new Genesis holders.
• Moderator/admin follow-up for premium claims and support workflows.

Why it matters

Narrrf’s World is community-first. Discord keeps the world alive between website visits, game sessions, Lab upgrades, and partner events.

Future ability direction

Discord fights and role-based events are a safe first lane for testing Genesis ability concepts before deeper game-engine integration.