AtlasForge

Furnished towns that follow the ground they stand on

AtlasForge is a building toolkit for Paper 1.21.4 and newer. One command builds a whole town on the ground you already have: a square, streets, plots, furnished houses with yards, a church and an inn. It also makes the terrain to put the town on, paints it, and exports what you built.

Towns

Any size: ask for 1 to 200 houses, or say small, medium or large.
Built on the ground as it is: streets take the easy way over a hill and plots sit where the slope lets them. Where no street a cart could climb leads anywhere, you get a street of steps.
No bare cuts: every cut into a hillside gets a grass bank, a rough stone wall, or a planted shelf with a second wall behind it.
Yards: a fence with a gate, a vegetable plot, paths and a few pieces such as a woodpile or a bench.
An honest count: when the ground can't take every house, the town tells you how many it seated and how much of the ground was too steep, under water or already built on.
Towns don't overlap: raise a second town next to the first and it goes around it.
Same seed, same town: a seed is a number or a word, and the same seed on the same ground builds the same thing.

Preview first

/atlas town 30 --preview reads the ground, works the town out and hangs it in coloured glass: streets at their real height, each house as a volume up to its ridge. Nothing in the world changes. /atlas confirm builds what you saw, /atlas cancel throws it away, and glass you leave alone fades after five minutes.

Houses

Furnished inside: rooms with doors between them, windows, stairs or a ladder, a kitchen downstairs and bedrooms upstairs. No room is left without a light.
One house on its own: /atlas house builds one where you stand, in nine forms, from 1 to 8 floors, facing the way you choose.
Cellars on slopes: a house whose floor ends up three blocks or more above falling ground gets a cellar with a door on the low side, barrels, a lantern and a hatch from the room above.
Aged on request: --state worn or --state ruined for buildings that look lived in or abandoned.
A roof for your own walls: select a building you made and /atlas roof puts a gable, hip, pyramid or flat roof on it.

Another house on one plot

Stand on a house you don't like and run /atlas reroll. Only that plot, its yard and its path to the street are rebuilt. Run it again for another one. The church and the inn take turns too.

Styles and pieces

Eight styles in the box: medieval, nordic, japanese, alpine, mediterranean, desert, stone and ruins.
Your own: a style is one YAML file in plugins/AtlasForge/cultures/. base: names a style to start from, so the file only has to say what differs. /atlas culture check tells you what is wrong with a file, and /atlas culture reload picks up changes without a restart.
117 pieces: lamps, wells, fountains, stalls, benches, carts, planters and indoor furniture. /atlas piece places one where you stand, made of the blocks of the style you give it.

Terrain and painting

Whole maps: /atlas map builds terrain over a box, with surface layers, a sea and a snow line. A 1024×1024 map is about 200 million blocks and takes a little over a minute from the console.
Relief in a selection: /atlas terrain fills your WorldEdit selection with one of 14 noises.
Erosion: five modes, from smoothing to melting.
Roads and rivers: walk the route, mark the points, and the road or the river follows them. A river finds the valley between your marks.
Paint with masks: /atlas paint moss_block #flat #near[water,3] paints only where every mask agrees.
Gradients: join two blocks with .. and the blocks in between are found by colour.
Brushes and palettes: 13 brushes, from boulders and roots to smoothing, and 27 palettes for the texture command.

Undo

/atlas undo takes back the last thing AtlasForge built for you, ten jobs deep, and nothing else. A //set you did afterwards stays where it is. Big jobs come back whole: we undo a 150-house town on an 840×840 map and count the blocks before and after.

Export and console

Schematics: /atlas export writes Sponge v3, Sponge v2, MCEdit or Litematica files, with block states, chests, signs and beds inside.
Top-down picture: /atlas render writes a PNG of any area.
Nobody online: map, town, reroll, piece, culture, texture, export and render run from the console or over RCON, so a script or another plugin can drive them. The result of a long job is written to the server log.

How to use it

Install: drop the jar into /plugins next to FastAsyncWorldEdit, restart once and paste your licence key into config.yml.
Preview: stand where you want the square and run /atlas town 25 --preview.
Build: /atlas confirm. If you change your mind, /atlas undo.

Commands and permissions

Towns: /atlas town, confirm, cancel, reroll.
Houses and pieces: /atlas house, roof, piece, culture.
Terrain: /atlas map, terrain, erode, mark, road, river.
Painting: /atlas paint, gradient, texture, brush, palette.
Output: /atlas export, render. And /atlas undo.
The alias is /af. One permission, atlasforge.use, on for operators by default.
Options go in order or by name, and tab completion names every one: /atlas town 40 --culture nordic --seed 2026 --state worn.

Requirements

Paper 1.21.4 or newer, forks like Purpur included, on Java 21.
FastAsyncWorldEdit. Plain WorldEdit is not enough.

FAQ

Does it need a flat area?
No. Towns are made for hills. On ground that is mostly water or cliff the town comes out smaller and says why, and if not one house fits it builds nothing.

Will it build over what is already there?
A town goes around other towns and anything else already standing. A map is different: /atlas map replaces the whole box you give it.

Can players use it?
It is a tool for staff and builders. The permission is off for players by default.

Can I take a town to another server?
Yes. Export it as a schematic or a Litematica file and paste it there.

For questions or bug reports, use the discussion tab on this page or our Discord. Every update is announced on the Discord before it reaches the listing.