Intégrations

Aucune dépendance obligatoire. WorldGuard, PlaceholderAPI et ItemsAdder sont des softdepend.

WorldGuard

Les flags s’enregistrent dans onLoad(). WorldGuard doit être présent au démarrage. Un /guns reload ne les recrée pas.

Flag	Défaut	Effet
guncraft-shoot	allow	Tirer dans la région
guncraft-pvp	allow	Dégâts joueurs (+ action DAMAGE)
guncraft-damage-mobs	allow	Dégâts mobs
guncraft-replace-blocks	deny	REPLACE_BLOCK et explosions qui cassent des blocs
guncraft-explode	deny	EXPLODE et éclair réel (LIGHTNING + effect-only: false)

/rg flag spawn guncraft-shoot deny
/rg flag pvp guncraft-pvp allow
/rg flag pvp guncraft-explode allow

Condition de script : if: in_region:spawn — voir Scripting.

PlaceholderAPI

Identifiant : guncraft. Arme = item en main.

Placeholder	Valeur
%guncraft_ammo%	Munitions actuelles
%guncraft_max_ammo% / %guncraft_magazine%	Taille du chargeur
%guncraft_weapon% / %guncraft_weapon_name%	Nom
%guncraft_weapon_id%	Id pack:nom
%guncraft_reloading%	true / false
%guncraft_aiming%	ADS actif en ce moment
%guncraft_ads%	L’arme a le mode ADS
%guncraft_rarity%	COMMON / …
%guncraft_ammo_type%	Type (light, …)
%guncraft_pellets%	Nombre de pellets
%guncraft_automatic%	true / false
%guncraft_weapons_loaded%	Armes chargées (global)

ItemsAdder

type: ia:my_pack:pistol
or-if-null:
  type: WOODEN_HOE
  custom-model-data: 100

Sans ItemsAdder, or-if-null est utilisé. Sans fallback, l’arme peut tomber sur une barrière.

API Java

Classes non obfusquées.

GunCraftAPI api = GunCraftAPI.getInstance();
api.giveWeapon(player, "demo-pack:Pistol");
ItemStack stack = api.createWeapon("SMG");
WeaponConfig cfg = api.getWeapon("demo-pack:Pistol");
boolean isGun = api.isWeapon(stack);
WeaponItem item = api.getWeaponItem(stack);
Collection<WeaponConfig> all = api.getWeapons();
api.reload();

Event	Notes
PlayerFireEvent	Avant le projectile (annulable)
PlayerHitByWeaponProjectileEvent	Joueur, isHeadshot(), getDistance()
WeaponProjectileHitMobEvent	Mob, isHeadshot()
WeaponProjectileHitBlockEvent	Bloc (non annulable)

Package : fr.rhum0ne.gunCraft.api / fr.rhum0ne.gunCraft.events.