Player Guide

1.Getting Started

GlyphGalaxy runs in your web browser (a native client is on the long-term roadmap). You play through a client that connects to a game server for multiplayer.

To play (local dev build):

• Open the client at http://localhost:5180 — use localhost, not 127.0.0.1 (the dev server binds IPv6).
• The client auto-connects to the game server on ws://localhost:8080. If no server is running, you drop into offline solo play automatically — the whole single-player game still works.
• Click the screen to lock your mouse and start playing. Press Esc to release the mouse.

First five minutes:

• You start in Creative mode. Look around, fly with a double-tap of Space, and place/break blocks freely.
• Press G to switch to Survival when you want the full loop (gathering, hunger, danger, mobs that fight back).
• Open your block palette with E, the crafting menu with K, and your wallet with B.

Mobile (touch) and gamepad input are supported in addition to keyboard + mouse.

2.Game Modes

Press G to cycle modes:

3.Controls

The in-game hint bar (top of screen) always shows the current bindings. Defaults:

Movement

• WASD — move
• Space — jump (double-tap in Creative/Spectator to toggle flight)
• Ctrl — sprint
• Shift — sneak (and descend ladders / fly down)

Interaction

• Left-click — break a block / attack a mob (or PvP opponent)
• Right-click — place the held block / use (open chest, anvil, furnace, eat food, toggle door, plant seeds, etc.)
• Mouse wheel or ← → — scroll the hotbar; ↑ ↓ — page the hotbar; 1–9 — pick a hotbar slot

Menus & panels

• E — Inventory / block bag
• I — Items (your on-chain Glyph NFTs)
• K — Crafting (full recipe set if near a crafting table, else hand recipes)
• T — Trade / Marketplace
• P — Plots: claim land + register your WAVE name
• V — mark a build region (two corners); N — inscribe the marked region as an NFT
• B — Wallet
• O — Settings
• G — Game mode · C — cycle weather · M — mute
• F1 — toggle HUD · F2 — screenshot · F3 — debug overlay · Esc — release mouse

Touch controls (on-screen joystick + buttons) and gamepads work too.

4.The World

• Terrain is generated deterministically from a world seed, so everyone on a server sees the identical landscape (only player edits travel over the network).
• Biomes: plains, forest, mountains, desert, and snowy — each with its own trees, surface blocks, and creatures.
• Caves, rivers, lakes & ores are carved through the terrain; dig down to find coal, iron, copper, gold, and the prized Radiance Crystal.
• Day / night cycle: a full day runs about 3 minutes. The sky shows a blocky sun and twin moons (pale "Lume" + amber) over a starfield. Night is when hostile creatures come out.
• Weather: rain, snow, storms with lightning and thunder. Press C to cycle it locally (online, the world shares one synchronized sky).
• Liquids: water and lava flow realistically — dig into a lake and it floods the space; lava + water makes cobblestone. You can swim, and you'll climb out onto shore by holding jump against a bank.

5.Building & Blocks

Place blocks with right-click, break with left-click. There are 52 stock block types, grouped roughly as:

• Natural: grass, dirt, stone, sand, water, lava, wood, leaves, glass, glowstone
• Ores: coal, iron, copper, gold, and Radiance Crystal
• Building: cobblestone, stone bricks, planks, gravel, bricks, bedrock, snow, ice, mossy cobblestone, sandstone
• Decorative / glowing: crystal, prism, mirror, lantern, glow mushroom
• Woods & desert: birch, dark wood, cactus
• Plants (cross-quad): tall grass, flowers (red/yellow/glow), crops
• Functional: crafting table, glyph anvil, chest, ladder, door, furnace, farmland

Open the Inventory (E) to see every block as a textured preview and pick what to hold. The hotbar shows the same thumbnails. Doors are real 2-tall panels (open, toggle, or destroy them); ladders let you climb.

6.Survival: Health, Hunger & Hazards

In Survival mode you have three vitals (shown above the hotbar):

• ❤ Health — 10 hearts (20 points). Hit 0 and you die (respawn from the death screen). Regenerates slowly only while well-fed.
• 🍗 Hunger — 10 drumsticks (20 points). Activity (walking, sprinting, jumping, taking damage, healing) drains it. At 0 you starve (lose health over time).
• 💧 Air — drains when your head is underwater (~11 seconds), then you start to drown. It refills at the surface.

Hazards: falling more than ~3 blocks hurts (water and ladders cancel fall damage), lava burns fast, and drowning / starvation chip away at health.

Food restores hunger (right-click to eat held food): apple, bread, glow berry, plus cooked meats (beef, chicken, pork, mutton, fish) once you smelt the raw drops. Eating at full hunger does nothing, so don't waste food.

7.Crafting, Tools & Smelting

Crafting (K): opens a recipe list. Standing near a crafting table unlocks the full recipe set; otherwise you can hand-craft the basics (planks, sticks, a table). Right-click a placed crafting table for the full set.

Tools come in four tiers — each faster and more durable than the last, and each able to harvest more:

Tool types: pickaxe (stone/ore), axe (wood), shovel (dirt/sand/gravel), sword (combat), hoe (farming). Mining the wrong material with bare hands or a too-weak tool is slow or yields nothing — match the tool to the block.

Smelting (furnace): right-click a placed furnace to open it. Load an input + fuel (coal, planks, etc.) to smelt ores into ingots, raw meat into cooked food, and Radiance Crystal → Radiant Gem (the material for top-tier radiant tools).

8.Farming

• Use a hoe on grass or dirt to till it into farmland.
• Right-click farmland with seeds to sow a crop.
• Crops grow through visible stages over time (they get taller and shift from green to ripe). Online, growth is synchronized for everyone via the shared world clock.
• Break a ripe crop to harvest produce + more seeds.

Five crops: wheat, corn, pumpkin, tomato, beans. Crops uproot if you remove the farmland beneath them. Tall grass can be foraged for starter seeds.

9.Creatures (Mobs)

There are 13 species. Online, mobs are simulated by the server (everyone sees the same creatures in the same place); offline they're simulated locally.

Passive (wander, flee when hit): chicken, pig, sheep, cow, fish.

Tameable companions — feed them meat to tame; a tamed pet follows you: bear, dog, wolf, cat.

Hostile (spawn at night on the surface, or any time in dungeons): zombie, skeleton, blob (hops and splits in two when killed), and the rare, powerful ice dragon. Hostiles chase and attack you; they burn off at dawn unless deep underground.

Combat & drops: hit a creature with left-click. Your damage comes from your equipped weapon — a leveled evolving weapon hits hardest. Slain creatures drop loot that falls to the ground for you to collect:

• Cow → raw beef + leather · Chicken → raw chicken + feathers · Pig → raw pork
• Sheep → raw mutton + wool · Fish → raw fish
• Zombie → rotten flesh · Skeleton → bone · Blob → slime
• Ice dragon → ice shards + a Radiant Gem (a real prize)
• Dogs/wolves/bears/cats are companions, not livestock (no drops)

10.Structures & Loot

Scattered through the biomes are generated structures, each with interactive chests holding loot rolled from the world seed:

• Ruined tower · Village · Desert pyramid · Dungeon · Snowy cabin

Dungeons are dangerous — hostile creatures spawn inside day or night, guarding better loot. Right-click a chest to open it; take and deposit items. Online, chest contents are server-authoritative and persist across restarts.

11.Your Wallet

GlyphGalaxy has a built-in RXD wallet (press B):

• A standard Radiant wallet (BIP-44, SLIP-0044 coin type 512) created locally and encrypted behind a passcode — your keys never leave your device.
• Shows your deposit address + QR code and your balance.
• Bring your own wallet: power users can import an existing Photonic/Orbital seed.
• Session balance ("game wallet"): top up a small, capped sub-balance once and small in-game purchases auto-sign instantly (no popup per buy); big spends still confirm with your main wallet, and you sweep the rest back when you're done. No server ever holds your funds.

12.Glyphs: On-chain Items

Glyphs are Radiant's on-chain tokens. In GlyphGalaxy:

• Stock blocks and basic resources are off-chain (free, infinite in creative).
• Special items, builds, land, names, and all user-created content can be on-chain Glyphs you truly own — tradeable, portable, and provably yours.

Mint a build as an NFT:

• Press V and click two corners to mark a region of what you built.
• Press N (or right-click a Glyph Anvil) to inscribe it — give it a name and choose a rarity: common, uncommon, rare, epic, legendary, mythic.
• It's minted to your wallet as a Glyph NFT and appears under Items (I).

Resource bundles: you can tokenize a stack of an in-game resource (ingots, planks, gems…) as a fungible FT bundle and trade the whole stack on the marketplace; buying one credits your in-game bag.

There are several Glyph item kinds you'll meet below: plain NFTs (builds), mutable NFTs (evolving items), containers (collections), land plots, and WAVE names.

13.The Marketplace

Press T to open the marketplace — a trustless, peer-to-peer exchange:

• Sell: list one of your NFTs (or a resource FT bundle) for a fixed RXD price.
• Buy: browse listings and purchase. Settlement is an atomic on-chain swap — the item and the payment change hands in a single transaction, so neither side can be cheated. No middleman ever holds your item or coins.
• A game-server order book is just for discovery (finding listings); the trade itself settles directly on-chain.

You can re-sell items you bought; the marketplace tracks where each token currently lives so it can be re-listed.

14.Land & Identity

Press P for the Genesis — Land & Identity panel.

Land plots: Radiantia is a grid of 16×16-block plots (4,096 addressable on the full continent). Claiming a plot:

• Costs a bit of proof-of-work (your device solves a small puzzle — an anti-squat gate), then mints a land-plot NFT to your wallet.
• Owning a plot grants you build rights there. Unclaimed land is an open sandbox anyone can edit; a claimed plot only accepts edits from its owner.

WAVE names (your player identity): register a human-readable name (e.g. alice.rxd) using a commit-reveal flow that protects you from name-sniping:

• Commit a hidden hash of your name.
• Wait a block, then Reveal the name — your earlier commit wins, so a bot can't front-run you. The verified name becomes your display name.

15.Evolving Items

Some weapons, armor, and pets are mutable Glyph NFTs that grow with you — they gain XP, levels, and durability through play and carry that progress on-chain.

How XP accrues:

• Kills grant XP to your equipped weapon and pet (tougher creatures give more XP).
• Taking hits grants XP to your equipped armor (and the armor absorbs part of the damage).
• Swinging a weapon and getting hit also spend durability.

What leveling up does:

• Stronger stats — weapons gain damage, armor gains defense, pets gain power + vitality. Your weapon's level-scaled damage is what's actually applied in combat (and in PvP).
• More durability — max durability grows each level (and tops up on level-up), so higher-level gear lasts longer between repairs.
• A more valuable on-chain asset — the item's {level, xp, durability} is its live on-chain state.

The level/XP HUD (bottom-left) shows each equipped item's level, an XP bar, and a durability bar. Max level is 50, and stats scale with both level and rarity.

⛓ Putting it on-chain: each equipped item has a "⛓ Mint on-chain" button (then "⛓ Sync Lv N" afterward). Mint puts the item on the blockchain; Sync commits its accrued progress to the token in place — so your battle-worn, leveled item is permanently that item on-chain, and worth more than a fresh one when you trade it.

16.Creator Collections

Creators can group their item NFTs into an on-chain collection (a Glyph container) — a named set (e.g. "Founders Drop") that links its member items together on-chain. Collections can be a fixed snapshot at mint or grown over time. Useful for drops, themed sets, and showing provenance in the marketplace.

17.PvP Arenas

Wager RXD on a 1-on-1 duel where the winner takes the pot — settled on-chain, with no one able to cheat or run off with the stakes.

How a match works:

• One player opens a match with a wager; another joins.
• Both players stake their RXD into a shared 2-of-3 escrow (you, your opponent, and the game server as a neutral arbiter).
• You fight. The server runs the duel authoritatively — your hits deal your equipped weapon's real damage, and HP is tracked server-side, so the outcome can't be spoofed.
• On a knockout, the server (arbiter) signs the payout to the winner, who co-signs and collects the pot.

Why it's safe: the escrow is 2-of-3, so the server can never take the money (it's only one signature of three) and can only help pay the rightful winner. If a match is abandoned, the two players can cooperatively refund themselves without the server.

Leaderboards: wins update a persistent Elo ranking (beating a higher-rated player is worth more than stomping a weaker one).

Season passes: a season pass is a Glyph FT you hold to unlock ranked play and seasonal rewards.

18.Multiplayer & What the Server Owns

When you're connected to a server you're playing the same world as everyone else. To keep things fair, the server is the source of truth ("authoritative") for the things that matter:

• The world — edits, and chests (contents persist across restarts).
• Creatures — spawns, movement/AI, and confirmed kills.
• Evolving-item XP — accrued server-side from confirmed kills/hits.
• Land ownership — resolved from the chain.
• Arena matches — HP, the winner, and the escrow payout.
• The day/night clock and weather — one shared sky.

Your own inventory, position, and wallet keys stay on your device. If the server goes away, you seamlessly drop to offline solo play (local creature simulation, local item progress) and reconnect automatically when it returns.

19.Economy & Fees

• RXD (Radiant) is the in-game currency for purchases, land, and wagers.
• Marketplace creator split: when an item sells, the value splits 90% to the creator / 5% treasury / 5% dev — creators keep the lion's share (the treasury funds events and airdrops).
• Network fees: every on-chain action (mint, trade, claim, settle) pays a small Radiant transaction fee in RXD.
• No custody: the game never holds your items or coins — trades and payouts settle directly on-chain between players.

20.Tips, FAQ & Troubleshooting

Tips

• Go Survival (G) for the real loop; gather wood → make a crafting table → tools → mine up the tiers (stone → iron → radiant).
• Eat before your hunger empties — healing needs a full belly.
• Build and shelter at night, or arm up: night brings hostiles.
• Equip an evolving weapon early and fight — it gets stronger the more you use it, and a leveled item is worth more on the market.
• Mine Radiance Crystal with an iron pickaxe and smelt it into Radiant Gems for the best gear.

FAQ

• Do I need crypto to play? No — the whole sandbox (build, survive, farm, fight, explore) is free and works offline. RXD is only for owning/trading on-chain items, land, and arena wagers.
• Are my items really mine? Yes — on-chain Glyphs are owned by your wallet, not the game. You can trade them peer-to-peer at any time.
• What can a leveled item do? See Evolving Items: more damage/defense/durability, and a higher on-chain value.

Troubleshooting

• Black screen / won't connect: make sure you're using localhost:5180, not 127.0.0.1.
• "No RXD UTXOs at your address": your wallet is empty — fund the deposit address (B) before minting/trading.
• On-chain action does nothing: on-chain features need a network connection (a Radiant indexer); in pure offline sandbox they're unavailable.
• Performance: large worlds do a lot of meshing on load — give it a few seconds, and lower the render distance / post-FX in Settings (O) if it's heavy.

21.Glossary

• RXD / Radiant — the blockchain and its coin; GlyphGalaxy's currency.
• Glyph — a Radiant on-chain token. NFTs (unique items), FTs (stackable), mutable NFTs (evolving items), containers (collections).
• Mint — create a Glyph on-chain (e.g. inscribe a build as an NFT).
• Photon — the smallest unit of RXD.
• WAVE name — your on-chain player name (e.g. alice.rxd).
• Plot — a 16×16-block parcel of land you can claim and own.
• Evolving item — a weapon/armor/pet that gains XP, levels, and on-chain state.
• Escrow (2-of-3) — the arena's stake-holding multisig; pays the winner, refunds on abandonment, never lets the server take funds.
• Authoritative server — the server is the source of truth for the world, mobs, combat, and arenas, so play is fair.
• Radiantia — GlyphGalaxy's first continent.