◊ 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.

• 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.

• 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.
• 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 ↗

• 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.