UltimateBoxed

[!(https://img.shields.io/badge/License-Fair_Core-blue.svg)](LICENSE) [!(https://img.shields.io/badge/Paper-1. 21. 1-orange.svg)](https://papermc.io) [!(https://img.shields.io/badge/Java-21-blue.svg)](https://openjdk.org) [!(https://img.shields.io/badge/Version-1. 0. 0-green.svg)](https://github.com/Crafteria-dev/UltimateBoxed/releases)

> 🇫🇷 (#-ultimateboxed-fr) · 🇬🇧 (#-ultimateboxed-en)

# 🇫🇷 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 : (https://papermc.io) 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` : ```yaml world: lobby-world: "world" ``` 4. Démarrez le serveur

## ⚙️ Configuration rapide

```yaml 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 ` | Modifier la zone d'un joueur _(admin)_ | | `/boxed reset ` | 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: (https://papermc.io) 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`: ```yaml world: lobby-world: "world" ``` 4. Start the server

## ⚙️ Quick configuration

```yaml 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