Ai.Builder NPC: Guided Builder NPCs for Paper Minecraft Servers

Ai.Builder NPC lets you spawn guided builder NPCs for Minecraft that plan, preview, and construct builds only after you confirm each step.

Ai.Builder NPC

Building in Minecraft has always been a trade-off between time and vision. You can picture the cottage, the castle, the treehouse, but placing every block by hand eats hours. Ai.Builder NPC changes that rhythm. This Paper plugin lets players spawn named builder NPCs who plan constructions, show you exactly what they will place, and wait for your confirmation before touching a single block. No surprise edits, no half-finished walls, no griefed terrain.

What Makes Ai.Builder NPC Different

Most building plugins fall into two camps: rigid schematic pasters or fully automated AI tools that run wild on your world. Ai.Builder NPC sits in the middle. Builders can place original built-in models without any AI service at all, or plan custom builds through your own OpenRouter key. Either way, every plan needs player confirmation before construction starts.

The interface is built for clarity. Questions and confirmation previews appear in bold yellow, while chat buttons use green to confirm and red to cancel. Menus, help, and chat support English by default and Portuguese as an option, though command words always stay in English with /builder.

Built-In Models and Downloadable Packs

Seven constructions ship compiled into the plugin and work immediately: Country Cottage, Modern House, Modern Cube Home, Ranch House, Giant Oak Tree, Modern 3-Story Building, and Treehouse. Beyond those, this release includes 57 extra constructions as downloadable packs, covering world monuments like the Colosseum and Eiffel Tower, medieval castles and abbeys, village bakeries and taverns, biome village houses, and a couple of showcase builds.

Server operators extract a pack and drop the top-level JSON files into plugins/AIBuilder/prebuilts/, then run /builder reload and /builder prebuilt list to see each construction's id, title, and required area. In game, mark an area, run /builder <builder-name> prebuilt <id>, and confirm. Each pack includes its own README, manifest, MIT license, and a SHA256 sidecar for integrity checks.

How to Install on Your Server

Requirements are modest: a Paper server, Java 25, and no hard dependencies. GriefPrevention and CoreProtect are optional but recommended for claim protection and block history. To install, place the plugin jar in your server's plugins/ folder and start Paper. The plugin generates plugins/AIBuilder/ with config, language files, prebuilts, and an in-game doc kit. If you prefer a smoother path, the foxygame.net launcher bundles Ai.Builder NPC in its add-on catalog, so server owners can pull the plugin and matching packs without hunting through folders manually.

AI Custom Builds Through OpenRouter

For original requests, add your OpenRouter key and model identifier to config.yml, run /builder reload, and talk to your builder in chat. Something like @alfred build a small stone cottage with a garden triggers a plan, and /builder alfred yes sets it in motion. Without a key, AI chat simply explains how to configure one while every non-AI tool keeps working.

Parental controls such as allowed hours and daily limits apply only to AI requests, which keeps server operators in control of costs and usage.

Commands, Limits, and Safety

The command set covers the full workflow:

  • spawn, list, select, and delete manage your builders.
  • zone set1 and zone set2 mark construction areas with the diamond shovel.
  • terrain clean and terrain level preview vegetation removal and flattening before you confirm.
  • build save, build continue, and build undo handle long projects safely.

Limits keep servers stable: a maximum of 256 user models, files up to 64 MiB, and heights up to 100 blocks. Only full solid blocks are supported by the executor, so doors, beds, stairs, slabs, torches, and fluids are skipped. Coordinates are relative to the marked area's minimum corner, and invalid JSON is logged and ignored rather than crashing anything.

Safety is layered. Only the builder's owner or an operator can control it. AI-generated jobs are checked against dimensions, materials, area, block budgets, and server protections. GriefPrevention claims stay protected, and a broken claim integration fails closed. Builders never attack players, only hostile monsters, and only when their queue is empty.

Supported Versions and Getting Started

Ai.Builder NPC targets Paper servers, developed and tested on Paper 26.3 with api-version 1.21, and it runs on Java 25. If you want to download Ai.Builder NPC for Minecraft, grab the jar from the project page, or let the foxygame.net launcher handle version compatibility and auto-updates so your server stays current without manual file swaps.

Start conservative with block and volume limits, raise one setting at a time, and watch server performance. Whether you are decorating a survival village or staging a showcase world, guided builder NPCs turn ambitious ideas into confirmed, controlled construction. Mark an area, pick a model, approve the plan, and watch your world grow.