◊ Lost Pixel Gems — Guide

How to use every app, page and tool across the project. Art by D.C.O.T. and every contributor.

📚 Full documentation hub: every manual, contract spec, architecture note, economy & deploy guide — read them all at docs.html (the same Markdown that renders on GitHub, also in the .zip).
💎 NEW · THE LOST PIXEL GEM — an open mint, 10,000 supply · ERC-721 · 4 rarities, launching Aug 14, 2026. Mint from the movable MINT window on the home (drag it anywhere, close it, it's mobile-friendly, with a live countdown and the interactive voxel-TV art). Contract 0x1214…287b ↗ · collection on OpenSea ↗. Follow launch news on 𝕏 @LPC_NFTS ↗.

🌐 The ecosystem — one multiverse, many collections & chains

Create, Play, Collect, Live and Share — everything built from pixels. Lost Pixel is a single fully on-chain pixel-art multiverse spread across three chains, where the collections interoperate: a key on one chain unlocks land on another, a resource earned in a faucet fuels mints everywhere, and a gem you own can become your body inside the city. Nothing lives on a private server — art, traits, animation, lands and game state are stored on-chain.

Two families, by who makes the art: 🎨 Community = art open to creators (you make it with the editors) · 💠 D.C.O.T. = art authored by the creator.

CollectionByChainWhat it is
🎨 Lost Pixel Legacy (LPLART)Community🔷 Ethereum L1Open to creators — draw pixel art in the Pixel Editor and mint it, exact SVG on-chain. OpenSea ↗
🎨 LPG Assets (LPGA) + MapsCommunity🔷 L1 / 🟦 BaseOpen to creators — build a 3D model in the Voxel Editor, mint it on-chain (burn PIXEL by size) and place it on the Map.
🎨 PIXELGEMS (POOLGEMS)Community🔷 Ethereum L1Open to creators — the rewritable interactive 3D gem you mutate in the Voxel Editor / .FUN. Deflationary & fusable. Becomes your avatar in the city.
💠 LPCG — City GenerationsD.C.O.T.🟣 Robinhood11,104 pixel warriors — the $LPCG playground: on-chain Chess, a playable voxel map and an Explorer.
💠 LPCG MEMESD.C.O.T. + collabs🟣 RobinhoodCurated meme drops (invited community-artist collabs), mint only for LPCG holders. Explorer & Drop Studio ↗
💠 CARDS-LPGD.C.O.T.🔷 Ethereum L1On-chain collectible cards (POOLGEMS Burning Card, Mutation Card), minted on Transient ↗.
💠 GEM V1 + Vox Lands (LPVL)D.C.O.T.🔷 Ethereum L1The access keys: own GEM #N → claim LAND #N, a fully on-chain editable 250³ parcel. 111 supply, complete.
⛽ PIXELS (LPGR)Fuel🔷 L1 / 🟦 BaseThe deflationary fuel earned free weekly at the Streaming faucet, burned to mint in every community collection.
🔀 The mutation process (PIXELGEMS)
  1. Mint / own a POOLGEMS gem (the original 10,000 GEM is burned 1:1 to claim the on-chain PIXELGEMS of the same id + 6 PIXELS).
  2. Earn PIXELS free each week at the Streaming faucet (GEMS V1/V2 & LPC-BOT holders).
  3. Open the Voxel Editor or the .FUN Mutation Lab and burnPixels to grow your gem's voxel capacity (24 base + each PIXEL burned), then rewrite its art, traits & animation — unlimited times, each save bumps an on-chain version. Gems are fusable.
  4. Your mutated gem is a live 3D NFT you wear in Lost Pixel City · Live — as your body or on top — plus equippable wearables (crown, wings, aura…) that every player sees on you in real time.
🧭 Migration guide (Lands & gems)
🔗 Interoperability — how the pieces connect

The apps & pages

Voxel Editor — tools (what each does)

Lost Pixel Editor — tools

🖥 Desktop & PC — full step-by-step tutorial

🎨 Lost Pixel Studio — from blank canvas to on-chain art
  1. Open it from the menu → 🎮 Play → Lost Pixel Studio. On first run an automatic ❔ tour highlights every tool; you can replay it with ❔ Guide in the top bar.
  2. Set the canvas — click ✦ New and pick a size (16² · 32² · 64² · 128², or a custom W×H). The framed canvas centres itself with a neon contour.
  3. Navigate — mouse-wheel zooms toward the cursor, space+drag or middle-mouse pans, and the fit button re-centres. The +/− buttons zoom in fixed steps.
  4. Pick a colour — use the chromatic wheel + H/S/V sliders in the left panel, type a hex, sample the canvas with the 💉 eyedropper I, or open the 🎨 draggable colour-wheel window from the top bar. Set a 2nd colour for the dither & gradient tools.
  5. Draw — ✏ Pencil B / ▧ Eraser E (adjust brush size + Mirror X), 🪣 Fill G, ▚/▒ Dither D/K, 🌈 Gradient J, shapes ╱ Line L · ▭ Rect U · ◯ Ellipse O, and 🔤 Text T (3 pixel fonts).
  6. Select & transform — ⛶ Marquee M, 🪢 Lasso Q or 🪄 Magic-wand W, then ✥ Move V (freely in & out of the canvas). Enter commits, Esc cancels, Del clears.
  7. Layers & frames — build up in the right-panel Layers (add / duplicate / reorder ▲▼ / merge / opacity / hide). Animate in the bottom timeline — add frames, set FPS, loop/ping-pong, and 🧅 onion-skin to trace neighbours. Copy frame gives each frame its own layers & pixels — fully independent, edits never leak between frames.
  8. 🎚 Fine-tune timing — open the Animation Equalizer to set each frame's ms and its transition (hard-cut ▸ or crossfade ⇄) individually.
  9. 🧩 Collage (optional) — toggle Collage in the top bar to get an expanded board around the canvas; pull frames/selections/images out as draggable, paintable windows (auto-cached), and export them together as a Board PNG. See the Collage line above.
  10. 🤖 AI (optional) — type a prompt; a free image is generated and adapted to your canvas, optionally snapped to your palette and added as a new layer.
  11. Export — ⬇ Export → PNG (×1–×64) · sprite sheet · animated GIF · animated SVG · static vector SVG · 🧩 Collage board · JSON · .lps project; lossless web sizes to 8K. Every .lps / PNG / SVG embeds the whole editable project — re-import one to restore every layer, frame, palette & setting. Or 🧊 Voxelize to hand the art to the Voxel editor as a 1-voxel plane. The whole Studio also installs offline as a PWA.
  12. 🏛 Mint on-chain — mint the current frame into LOST PIXEL LEGACY (LPLART): the exact SVG is stored on Ethereum mainnet, no IPFS. Fill name + Artist/Description/Portfolio, connect any wallet, pay 0.0001 ETH + burn 1 PIXEL; very detailed art is auto-fit into one transaction and your wallet shows the final gas.

⌨ Every keyboard shortcut (PC): B pencil · E eraser · G fill · D dither · K dither-brush · J gradient · L line · U rect · O ellipse · I eyedrop · C replace · T text · M marquee · Q lasso · W wand · V move · H pan · [/] brush size · Ctrl+Z/Ctrl+Y undo/redo · Space+drag pan.

✏ Voxel Editor — build & save a 3D land
  1. Open it from the menu → 🎮 Play → Editor, or from a parcel you own via ✏ Edit a Land I own. Orbit with drag, zoom with the wheel.
  2. Build — Add T places a voxel, Erase R deletes, Paint G recolours. Work fast with Fill face F, Fill box B, Line L (continuous — Esc/right-click ends), ▦ fill plane, and 🪣 fill the void.
  3. Select & edit — 🎯 Pick voxels then Del, or Wand by colour W / by shape J, Marquee K and Move M. Grow/shrink the surface, stamp squares/circles, erase spheres.
  4. ⛽ Check the weight — click the live gas badge (top-right) to see your model's voxels · KB, the cost to save it as-is (ETH & USD at live gas), and whether it fits one transaction.
  5. 💾 Save on-chain — the Save modal lists viable quality versions (size · gas · live mint cost), previews in a window, and uses a real gas check so it never fails for lack of gas. The model is written fully on-chain (SSTORE2); each save bumps a permanent version and only the token owner can edit their land.
  6. 🎮 Play mode P — walk your model with gravity & collisions before you mint.

🖱 The menu — every button & its hover tooltip

The menu is identical on the home and every page (desktop right-rail / mobile hamburger). On desktop, hovering a button shows a neon tooltip — here is the exact text of each:

🎮 Play 🤝 Community 📚 Hub

How the world works

🏙 Lost Pixel City — explore, collect & the LPLART Gallery

🧊 Mint & place on-chain — step by step

🏘 Lost Pixel Vox Land — claim, migrate & edit

❔ On-chain FAQ

🪙 How to mint a new model

⛽ Gas & costs — what you actually pay

Model sizeOn-chain costGuidance
≲ 3,000 voxelsa few M gascheap ✅ (ideal)
~10,000 voxelsheavyworks, higher fee — you accept it
40k–86k+ voxelsmay exceed the block limitsplit into pieces, or the wallet may reject

Tip: Hollow & optimize + smaller builds = dramatically cheaper. The wallet always chooses the gas by the live market.

🎮 How the world works (game mechanics)

📜 The on-chain contracts (protocol)

🪙 Token types in the ecosystem

✅ What you can do — for the community

🎁 Rewards & rules

🤝 Follow & connect