BuilderNPC - NPC Builders, Towns & Roads

BuilderNPC
Give your world a team of builders.

BuilderNPC adds builder NPCs that construct furnished houses, shops, farms, public buildings, landmarks and entire towns. Watch them walk to the construction site, swing their tools and build in stages, then connect finished towns with country roads.

Requirements: Spigot 26.3 and Java 25.

Features

• 70 structure types across six categories: houses, public buildings, shops and workshops, farming, landmarks and decoration.
• 38 architectural styles, plus Automatic biome selection and Mixed styles. Choose medieval, Nordic, Japanese, modern, Victorian, Austrian Town House and many more, with coherent material palettes and distinctive details.
• Procedural designs with varied sizes, storeys, room layouts, facades, porches, balconies, dormers, chimneys and gardens. Nine roof shapes include gable, hip, mansard, gambrel, dome and pagoda.
• Furnished interiors with kitchens, bedrooms, fireplaces, desks, bookshelves, lighting and staircases. Public buildings have rooms tailored to their purpose.
• Walkability checks keep entrances, doors and stairs accessible and remove furniture or decoration that obstructs routes through a building.
• Whole towns in four sizes, with a town square, main roads, side streets, a ring road, street lamps, civic buildings and farms. Multiple builders can work on one town.
• Country roads and bridges route around foreign structures, plots and steep terrain. Finished towns can automatically connect to neighbouring towns.
• Terrain preparation clears natural trees, levels sites, fills hollows, creates retaining walls on slopes and builds platforms supported by pillars in water.
• Interactive previews show a single building as ghost blocks visible only to the ordering player. Confirm, reroll, rotate, move or cancel before construction starts.
• Build where you look, at your position or near the builder. Menus show structure dimensions and block counts.
• Configurable build speeds from slow to instant, with permission controls for individual speeds. Construction follows foundation, frame, walls, roof, windows, doors and furniture.
• Builder Plan opens the menu from anywhere and supports construction without an NPC: blocks appear directly at the site.
• Undo the last build, all work by a builder or an entire town, including roads and cleared trees. Blocks changed by players after construction are preserved.
• Persistent progress: builders, jobs, towns, plots, roads and undo records survive server restarts; queued work resumes afterwards.

What can you build?

• Houses: huts, cottages, family houses, townhouses, row houses, log cabins, villas, manor houses, mansions, apartments and skyscrapers.
• Public buildings: town halls, churches, libraries, schools, infirmaries, taverns, guard houses, bathhouses, market halls, museums, banks, post offices, hotels, fire stations, courthouses and theatres.
• Shops and workshops: blacksmiths, bakeries, butchers, general stores, warehouses, sawmills, alchemists, restaurants, cafes, bookshops, florists and pharmacies.
• Farming: fields, orchards, animal pens, barns, stables, greenhouses, apiaries, granaries and windmills.
• Landmarks and decoration: towers, lighthouses, castles, observatories, statues, gazebos, wells, fountains, parks, gardens, cemeteries, street lamps and town squares.

Protection and control
Builders check sites and individual block operations to avoid foreign structures, reserved plots and existing roads. Artificial blocks, including naturally generated villages and ruins, count as foreign; natural terrain and vegetation can be cleared. Sites with entities such as item frames, paintings or tamed animals are avoided.

Optional protection checks use simulated block-break events in the owner's name. WorldGuard, GriefPrevention, Towny, Lands and PlotSquared are declared as optional integrations; no additional plugin is required to use BuilderNPC.

Installation

1. Run a Spigot 26.3 server with Java 25.
2. Place the BuilderNPC JAR in the server's plugins folder and restart the server.
3. Adjust plugins/BuilderNPC/config.yml and messages.yml as needed.
4. Use /builder reload to reload configuration and messages.

Quick start
Right-click your builder to open the menu. Pick a structure and confirm its preview. You can also order a building directly:
To plan a town around your position:
Most building and management permissions default to operators. Grant the permissions listed in the Documentation tab to let other players create builders and place orders. Commands also work through the aliases /builders and /bnpc.

Language: English. Player-facing messages can be customised in messages.yml.

See the Documentation tab for commands, permissions, the Builder Plan and configuration notes.


Screenshots