🇺🇸 SurvivalPlus - English Version

SurvivalPlus is a utility plugin designed to enhance the early-game survival experience on Spigot and Paper servers. It provides players with balanced, cooldown-based abilities to streamline resource gathering and exploration.

✨ Features

🔥 HotMinage

Activate a temporary "auto-smelt" mode for your mining sessions.

• Effect: Automatically smelts only ores as you mine them (no stone/cobblestone auto-smelt).
• Duration: Lasts for 1 hour (3600 seconds) by default.
• Cooldown: Can be reused every 24 hours (86400 seconds).
• Command: /hotminage.

🕳️ BigHole

Quickly clear large areas for your base or mining projects.

• Effect: Instantly breaks allowed blocks in a radius around the player.
• Radius: Default radius of 10 blocks.
• Safety: Automatically removes lava in the area.
• Breakable Blocks: Handles stone, deepslate, granite, diorite, andesite, tuff, calcite, gravel, dirt, coarse dirt, rooted dirt, clay, dripstone, and moss.
• Cooldown: 2-hour (7200 seconds) default cooldown.
• Optional 5s Damage Protection: Can cancel damage for 5 seconds right after /bighole (useful to avoid fall damage after instant block removal).
• Optional Drop Clear In Radius: Can delete spawned dropped items only inside the BigHole activation area (helps reduce lag from too many entities).
• Command: /bighole.

🎒 Backpack

Store your items in a personal inventory.

• Effect: Opens a private inventory saved per player.
• Size: Configurable from 1 to 6 rows.
• Command: /backpack.

⚰️ DeathChest

Protect player loot on death.

• Effect: Spawns a double chest at death location and stores dropped items.
• Last Death Save: Stores world/X/Y/Z when a DeathChest is created.
• Hologram: Optional armor stand label above the chest with the player name.
• Particles: Optional vertical particle beam from the chest up to world max height.
• Auto Cleanup: When the death chest becomes empty, the chest + hologram/particles are removed automatically.
• Config: Can be enabled or disabled in admin config.
• Command: automatic (no player command).

🗑️ Trash

Open a disposable inventory to delete items.

• Effect: Items left in this inventory are lost when closed.
• Config: Can be enabled or disabled in admin config.
• Command: /trash.

📍 LastDeath

Check your last saved death location.

• Effect: Displays the latest stored death coordinates (world, x, y, z) from DeathChest events.
• Command: /lastdeath.

⚙️ Administration & Configuration

Manage the plugin settings directly in-game.

• Features: Enable/disable specific modes, modify cooldowns, change language, and access a management GUI.
• Command: /spconfig.

🧭 Admin GUI (Multi-Page)

Use /spconfig gui to open a cleaner, page-based admin interface.

• Pages: Home, HotMinage, BigHole, Backpack, DeathChest, System.
• BigHole Page: Includes cooldown editing, radius editing, damage-protection toggle, and drop-clear toggle.
• Navigation: Home button, previous/next page buttons, close button.

🧩 Useful Admin Subcommands

• /spconfig -> displays structured help.
• /spconfig enable <hotminage|bighole|backpack|deathchest>
• /spconfig disable <hotminage|bighole|backpack|deathchest>
• /spconfig cooldown <hotminage|bighole> <seconds>
• /spconfig radius <1-32>
• /spconfig backpack <on|off|rows <1-6>>
• /spconfig trash <on|off>
• /spconfig deathchest <on|off>
• /spconfig deathchest <hologram|particles> <on|off>
• /spconfig lang <fr|en>
• /spconfig display <on|off|actionbar|scoreboard>

🛠️ Commands & Permissions

Command	Description	Permission	Default
/hotminage	Activate auto-smelt mode	survivalplus.hotminage	Everyone
/bighole	Dig a large area	survivalplus.bighole	Everyone
/backpack	Open personal backpack	survivalplus.backpack	Everyone
/trash	Open disposable trash inventory	survivalplus.trash	Everyone
/lastdeath	Show your last saved death location	survivalplus.lastdeath	Everyone
/spconfig	Administer configuration	survivalplus.spconfig.admin	OP

• Bypass Cooldown: Players with the survivalplus.bypass.cooldown permission can use abilities without waiting.

📂 Configuration

The plugin is highly customizable via config.yml:

• Language: Toggle between English (en) and French (fr).
• Display: Timer displays in the Action Bar for active effects.
• Block List: Fully customize which blocks BigHole can break.
• BigHole Protection: features.bighole.damage-protection.enabled (5-second post-use protection).
• BigHole Drop Clear: features.bighole.clear-drops.enabled (drop cleanup only in BigHole radius).
• Trash: features.trash.enabled.
• DeathChest Hologram: features.deathchest.hologram.enabled.
• DeathChest Particles: features.deathchest.particles.enabled.

Example BigHole section:

features:
  bighole:
	enabled: true
	radius: 10
	cooldown-seconds: 7200
	damage-protection:
	  enabled: true
	clear-drops:
	  enabled: false

---

🇫🇷 SurvivalPlus - Version Française

SurvivalPlus est un plugin utilitaire conçu pour améliorer l'expérience de début de survie sur les serveurs Spigot et Paper. Il offre aux joueurs des capacités équilibrées avec des délais de récupération pour faciliter la récolte de ressources et l'exploration.

✨ Fonctionnalités

🔥 HotMinage

Activez un mode "auto-smelt" temporaire pour vos sessions de minage.

• Effet : Cuit automatiquement uniquement les minerais que vous minez (pas la stone/cobblestone).
• Durée : Dure 1 heure (3600 secondes) par défaut.
• Temps de recharge : Utilisable toutes les 24 heures (86400 secondes).
• Commande : /hotminage.

🕳️ BigHole

Déblayez rapidement de grandes zones pour votre base ou vos projets de minage.

• Effet : Casse instantanément les blocs autorisés dans un rayon autour du joueur.
• Rayon : Rayon par défaut de 10 blocs.
• Sécurité : Supprime automatiquement la lave dans la zone.
• Blocs Cassables : Prend en charge la pierre, l'ardoise des abîmes, le granite, la diorite, l'andésite, le tuf, la calcite, le gravier, la terre, l'argile, la spéléothème et la mousse.
• Temps de recharge : Délai de 2 heures (7200 secondes) par défaut.
• Protection dégâts 5s (optionnelle) : Peut annuler les dégâts pendant 5 secondes après /bighole (pratique contre les dégâts de chute quand les blocs disparaissent).
• Suppression des drops dans le rayon (optionnelle) : Peut supprimer les items qui apparaissent uniquement dans la zone du BigHole (utile pour limiter le lag).
• Commande : /bighole.

🎒 Backpack

Stockez vos objets dans un inventaire personnel.

• Effet : Ouvre un inventaire privé sauvegardé par joueur.
• Taille : Configurable de 1 à 6 lignes.
• Commande : /backpack.

⚰️ DeathChest

Protège le stuff des joueurs à la mort.

• Effet : Fait apparaître un double coffre à la position de mort et y stocke les objets drop.
• Dernière mort enregistrée : Sauvegarde monde/X/Y/Z quand un DeathChest est créé.
• Hologramme : Armor stand invisible optionnel au-dessus du coffre, avec pseudo du joueur.
• Particules : Colonne verticale optionnelle de particules jusqu'à la hauteur max du monde.
• Nettoyage auto : Quand le coffre est vidé, le coffre + hologramme/particules disparaissent automatiquement.
• Config : Activable/désactivable dans la config admin.
• Commande : automatique (pas de commande joueur).

🗑️ Trash

Ouvre un inventaire poubelle pour supprimer des objets.

• Effet : Les objets laissés dedans disparaissent à la fermeture.
• Config : Activable/désactivable via l'admin.
• Commande : /trash.

📍 LastDeath

Affiche les dernières coordonnées de mort enregistrées.

• Effet : Affiche monde, x, y, z de la dernière mort stockée via DeathChest.
• Commande : /lastdeath.

⚙️ Administration & Configuration

Gérez les paramètres du plugin directement en jeu.

• Fonctions : Activer/désactiver des modes, modifier les cooldowns, changer la langue et accéder à une interface GUI.
• Commande : /spconfig.

🧭 GUI Admin (Multi-Pages)

Utilisez /spconfig gui pour ouvrir une interface admin plus lisible, organisée par pages.

• Pages : Accueil, HotMinage, BigHole, Backpack, DeathChest, Système.
• Page BigHole : Gestion du cooldown, du rayon, du toggle de protection dégâts, et du toggle de suppression des drops.
• Navigation : Bouton accueil, boutons page précédente/suivante, bouton fermer.

🧩 Sous-commandes Admin utiles

• /spconfig -> affiche l'aide structurée.
• /spconfig enable <hotminage|bighole|backpack|deathchest>
• /spconfig disable <hotminage|bighole|backpack|deathchest>
• /spconfig cooldown <hotminage|bighole> <secondes>
• /spconfig radius <1-32>
• /spconfig backpack <on|off|rows <1-6>>
• /spconfig trash <on|off>
• /spconfig deathchest <on|off>
• /spconfig deathchest <hologram|particles> <on|off>
• /spconfig lang <fr|en>
• /spconfig display <on|off|actionbar|scoreboard>

🛠️ Commandes & Permissions

Commande	Description	Permission	Par défaut
/hotminage	Active le mode auto-smelt	survivalplus.hotminage	Tout le monde
/bighole	Creuse une grande zone	survivalplus.bighole	Tout le monde
/backpack	Ouvre le backpack personnel	survivalplus.backpack	Tout le monde
/trash	Ouvre une poubelle temporaire	survivalplus.trash	Tout le monde
/lastdeath	Affiche la dernière mort enregistrée	survivalplus.lastdeath	Tout le monde
/spconfig	Administre la configuration	survivalplus.spconfig.admin	OP

• Ignorer les délais : Les joueurs possédant la permission survivalplus.bypass.cooldown peuvent utiliser les capacités sans attendre.

📂 Configuration

Le plugin est personnalisable via le fichier config.yml :

• Langue : Basculez entre l'anglais (en) et le français (fr).
• Affichage : Affichage des minuteurs dans l'Action Bar pour les effets actifs.
• Liste de blocs : Personnalisez entièrement les blocs que BigHole peut casser.
• Protection BigHole : features.bighole.damage-protection.enabled (protection 5 secondes après utilisation).
• Nettoyage drops BigHole : features.bighole.clear-drops.enabled (suppression locale dans le rayon BigHole).
• Trash : features.trash.enabled.
• Hologramme DeathChest : features.deathchest.hologram.enabled.
• Particules DeathChest : features.deathchest.particles.enabled.

Exemple de section BigHole :

features:
  bighole:
	enabled: true
	radius: 10
	cooldown-seconds: 7200
	damage-protection:
	  enabled: true
	clear-drops:
	  enabled: false