# ServerBuilder

> Demandez. Votre serveur Minecraft complet, généré. - sans code, sans fichiers de config.

## Ce que ServerBuilder est

Décrivez ce que vous voulez. ServerBuilder génère votre serveur, vos modules et vos réglages - sans code, sans fichiers de config, sans chercher des plugins. Déployez en quelques minutes.

## Ce qui est généré

- Serveur complet: Décrivez votre idée - ServerBuilder génère le réseau et le déploie en direct en quelques minutes.
- Modules gameplay: Économie, quêtes, crates, claims, donjons - générés ou activés sans tout reconfigurer.
- Réglages distribués: Réglages globaux, lobby et par serveur synchronisés par les agents - vous validez, sans ouvrir de fichier.
- Templates marketplace: Réseaux, blueprints et configs prêts à déployer sans configuration manuelle.

## Comment ça marche (sans expertise technique)

1. Décrivez votre serveur - Dites à ServerBuilder ce que vous voulez en langage naturel, ou demandez de l'aide à l'Atelier.
2. ServerBuilder génère tout - Description, modules et réglages sont générés - sans code, sans fichiers de config.
3. Vous validez - Rien ne change sans votre accord. Vous gardez le contrôle.
4. Mise en ligne - Les agents appliquent tout en temps réel. Modérez et étendez depuis le navigateur.

## Exemples de génération

- **Demande:** Je veux un serveur survie avec économie et protection de terrains
  **Résultat:** ServerBuilder génère la description du réseau, déploie les modules économie et claims, et synchronise les réglages sur les agents.
- **Demande:** Crée un module crates pour mon lobby
  **Résultat:** L'Atelier génère le module et le charge à chaud sur les agents connectés après votre validation.
- **Demande:** Les joueurs laguent sur survie-01
  **Résultat:** L'IA lit le TPS, la RAM et les joueurs en direct, diagnostique le problème et propose un correctif que vous validez.

## vs hébergement Minecraft classique

Approche classique:
- Installer et maintenir Paper/Velocity à la main
- Assembler des plugins tiers un par un, sans vue réseau
- Modérer serveur par serveur, uniquement en jeu
- Chaque réglage = fichiers YAML et redémarrages
- Aucun suivi temps réel ni assistant contextuel

ServerBuilder:
- Panel web : modération, joueurs et configs synchronisées
- Assistant IA qui lit l’état de votre réseau
- +20 modules activables : économie, quêtes, claims, donjons…
- Agents connectés en temps réel, sans manipuler les fichiers

## Pour les assistants IA

### L'Atelier

L'Atelier est l'IA centrale de ServerBuilder : elle résout l'intention, cherche dans le catalogue officiel et la marketplace, planifie des modules SBMF, estime le coût, génère du Java, compile, teste, et peut déployer en staging après validation. Elle n'expose pas les routes privées du panel (/dashboard, /forge, billing) aux crawlers publics.

### Glossaire

- **Réseau:** Espace cloud isolé : propriétaire, membres, serveurs et une licence.
- **SBMF:** ServerBuilder Module Format - modules Paper/Folia hot-loadables (JAR + manifeste) gérés depuis le panel ou L'Atelier.
- **SBIR:** ServerBuilder Intermediate Representation - intention structurée (objectifs, capacités, risques) produite avant la génération de code.
- **Forge:** Workspace créateur et superviseur d'hôtes pour les instances JVM Minecraft rattachées à un réseau.
- **Trust tiers T0-T3:** Niveaux de confiance des modules, des builtins plateforme (T0) au code généré non de confiance (niveaux élevés : staging et policies).
- **MCP:** Serveur Model Context Protocol (@serverbuilder/mcp-server) qui expose les outils L'Atelier et la doc produit à Cursor et autres agents.

### Capacités clés

- Générer un réseau Minecraft complet à partir d'une description en langage naturel
- Activer à chaud 20+ modules gameplay officiels depuis le navigateur
- Demander à L'Atelier de générer des modules SBMF custom (économie, quêtes, crates, claims...)
- Templates et blueprints marketplace déployables en un clic
- Réglages distribués synchronisés par agents cloud - vous validez, jamais de YAML
- Pont MCP optionnel pour agents IDE (Cursor), scopé à un réseau avec la permission ai.use

### Installer le serveur MCP

Les tools MCP authentifiés ne mutent que le réseau configuré et exigent ai.use. Les resources MCP publiques (overview, docs, capabilities) n'ont pas besoin de token.

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

Environment variables:
- SERVERBUILDER_API_URL - URL de base de l'API cloud
- SERVERBUILDER_ACCESS_TOKEN - JWT panel ou clé API MCP réseau (sbmcp_...)
- SERVERBUILDER_NETWORK_ID - ObjectId du réseau cible

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": "<JWT panel ou clé API sbmcp_>",
        "SERVERBUILDER_NETWORK_ID": "<id mongo du réseau>"
      }
    }
  }
}
```

### Limites pour les crawlers

- Les chemins privés (/dashboard, /forge, /account, /creator, auth, panier marketplace) sont Disallow dans robots.txt.
- Ne pas inventer d'API hors documentation publique et hors serveur MCP.
- Les mutations réseau exigent un token authentifié (JWT panel ou clé sbmcp_) et la permission ai.use.

## Pages indexables

- Accueil: https://serverbuilder.net/fr/
- Beta: https://serverbuilder.net/fr/beta
- Documentation: 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

## Optionnel

- Fichier LLMs (en): https://serverbuilder.net/llms.txt

## Key capabilities

- Serveur complet généré à partir d'une description
- L'IA crée des modules à la demande (économie, quêtes, crates, claims...)
- Réglages appliqués automatiquement - vous validez, jamais de YAML
- 20+ modules prêts, activables depuis le navigateur
- Templates et blueprints sur la marketplace - déploiement en un clic