UltimateBoxed

The Ultimate Boxed Plugin : A simple-to-use plugin for servers of all sizes.

License: FCL Paper Java Version

đŸ‡«đŸ‡· 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.

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+

  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.

Made with ❀ by ZO3N · github.com/Crafteria-dev/UltimateBoxed

The UltimateBoxed Team

profile avatar
  • 2
    Projects
  • 130
    Downloads

More from ZO3N_Dev

  • EasyTPA project image

    EasyTPA

    • 124
    • Bukkit Plugins

    EasyTPA: A simple-to-use plugin for servers of all sizes.

    • 124
    • May 10, 2026
    • Bukkit Plugins
  • EasyTPA project image

    EasyTPA

    • 124
    • Bukkit Plugins

    EasyTPA: A simple-to-use plugin for servers of all sizes.

    • 124
    • May 10, 2026
    • Bukkit Plugins