🇫🇷 Français · 🇬🇧 English

---

🇫🇷 UltimateBoxed (FR)

💡 Usage commercial : Gratuit pour les particuliers. Contactez ZO3N si vous générez des revenus avec ce plugin.

Plugin Paper 1.21.1 qui implémente le mode Boxed : chaque joueur évolue dans son propre monde isolé qu'il agrandit en complétant des quêtes. Inspiré de Grian, pensé pour les serveurs privés comme les grands réseaux.

---

✨ Fonctionnalités

🌍 Monde par joueur	Copie asynchrone d'une map template, chargée/déchargée automatiquement
🔒 Isolation totale	Portails bloqués, aucun joueur ne peut entrer dans le monde d'un autre
📜 Quêtes	8 types de conditions, système de paliers, prérequis, menu coffre
🎁 Récompenses	XP · Items · Agrandissement de zone
⚡ Optimisé	Sauvegardes différées, index précalculé, déchargement automatique

---

🚀 Installation

Prérequis : Paper 1.21.1 · Java 21+

1. Déposez le JAR dans plugins/
2. Placez votre monde template dans plugins/UltimateBoxed/template/ (doit contenir level.dat)
3. Définissez votre monde lobby dans config.yml :

   world:
     lobby-world: "world"
   

4. Démarrez le serveur

---

⚙️ Configuration rapide

zone:
  start-size: 1          # Taille de départ en chunks (1 = 16×16 blocs)
  damage-amount: 0.2     # Dégâts/s hors zone

world:
  lobby-world: "world"
  unload-when-empty: true

optimization:
  save-delay-ticks: 100          # 5 secondes
  auto-save-interval-ticks: 6000 # 5 minutes

update-check: true

Les quêtes sont configurées dans quests.yml en YAML. Chaque quête accepte :

• Conditions : BREAK_BLOCK PLACE_BLOCK KILL_MOB CRAFT_ITEM SMELT_ITEM FISH SLEEP TRADE_VILLAGER
• Récompenses : XP · ITEM · ZONE_EXPAND

---

🕹️ Commandes

Commande	Description
/boxed play	Rejoindre (ou créer) son monde Boxed
/boxed leave	Retourner au lobby
/boxed quests	Ouvrir le menu des quêtes
/boxed reload	Recharger la config à chaud (admin)
/boxed setzone <joueur> <n>	Modifier la zone d'un joueur (admin)
/boxed reset <joueur>	Réinitialiser la progression (admin)
/boxed status	Tableau de bord serveur (admin)

Permissions : boxed.use (tous) · boxed.admin (op)

---

❓ Problèmes fréquents

/boxed play bloqué → Vérifiez que template/level.dat existe (/boxed status).
Quêtes qui ne progressent pas → Le joueur doit être dans son monde Boxed (/boxed info). Vérifiez les noms Bukkit dans quests.yml.
Trop de mondes en RAM → Activez unload-when-empty: true.

---

📜 Licence

Fair Core License (FCL) — Gratuit pour usage personnel · Usage commercial interdit sans autorisation.

---

---

🇬🇧 UltimateBoxed (EN)

💡 Commercial use: Free for individuals. Contact ZO3N if you generate revenue with this plugin.

Paper 1.21.1 plugin implementing the Boxed game mode: each player evolves in their own isolated world, expanded by completing quests. Inspired by Grian, built for private servers and large networks alike.

---

✨ Features

🌍 Per-player world	Async copy of a template map, loaded/unloaded automatically
🔒 Full isolation	Portals blocked, no player can enter another's world
📜 Quests	8 condition types, tier system, prerequisites, chest GUI
🎁 Rewards	XP · Items · Zone expansion
⚡ Optimised	Deferred saves, pre-computed index, automatic unloading

---

🚀 Installation

Requirements: Paper 1.21.1 · Java 21+

1. Drop the JAR into plugins/
2. Place your template world in plugins/UltimateBoxed/template/ (must contain level.dat)
3. Set your lobby world in config.yml:

   world:
     lobby-world: "world"
   

4. Start the server

---

⚙️ Quick configuration

zone:
  start-size: 1          # Starting size in chunks (1 = 16×16 blocks)
  damage-amount: 0.2     # Damage/s outside the zone

world:
  lobby-world: "world"
  unload-when-empty: true

optimization:
  save-delay-ticks: 100          # 5 seconds
  auto-save-interval-ticks: 6000 # 5 minutes

update-check: true

Quests are configured in quests.yml. Each quest accepts:

• Conditions: BREAK_BLOCK PLACE_BLOCK KILL_MOB CRAFT_ITEM SMELT_ITEM FISH SLEEP TRADE_VILLAGER
• Rewards: XP · ITEM · ZONE_EXPAND

---

🕹️ Commands

Command	Description
/boxed play	Join (or create) your Boxed world
/boxed leave	Return to the lobby
/boxed quests	Open the quest menu
/boxed reload	Hot-reload config (admin)
/boxed setzone <player> <n>	Set a player's zone size (admin)
/boxed reset <player>	Reset a player's progression (admin)
/boxed status	Server dashboard (admin)

Permissions: boxed.use (all) · boxed.admin (op)

---

❓ Common issues

/boxed play blocked → Check that template/level.dat exists (/boxed status).
Quests not progressing → The player must be inside their Boxed world (/boxed info). Check Bukkit names in quests.yml.
Too many worlds in RAM → Enable unload-when-empty: true.

---

📜 License

Fair Core License (FCL) — Free for personal use · Commercial use prohibited without authorisation.