Installation

Plugin Spigot / Paper, Java 17+, API 1.18 (testé jusqu’à 1.21.x). Aucune dépendance obligatoire.

Fichiers

1. Placez le jar dans plugins/.
2. (Optionnel) ItemsAdder, PlaceholderAPI, WorldGuard.
3. Redémarrez le serveur (les flags WorldGuard s’enregistrent au onLoad).
4. Réglez plugins/GunCraft/config.yml (language: en ou fr).
5. Les packs d’exemple et de démo sont copiés une fois (jamais écrasés ensuite).

Give de test :

/guns give <joueur> demo-pack:Pistol

Démarrage rapide

• Joueur (guns.use, défaut tout le monde) : clic droit = tirer, F = recharger.
• Admin : /guns → vitrine. Clic droit sur une carte = éditeur (guns.edit).
• ADS (ads: true) : clic droit = viser, clic gauche = tirer.
• Auto : maintenir le clic de tir (droit sans ADS, gauche avec ADS).

Identifiant : pack:nom (ex. demo-pack:SMG). Le nom court (SMG) marche s’il n’est pas dupliqué.

Commandes et permissions

Commande	Permission	Défaut
/guns	guns.menu	op
/guns list	guns.list	op
/guns give <joueur> <arme> [n]	guns.give	op
/guns reload	guns.reload	op
/guns help	—	—
Tirer	guns.use	true
Éditeur GUI	guns.edit	op
Tout l’admin	guns.admin	op

Alias : /guncraft, /gc.

/guns reload recharge config, langues, munitions et packs sans restart. Les recettes de craft sont recréées. Le YAML invalide est skippé, les warnings vont dans le chat.

Config (config.yml)

language: en                 # en | fr | ou un fichier lang/<code>.yml
ammo-title: true             # HUD munitions
allow-console-commands: false
trail:
  max-particles: 16          # 0 = pas de trail
  step: 2.5

Textes de l’UI : plugins/GunCraft/lang/. Détail dans Contrôles & menus.