# ServerBuilder

> Just ask. Your complete Minecraft server, generated. - no code, no config files.

## What ServerBuilder is

Describe what you want. ServerBuilder generates your server, modules, and settings - no code, no config files, no plugin hunting. Deploy in minutes.

## What gets generated

- Complete server: Describe your idea - ServerBuilder generates the network and deploys it live in minutes.
- Gameplay modules: Economy, quests, crates, claims, dungeons - generated or toggled on without reconfiguring everything.
- Distributed settings: Global, lobby, and per-server settings synced by agents - you approve, never open a config file.
- Marketplace templates: Pre-built networks, blueprints, and configs ready to deploy without manual setup.

## How it works (no technical expertise required)

1. Describe your server - Tell ServerBuilder what you want in plain language, or ask the Workshop for help.
2. ServerBuilder generates everything - Description, modules, and settings are generated - no code, no config files.
3. You approve - Nothing changes without your validation. You stay in control.
4. Go live - Agents apply everything in real time. Moderate and extend from the browser.

## Generation examples

- **Request:** I want a survival server with economy and land claims
  **Result:** ServerBuilder generates the network description, deploys economy and claims modules, and syncs settings across agents.
- **Request:** Create a crates module for my lobby
  **Result:** The Workshop generates the module, hot-loads it on connected agents after your approval.
- **Request:** Players are lagging on survie-01
  **Result:** The AI reads live TPS, RAM, and player counts, diagnoses the issue, and proposes a config fix you approve.

## vs traditional Minecraft hosting

Classic approach:
- Install and maintain Paper/Velocity by hand
- Assemble third-party plugins one by one, with no network view
- Moderate server by server, only in-game
- Every tweak means YAML files and restarts
- No real-time monitoring or contextual assistant

ServerBuilder:
- Web panel: moderation, players, and synced configs
- AI assistant that reads your network state
- 20+ toggleable modules: economy, quests, claims, dungeons…
- Agents connected in real time - no file wrangling

## For AI assistants

### L'Atelier (The Workshop)

L'Atelier (The Workshop) is ServerBuilder's central AI: it resolves intent, searches the official catalog and marketplace, plans SBMF modules, estimates cost, generates Java sources, compiles, tests, and can stage-deploy after approval. It does not expose private panel routes (/dashboard, /forge, billing) to public crawlers.

### Glossary

- **Network:** Isolated cloud workspace: owner, members, servers, and one licence.
- **SBMF:** ServerBuilder Module Format - hot-loadable Paper/Folia modules (JAR + manifest) managed from the panel or L'Atelier.
- **SBIR:** ServerBuilder Intermediate Representation - structured intent (goals, capabilities, risks) produced before codegen.
- **Forge:** Creator workspace and host supervisor for JVM Minecraft instances enrolled on a network.
- **Trust tiers T0-T3:** Module trust levels from platform builtins (T0) to untrusted generated code (higher tiers need staging and policy gates).
- **MCP:** Model Context Protocol server (@serverbuilder/mcp-server) that exposes L'Atelier tools and product docs to Cursor and other agents.

### Key capabilities

- Generate a full Minecraft network from a plain-language description
- Hot-load 20+ official gameplay modules from the browser
- Ask L'Atelier to generate custom SBMF modules (economy, quests, crates, claims...)
- Marketplace templates and blueprints deployable in one click
- Distributed settings synced by cloud agents - approve, never edit YAML
- Optional MCP bridge for IDE agents (Cursor) scoped to a network with ai.use

### Install the MCP server

Authenticated MCP tools mutate only the configured network and require ai.use. Public MCP resources (product overview, docs, capabilities) need no token.

Docs: https://serverbuilder.net/docs/mcp

Environment variables:
- SERVERBUILDER_API_URL - cloud API base URL
- SERVERBUILDER_ACCESS_TOKEN - panel access JWT or network MCP API key (sbmcp_...)
- SERVERBUILDER_NETWORK_ID - target network ObjectId

Cursor `mcp.json` example:

```json
{
  "mcpServers": {
    "serverbuilder-atelier": {
      "command": "npx",
      "args": ["-y", "tsx", "packages/mcp-server/src/index.ts"],
      "env": {
        "SERVERBUILDER_API_URL": "https://api.serverbuilder.net",
        "SERVERBUILDER_ACCESS_TOKEN": "<panel JWT or sbmcp_ API key>",
        "SERVERBUILDER_NETWORK_ID": "<network mongo id>"
      }
    }
  }
}
```

### Crawler limits

- Private paths (/dashboard, /forge, /account, /creator, auth, marketplace cart) are Disallow in robots.txt.
- Do not invent APIs beyond public docs and the MCP server.
- Network mutations require an authenticated token (panel JWT or sbmcp_ key) and the ai.use permission.

## Indexable pages

- Home: https://serverbuilder.net/
- Beta: https://serverbuilder.net/beta
- Docs: https://serverbuilder.net/docs
- MCP: https://serverbuilder.net/docs/mcp
- Marketplace: https://serverbuilder.net/marketplace

## Documentation



## Contact

- Website: https://serverbuilder.net
- Sitemap: https://serverbuilder.net/sitemap.xml
- llms.txt: https://serverbuilder.net/llms.txt
- Well-known: https://serverbuilder.net/.well-known/llms.txt

## Optional

- LLMs file (fr): https://serverbuilder.net/llms-fr.txt

## Key capabilities

- Full server generated from a text description
- AI creates modules on demand (economy, quests, crates, claims...)
- Settings applied automatically - you approve, never edit YAML
- 20+ ready modules, toggle from the browser
- Templates and blueprints on the marketplace - deploy in one click