Wiki

World Structure

This page defines how ChonkyCraft should use Minecraft's 3D space.

Status: Planned

This page defines how ChonkyCraft should use Minecraft's 3D space.

The project should make the world feel tall, deep, layered, and alive.

Design Goals

  • Make the overworld feel like broad frontiers through large biome coverage
  • Make caves feel inhabited instead of empty ore corridors
  • Make the sky a real frontier with its own routes and threats
  • Make the Nether part of progression instead of a detached checklist
  • Add later otherworld spaces that still feel like playable terrain, not abstract nonsense
  • Keep the whole structure readable enough that players can learn it by playing

Overworld Readability

The overworld should not be fully random in progression feel.

Current direction:

  • Use large-biome-style regional scale so biomes read like places instead of tiny patches
  • Weight earlier landmarks and ore families closer to spawn
  • Weight stronger biome and ore families farther out
  • Let cave depth increase richness and danger inside each horizontal band
  • Keep noisy exceptions, teaser pockets, and locked landmarks so the world does not feel like perfect rings

This should behave like soft frontier bands, not a board-game map.

World Layers

The intended world stack is:

  1. Surface biomes
  2. Living cave biomes
  3. Deep cave biomes
  4. Low sky routes
  5. Nether frontier
  6. High sky frontier
  7. Otherworld realms

Current implementation note:

  • The permanent chonkycraft:adventure preset already owns sky_frontier, high_sky_frontier, shardwilds, and mirror_frontier so later layer unlocks do not require changing the world preset on an active save
  • Those future layers now also have first-pass dedicated biome identity through Frostroost and Twilight Prairie, instead of existing only as reused biome buckets
  • Those later layers now also have first-pass landmark destinations through Frostroost Roosts and Eclipse Gardens, so they are not just empty ownership space
  • The first staged access chain is now partly implemented through Starwell Ascents into Frostroost Roosts and Velvet Eclipse Courts into Eclipse Gardens, instead of leaving the later layers as landmark-only destinations
  • The owned-layer roster now also has dedicated late-biome landmark coverage through Updraft Perches, Sunveil Sundials, Glimmer Bowers, and Brand Fanes, so updraft_reaches, sunveil, glimmergrove, and cinder_reach are no longer just biome ownership plus ore content

Not every layer needs to unlock at the start.

Living Caves

Caves should feel like places with ecology and purpose.

Required cave qualities:

  • Distinct chamber types instead of endless similar tunnels
  • Route variety, with loops, drops, shortcuts, and hidden pockets
  • Local fauna, nests, hazards, and elite dens
  • Clear biome signatures underground, not only on the surface
  • Small underground landmarks that teach players where they are

Examples of cave content:

  • Spider brood chambers
  • Root-choked sinkholes
  • Underground ponds and marsh pockets
  • Crystal seams
  • Burial corridors
  • Raider storerooms
  • Fungal warrens

Boss-related worldgen should use these spaces on purpose:

  • some bosses should belong to a biome
  • some should belong to a cave layer
  • some should belong to a generated shrine, arena, or route endpoint
  • locator maps and quest hints should target those real places when possible

Cave Readability Rule

Alive does not mean cluttered.

Caves should be:

  • Dangerous
  • Rewarding
  • Visually distinct
  • Easy enough to read in motion

Avoid:

  • Overdecorated noise
  • Mazes that force constant map-checking
  • Too many interacting hazard systems at once

Sky Content

The sky should become real adventure space, not just a late novelty.

Low Sky

Early to midgame sky content should include:

  • Ballooned ruins
  • Wind bridges
  • Watchtowers
  • Nest islands
  • Weather-borne cargo wrecks

Low sky should be reachable before full flight through:

  • Grapnels
  • Jump mounts
  • Launch structures
  • Climb routes

High Sky

Mid to late game sky content should include:

  • Large floating landmasses
  • Storm shrines
  • Roosts
  • Starwell ruins
  • Air current routes

High sky should reward:

  • Better mounts
  • Relics
  • Rare materials
  • Traversal tools
  • Optional boss paths

Nether Frontier

The Nether should be part of the adventure ladder.

Its role should be:

  • A hostile traversal frontier
  • A source of heat-forged materials and danger-biased relics
  • A region that opens after the player already has stronger mobility tools
  • A place where route planning matters

Nether content should focus on:

  • Bastions and ruined corridors
  • Lava-route movement
  • Heat management
  • Stronghold hunts
  • Rare elite predators
  • Mount tack and relic materials that justify the risk

Avoid making the Nether:

  • Just a blaze-rod stop
  • Pure resource grind
  • Mandatory too early, before the player has enough movement tools

Otherworld Realms

Late progression can open new otherworld spaces.

These should be:

  • Overworld-like in readability
  • Strong in terrain identity
  • Limited in number
  • Worth remembering as places, not just loot tables

Examples of acceptable directions:

  • A storm-ravaged mirror frontier
  • A luminous fungal wildland
  • A shattered twilight prairie

These should not feel like:

  • Random dimension soup
  • Pure void platforms with abstract mobs
  • High-concept lore spaces with weak gameplay

Unlock Sequence

Current planning direction:

  • Start: surface and living caves
  • Early game: deeper cave language and local vertical shortcuts
  • Phase 03: first real low-sky access
  • Phase 06: stronger sky routing
  • Phase 07: Nether frontier opens alongside Worldshift pressure
  • Phase 13+: otherworld access begins through breaches and starwell systems

Traversal Support

To make the 3D world fun rather than annoying, the project needs:

  • Good early ladders, ropes, and route markers
  • Grapnel progression
  • Mount progression
  • Launch points and climb paths
  • Late pre-breach Wayshrines
  • Smart shortcuts inside major structures

Shelter Rule

The world should reward readable shelter building.

  • Homes should matter because weak entries can eventually be breached by hostile pressure
  • Fences, gates, doors, walls, and layered yards should all have real defensive value
  • Stronger materials should buy more time
  • Random mob grief should not be the main reason players fortify

Fun Rule

If the world is bigger and more vertical but not more fun to move through, the design failed.