How VENDWORLD works

Overview

VENDWORLD is a social vending-machine tycoon game. There are exactly 2,222 Genesis machines, each an ERC-721 NFT minted for free on OpenSea. Holders place their machine on a street plot in Neo Sakura City, keep it stocked, collect City Credits from simulated customers and upgrade it over time.

The NFT is your machine's identity and ownership. To put it on the map you burn VEND, the city's token. Once placed, it earns a share of an hourly VEND reward pool. Everyday play (stock, sales, credits, levels) runs on our servers, so it's fast, cheap and fair.

Quick start

1. Get a machine. Mint from the official OpenSea drop (link announced on this site) or buy one on the secondary market.
2. Get VEND. After mint-out, VEND launches with the world. Buy 10,000 VEND per machine you want to place.
3. Open the city. Go to World. Wallet connect opens at launch; until then press Play the demo to get 3 sample machines and test VEND. At launch you'll sign a login message, which costs nothing and grants no permissions.
4. Open your Backpack. Your machines appear there. Press Place.
5. Pick a glowing plot. Hover to compare traffic and rivals, then confirm and approve the 10,000 VEND burn in your wallet.
6. Play the loop. Collect the coin bubbles above your machine, restock before it empties, recharge its energy and claim your VEND from the Rewards panel.

No machine yet? Choose Play the demo to run three sample machines in your browser with a test VEND balance.

Controls

Cities & plots

There are four cities. Each is a grid of blocks in six district types, surrounded by forest (or snow) on three sides and water on the fourth. Every block is ringed by a sidewalk, and the sidewalk tiles (except the corners) are plots: 7,920 in total, far more than the 2,222 machines, so there's always a choice. Travel between cities with the Cities button.

District types

Each city uses the same six district types under local names, with the same base traffic:

Plot rules

• One machine per plot, one plot per machine.
• Plots are game licences, not separate NFTs. You don't buy land.
• When you sell your machine, its placement goes with it to the new owner.
• Roads, buildings, parks, the beach and the water can't hold machines.

Core loop

Traffic & rivals

Each plot has an effective traffic score. It starts from the district's base traffic and is adjusted by today's event, whether your machine's card collection is hot today, and how many machines are nearby.

So a Downtown corner with 12 neighbours (−42%) can sell less than a lonely Residential corner. The placement screen shows every number before you confirm.

Sales simulation

Customers are simulated. Every tick, the engine works out how many items each placed machine sells.

Stock and City Credits

• Each sale earns 5 City Credits (CC) and 1 XP, held in the machine until you collect.
• Restocking costs 2 CC per item. Capacity starts at 20 and grows 8 per level.
• Every sale has a 4% chance to drop an upgrade part.
• Offline progress catches up for at most one game day, so a machine left alone will stall rather than pile up forever.

Upgrades

Each level adds capacity (+8 items) and sales demand (+12%), raises your machine's reward weight (1.0x at level 1 up to 15.0x at level 10) and changes its look: a rooftop sign from level 4, a neon pink sign from level 7 and a gold star at level 10.

City Credit and parts costs are prototype values and will be rebalanced after the beta. A higher weight gives a bigger share of the pool, never a fixed number of tokens.

Relocation

• Moving a placed machine to another free plot burns 3,000 VEND.
• Cooldown: one game day (24 game hours) between moves.
• You can preview any plot's traffic for free before deciding.
• Stock, level and pending credits move with the machine.

Events & day/night

Every game day the city council runs one event that multiplies a district's traffic by ×1.5: Office Rush (Downtown), Mega Sale Weekend (Plaza), Noodle Night (Ramen Street), Block Party (Residential), Sakura Festival (Park) or Cargo Week (Harbor). Three card collections are also hot each day and sell ×1.3 faster. Check Hot Items in the city.

A game day lasts about four real minutes in the demo. At night the city darkens, street lamps glow and your machine's screen lights up its corner.

Weather

Each city has its own climate, and the weather changes every six game hours (the same for every player): rain and the odd storm in Neo Sakura City, mostly sunshine in Coral Cove, snow and blizzards in Frostpeak, and frequent neon rain in Neon Bay. The current weather shows next to the clock. Weather is visual only and does not change sales.

The VEND token

VEND is the power that runs Neo Sakura City. You burn it to put your machine on a street, and once it's live your machine earns VEND every hour from the season reward vault. Burned VEND is destroyed for good; rewards come only from a pool that was funded in advance.

Launch timeline

1. Mint. The 2,222 Genesis machines mint for free on OpenSea (gas only).
2. Mint out. When the last machine is minted, the 48-hour countdown starts and is shown on this site.
3. Token launch. VEND goes live and the liquidity pool opens on a DEX. The official contract address is posted here and on our socials at the same moment.
4. World opens. Holders connect, pick plots and burn VEND to place. Plots are first come, first served, but nobody can take a plot that's reserved to you mid-transaction.
5. Season 1 starts. The first 30,000,000 VEND reward vault is funded and hourly rewards begin for every placed machine.

How VEND moves

Getting VEND

• Buy it on the DEX. You need VEND before your first placement. Swap for it in the official liquidity pool (link published at launch).
• Machine rewards. Every placed machine earns an hourly share of the season vault. See Place-to-Earn.
• From other players. VEND is a normal token, so it can be sent wallet to wallet.

Simulated sales never create VEND. Every reward VEND was set aside in the vault before the season started.

Burning to place

Every machine needs a VEND burn to go live on the map. The burn happens inside the PlacementRegistry contract in the same transaction that claims the plot, so you can never pay without getting your plot, or get a plot without paying.

• The placement fee targets roughly $10 worth of VEND. At launch it is a fixed 10,000 VEND; the team can adjust it under a 7-day timelock as the price moves. The exact amount is always shown before you confirm.
• If the transaction fails or the 5-minute reservation expires, nothing is burned and the plot is released.
• Burned VEND is not refundable, including if you later move or sell the machine.
• When you sell your NFT, its placement, level and stock go with it. The buyer does not pay a new placement burn.

Place-to-Earn

Each season the reward vault is funded with a fixed amount of VEND and released evenly, hour by hour. Every hour's release is shared between all active machines in proportion to their weight. Your rate goes up when you level up, keep stock and stay charged, and goes down when more machines join or rivals level up.

Level weight

* Reference only: all 2,222 machines active with an average weight of 2.0 (total weight 4,444) and a location factor of 1.0. Your real rate depends on everyone else and is shown live in the game.

The other factors

Worked example

A Level 5 machine on a busy but crowded Ramen Street corner: weight 4.0 × 1.1 location × 1 uptime × 1 energy = 4.4. If the whole city's active weight is 4,444, it earns 13,889 × 4.4 ÷ 4,444 ≈ 13.8 VEND per hour, about 330 per game day. If it runs out of stock, that falls to about 3.4 VEND/hour until restocked. If the city's total weight doubles, every machine's rate halves.

Claiming

• Rewards build up as pending VEND on your Rewards dashboard: rate, pending balance, season remaining and history.
• Claim whenever you like; claims are batched on-chain through the RewardDistributor with proofs, so nothing can be claimed twice.
• Pending rewards belong to the wallet that owned the machine when they accrued. After a sale, future rewards go to the new owner.
• When a season's vault is used up, accrual stops until the next season is funded and announced. Rewards already accrued stay claimable.

Costs

Launch values. Any change is announced at least 7 days before it takes effect and never applies to a transaction already in progress.

Burn math

If all 2,222 machines are placed, 22,220,000 VEND (2.2% of supply) is burned by placement alone. Taking one machine from level 1 to 10 burns another 64,500 VEND. A season releases 30,000,000 VEND, so whether supply shrinks or grows in circulation depends on how much players burn versus claim. Both numbers will be shown live in the city.

VEND vs City Credits

The other assets: the Genesis NFT (ERC-721, 2,222 max) is your machine, and parts are off-chain upgrade items dropped by sales.

Supply & allocation

Rewards policy

• Every season publishes its vault size, length, weights, eligibility, wallet limits and anti-bot rules before it starts.
• Total rewards can never exceed what was deposited in the vault. Nothing is printed to top it up.
• Rewards are paid in VEND, not dollars. Displayed rates are estimates and change every hour.
• Simulated customers are fiction. Their purchases never fund payouts, and new players' placement burns never pay older players.
• No guaranteed APY, ROI, payback period, token floor or income, ever.

Token safeguards

Token FAQ

Traits & rarity

The Genesis collection is Pixel Genesis V2: 2,222 isometric pixel-art vending machines, drawn on a 128 × 128 pixel grid and exported at 1024 × 1024. Every machine has the same chassis, a red display with nine sample pixel-avatar cards, a roof crate and a traffic cone; the traits change its colours, trim, crate, lights and emblem. Every image is checked to be unique.

Rarity

The cards on the machines are sample pixel avatars made for VENDWORLD, not artwork from other NFT collections. Rarity is cosmetic at launch and says nothing about market value.

Reveal

Before the reveal, every token shares the same unrevealed look and no trait data is public. At the reveal:

1. Before mint opens, the team picks a secret seed and publishes only its SHA-256 hash (the commitment). The seed can no longer be changed.
2. After mint-out, the hash of a block mined after the last mint is taken. Nobody could know it when the seed was committed.
3. The offset is SHA-256 of seed + ":" + block hash, modulo 2,222. Token N gets artwork ((N − 1 + offset) mod 2,222) + 1. The city, the game and the site switch to the real artwork at once.
4. The seed is then published. Anyone can check that its hash matches the commitment and recompute the offset, so neither the team nor anyone else could steer which token got which machine.

The NFT metadata on OpenSea uses the same assignment, so a token's picture on OpenSea and its machine in the city always match.

Metadata

Genesis art and base metadata are uploaded to the OpenSea Studio drop and are not rewritten after reveal. Game state (level, district) is served separately by our API, so your original art stays immutable.

{
  "name": "VENDWORLD Machine #0224",
  "description": "Genesis vending machine in VENDWORLD. Game progression and earnings are not guaranteed.",
  "image": "ipfs://<CID>/0224.png",
  "external_url": "https://<domain>/machine/224",
  "attributes": [
    { "trait_type": "Collection", "value": "Pudgy Penguins" },
    { "trait_type": "Body", "value": "Lavender" },
    { "trait_type": "Chassis", "value": "Wide" },
    { "trait_type": "Rarity", "value": "Common" }
  ]
}

Architecture

The browser draws the city and talks to our API. The API and the game workers own all game state in Postgres. A chain indexer watches the contracts, so the API always knows who owns which machine. Only ownership and VEND burns live on-chain.

Wallet sign-in

We use Sign-In with Ethereum. You sign a plain-text message with a one-time nonce. It costs no gas, approves nothing and can't move your assets.

Placement flow

Placing is designed so two players can never grab the same plot. The server issues a short reservation with every quote, and occupancy is only committed once the server has verified the result.

Ownership sync

Smart contracts

Contract addresses will be listed here once deployed. The chain is still being chosen and must support OpenSea Drops.

Prototype status

The current world is a playable prototype. It shows the real map, rules and numbers, but some parts are stand-ins:

Security & fairness

• Server-authoritative game state; the browser only draws.
• Seeded randomness per machine and tick, so any result can be replayed in a dispute.
• Idempotent ticks and ledger entries: nothing is ever counted twice.
• Rate limits, bot detection and multi-wallet clustering checks.
• Contracts audited, admin keys in a multisig with timelocks, emergency pause limited to narrow functions.
• Chain reorg handling: occupancy is committed only after finality.
• No arbitrary seizure of NFTs, ever.

Risk disclosures