biocraft documentation
biocraft is a browser-based, first-person, co-op voxel game. you drop into a living voxel world, mine and place blocks, fight off escalating waves of enemies, and claim plots of land that you can develop and own. it is fps meets voxel sandbox meets territory you actually own.
it is free to play and runs entirely in the browser - no download, no signup to start. play solo or together in a shared, real-time co-op world.
the core promise: claim a plot, build it up with blocks and pre-made structures, defend it through waves, and own it as a real solana nft you can keep or sell. your time and creativity become a developed, tradeable piece of the world.
02the vision
most games rent you a world. biocraft is building a persistent voxel world where players don't just play, they own and develop real territory.
a claimed plot is a genuine onchain asset - a solana nft held in your own wallet, not a database entry we can revoke. the land you build, defend, and develop is yours to keep, show off, or sell.
the world is shaped by the people in it. every structure raised, every plot claimed, every territory developed is the work of a player. the most developed land is visible to everyone, from a distance, by its glow. the long-term goal is a living, player-built, player-owned world that keeps growing as more people claim and develop it.
03getting started
jumping in takes seconds:
- go to biocraft.bet
- click play free
- you are in. no wallet, no signup required to start playing.
optional: sign in to save progress
you can play entirely as a guest. if you want your progress to persist across sessions and devices, sign in with discord, google, or a solana wallet. signing in with a wallet is also what lets you mint your land onchain (see onchain land).
first steps
- pick a spawn biome - forest island (calm start), snow island (frozen peaks), desert canyon (copper dunes), or bio zone (spore towers).
- customise your character - body colour, trim and visor, helmet, and a name.
- drop in from the staging deck and start mining, building, and fighting.
04controls
biocraft plays in first person with mouse look. the full control reference:
movement
| W A S D | move |
| mouse | look |
| shift | sprint |
| space | jump - hold in the air to use the jetpack (once unlocked) |
| G | fly mode (space up, shift down) |
| T | third-person camera |
| esc | release the mouse / pause input |
combat
| left-click | fire |
| scroll wheel / ` | switch weapon |
| tab | aim down sights (toggle) |
| V | melee |
building
| F | place block |
| R | break / mine block |
| 1 - 9 | select block from the hotbar |
| Q / E | cycle the block palette |
| L | line tool |
| B | fill tool |
| X | cancel the pending line / fill |
| Z / Y | undo / redo |
land, templates & ui
| C | claim the plot you are standing on |
| shift + C | release a plot you own |
| H | open the templates picker (or use the templates button) |
| R | rotate a template 90° while previewing it |
| M | open the territories leaderboard |
| K | cinematic camera mode (scripted flythrough) |
| P | toggle the fps meter |
05combat & weapons
four weapons, each unlocked by level. only unlocked weapons appear in your in-world selector (scroll or ` to switch).
| weapon | unlocks | damage | fire rate | range | role |
|---|---|---|---|---|---|
| pulse rifle | level 1 | 18 | 0.09s (full auto) | 240 | fast, accurate starter |
| scatter gun | level 2 | 13 × 8 pellets | 0.55s | 46 | close-range shotgun spread |
| heavy lance | level 4 | 88 | 0.72s | 320 | slow, heavy-hitting, scoped |
| rail sniper | level 7 | 100 (×2 headshot) | 1.25s | 600 | bolt-action, 4x scope, near one-shot |
a rail-sniper headshot deals double damage - enough to one-shot even a brute. its scope also pushes the haze back so the distant swarm is visible and hittable.
jetpack & aiming
- jetpack (unlocks at level 3): hold space in the air to thrust upward. fuel is limited and recharges while you are on the ground.
- aim down sights: tab toggles aiming, which zooms in. scoped weapons (heavy lance, rail sniper) get a scope vignette.
waves
enemies attack in escalating waves. each wave runs through a build phase (a telegraph banner and countdown, with arrows showing the directions the attack is coming from), a swarm phase (the fight), and a brief cleared regroup beat before the next, bigger wave. surviving a wave banks xp.
waves come from the land and from the sea - sea-borne waves arrive by enemy ships sailing across the water. enemies range from fast swarmers to heavy brutes (which can drop rare loot).
the horde mind
after wave 5 is cleared, a server-wide boss awakens: the horde mind. an eight-second full-screen warning, then a giant entity towers over the island and advances on everyone, slowly but unstoppably.
it has a shared 3000-hp pool and shifts through three attack phases as its health drops - slam and charge, then biomass projectiles, then ground stomps - moving faster with each phase. it is host-authoritative and shared: every player online is fighting the same boss.
defeating it rewards every player online: +500 xp and a horde core - a legendary block you can build with.
06missions & leveling
you gain xp two ways: per-action (repeatable, so leveling continues forever) and one-time mission bonuses for working through the objective ladder in order.
per-action xp
| swarmer kill | 2 xp | enemy kill | 4 xp |
| brute kill | 15 xp | survive a wave | 25 xp |
| collect a drop | 3 xp | claim a plot | 20 xp |
the mission ladder
| # | objective | reward |
|---|---|---|
| 1 | survive your first wave | +50 xp |
| 2 | claim your first plot of land | +75 xp |
| 3 | kill 25 enemies | +120 xp |
| 4 | collect 5 drops | +100 xp |
| 5 | reach wave 5 | +150 xp |
| 6 | build a tower 10 blocks high | +130 xp |
| 7 | survive a sea-borne wave | +180 xp |
| 8 | kill a brute | +160 xp |
| 9 | claim 3 plots of land | +200 xp |
| 10 | collect a rare drop from a brute | +250 xp |
the level curve
cumulative xp to reach each level: L2 = 150, L3 = 350, L4 = 650, L5 = 1000, then a flat +200 per level after that (L6 = 1200, L7 = 1400, and so on). early levels are quick so the first unlocks feel reachable.
the unlock tree
| level | unlocks |
|---|---|
| 1 | pulse rifle |
| 2 | scatter gun |
| 3 | jetpack |
| 4 | heavy lance |
| 5 | land plot cap → 4 |
| 7 | rail sniper |
| 10 | land plot cap → 5 |
| 15 | land plot cap → 6 + gold helmet |
your plot cap is 3 until level 5, then 4 (level 5), 5 (level 10), and 6 (level 15).
07land ownership
the world is divided into a grid of square plots, each 32 × 32 blocks. owning land is the foundation of biocraft.
claiming a plot
- stand on an unclaimed plot and press C to claim it. claiming is free.
- the land readout (bottom of the screen) shows the plot you are standing on and whether it is unclaimed, yours, or someone else's.
- press shift + C to release a plot you own.
plot cap
how many plots you can hold scales with your level: 3 (levels 1-4), 4 (level 5), 5 (level 10), 6 (level 15).
what owning land means
your land is protected: only you can build or break blocks on a plot you own. other players cannot edit your land. claiming first wins, and your claims persist with your account. owned land is also what you develop (see development & tiers) and, with a connected wallet, what you can take onchain (see onchain land).
08onchain land
this is what makes biocraft land yours for real. when you claim a plot with a connected wallet, a plot nft mints to your solana wallet.
a real solana nft
- the plot is minted as a standard solana nft on mainnet (via crossmint), held in your own wallet.
- it is verifiable onchain and fully yours - keep it, build on it, or sell it.
- each nft carries the plot id, its biome, and its world coordinates as metadata, plus the biocraft land artwork.
how to mint
- connect a solana wallet - sign in with your wallet (phantom) in the lobby, or connect one from the onchain land panel. your wallet address is read from your session.
- claim a plot. with a wallet connected, the free mint request is sent automatically.
- the mint confirms onchain asynchronously - about 30 seconds. the in-world readout shows "minting onchain..." and updates to confirmed once the nft exists, with its real solana mint address.
- you can also mint your existing offchain plots from the lobby's onchain panel.
selling & trading
because it is a normal solana nft, you can list it on any solana marketplace (such as magic eden or tensor) for any price you set. you can sell a plot you have built up and developed, or keep building.
verify it
a real minted biocraft plot, verifiable on solscan:
GcBqTcFeFGbSbxvR4JNeGsK9bf4xfwGmudMmpy3SvVEV
collection (crossmint, solana mainnet): f8aff43c-057a-498a-a4d4-d5e7d3bf6e29
09building & templates
free-form building
place and mine blocks one at a time: F to place, R to break. pick from a large block palette (1-9 to select, Q/E to cycle), draw straight rows with the line tool (L), fill boxes with the fill tool (B), and undo or redo with Z/Y. you can build on unclaimed land or land you own.
templates
building block-by-block is powerful but slow. templates let anyone make something impressive instantly: press H (or the templates button) to open the picker, choose a structure, and a translucent ghost shows where it will land. R rotates it 90°, a click stamps every block at once, and esc or right-click cancels.
the 12 starter structures:
- defensive: rampart wall, watchtower, fortress, gatehouse
- bases: cottage, bunker, compound
- showcase: monument, stepped pyramid, build platform
- functional: sniper tower, bridge
each is built from the game's own blocks so it matches the world's look. templates can only be stamped on land you own - the ghost turns red and placement is blocked if the footprint would fall on land you don't own. stamped structures are normal blocks: they sync in co-op, persist, and can be edited or broken afterward (the whole stamp is a single undo step).
10land development & tiers
plots level up based on how developed they are. every owned plot accrues a development score, and the score maps to a visible tier.
the score
+ distinct block types × 15
+ height above terrain × 8
+ structures stamped × 75
+ waves defended on the plot × 50
+ minutes held (capped at 120) × 2
building more raises it, variety beats spamming one block, taller builds score more, stamping a template adds a chunk, defending waves on your land counts, and simply holding a plot adds a small passive amount.
the six tiers
for reference: one stamped cottage reaches tier 2, a fortress reaches tier 3, and tier 5 is a real grind of building, variety, defense, and time.
visible signals
- border glow - a developed plot's outline glows brighter and shifts colour by tier (dim slate → teal → bright cyan → lime → gold) and grows taller. you can spot a developed plot from a distance.
- tier badge - the land readout shows "tier N: name" for any plot.
- leaderboard - press M (or the territories button) for "top territories": the most developed plots in the world, by rank, owner, tier, and score.
tiers are shared and persisted - every player sees the same tier and glow on a plot, and your land's development carries with it.
11the flywheel
biocraft is a loop. each step feeds the next:
why it matters: your time and creativity translate into a real, owned, tradeable asset. you are not grinding for points - you are developing territory that is genuinely yours, visible to everyone, and the world itself is built and developed by its players.
12accounts & saving
sign-in options
- guest - play immediately, no signup.
- discord or google - link your progress to an account.
- solana wallet - sign in with your wallet (this is also what enables onchain land).
what persists
when you are signed in, biocraft saves your character (name, colours, helmet), your xp and level, your mission progress, your land claims, and your land's development. these carry across sessions and devices.
land claims tie to your identity, so the plots you own follow your account. a guest's progress can carry over to a wallet when you sign in, so you do not lose what you built before connecting one.
13faq
is it free?
do i need a wallet?
what does it cost to claim land?
is my land really mine?
can i sell my land?
do i lose progress if i leave?
can i build without placing every block?
how do plots get more valuable?
what is the collection address?
f8aff43c-057a-498a-a4d4-d5e7d3bf6e29. you can verify an example minted plot on solscan.