🇫🇷 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+

Déposez le JAR dans plugins/
Placez votre monde template dans plugins/UltimateBoxed/template/ (doit contenir level.dat)
Définissez votre monde lobby dans config.yml :
```
world:
  lobby-world: "world"
```
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.

Fait avec ❤️ par ZO3N · github.com/Crafteria-dev/UltimateBoxed

🇬🇧 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+

Drop the JAR into plugins/
Place your template world in plugins/UltimateBoxed/template/ (must contain level.dat)
Set your lobby world in config.yml:
```
world:
  lobby-world: "world"
```
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.

Made with ❤️ by ZO3N · github.com/Crafteria-dev/UltimateBoxed