Valheim

🗺️ Better Continents

BETTER CONTINENTS VERSION SERVER + CLIENTS

"The Allfather did not carve the Tenth Realm in a single stroke. With hammer and chisel, the jagged peaks were raised, deep fjords torn open, and ancient oceans poured into the abyss. Take up the chisel, Viking, and shape the continents to your will."

Paint a picture. Walk on it.

Better Continents is a total procedural and bitmap overhaul of Valheim's world generation. It gives world builders, server admins and cartographers complete control over the terrain: replace or augment vanilla's landmasses with your own heightmaps, biome layouts, location and spawn placement, and multi-layered noise.

Import a real map of the Earth, recreate Middle-earth, sculpt realistic mountain ranges, or carve an unforgiving archipelago for a hardcore campaign. Then keep going: worlds that reach 65 km from the centre, peaks 16 km high, lakes above the sea, whole towns baked into the ground, and any world, vanilla or not, exported back to pictures you can edit.


NEW IN 0.10.7

Your heightmap stays exact where you build, and the mountains get their jaggedness back.

You It
Keep Heightmap Override All on lowlands, meadows, plains, towns and canals stay exactly as the PNG says: no noise at all
Climb a mountain or walk the Deep North Valheim's own alpine fractal ridges, couloirs and micro-gullies (10 m and 2.5 m) and slope tilt, blended in at runtime: Mountain Noise (bc g mn <scale>)
Cross the Mistlands stepped terrace crags and sharp ridges: Mistlands Noise (bc g msn <scale>)
Walk down to the shore the noise fades with altitude, so coasts and low ground are never touched

🚫 Location exclusion mask · ❄️ A cold map for the Deep North · 🌊 Deep North and Ashlands water that follow your world · 📐 Sharper baked meshes · 🌐 Exports BetterWorlds reads as they are · 🖼️ An editor pack for Gaea and other terrain editors · 🔌 Upgrade World, Expand World Data and Expand World Size support · 🔄 bc regen filters · 📌 bc genloc pins

📖 Read the saga — the problem it solves

With Heightmap Override All = true, every metre of height came strictly from the PNG's pixels. At 4 m or 8 m a pixel, mountains lost all of Valheim's natural jaggedness and came out as smooth mounds or clay pyramids, unless heavy micro-gully detail was baked offline into huge 16k pictures. Turning Heightmap Override All off instead put the game's octave noise across the whole world, town squares, harbours and canals included.

Now the noise is gated by biome. Mountains and the Deep North get the alpine noise, the Mistlands get the crags, and everything else follows the heightmap to the pixel. Both default to 1, Valheim's own; 0 keeps them flat to the heightmap.


BEFORE YOU INSTALL

If… Then…
💾 you change versions back up worlds_local/<World> first.
🤝 you play on a server the server and every player run exactly the same Better Continents version; anyone else is refused when they join. A world without Better Continents has no check.
🖥️ you run a dedicated server it cannot create a Better Continents world itself: create the world in the game client, then copy its folder into the server's worlds_local/.
🧱 you ever remove Better Continents from a world with baked buildings run bc_bake unbake world confirm in it first.
↩️ you want to go back to an older version some worlds cannot: see Going back to an older version below.
📏 you run Expand World Size on a world past 16 km it and Wide Sectors never both run. A world saved with wide sectors is not loaded while Expand World Size's wider grid is in use: keep one of the two mods.
🧪 you try lakes, clearing or the editor pack they are experimental. Try them on a copy of a world first.
⬆️ you come from 0.9.x the worlds you already have keep generating as they did under 0.9.4; only worlds made with 0.10 get the new behaviour.
↩️ Going back to an older version — the worlds that cannot
  • A wide world: every world past 16,350 m made with 0.10.3 or later (unless Wide Sectors was Off), and any older one converted with Wide Sectors = On. An older Better Continents opens it as a world without Better Continents (vanilla terrain), and if an older version, or the game alone, saves it, its objects are written twice (two of every chest).
  • A world made with fine heights: 0.10.0 to 0.10.2 cannot read it and give it vanilla terrain.
  • A world read at a Heightmap Amount above 5 opens in versions before 0.10.3 without the high-terrain rules: on ground higher than 3,000 m a player counts as being inside a dungeon. A world whose High Terrain is On or Off opens in them as a world without Better Continents.
  • A compact world cannot be read by 0.9 (it gets vanilla terrain); every 0.10 version reads it.
  • A world with baked buildings needs 0.10.4 or later. An older Better Continents opens it as a world without Better Continents, and the game alone opens it without its layer: either way the baked pieces are neither drawn nor solid. The settings and the layer stay in the world's files, and a newer version reads them again.
  • A world with lakes or a clearing mask needs 0.10.5 or later. An older Better Continents opens it as a world without Better Continents (vanilla terrain). The settings stay in the world's files.
⬆️ Upgrading from 0.9 — what changes for old worlds and new ones

Every world stores a settings version in its BetterContinents file. A world made by 0.9.x is version 11 and follows the 0.9.4 rules; a world 0.10 creates is version 12, and each new-world behaviour below switches on only for it. A few changes reach every world and are marked "Applies too".

Not every world made in 0.10 is version 12: a world made from a preset of version 11 or older (the four presets that ship with the mod are version 7 files, and presets saved by 0.9.x are version 11), from an export of a world resized under 0.9.x or made under Expand World Size at another size, or with Override version 11 is version 11.

Behaviour Version 11 (made with 0.9.x) Version 12 (made with 0.10)
What the maps span 21,000 m, whatever World Size says 2 × (World Size + Edge Size), the land dropping away over Edge Size; 21,000 m at the default 10000 / 500
Heightmap Alpha (off by default) On: the heightmap is read as 8-bit grey, alpha unused. Off: 16-bit grey On: 16-bit grey with a 16-bit alpha, blended with the game's own terrain. Off: 16-bit grey
Biome precision up to 5 (cells of about 11 m); a higher value is stored but used as 5 up to 31 (cells of 2 m)
Expand World Data: altitude rules the maps' heights replace them (except where the rough map is white) they apply over the maps' heights, as over the game's own
Expand World Data: lava: true biomes (biome map, no heat map) only the Ashlands are hot they are hot too: lava burns and the Ashlands weather applies
Expand World Data: grounds a terrain legend naming one of its biomes reads as a bad colour (a warning, Meadows ground); precision's colour replaces a territory's the name becomes that biome's ground colour; precision keeps a territory's ground colour
Expand World Data: biomes on a biome map stored by number, so renumbering its yaml swaps biomes stored with their names and followed if the numbers move; a biome it no longer has reads as None
Location map pins at the corner of one pixel picked at random, up to a pixel south-west of where the other maps put it; shared colours dealt out at random on the pixel nearest the pin's middle; shared colours dealt out the same way every time. A world export's pins are still read at the corner
Start override and a pin in the same 64 m zone the pin wins and the start is dropped (0.10 logs an error) the start is placed first and the pin is dropped
Layout: alt-biome grid, location search, biome bands, Ashlands and Deep North rings, lakes, streams, minimap vanilla's; World Size only moves the game's edge scaled to the world when World Size or Edge Size is not 10000 / 500; the alt-biome Grid setting has no effect
The game's edge (kill zone, ship push-back, water edge) applies too follows each world's own World Size, applied again for every world loaded in a session
Expand World Size installed its size spans the maps and it lays the world out the same: its size wins over the world's own
Maps in memory applies too held as 128 × 128 tiles; a tile of one value (open sea) as that value
Compact Maps not available: a version 11 world is never compact as Compact Maps says when the world is made; the world keeps it for good
The world file saved as version 11, as 0.9.4 saves it version 12; 0.9.x reads it as version 11 and cannot read a compact one
Vegetation twin guard applies too in zones generated from now on, a plant is not placed within 1 m of the same kind of object already there
Water depth applies too a zone's water takes the depth of its ground when the ground is rebuilt in place (look and wave size only)
Zone regeneration after bc changes and on bc regen applies too runs in single player or on the host, in a world that uses Better Continents, with the world's own settings, so an older world edited with bc keeps its 0.9.x rules
Exporting a world applies too Default Heightmap Amount is 1 (was 2); heightmap.png records its Amount and Sea Level
A .bcworld file accepted by 0.9.x and 0.10 accepted by 0.10 only; 0.9.x refuses it as a bad header
BetterContinents.cfg applies too read as it is; its one-time changes touch only the file, never a world file

Most rows matter only when you use the feature. At the default World Size 10000 and Edge Size 500, with no Expand World Data, no Heightmap Alpha, Biome precision of 5 or less, no location map and no heightmap-fine.png, a version 12 world generates the same as a version 11 one. Nothing converts an existing world from 11 to 12; only Override version re-stamps one at a save, which is not recommended.

🔎 Which version is my world?
  • Read it. bc info (console, F5; bc needs devcommands and runs only on the host) prints Version 11 or Version 12 first; on a joined player's machine, with the Server Devcommands mod, it shows the settings the server sent. The BepInEx log (BepInEx/LogOutput.log) prints the settings, starting with that Version line, when a world loads, when a new world is created, on the server each time it sends the settings to a joining player with no cached copy, and on a joining player's machine when the server's settings arrive. A save prints nothing there (the game saves on a background thread whose lines never reach the file), though the world's BetterContinents file is still written at every save. A default-size version 12 world prints no "maps span" line, so read the Version line. The Esc-menu hint shows only the mod version and ENABLED or DISABLED. A world with no BetterContinents file in its folder is vanilla and has no version. A world from a much older Better Continents shows a number below 11 until it is loaded again after its first save.
  • From Config (no export folder): a new world is version 12, unless Override version says otherwise.
  • A preset file: the world gets the preset's version, saved as at least 11. A preset saved by 0.9.x makes version 11; one saved by 0.10 from a version 12 world (bc savepreset), or made by bc_import or an export, makes version 12 (11 by the export rule below). The four presets that ship with the mod (Continents, Pangaea, Swirls, Vanillaish) are old version 7 files, so a world made from one is version 11. They hold no map files and vanilla's size, where the two versions generate alike.
  • A Directory ([00 BetterContinents.Debug]): a folder with an export.cfg (a world export), and likewise bc_import and an export's own preset, gives version 12 when its maps span what its own World Size + Edge Size give, and otherwise version 11 (an export of a resized 0.9.x world, or one made under Expand World Size at another size; that one is rebuilt as it was only with Expand World Size installed at that size). A folder of maps you made yourself, with no export.cfg, makes a version 12 world. The same files give a slightly different world than 0.9.4 made from them (exact pins, start before pins, the alpha blend, finer precision, Expand World Data's rules); set Override version to 11 before you create the world to get the 0.9.4 result.
  • Override version ([00 BetterContinents.Debug], empty by default, for testing): a whole number of 11 or more is the version a From Config world gets. While set, it is also the version every world is saved in (only the preset bc_import or an export builds ignores it) and the one a host sends to joining players: 11 re-saves a version 12 world as 11, which loses what 12 added from its next load, and 12 re-stamps a version 11 world, so new zones follow the 0.10 rules and seams are likely where they meet old ones. A number below 11 writes the old fixed layout and drops data. It is read at every save, so editing it changes the next autosave of a loaded world. Leave it empty, on a server above all.
🔀 Mixing versions
  • Multiplayer. On a world that uses Better Continents, the server and every player must run exactly the same version of the mod, whatever the world's settings version: a 0.9.x player cannot join a 0.10 server and the other way round, and two different 0.10 releases refuse each other too. Players play the settings version the server sends, whatever their own config says. A player's cached copy of a version 11 world stays valid, so it is not downloaded again.
  • A version 12 world opened in 0.9.x is not supported: copy the world folder first. 0.9.x reads it as version 11 (maps spanning 21,000 m whatever World Size says, no layout, the heightmap's alpha read as 8 bits…), so zones generated from then on follow the 0.9.x rules: a world of non-default size can show seams, and the pins already in the world stay. Its next save writes it as version 11. A compact world cannot be read at all: 0.9.x switches Better Continents off for it and generates vanilla terrain that stays in the world, leaving the file alone. A preset saved by 0.10 loads in 0.9.x as a version 11 world (a compact one makes a world without Better Continents).
  • A 0.9.x world in 0.10 and back. With Override version empty, 0.10 writes a version 11 world's file exactly as 0.9.4 does, so the world opens in 0.9.x as before. BetterContinents.old beside the file holds only the save before the last.
📝 Your BetterContinents.cfg — what changed in it since 0.9

Your existing file is read as it is: every key keeps its name and section, and the new keys appear in it. Except where noted, a setting is a default for worlds you create afterwards; an existing world uses what it stored.

  • Compact Maps is now Auto / On / Off (Auto by default). An old true reads as On and false as Auto, and BepInEx writes On or Auto in its place at the next start.
  • Heightmap Amount now takes 0 to 81 (was 0 to 5), and Default Heightmap Amount 0.01 to 81. A Default Heightmap Amount of 2 (0.9's default) is set to 1 once, with a line in the log; set it back and it stays. The hidden Config Version in [07 BetterContinents.Misc] records the step.
  • New keys include Mountain Noise, Mistlands Noise, Ashlands Water and Deep North Water in [01 BetterContinents.Global]; High Terrain in [02 BetterContinents.Heightmap]; Location Exclusion Mask, Coldmap File and Coldmap Scale in [06 BetterContinents.Maps]; Max Map Size, Wide Sectors, Map Memory and Upgrade World Radius in [07 BetterContinents.Misc]; Largest Size in [09 BetterContinents.Export]; and every section from [10 BetterContinents.BakedPlacements] on.
  • Debug Reset Command is empty by default, because Better Continents regenerates the zones itself; the old default zones_reset start is set to empty once, with a line in the log that says how to go back.
  • Spawnmap File is only the creature spawn map: it is no longer moved into Locationmap File, and no spawnmap.png is renamed to locationmap.png.
  • A new file selects the preset Disabled; an existing Vanilla stays and still makes a world without Better Continents, with an error in the log.
  • Ranges: Start Position X and Y take -1,000,000 to 1,000,000 m (the config stopped at 10,500); Biome precision takes 0 to 31 (a version 11 world uses at most 5).

I

Shape mountains, cliffs and ocean trenches from a grey picture, up to 16 km high.

🌐 Heightmap the continental foundation and its coastlines; a 16-bit grey PNG for smooth slopes. Heightmap Amount 0 to 81 gives peaks up to 16,170 m
💎 Fine heights an optional heightmap-fine.png adds 8 more bits to every height, so a tall world's gentle slopes stay smooth
🏔️ High terrain worlds that go high get Better Continents' versions of the game's height rules, so terrain, weather and building keep working on a high mountain
🔆 Heightmap Alpha blend the heightmap with the game's own terrain: where a pixel is transparent, vanilla shows
⛰️ Rough map where it is white, the biomes' own rough ground shows through; where black, the heightmap stays smooth (with Heightmap Override All off)
🎛️ Blend modes Add, Multiply, Maximum, Minimum and Masked
⚡ Noise layers stack unlimited FastNoiseLite layers (Perlin, Simplex, Cellular/Voronoi, Value), each with its own frequency, fractal octaves, domain warping and mask
🌊 Sea level and continent size raise the sea to drown lowlands into archipelagos, or lower it to expose land bridges; Continent Size scales the noise layers' features (0.5 leaves them as they are; it never scales a heightmap)
📖 Read the saga — the numbers behind a heightmap

The formula. A pixel gives (pixel / 65535 * Amount - 0.15 + Lerp(1, -1, Sea Level Adjustment)) * 200 metres on the game's height scale, where the sea is at 30 m. At Sea Level Adjustment 0.5, Amount 1 (the default everywhere) spans -30 m to 170 m (60 m below the water to 140 m above it) and clips higher ground; Amount 81 spans -30 m to 16,170 m. Pure black is the deepest ocean, pure white the highest summit.

High terrain. The game's height rules were made for land under about 400 m. A world whose heightmap is read at an Amount above 5 gets Better Continents' versions: inside a dungeon then means more than 3,000 m above the ground below, not just above 3,000 m; the ground is found at any height; and the game's altitude limits of 1,000 m or more for plants, creatures, locations and grass are lifted (lower ones, such as the tree line, stay). Worlds read at 5 or less keep the game's own rules. High Terrain ([02 BetterContinents.Heightmap]; Auto, On, Off) gives them to every Better Continents world (On) or none (Off). Off costs a world with high ground: no grass above 500 m, no plants, creatures or locations above about 1,000 m, no terrain, weather or building above 3,000 m, and no ground found above 6,000 m. A new world keeps the mode it was made with; bc h ht changes it in a running world. The log says when the rules are on, and bc info says how high the world's land can reach.

Fine heights. heightmap-fine.png sits beside the heightmap: the same size, 8-bit grey, adding 1/256 of a 16-bit step to each height (24 bits in all). At Amount 81 a 16-bit step is 0.25 m, so it matters. A record inside names the heightmap's CRC-32, so it is used only with the heightmap it was made for (one with no CRC is trusted). A new world reads it unless Compact Maps is Off, and is then compact. When the file is there but not used, a Fine heights: line in the log says why. The world export writes it.

Heightmap Alpha on a version 12 world reads a 16-bit grey heightmap with a 16-bit alpha. A version 11 world keeps reading the heightmap at 8 bits with it on and ignores the alpha; with it off, every world reads 16-bit grey.

The detail heightmap (legacy) gives fine detail to worlds made by old versions of Better Continents; a new world gets its fine detail from height layers instead.


II

Forget vanilla's rings. Paint where every biome, forest, boss and trader goes.

🎨 Biome map a colour per biome: Meadows, Black Forest, Swamp, Mountain, Plains, Mistlands, Ashlands, Deep North. Islands of one biome, or gentle climate transitions
🎯 Biome precision ground textures, grass, vegetation and spawn points follow your borders inside each 64 m zone, on cells down to 2 m. Heights do not change; 0 is vanilla
🌸 Alt biomes paint where Valheim's 32 alt biomes go: Dark Meadows, Troll Black Forest, Fortress Mountain, Lox Plains and the rest
🌲 Forest map tundra clearings in the Black Forest, ancient woods across the Plains, even in biomes that are normally 100% forest
⛩️ Start temple the sacrificial stones and spawn exactly where you want them, anywhere within a million metres
💀 Bosses, traders, dungeons Eikthyr to the Queen, Haldor and Hildir, crypts: each on the pixel you painted
🚫 Location exclusion mask towns, roads and ruins where no random crypt, camp or altar may spawn, without cutting the world's quota
🗺️ And more maps spawn, vegetation, paint, lava, moss, heat and cold maps, each with its legend
📖 Read the saga — biomes, Expand World Data and precision

Biome precision from 1 to 5 splits every 64 m zone into a grid of up to 6 × 6 cells (11 m), instead of following the borders only at the zone's corners. A version 12 world goes on up to 31, a grid of 32 × 32 cells of 2 m.

Expand World Data biomes. Name the biomes Expand World Data adds in the biome map's legend (biomemap.txt) as its expand_biomes.yaml does, for example DeadWastes: 8B4513. Give each a terrain in the yaml (without one Expand World Data leaves its ground flat under water). Install Expand World Data wherever the world is played, with the same yaml, and add new biomes at its end: it numbers them in that order, and the world stores the number.

On a version 12 world, Expand World Data's altitude rules (a biome's or territory's altitude multiplier and delta, water depth, height limits and lava dip) apply over the heightmap's heights. With a biome map and no heat map (or Heatmap Scale 0), its lava: true biomes are hot where the biome map puts them; a heat map decides by heat. The terrain map's legend (terrainmap.txt) can name one of its biomes for a ground colour, and Biome precision keeps its territories' ground colours. The world saves the names of the biomes its biome map adds and follows them if Expand World Data renumbers them later: a biome it no longer has reads as None.

📖 Read the saga — alt biomes, forests and locations

Alt biomes. Paint an alt-biome map (altbiomemap.png) and list its colours in a legend (altbiomemap.txt). Every alt biome has a default colour, and the legend is written for you when it is missing. Every painted area becomes a region of its own: stack several alt biomes on one colour, keep an area free with none, or plant the region under a point with at x, z. Then choose how the game places the rest: at random on unplanted land (what you planted counts toward its limits), only what you planted, or none at all. A version 12 world's alt-biome grid covers the whole world, however big. Mode = Off means no alt biomes, not no grid: Valheim builds its grid for every world. Every package carries a palette for Krita and GIMP (BetterContinents.gpl) and a printable colour chart (altbiome-palette.png).

Forests. A forest map is grey: white is the most trees, black open clearings, with the default Forestmap Multiply 1 and Forestmap Add 1. With Forestmap Multiply 0, black leaves the game's own forest and the map only adds trees. Forest Scale sets the size of the game's own forest and clearing patches: 0.5, the default, is the game's own size.

Exact pins. On a version 12 world a pin on the location map lands exactly on its pixel, where the height and biome maps put it. A pin of several pixels lands on the one nearest its middle, and locations that share a colour are dealt out the same way every time. The start position is placed before the pins, so a pin in its zone cannot take it. A world made from a world export reads its pins where the export wrote them. Start Position X and Start Position Y accept -1,000,000 to 1,000,000 m.

The exclusion mask (no_spawns_mask.png or nospawns.png in the maps folder, or Location Exclusion Mask in [06 BetterContinents.Maps]): non-black pixels are off limits for random locations (burial chambers, sunken crypts, goblin camps, boss altars). Unlike Skip Default Locations, which removes every location, a rejected spot does not count against the quota, so the game places its full count elsewhere. The location map's own pins are never blocked.

Pictures. PNG is recommended; 2048 or 4096 px squares give excellent fidelity for a vanilla-size world, and maps up to 16,384 px are read. A map covers the whole world: 2 × (World Size + Edge Size) across, 21,000 m on a vanilla-size world and on every version 11 world.


III

Out to 65 km, with the maps, the layout and the save all following.

📏 World Size and Edge Size lay out the whole world, not only its edge: the maps span World Size + Edge Size, and the land drops away over the edge
🧭 Everything follows the alt-biome grid, location search, biome bands, the Ashlands and Deep North rings, lakes, streams and the minimap
🌍 Wide Sectors every zone out to 65.5 km gets its own place in memory and in the save, so far objects are not lumped together or lost
🧱 Maps in tiles maps are held as 128 × 128 tiles, open sea as one value: a world that took about 1.32 GB takes about 99 MB
🗜️ Compact Maps big worlds keep their maps compressed in memory, in the save and on the wire: five 16,384 px maps take 52.6 MB instead of 352.5 MB
🧠 Your machine's limits Max Map Size caps the pictures this machine reads; Map Memory caps what compact maps may take
📖 Read the saga — why big worlds needed Wide Sectors

Valheim files objects by zone only out to about 16.4 km from the centre. Past that, everything out there shares one list, which is sent whole to any player near it and saved as one file. Past about 22.1 km, a patch to the south-west is saved under the same file name as every portal in the world, so the two overwrite each other. Past 32.7 km east, west, north or south, each zone's creature spawner is moved to the 20 km line when the world saves, so after a restart those zones spawn no creatures of their own.

Wide Sectors ([07 BetterContinents.Misc]) gives every zone out to 65.5 km its own place, on the server and on every client (about 32 MB each), and saves the spawners where they are. Auto (the default) makes every new world past 16,350 m wide and leaves existing worlds alone. On also converts an existing big world when it loads, one way: the game first saves a copy of the old save (<world>_backup_<date and time>), a warning in the log names it, and damage already done is not undone. Off makes no new wide worlds; a wide world stays wide. The machine that runs the world reads the setting; a joining player's game follows the world.

What big costs. World Size + Edge Size can go up to 65,000 m (beyond 65.5 km objects share one list again). The real limit is start time and memory: every load builds a bigger alt-biome grid, on the server and on every client as it joins, about 0.2 GB at a radius of 16,350 m and about 0.8 GB and 25 s at 32,764 m. A 24,500 m world starts in about 18 s, and a 32,764 m world with five 16,384 px maps in about 16 s (measured on one 32-core machine). Set World Size to how far players will really go. bc info says when a world's maps follow World Size.

On a version 11 world, World Size only moves the game's edge (the kill zone, the ship's push-back, the water's edge), and the maps keep vanilla's 21,000 m.

📖 Read the saga — compact maps, max map size and map memory

Tiles, in every world. Every pixel map (heights, biomes, forest, spawns, paint, terrain and the rest) is held as 128 × 128 tiles, and a tile of one value is held as that value. Every value reads exactly as before. Measured on a real 10,501 px heightmap, forest map and biome map: about 99 MB instead of about 1.32 GB.

Compact Maps ([07 BetterContinents.Misc], Auto / On / Off): a compact world keeps its maps compressed, decodes each tile when first read, and saves and sends its maps compressed. Auto makes a new world compact when any map but the location and alt-biome maps is more than 8,192 px across, or when its heightmap has fine heights; On makes every new world compact; Off none (with a warning when a map is more than 8,192 px across), and heightmap-fine.png is then not read. It is read only when a world is made (From Config, bc_import, or a Directory's export.cfg), and a world keeps it for good.

Max Map Size (4096, 8192 or 16384 px; 16384 by default): the largest map this machine reads from a picture file, from the next read on. It is each machine's own and never part of a world. A bigger map is refused before it is read, with a line in the log, and the world is made without it. Maps a world has already stored are always read.

Map Memory (512 MB by default, 64 to 65,536): how much the decoded tiles of compact worlds may take on this machine. Past it, the least recently read tiles are dropped and decoded again when needed. It applies at once and does nothing for any other world. One 16-bit 16,384 px map is 537 MB decoded: for a 16k world on a server with memory to spare, use 1024 to 2048.


IV

A sea that knows your world: waves to the edge, calm in your north, red in your south.

🌊 Waves at any size Better Continents' own water: waves and white crests to the world's edge, and boats and swimmers feel the waves that are drawn
❄️ Your Deep North its calm sea, cold, blizzards and snow follow your Deep North biomes, or a cold map you paint
🔥 Your Ashlands the red, boiling sea follows your own Ashlands and heat map, not vanilla's southern circle
🏞️ Lakes above the sea (experimental) lakes with their own water level: swim in them, sail on them, see them on the map
🧹 Clearing (experimental) keep trees, rocks and bushes off roads, lake beds and other marked ground
📖 Read the saga — the water

The game's water shader knows two circles of a 10 km world, written into its code: a calm Deep North sea and a red Ashlands sea. Better Continents' own water reads the world's own rules instead. It keeps the game's look (colours, glare, foam), works in place on existing worlds, and the waves boats and swimmers feel are the waves that are drawn, on every machine and on a dedicated server. The far plane beyond the loaded zones is flat with the game's ripple texture, as in the game. It is on only in a world that Better Continents shapes and whose sea is not the game's; a vanilla world, and a world made without maps at the game's own size, keep the game's water exactly. If a graphics device cannot run it, or another mod has replaced the game's water shader, that player sees the game's water and nothing changes for anyone else. Own Water and Soft Far Sea are in [11 BetterContinents.Water], each player's own; bc_water explains what is drawn.

The cold map (coldmap.png, or Coldmap File in [06 BetterContinents.Maps]) is a grey picture: anything above black is Deep North cold, freezing weather, snow instead of cultivated ground, and calm water, multiplied by Coldmap Scale (default 10; bc cold sc <scale>). With no cold map, the Deep North's weather follows your Deep North biomes on the biome map. Deep North Water (bc g dnw <on|off>, on by default) makes the calm sea follow your Deep North or cold map; Ashlands Water (bc g aw <on|off>, on by default) makes the red sea follow your Ashlands and heat map. Both are in [01 BetterContinents.Global].

📖 Read the saga — lakes and clearing, from Tarn

Valheim has one water level, so every lake above the sea is a dry hollow. A world can now carry a list of lakes, each with its own height, and Better Continents fills each with the game's own water as you come near: you can swim in it, sail on it, and see it on the minimap and the large map.

The list is lakes.txt in the maps folder (Tarn's own format, so a map maker's file works as it is; tarn-lakes.txt is read too). It is saved with the world, sent to every player, and carried by export, import and .bcworld files. In game, bc_lake here fills the hollow you stand in up to just under its spill point, and bc_lake at <x> <z> does it anywhere.

A clearmask.bin (Tarn's .clear file) keeps trees, rocks, bushes and pickable debris off marked ground; it acts on zones generated after it exists, so make a new world or regenerate those zones.

Both come from Tarn, by Raven Iron (Wubarrk and NomadicWar), and both are experimental: they work in the tests and on test worlds, but details may still change. Better Continents reads Tarn's own files (BepInEx/config/Tarn/<world>.txt and .clear) once, when the world has no lakes or mask yet, and never writes to Tarn's folder. If the Tarn mod itself is installed, Better Continents' lakes and clearing step aside and say so. Settings are in [12 BetterContinents.Lakes]; Water and lakes, the easy guide has the whole story.


V

Turn any world, vanilla or not, into pictures. Edit them. Make a new world from them.

🗺️ Every map a 16-bit heightmap sampled the way the game builds terrain, plus biome, location, forest, heat, cold, alt-biome, lava, moss and ground-paint maps with their legends, the exclusion mask, and an export.cfg that loads them
🗂️ A preset every time each export also makes a New World preset, named after the world and the time, and a README.txt explaining every file
📐 1024 to 16,384 px with a size, memory and time estimate before you start
🌐 For BetterWorlds the folder holds what BetterWorlds needs to rebuild the same world
🖼️ Editor pack (experimental) the ground as a 32-bit float TIFF with masks, for Gaea, World Machine, Houdini or any editor that reads one; bc_import edited brings it back
🖥️ A window for it switch on Hud: F9 a status box, F7 a window with Export, Import and Bake tabs
⏱️ In the background it runs while you play, and a cancelled export removes its partial files and preset
📖 Read the saga — sizes, heights and what an export holds

Sizes. 1024, 2048, 4096, 8192 or 16384 px. Largest Size ([09 BetterContinents.Export]) sets the largest offered; the window hides bigger sizes and bc_export refuses them with a message.

Heights are encoded for Heightmap Amount 1 and Sea Level 0.5 unless you choose otherwise (Default Heightmap Amount, 0.01 to 81, or amount=): -30 m to 170 m on the game's height scale, with the waterline at 0.30 of the pixel range. That is the encoding a map made at Better Continents' default settings uses, so exports and such maps can be cut and pasted into each other. Higher ground is clipped, and the export says how many pixels. The exported heightmap.png records its Amount and Sea Level in a PNG text chunk; a new world that reads it at other settings warns in the log, and bc info shows the record.

Fine heights. fine=auto|off|4|8, or the Fine heights choice in the window. Auto writes 4 bits where one step of the heightmap is more than 1.5 cm, from an Amount of about 4.92; below that the folder is as it always was. heightmap.png is the same either way. After editing heightmap.png, delete heightmap-fine.png or export again.

For BetterWorlds (Wubarrk's other world-building mod), every export carries:

  • coldmap.png, the Deep North's cold map (16-bit grey, read back with Coldmap Scale 10), so a rebuilt world keeps the Deep North's weather, snow and calm sea. A world using its own cold map gets that map copied byte for byte, with its own scale. nocold or the window's Cold switch leaves it out.
  • no_spawns_mask.png, at the top of the folder and in sources/.
  • world.json (World Radius, Edge Size, Layout) and, in manifest.json, the keys settingsVersion, exportRevision, worldSize, edgeSize, layout, wideSectors, highTerrain, cold, fileBytes and locations.pinGrid. The format is still bc-export/1: every key is new, none changed.
  • An export.cfg that pins Mountain Noise and Mistlands Noise to 0 (the heights already hold that noise) and writes the world's Ashlands Water and Deep North Water, plus High Terrain when the rebuilt world would not get the same state from Auto. Crag detail finer than a pixel (the 2.5 m and 10 m features) is not carried over.
  • A heatmap.png exact for the game's own Ashlands test: above black exactly where the world is Ashlands.
  • A note in README.txt and the manifest when a map file is over 256 MiB, the most BetterWorlds takes for one file, and how BetterWorlds opens the folder (bw_import newest, or Import project).

The window. With Hud on, F9 shows a status box (the export's progress, the last export folder, and the map pixel you stand on) and F7 opens the window, freeing the mouse. Its Export tab lists every map with a line saying what it holds (point at one for more), all on by default, with the size, the Heightmap Amount and Sea Level, fine heights, the Cold switch and the Editor pack block, an estimate, and Start export; when it finishes it shows what the export came to (heights, clipped pixels, missing locations, the preset) with Copy the folder path and Open the folder. Its Import tab lists your exports, newest first: Make preset builds and selects a New World preset, Use as config loads it through BetterContinents.cfg and "From Config". The window is modelled on The Eye.

Where it goes. Every export gets its own folder, BetterContinents/<world>/export-<time>/ beside the game's worlds_local folder, never inside the world's save folder.

📖 Read the saga — the editor pack, and its honest status

bc_export 4096 editor (or the window's Editor pack block) also writes editor/: the ground as a 32-bit float picture (height.tif, and height.r32 if asked), masks for what a heightfield does not hold (water, slope, forest density, biomes, and a protect-locations mask to keep towns, dungeons and boss places as they are), editor.json, a README-editor.txt with your world's numbers, and probe.tif, a test picture that shows how your editor turns a file.

Sculpt or erode the height, save the result into editor/return/, and bring it back with bc_import edited: it makes a new folder, <export>-edited, whose heightmap.png and heightmap-fine.png carry the edited ground to about a millimetre on gentle ground. Every other map is copied unchanged, and the export itself is never changed. Then bc_import <export>-edited makes the preset. It reads float, 16-bit and 8-bit TIFF (uncompressed or Deflate), .r32 and 16-bit PNG, up to 16,384 px, and says what it did. The window's Import tab has an Editor return section with Bring it back.

Good to know. Biomes, locations, alt biomes, forest and paint do not move with ground you reshape: paint them in the PNGs, or edit around the protect-locations mask. Build in your editor with a Raw output range (a Normalized range changes the numbers, and the way back stops when it sees one). The pack's pixel grid can sit up to half a pixel from an editor's own; README-editor.txt gives the Height and Scale to set, and editor.json the alternative that keeps the pitch.

Honest status. The pack and the way back are tested with Better Continents' own loaders, but not yet with a real Gaea round trip: its row order, pixel registration and TIFF compression are unconfirmed (probe.tif shows the first, and the way back works out the turn by itself). The time and memory of a pack on a big real world are estimates until measured.


VI

Bake a whole town into the ground, and win back your frame rate.

🧱 Bake the pieces players built within a circle or box become part of the world's layer: drawn by every player, solid to walk on, no longer thousands of game objects
🚪 What stays real doors, chests, stations, beds, cooking fires, portals, wards, signs, anything that moves, kept as protected pieces nobody can damage or remove
🏘️ Town files a placements.bcp in the maps folder builds its towns into a new world: pieces, live pieces, ground, paint and cleared vegetation
↩️ Undo and unbake every change writes its undo file first; bc_bake unbake world is the way out
🌑 Shadows that keep up near shadows merged into a few shapes on the other processor cores, far ones drawn zone by zone
📖 Read the saga — how much it saves, and what it will never touch

The numbers. In a test village the objects within 128 m went from 7,984 to 2,472 (5,512 pieces baked). In the densest block of a 700,000-piece town the frame rate went from 45 fps as real pieces to 81 fps baked, and in the busiest view of a test town of 33 blueprint buildings from 38 to 63 fps, with about 350 MB of graphics memory for its shadows (measured on one machine). Baked meshes are written with full 32-bit float positions and normals for sharp edges and smooth shading.

The Town option also bakes comfort decor (tables, banners, rugs, plants; chairs and benches become seats you can still sit on), and torches and lanterns, which become lit copies that never need fuel. A baked piece gives no comfort and a baked light no warmth. Black marble and the other pieces the game turns at random bake, each with its own turn.

Never baked: anything that gives items. Bushes, mushrooms, flax, saplings and items on the ground stay the game's own.

Safe by design. Every change shows a dry run first and needs confirm. Every change writes its undo file before it changes anything, and a crash or a cut save is finished or taken back at the next load: no piece is ever lost, and none is both a real piece and a baked one. bc_bake undo puts back exactly what the last change took, bc_bake unbake turns baked pieces in an area back into real ones, and every change reports what it could not find.

Players download the layer when they join (a few MB for a whole town file, cached for next time), and a change made during play reaches them as a small patch before any piece is taken away. bc_bake load brings a newer town file into a running world; a container that holds items is never taken away. How far baked pieces are drawn, their shadows, lights and seats are each player's own settings, in [10 BetterContinents.BakedPlacements].

Baked buildings, the easy guide (BetterContinents-Baking-Guide.pdf) walks through it step by step.


VII

Change a setting, watch the world regenerate around you, keep everything players built.

🎨 World Architect a settings window in game: layer stacking, real-time height view, immediate regeneration
⌨️ The bc commands read or change any setting from the console, reload a map from disk, pin locations on the map
🔄 Zone regeneration after every change, the world's zones regenerate by themselves, except around what players built or worked, tombstones and other players
👯 Vegetation twin guard a zone filled twice never gets two copies of one plant on one spot; bc_twins finds and removes the doubles a world already has
🧭 Map mods the minimap is finished before other mods see it
📖 Read the saga — Debug Mode and zone regeneration

Debug Mode ([00 BetterContinents.Debug], off by default) is for editing a world's settings live. In a world that uses Better Continents, on the machine that runs it (single player or the host), it turns devcommands on when you spawn, shows "Better Continents Debug Mode Enabled!" at the top left, and adds a Better Continents button to the Esc menu and the large map that opens the settings window (Alt+F8 does the same while the Esc menu or large map is open). It does not reveal the map, though most bc changes do, as they redraw the minimap. Leave it off for a world you play.

Every generated zone is reset, except the zones within one zone (the 3 × 3 around) of something a player built, a tombstone, ground a player has worked (fields, paths, roads, levelled or dug ground), or you inside a dungeon. A player connected from another machine keeps the zones their game has loaded around them (5 × 5 with the game's default, never less than 3 × 3), checked as the work goes. A location reaching into several zones is kept or regenerated whole. Players, what players built, tombstones and tamed animals are never removed. Crops are kept with their field; a tree a player grew from a sapling counts as the world's. Each reset zone generates again, locations included, when someone comes near.

The ground follows the new settings everywhere, kept zones included; edits made with the hoe, cultivator or pickaxe ride on the new ground. Lowering the ground under a base leaves its pieces in the air, and the game breaks unsupported pieces a few seconds later (in a test, a workbench and floor left about 3 m up were gone 8 seconds later); raising it buries them. Make big height changes before you build, or away from what you want to keep.

The work is spread over frames, with progress lines in the console. A change rebuilds the loaded terrain once first, a stall of about 1.6 s; bc regen alone changes no ground. A world saved mid-way saves emptied zones as not generated, and a location is never saved half cleared. A location whose zone generates during the work can end up half placed or placed twice; bc regen again sets it right. It runs in single player or on the host, only in a world that uses Better Continents. Debug Reset Command is empty by default; a console command written there (for example Upgrade World's zones_reset start) runs instead.

📖 Read the saga — vegetation twins, and map mods

Twins. The game fills a zone with trees, bushes and rocks from the world seed, the zone and each plant's name. A zone filled a second time over its own objects (a command that fills zones again, or a save put back together from mismatched files) gets everything doubled. In every Better Continents world, a plant is not placed within 1 m of the same kind of object already in its zone, or placed by another entry in the same pass. It changes vegetation only, in zones generated from now on. One entry never blocks itself, so vanilla's densities stay; where two entries place the same prefab, a second plant within 1 m is dropped, so such a zone can hold fewer plants than before. bc_twins removes doubles a world already has: the copy nearest the ground stays, and nothing a player built is ever removed.

Map mods and no-map worlds. The minimap is finished before the game hands it to other mods (still drawn on several cores; the loading screen waits for it). ZenMap's cartography tables and admin map show the real land and sea. Mods that show the map only at a table or on parchment, or give admins their map back, get the finished map on every join. Any mod that reads, copies or restyles the minimap when it loads sees the finished map.


THE TOOLBOX

First ten minutes: open BetterContinents-Guide.pdf from the package → put your maps in a folder and point Directory at it → New World, pick From Config in the Better Continents box → F5, devcommands, bc info → or skip the maps: walk into any world and type bc_export.

Key Command
F5 console bc info the world's settings and version
F9 export status box (with Hud on) bc regen regenerate zones, or a part with dry, biome=, min=…
F7 export, import and bake window (with Hud on) bc_export · bc_import world to maps · maps to a preset
Alt+F8 settings window (Debug Mode, from the Esc menu or large map) bc_cache share a world's settings as a .bcworld file
bc_bake · bc_lake · bc_twins baking · lakes · doubled vegetation
📥 Make a world from an export — four ways, easiest first
  1. Pick the preset. Main menu → Start Game → your character → Start → New World; pick the export's preset (<world> <date> <time>) in the Better Continents box, and press Done. The preset is a copy of the folder as exported: it keeps working if you move or delete the folder.
  2. After editing the PNGs, bc_import. In the console (F5), in the main menu or a world: it remakes the preset from your newest export as it is now, and selects it. bc_import list numbers every export; bc_import 3, bc_import <world> or bc_import <folder> picks one, including any folder of maps you made yourself. The window's Import tab does the same with buttons.
  3. To keep editing, the config. bc_import <number> config copies the folder's export.cfg into BetterContinents.cfg (your old file is kept beside it) and selects "From Config", so every new world reads the PNGs as they are at that moment. Pasting export.cfg at the end of BetterContinents.cfg yourself does the same, with no restart. export.cfg lists Override version (empty), so one you had set is cleared.
  4. Or point Directory at the folder, and create the world with "From Config": the folder's export.cfg comes with the maps and wins over your own settings for the keys it lists (the log lists what it changed).

A world that already exists keeps the maps it was created with. For step-by-step instructions written for first-timers, see BetterContinents-Export-Guide.pdf in the package.

🖼️ Round-trip through Gaea or another terrain editor
  1. bc_export 4096 editor (options: editoronly, eformat=tif,r32, eunit=v|metres — metres also writes height-metres.tif — eamount=auto|<0.01..81>, esize=<128..Largest Size>, emasks=default|all|none|<list>, eprotectpad=, eprotectfeather=).
  2. Load editor/height.tif in your editor with a Raw output range; check probe.tif for how it turns the picture.
  3. Sculpt, then save into editor/return/.
  4. bc_import edited [<number> | <folder> | <world>], with unit=, range=lo,hi, amount=auto, sealevel=auto, orient=auto|none|flipy|flipx|rot180|transpose|antitranspose|cw90|ccw90, ering=keep|gaea, fine=8|4|off, files=<path>, size=<n> and preset if needed. bc_import edited help lists them; bc_import edited cancel stops it.
  5. bc_import <export>-edited makes the preset.
🌱 Let players skip the download on a huge world

bc_cache export writes the world's settings and maps as a shareable .bcworld file plus a .txt description into BetterContinents/<world>/ (on the host or a dedicated server, this world's settings; on a client, your cached copy of the world you are in). bc_cache list shows what is cached. A player who runs bc_cache import <file> joins with no download at all. Better Continents also imports every .bcworld it finds under BepInEx/plugins/ (recursively) or in BepInEx/config/BetterContinents/seed/ when it starts, so a mod pack that holds nothing but a .bcworld file pre-seeds every player who installs it. Ids already cached are skipped, never overwritten, and the id comes from the file's content, never its name. A .bcworld and a world's settings package can be up to 1.5 GB.

🧹 Remove Better Continents from a world cleanly

If the world has baked buildings, run bc_bake unbake world confirm in it first, so every baked piece becomes a real piece again. Back up worlds_local/<World> before you remove the mod.

⌨️ Every command

bc is for building worlds: it is a cheat command, so it needs devcommands, and it is registered for the host only. The Server Devcommands mod lets any player with devcommands type it on their own machine, but there a bc change alters only that player's copy of the settings and their view of the ground, never the world, and zone regeneration refuses. bc_altbiomes, bc_export, bc_import, bc_cache, bc_twins and bc_bake's read-only words work for every player; bc_import and bc_cache work in the main menu too. bc <group> help lists a group (bc h help). When an admin sends a command to a dedicated server (bc_export server …, bc_twins server …), the answer comes back to the admin's console as well as the server's log.

Command What it does
bc info the world's settings, whether its maps span World Size, and the record in an export's heightmap
bc regen [dry] [biome=<names>] [min=<m>] [max=<m>] [pos=<x>,<z>] [zone=<x>,<z>] [chance=<0..1>] regenerate zones now; dry counts and changes nothing; biome= picks zones with any corner in those biomes; min=/max= (or radius=) are metres from pos (the centre by default); zone= one zone; chance= resets each with that chance. Refused with a console command in Debug Reset Command
bc reset redraw the minimap (revealing it), rebuild the alt-biome grid and loaded terrain, then regenerate
bc reload <map> reload an image map from disk (hm, bm, fom, lm, heat, … or all)
bc <group> <setting> [value] read or change a setting, e.g. bc g sl 0.55; groups include g, h, b, fo, st. bc h alpha decodes the heightmap again at once
bc scr a screenshot of the map
bc show [filter] · bc hide [filter] · bc bosses pin locations on the map, or remove those pins (yours stay)
bc genloc · bc genloc alt · bc genloc pins run location generation again with a report and send the new icons; alt takes the alt-biome branch; pins only puts the location map's pins and the start back into the registry
bc savepreset [name] save the current settings as a preset (named after the world by default)
bc ab info · list [filter] · here · fn [path] · mode [Random/PlantedOnly/Off] · bc reload ab alt biomes: what they did, which regions have them, where you stand, set or re-read the map, how unplanted land is filled; bc ab help for the rest
bc export … · bc import … · bc cache … · bc twins … the same as the commands below, in the bc tree
bc_altbiomes [here/names/hash/list] any player: your region, the names and colours, whether your placement agrees with the server's (list needs devcommands)
bc_export [size] [options] · status · cancel · help export, for any player the server allows (Allow Export); bc_export server asks a dedicated server to export (admins). Options: amount=, sealevel=, heatscale=, edge=auto/on/off, forest=additive/exact, fine=, noheight, nobiomes, nolocations, noforest, noheat, nocold, noaltbiomes, nolava, nomoss, nopaint, nosources, nopreset, perpoint, and the editor pack's. A client's export holds only the locations the server shows on the map
bc_import · list · <number> · <world> · <folder> · … config · status · help · edited … a New World preset from an export (your newest by default), or load it through the config
bc_cache export · import <file or folder> · list · help the shareable world cache
bc_twins [radius] · remove [radius] · remove confirm [radius] · server … · help count doubled vegetation (exact, or within 0.1–5 m), preview a cleanup, delete extras 1000 a frame. Crops go only when on one spot; without a radius only exact twins go. Back the world up first
bc_bake … area <radius>, box …, words town, any, convert; undo, unbake; load or export a town file; info, stats, hide, show for anyone; admins put server first. Every change is a dry run until confirm
bc_lake … (experimental) here, at <x> <z>, list, info, remove <name/all>, depth [scale], load, import, export, mask at/load/export, regen, server …. Words that replace or remove data need confirm and keep a backup; on a server, changes need an admin
bc_water · force on/off · probe whether Better Continents' own sea is on and why; with Debug Mode, force it or compare drawn and felt waves

MULTIPLAYER

Each player's own The server decides Needs the same Better Continents everywhere
water drawing · baked-building drawing · lake drawing · export keys and defaults · map memory the world's settings and maps · Hud and Allow Export · how fast settings are sent every world that uses Better Continents

⚠️ Versions must match exactly. On a Better Continents world, a player on any other version is refused when they join. Update the server and every player together.

📖 Read the saga — joining a world, and how fast it downloads

Valheim saves each world as a folder, worlds_local/<WorldName>/, and Better Continents keeps the world's settings and maps inside it, in a file named BetterContinents. To move a world to a server, copy the whole folder.

Players need no copy of the world. When a player joins, the host or server sends them the world's settings and maps before the join finishes, and their game caches them, so the download happens once per world revision. A detailed world is tens of megabytes, and Valheim pins every Steam connection to about 150 KB/s, so that first join can take over a minute. The server's log says how long it will take.

Settings Transfer Rate ([07 BetterContinents.Misc], KB512 by default) raises it for that transfer only, then restores Valheim's own: Vanilla, KB256, KB384, KB512, KB768, MB1, MB1_5, MB3 or Unlimited (100 MB/s). Steam sends at exactly the rate set, with no congestion control, so pick one the server's upload can carry; the transfer itself moves about 4 MB/s at most. Measured on a local server with an 11.8 MB world: Vanilla 78 s, KB512 23 s, Unlimited 3 s. A 16k world's 52.6 MB take about 1.7 minutes at KB512 and 17 s at MB3. Only the sending machine's value matters. PlayFab (crossplay) connections cannot be raised and are sent at Valheim's rate; the log says so once. The log shows Settings transfer rate: 512 KB/s (server setting) when a transfer starts and Settings sent: <bytes> in <seconds> (<KB/s>) when it ends. Or skip the download with a .bcworld file (see the Toolbox).

Hud and Allow Export: on a client connected to a Better Continents server, the server's values replace the client's own, and a change on the server reaches connected players at once.


COMPATIBILITY

Mod
⛔ Expand World Size It sizes and lays out the world itself, and Better Continents leaves the layout to it. Install it on every machine that plays the world or on none, and do not add it to a world Better Continents laid out. Keep its World Stretch at 1: anything else magnifies Better Continents' maps so only their centre shows (the log warns once). Its own save grid (1.44 and later, up to 65,536 m) and Wide Sectors never both run: while its grid is the wider one, a new world is not made wide, and a world saved with wide sectors is not loaded (the game's load error is set, nothing is saved over it, and a message names both). Keep one of the two.
Expand World Data Works, including its releases that moved classes into namespaces. The log line "Expand World Data" <version> detected. Applying compatibility: size yes, biome names yes, lava and terrain yes, minimap height yes. says what was reached. Install it wherever the world is played, with the same yaml.
Upgrade World Recommended for resetting zones and forcing location spawns (location_register). Better Continents answers its questions about biomes, heights, forests, locations and vegetation, so zones_reset, zones_generate, biomes_count and locations_add follow your maps (checked offline against its DLL, not yet run in a game). Upgrade World Radius raises its World radius (10,500 m by default) to cover a big world, rounded up to a whole zone and never lowered. After locations_restore, the location map's pins and the start stay where they were; if one is missing, bc genloc pins puts it back. upgrade ashlands and upgrade deepnorth pick zones by distance, not by biome: on a world with its own biome map or size, use bc regen biome=AshLands (the log says so once).
Server Devcommands Recommended: flying, god mode and a free camera while you design. It also lets players type bc on their own machine (their copy only).
Infinity Hammer Recommended for building ruins, landmarks and settlements into your terrain.
World Edit Commands Works.
ZenMap and other map mods See the finished map: cartography tables and admin maps show the real land and sea.
Tarn If installed, Better Continents' own lakes and clearing step aside. Tarn's files are read once into a world, and never written.
BetterWorlds Reads Better Continents' export folders as they are.
Gaea · World Machine · Houdini Read the editor pack's float TIFF.

SETTINGS

BepInEx/config/BetterContinents.cfg, or Configuration Manager. The file is read again whenever it changes on disk. A world setting is a default for new worlds: an edit is read at once, but changes only worlds created afterwards; an existing world uses what it stored. Every map and setting has its own chapter in BetterContinents-Guide.pdf.

🔒 The world's and the server's — stored in each new world, or decided by the machine that runs it
Section Settings
00 Debug Enabled · Override version · Directory
01 Global Skip Default Locations · Continent Size · World Size · Edge Size · Sea Level Adjustment · Ashlands Gap · Deep North Gap · Rivers · Map Edge Drop-off · Mountains Allowed At Center · Mountain Noise · Mistlands Noise · Ashlands Water · Deep North Water
02 Heightmap Heightmap File · Heightmap Amount · Heightmap Blend · Heightmap Add · Heightmap Mask · Heightmap Override All · Heightmap Alpha · Roughmap File · Roughmap Blend · High Terrain
03 Biomemap Biomemap File · Biome precision · Terrainmap file
04 Forest Forest Scale · Forest Amount · Forest Factor Overrides All Trees · Forestmap File · Forestmap Multiply · Forestmap Add
05 StartPosition Override Start Position · Start Position X · Start Position Y
06 Maps Locationmap File · Spawnmap File · Vegetationmap File · Paintmap File · Lavamap File · Mossmap File · Heatmap File · Heatmap Scale · Location Exclusion Mask · Coldmap File · Coldmap Scale
07 Misc Compact Maps (stored in the world) · Settings Transfer Rate (the sending machine's value) · Wide Sectors (read by the machine that runs the world)
08 AltBiomes Altbiomemap File · Mode · Grid · Fixed Seed · Chance Multiplier · Amount Multiplier · Region Size Scale · Distance Scale · Min Sector Thickness · Mean Sector Height · Fix Neighbour Check · Overrides
09 Export Hud · Allow Export (on a client, the server's values win)
12 Lakes Lake Depth Scale (stored with a new world's lakes; bc_lake depth changes it)
🖥️ Local to your machine — yours alone
Section Settings
00 Debug Debug Mode · Debug Reset Command
07 Misc Map Memory · Max Map Size (from the next map read) · Upgrade World Radius (when a world loads)
09 Export Hud Hotkey (F9) · Window Hotkey (F7) · Default Size · Default Heightmap Amount · Default Sea Level · Largest Size
10 BakedPlacements Draw Distance · Draw Scale · Detail Scale · Shadows · Light Distance · Light Count · Light Shadows · Seat Distance · Tints · Diagnostics
11 Water Own Water · Soft Far Sea
12 Lakes Lake Build Range · Lake Build Budget · Lake Sound · Lakes On Map

CREDITS

Needs: BepInExPack Valheim 5.4.2360. Install with a mod manager, or unzip into BepInEx/plugins, on the server and on every player's game.

  • 👑 Originally created by billw2012, the pioneer of Valheim heightmap and custom continent generation.
  • 🛠️ Maintained and expanded by JereKuusela.
  • ⚡ Modernized for Valheim 1.0 by Wubarrk.
  • 🏞️ Lakes and clearing come from Tarn, by Raven Iron (Wubarrk and NomadicWar), contributed under the LGPL-2.1.
  • 🔊 Noise by FastNoiseLite.
📚 The guides in this package, and more to read
  • 📕 The Better Continents Guide — BetterContinents-Guide.pdf, with a clickable table of contents: setup and quick start, FAQ, and a chapter for every image map and every setting. The older online docs by JereKuusela describe an old Better Continents (no Valheim 1.0 Deep North, no lava map, no alt-biome planting, no export); everything in them is in this PDF, updated for Valheim 1.0.
  • 📗 Export & Import, the easy guide — BetterContinents-Export-Guide.pdf: illustrated, step by step for first-timers: exporting, editing the pictures, cutting and pasting between worlds, Biome precision, and new worlds from an export.
  • 🧱 Baked buildings, the easy guide — BetterContinents-Baking-Guide.pdf: baking a base or a town, undo and unbake, town files, servers and settings.
  • 🌊 Water and lakes, the easy guide — BetterContinents-Water-Guide.pdf: the waves of a big world, the settings and commands, then lakes and clearing.
  • 🤖 Map-making, a skill for AI agents — BetterContinents-AI-Skill.pdf: hand it to an AI agent (Claude, Gemini or another) and it learns the whole craft: what the game demands of a map, natural-looking geography, the generator and checker toolkit (attached inside the PDF), export and import, baked buildings and town files (with a placements.bcp writer and checker), and the traps.
  • 🎨 Colours — BetterContinents.gpl (a Krita and GIMP palette with every biome and alt-biome colour) and altbiome-palette.png (a printable chart).
  • 🌿 Alt biomes in Better Continents — the legend syntax, the colour scheme, the quota rule, the commands and log lines.
  • 🔧 Valheim 1.0 migration notes — what changed for Valheim 1.0 and what has been verified in play.
  • 💬 Valheim Worlds, the Better Continents community Discord.
⚖️ Licences
  • Better Continents is free software under the GNU Lesser General Public License v2.1 (LICENSE.md). Source code: github.com/RGlabs84/BetterContinents10. This package includes the exact source of this release as BetterContinents-source.zip.
  • BetterContinents.dll also contains ImageSharp (Apache-2.0), five .NET libraries (MIT) and FastNoiseLite (MIT). Their notices are in THIRD-PARTY-NOTICES.txt.
  • BetterContinents-Guide.pdf is the Better Continents Guide, originally written by billw2012 and maintained by JereKuusela, updated for Valheim 1.0 by Wubarrk.
  • BetterContinents-Export-Guide.pdf, BetterContinents-Baking-Guide.pdf, BetterContinents-Water-Guide.pdf and BetterContinents-AI-Skill.pdf were written by Wubarrk with Claude (Anthropic) as the drafting agent.
  • Every guide is licensed under the GNU General Public License v3 (GUIDE-LICENSE.txt), with its source files (and its pictures or toolkit) attached inside the PDF.

🔗 Also by me: TortalPortal, the portal overhaul with destination previews, favourites and server sync, for travel across your custom continents; and BetterWorlds, which rebuilds worlds from Better Continents exports.

Made by Wubarrk — ravenirongames.com. Bug reports welcome on Discord.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.