◊ Lost Pixel Gems — Guide

• 🏙 Lost Pixel City — walk the 3D city of gem portals (first/third person).
• ⛓ Explore — on-chain explorer: gems, owners, live transactions.
• 🧬 Digital Life — the R3 living-gems app: gems evolve with real data (CERN, weather, quakes).
• 🎮 Game — interactive pixel-art game.
• 🧊 Voxel — 3D voxel viewer.
• ✏ Editor — the full voxel editor (below).
• 🌍 Public Voxel Map — the LPG map: walk the world as a pixel, place your models free.
• 👑 Owners · 💬 Chat · ✍ Creative Process · ↗ Metaverse · 🛰 DEV · On-chain

• Add T — place a voxel · Erase R — delete a voxel · Paint G — recolour a voxel
• Draw single voxels V — click/drag single voxels
• Fill a face plane F — flood-fill the clicked coplanar surface (extrude/erase)
• Fill a box volume B — drag a rectangular prism to fill/clear
• Draw / Paint / Erase line L — continuous: keep clicking to chain segments, Esc/right-click to finish
• ▦ Fill plane at depth — fill the whole grid slice at the clicked depth
• 🪣 Fill the void — 3D bucket-fill of the connected empty region you click
• 🎯 Pick — click voxels to select them (click again to deselect), then Del to remove — the easy way to delete elements
• Grow / Shrink the surface · Stamp a square/circle · Erase a sphere
• Wand by colour W · Wand by shape J · Marquee K · Move the selection M
• Play mode P — walk your model (gravity, collisions)
• ⛽ Live gas reader — a badge (top-right) shows the network gas price live. Click it to estimate your model's weight (voxels · KB) and the cost to save it as-is (in ETH & USD, at live gas), and whether it fits one transaction.
• 💾 Save (Lands) — opens a modal with the viable quality versions, each with size, gas and live mint cost; preview in a separate window; the save uses a real gas check so it never fails for lack of gas.

• ✏ Pencil B — draw single pixels/freehand · ▧ Eraser E — clear to transparent; both with adjustable brush size + Mirror X
• 🪣 Fill / bucket G — flood-fill an area (tolerance) · ▚ Dither fill D — flood-fill with an ordered Bayer trama pattern (colours 1 & 2)
• ▒ Dither BRUSH — a mono-tone trama brush: drag to paint a 50% ordered-dither stipple in the current colour · 🌈 Gradient bucket — fill an area with a smooth colour ramp
• ╱ Line · ▭ Rectangle · ◯ Ellipse — draw straight lines and outlined/filled shapes in the active colour
• 💉 Eyedropper I — pick a colour off the canvas · 🔁 Replace colour — swap one colour for another everywhere
• 🔤 Text T — write pixel text with 3 bundled pixel fonts (Minecraft, Determination, Deltarune); adjustable size + Fit width to canvas; type live on the canvas and click to stamp in the current colour
• ▒ Inverted-trama brush — the mono-tone dither brush also paints an inverted ordered-dither stipple (the negative of the trama), for quick anti-aliased edges and shading counter-textures
• ⛶ Select / marquee M · 🪢 Lasso — freehand selection · 🪄 Magic wand W — select by colour · ✥ Move V — move the selection or the whole image, freely in & out of the canvas (Enter commits, Esc cancels) · ✋ Pan
• Layers — add, duplicate, ▲▼ reorder, merge-down, opacity and show/hide; imports and AI results arrive as their own layers
• Animation timeline (onion skin) — frames, FPS, loop, ping-pong, with prev/next ghosted, plus 📄 Copy frame (clones the canvas + all layers into a new frame). Every frame is now fully INDEPENDENT — a copied frame gets its own layers & pixels, so edits never leak to any other frame.
• 🎚 Animation Equalizer — a per-frame mixer: set each frame's timing in ms and its transition (hard-cut ▸ or crossfade ⇄) independently, for precise, uneven-timed animations and smooth fades.
• 🧊 Voxelize — send the current art straight to the Voxel editor as a 1-voxel-deep plane, ready to extrude or place on-chain.
• Palettes & colour wheel — add colours, build a palette from an image, export .hex, plus a chromatic colour wheel in a draggable pop-out window for PC & mobile
• 🤖 AI image generator — text → image (Pollinations, free), optional snap-to-palette, added as a new layer; you can also feed a reference image and the result arrives as its own new layer
• Import images — RESIZE the canvas to the image, or ADAPT the image into the current canvas (keeps aspect ratio); also drag-drop images onto the canvas as collage layers
• 🧩 Collage board mode (top bar) — opens an expanded board around the framed canvas. Pull frames, selections & images out as free windows you can drag, resize (corner) and paint (✏/▧/🪣) in the space outside the canvas. Everything auto-saves to cache and exports together as one Board PNG. Double-click a window to recover it into the canvas as a layer. Separate from ⬆ Import (which still imports straight into the canvas).
• Grid & ruler guides — pixel grid plus RED/GREEN (X/Y) guides every 8px, inside a neon canvas frame (external glow contour)
• Export — PNG (x1–x64), sprite sheet, animated GIF, animated SVG, static SVG (pixel-perfect vector), JSON meta, .lps project; web sizes up to 8K at nearest-neighbour (lossless)
• 🔁 Full round-trip (.lps / PNG / SVG) — every export embeds the whole editable project, so re-importing a .lps, PNG or SVG restores every layer, frame, palette & setting exactly as you left it — the file is the save.
• 📲 Installs offline as a PWA — add Lost Pixel Studio to your home screen / desktop and use the full editor offline, like a native app.
• ⛽ Live gas tracker — shows the current Ethereum gas price in the top bar
• 🏛 Mint on-chain — mint the current frame into LOST PIXEL LEGACY (LPLART), a fully on-chain ERC-721 where the exact SVG is stored on Ethereum mainnet (no IPFS). Metadata: art name + 3 traits (Artist, Description, Portfolio). Cost 0.0001 ETH + burn 1 PIXEL; multi-wallet (MetaMask/Rabby/Coinbase…); any art is auto-fit into one transaction (palette auto-reduced just enough if very detailed); live gas estimate, wallet sets the final fee. Contract 0x8419…C0ea ↗
• ❔ Opening tour — an automatic step-by-step tools tour runs on first open; reopen it any time with the ❔ Guide button

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.

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 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:

• 🏙 Lost Pixel City — On-chain city of gem portals — explore & build.
• 🏘 Lost Pixel Lands — The voxel citadel — fly through the 111 on-chain parcels.
• 🌍 Public Voxel Map — The shared 8000×256 world — walk it as a pixel, place models.
• 🟦 L2 · Base Map — Map 2 on Base: heavy full-fidelity models, alongside Map 1.
• 🎮 Game — Interactive pixel-art game.
• 🎨 Lost Pixel Studio — Pro pixel-art editor: layers, onion-skin timeline, palettes, collage board, PNG/GIF/SVG export & on-chain mint.
• ✏ Editor — Voxel editor — build & save your model on-chain.
• 🎨 Build your Land — Browse the 111 parcels live on-chain, then build yours.

• ↗ Metaverse — Back to the immersive home.
• 💬 Chat — Lost Pixel Gems community chat.
• 👑 Owners — Collectors, holdings & burns.
• 🌊 Claim PIXEL — SPIXELS: weekly random PIXEL airdrop for holders.
• 🗂 Collections — V1 · V2 · BOT · ABS collections with collectors & ranks.
• ⛓ Explore — On-chain explorer: gems, owners & live transactions.
• 🧭 My Assets — Everything you own on-chain — jump to your parcels.
• 🧬 Gems R3 — Living gems that evolve from real-world data.

• ✍ Creative Process — The creative process of D.C.O.T.
• ✦ Guide — Detailed desktop tutorial for Lost Pixel Studio & the Voxel Editor + every tool. (this page)
• 🎮 Tutorial — Step-by-step walkthrough guided by LPC-BOT.
• 🏦 Claims Pool — LPP: claim your ERC-20 & ERC-721 allocations.
• 📚 Docs — Full docs: manuals, contracts, architecture, economy & L2 Base.
• 🛰 DEV · On-chain — On-chain verification of every contract + the roadmap.

• Create free — no wallet, no subscription. Build in the editor, add to the map for free.
• Keep = burn — making a construction permanent burns PIXELS (deflationary).
• Own a gem (V1) → own an editable room; V1 owners add models to the shared map.
• Map controls — Walk as 1/4/8 pixels, pick a sector, Shift sprint, Space×2 double-jump, V first/third person, ☔ rain toggle, ⚙ quality.

• 🖼 Clickable NFT frames — every artwork frame is now clickable: it opens an in-page info card with the piece's name, 🎨 creator, collection, and links to its marketplace & explorer page.
• 👤 The station's Collector — each station shows its Collector (the wallet, or their ENS name when set).
• 𝕏 Collector frame — the 𝕏 frame opens the collector's X profile and shows their profile picture right in the city.
• 🏛 LPLART GALLERY — a permanent domed annex behind the arches with 10,000 frames that auto-index every Lost Pixel Legacy (LPLART) mint, 100% on-chain. Reach it via 🗺 Map → 🏛 LPLART GALLERY.
• 🌌 Maya-constellation sky + pixel rain — the city runs a living sky of Maya constellations with falling pixel rain and sunrise/sunset colour cycles.
• 🔄 Autonomous on-chain gallery sync — the city keeps itself in sync with the chain: new mints, edits and collectors appear on their own, no backend.

• 1 · Build in the editor. For your first mint keep it small (a 32³ box = the cheapest gas and burns just 1 PIXEL).
• 2 · Mint — press 🎨 Mint this model as NFT. A window shows a preview, your PIXELS balance, your owned NFTs, and how many PIXELS this size burns. Name it (permanent — can never be changed), then 🔥 Burn PIXELS & mint. Your voxels + name are written to Ethereum forever.
• 3 · Place — after minting, click 🗺 Choose location & place on the map. Drag your model to a free cell (green = taken; each position is unique) and seal it — this burns 1 more PIXEL.
• 4 · Visit — hit 🌍 visit your place on the canvas to teleport in front of your parcel on the public voxel map.
• Move it later — only the position is editable (burns 1 PIXEL per move) from map-claim or My Assets. The name and design stay immutable forever.

• What it is — a separate collection, Lost Pixel Vox Land (LPVL): 111 fully on-chain 250³ voxel parcels. If you hold GEM V1 #N you claim LAND #N for free (only mint gas) on the Claim page.
• Edit it forever, with no limit — the owner opens the Voxel Editor (via ✏ Edit a Land I own), reshapes the parcel however they like, and hits 💾 Save — the model is written fully on-chain (SSTORE2). You can re-save as many times as you want; each save bumps a permanent on-chain version and only you (the token owner) can edit your land.
• The map is a live reader of the 111 lands — the Lands map reads each parcel's voxOf() straight from the chain, so the moment your save confirms, your changes show up in the map (and in the 3D viewer & NFT metadata). Un-edited parcels show the default house.
• 🔁 Contract migration (important) — the first Lands contract had a storage bug that made saved models come back empty (the transaction succeeded and charged gas, but nothing persisted). It has been replaced by a fixed, verified contract. What you do:
  • The old contract is frozen (no more claims/saves there).
  • On the Claim page, each of your lands is labelled 🔁 migrate (you held it on the old contract) or 🆕 claim (new). Press Claim — both are free (only mint gas) and land on the fixed contract. Your GEM #N still maps to LAND #N.
  • Then edit & Save — now it persists permanently and unlimited.
  • Nothing needs to be "copied": models never persisted on the old contract, so migrating is simply re-claiming for free.
• The contracts (Ethereum mainnet): LPVL (canonical, fixed) 0x75C3…ae52 ↗ · old (deprecated, frozen) 0x52B0…4757 ↗.

• What are PIXELS? — LPGR token #2 (on Etherscan ↗). They are the deflationary fuel of the map: minting burns them by size (32³→1, 64³→2, 128³→3, 256³→6) and placing/moving a model burns 1. Burns are permanent (sent to 0x…dEaD). See the live burn meter in Explore.
• Do I need to be an owner? — No. Anyone who owns and burns PIXELS can mint and place. Only deploying/config is the deployer's.
• Is it really fully on-chain? — Yes. The voxel bytes, the name, the position and the owner all live in the contracts; the public map rebuilds the world by reading them — no database. EVM is the visual engine.
• Can I edit my model after minting? — Only its position (1 PIXEL per move). Name + design are immutable forever, by design.
• The mint didn't pop up / "gas too low". — That means the transaction would revert: you don't hold enough PIXELS, or the model is very large (storing lots of bytes on-chain costs a lot of gas — keep it small). The mint window now tells you the exact reason.
• The contracts (Ethereum mainnet): Lost Pixel Assets 0xa079…b51B ↗ · Voxel Map · Genesis Map 1 0x5134…dad3 ↗.

• 1. Build in the editor → hit ⬚ Hollow & optimize to strip hidden interior voxels (same look, far cheaper).
• 2. Press 🎨 Mint this model as NFT. The window shows a live preview: voxel count, size class, colour swatches, the on-chain size (KB) & estimated gas, and your PIXELS balance.
• 3. Give it a permanent name (immutable forever). If it's a heavy model you tick a box to accept the gas — you can mint anything if you consider it worth it.
• 4. Approve the PIXELS burn once, confirm in your wallet → your .vox + name are written to Ethereum. It appears in Explore with a live thumbnail.
• 5. 🗺 Save it to the map → pick a free cell (the picker is 1:1 with the 8000×256 map) → seal it (burns 1 PIXEL) → get a shareable link to your parcel.

• Two things get burned/paid: PIXELS (LPGR #2, the deflationary fuel) and Ethereum gas (paid to the network in ETH).
• PIXELS by size (minting): 32³ = 1 · 64³ = 2 · 128³ = 3 · 256³ = 6. Sealing or moving a position = 1 PIXEL (flat).
• Gas = data. Fully on-chain means every voxel byte is written to Ethereum. More voxels → more gas. The mint window shows the estimate before you sign; your wallet quotes the real market fee.

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

• The map is a game protocol. The public voxel map is not a database — it reads the VoxelMap contract live and rebuilds the world. The EVM is the visual engine; anyone can read it and build their own client (open SDK, MIT).
• Walk & teleport. Explore as a 1/4/8-pixel avatar; open a shared link ?tp=x,z to teleport straight to a model's parcel. Minters share their spot with the world.
• Unique positions. Every cell is unique — first to seal it owns it. Name & design are immutable forever; only the position can move (1 PIXEL).
• Two ways to place: On-chain (permanent, sealed in the contract, burns 1 PIXEL) or the free off-chain "raw" export (needs the site's backend) for drafts.
• Lost Pixel City stations. Own a GEM V1 → own a portal-station; auto-populated with your real NFT collection (read free from Blockscout). Only you (verified by ownerOf + wallet signature) can edit its 5 frames (4 NFTs + your 𝕏 profile) and its title. Each frame is clickable for an info card (name · 🎨 creator · collection · marketplace/explorer), the station shows its Collector (wallet or ENS), and the 𝕏 frame opens their X + profile picture. A permanent 🏛 LPLART Gallery (🗺 Map → 🏛 LPLART GALLERY) auto-indexes every LPLART mint across 10,000 on-chain frames, under a Maya-constellation sky with pixel rain.
• Anyone can play. No allow-list to create — own and burn PIXELS and you're in. Only deploy/config is the deployer's.

• 🧊 LOST PIXEL GEMS ASSETS (LPGA, ERC-721) — 0xa079…b51B ↗. Your voxel NFTs: the .vox + name live on-chain; tokenURI renders an on-chain SVG + interactive HTML. Minting burns PIXELS by size.
• 🗺 VOXEL MAP · Genesis Map 1 (Protocol) — 0x5134…dad3 ↗. The public map stored 100% on-chain (owner + position + voxels per cell). Placing seals a unique spot (burns 1 PIXEL). New maps = new deployments (Map 2, 3 …).
• 🟦 LOST PIXEL GEMS BASED ASSETS (LPGBA, ERC-721, Base L2) — 0x77e9…8522 ↗. The parallel asset contract on Base (creator picks L1 or L2 per model): mints the model 100% on-chain at full fidelity, frozen — burns PIXEL by size + 0.0001 ETH (proven cross-chain by an EIP-712 voucher).
• 🟦 LOST PIXEL GEMS · MAP 2 (Protocol, Base L2) — 0xe2bf…37A7 ↗. The separate Map 2 (1:1 voxel scale, like Map 1): place your minted LPGBA optionally, whenever you want (burns 1 PIXEL). Asset ≠ map, exactly like L1.
• 🔥 PIXELS (LPGR token #2, ERC-1155) — 0x6912…548 ↗. The deflationary fuel; burned to 0x…dEaD to mint & place (on L1 and, via voucher, for L2).
• 🏦 LOSTPIXELPOOL (LPP, ERC-20/721 pool) — permanent claims pool. The admin funds it and assigns per-wallet allocations (one by one or by CSV); holders claim their share. Open ↗
• 🌊 STREAMING PIXELS (SPIXELS) — a weekly PIXEL reward faucet for GEMS/BOT holders. Open ↗

• THE LOST PIXEL GEM (ERC-721) — the open mint: 10,000 supply · 4 rarities, launching Aug 14, 2026. Contract 0x1214…287b ↗ · OpenSea ↗. Mint from the movable MINT window on the home (live countdown).
• LOST PIXEL GEMS V1 (LPG, ERC-721) — the genesis 1/1 gems. Each has a portal room in Lost Pixel City. Eligible for the weekly PIXEL stream.
• LOST PIXEL GEMS V2 (LPGNTRCTV, ERC-721) — the interactive off-chain edition. Also eligible for the weekly PIXEL stream.
• LPC-BOT (ERC-721) — Lost Pixel City bots. Eligible for the weekly PIXEL stream.
• LOST PIXEL GEMS ASSETS (LPGA, ERC-721) — the voxel models you mint in the editor; fully on-chain, placeable on the map.
• PIXELS (ERC-1155, id 2) — the utility/fuel token: burned to mint & place, and the reward streamed to holders.
• Travelers / Residents / Mutants (Base) — the alternate Lost Pixel City project collections (see the Travelers page).

• Create — design a voxel model in the editor and mint it fully on-chain (LPGA). Your art & name are immutable forever.
• Build the world — place your models on the public voxel map; walk it as a pixel. It's one shared, collaborative on-chain world.
• Display — every V1 gem has a portal room in Lost Pixel City where you exhibit your real NFT collection.
• Earn (airdrops) — hold a gem/bot and claim the weekly PIXEL stream; receive admin pool allocations (see rewards below).
• Verify — everything is on-chain and public: read the contracts on Etherscan, cross-check on Blockscout, see the full spec in WEB3-PROTOCOL.md ↗.

• 🌊 Weekly PIXEL stream (SPIXELS) — if you hold a GEMS V1, V2 or LPC-BOT, you can claim once per week a fully random 1–11 PIXEL reward. Nobody wins more than 11 in a week. Weeks are counted from the contract's deploy; eligibility is checked live, so it always uses the current owners. If only 1 PIXEL is left, the first to sign gets it. It runs forever while the pool holds PIXEL — button: 🔥 Claim weekly PIXEL supply. A global claim ranking is shown live.
• 🏦 Claims pool (LPP) — the admin (dcot-deployer.eth) can airdrop any ERC-20 or ERC-721 to a configurable allow-list of wallets (one by one or by CSV). You claim your allocation on pool.html. Allocations never expire.
• 🗺 Map rules — an object can be placed at most 11 times, models can't overlap on the same layer (stack vertically instead), and you can re-position your own placement for 1 PIXEL.
• ⛽ Costs — minting burns PIXELS by size (32³=1, 64³=2, 128³=3, 256³=6). Placing/moving on the map burns 1 PIXEL. You always pay only network gas + the PIXEL burn.

• 𝕏 @LPC_NFTS — official Lost Pixel City / Lost Pixel Gems news, mints & drops.
• 𝕏 @dcot15 — the artist, D.C.O.T.
• 💬 Community chat · 📚 Docs hub · 🛰 DEV · On-chain