​

Main Configuration

• ENABLE-DEBUG: false - Toggles detailed debug messages in the console. Useful for troubleshooting.
• language: en - Sets the language file used for plugin messages (e.g., en for English).
• FriendlyFireEnabled: false - If true, allows players on the same team or party to damage each other with guns.
• KickPlayerIfDeniedResourcepack: false - If true, players who decline the server resource pack prompt will be kicked.
• useDefaultResourcepack: true - If true, the plugin uses its built-in default resource pack URLs. If false, it uses the URLs specified in DefaultResourcepackOverride.
• EnableWeaponDurability: false - If true, QualityArmory weapons will lose durability when used.
• BulletDetection.step: 0.1 - Controls the distance interval (in blocks) for checking bullet collisions. Smaller values are more accurate but may use more server resources.
• BlockBullets.door: false - If true, bullets will be stopped by door blocks.
• BlockBullets.halfslabs: false - If true, bullets will be stopped by half-slab blocks.
• BlockBullets.leaves: false - If true, bullets will be stopped by leaf blocks.
• BlockBullets.water: false - If true, bullets will be stopped upon entering water blocks.
• BlockBullets.glass: false - If true, bullets will be stopped by glass blocks.
• enableInteract.Chests: false - If true, allows players to open chests while holding a QualityArmory weapon.
• overrideAnvil: false - If true, replaces the standard anvil interface with the QualityArmory crafting bench when interacting with an anvil.
• showPossibleCrashHelpMessage: true - If true, displays a message suggesting /qa getResourcepack if a player might be experiencing client crashes due to the resource pack.
• anticheatFix: false - Enables specific adjustments intended to improve compatibility with some anti-cheat plugins.
• verboseItemLogging: false - If true, prints detailed information to the console during the loading of guns, ammo, and other items.
• enable_permssionsToShoot: false - If true, players require the permission qualityarmory.shoot.<gun_name> to fire specific guns.
• sendOnJoin: true - If true, automatically prompts players to download the resource pack when they join the server.
• sendTitleOnJoin: false - If true, displays a title message related to the resource pack when players join.
• resourcepackInvincibility: false - If true, players are invulnerable for a short time after joining while the resource pack is being applied.
• SecondsTillRPIsSent: 5.0 - The delay in seconds after a player joins before the resource pack prompt is sent (if sendOnJoin is true).
• enableBulletTrails: true - If true, displays particle trails following bullets.
• BulletTrailsSpacing: 0.5 - The distance (in blocks) between particles in a bullet trail.
• enableIgnoreArmorProtection: false - If true, bullets ignore the protection value of armor worn by the target.
• enableIgnoreUnbreakingChecks: false - If true, the Unbreaking enchantment on items is ignored when calculating durability loss (if EnableWeaponDurability is true).
• enableIgnoreSkipForBasegameItems: false - A legacy or internal setting likely related to how the plugin handles interactions with vanilla Minecraft items.
• Items.enable_Unbreaking: true - If true, makes QualityArmory items inherently unbreakable, regardless of the EnableWeaponDurability setting.
• enableReloadingOnDrop: false - If true, allows players to reload by pressing their drop key (default ‘Q’) while holding a gun.
• enableReloadingWhenSwapToOffhand: true - If true, allows players to reload by pressing their swap-to-offhand key (default ‘F’) while holding a gun.
• enableReloadOnlyWhenSwapToOffhand: false - If true, reloading is only possible using the swap-to-offhand key (‘F’), disabling other methods like right-click (if applicable).
• allowGunHitEntities: true - If true, allows guns to register melee damage when hitting entities directly.
• preventHiddenPlayers: true - If true, players hidden with the hidePlayer api method will not be able to be hit by bullets.
• preventGunsInHoppers: true - If true, guns cannot be moved with hoppers, this feature prevents some exploits related to item duplication.
• showOutOfAmmoOnTitle: false - If true, displays a large title message on the screen when the player tries to shoot with an empty gun.
• showReloadingTitle: false - If true, displays a large title message on the screen while the player is reloading.
• showAmmoInXPBar: false - If true, displays the current gun’s ammo count in the player’s experience bar.
• perWeaponPermission: false - If true, requires players to have individual permissions (qualityarmory.use.<item_name>) to use each specific gun, ammo, or misc item.
• useMoveForRecoil: true - If true, recoil is simulated by directly moving the player’s camera view. If false, other methods might be used.
• enableExplosionDamage: false - If true, explosions caused by QualityArmory projectiles can destroy blocks.
• enableExplosionDamageDrop: false - If true and enableExplosionDamage is true, blocks destroyed by explosions will drop their corresponding items.
• enablePrimaryWeaponLimiter: false - If true, enforces limits on the number of primary and secondary weapons a player can carry simultaneously.
• weaponlimiter_primaries: 2 - The maximum number of items classified as ‘primary’ weapons a player can carry if the limiter is enabled.
• weaponlimiter_secondaries: 2 - The maximum number of items classified as ‘secondary’ weapons a player can carry if the limiter is enabled.
• enableCrafting: true - Enables the /qa craft command and the crafting system for QualityArmory items.
• enableShop: true - Enables the /qa shop command and the GUI shop for buying QualityArmory items.
• AUTO-UPDATE: true - If true, the plugin will attempt to automatically download and install updates on server start.
• Swap-Reload-and-Shooting-Controls: false - If true, swaps the default mouse button actions (e.g., makes right-click shoot and left-click aim/reload).
• Order-Shop-By-Price: false - If true, items listed in the /qa shop GUI will be sorted by their configured price.
• enable_lore_gun-info_messages: true - If true, displays weapon statistics like damage, ammo type, etc., in the item’s lore text.
• enable_lore_control-help_messages: true - If true, displays basic control instructions (e.g., “[LMB] Shoot”) in the item’s lore text.
• Enable_Headshot_Instantkill: true - If true, landing a headshot on a player or mob results in an instant kill.
• Enable_Headshot_Notification_Sound: true - If true, plays a sound effect to the shooter when they successfully land a headshot.
• Headshot_Notification_Sound: entity.experience_orb.pickup - The specific sound event name to play for a headshot notification.
• Enable_Headshot_Sounds: true - If true, enables additional sounds related to headshots (e.g., impact/gore sounds).
• Headshot_Blacklist: [] - A list of entity types (e.g., ZOMBIE, PLAYER) that are immune to the special effects of headshots (like instant kill).
• Enable_Hit_Sound: true - If true, plays a sound effect to the shooter when they successfully hit an entity with a bullet.
• Hit_Notification_Sound: entity.experience_orb.pickup - The specific sound event name to play for a hit notification.
• Enable_AutoArm_Grenades: false - If true, grenades are automatically armed when thrown, bypassing the need to manually “pull the pin” first.
• gravityConstantForDropoffCalculations: 0.05 - The value representing gravity’s effect used in calculating bullet trajectory and drop-off.
• allowGunReload: true - A master switch to enable or disable all gun reloading mechanics.
• Auto-Detect-Resourcepack: true - If true, the plugin attempts to automatically select the correct resource pack version based on the detected Minecraft server version.
• ManuallyOverrideTo_1_8_systems: false - If true, forces the plugin to use item models and mechanics designed for Minecraft 1.8, overriding auto-detection.
• ManuallyOverrideTo_1_13_systems: false - If true, forces the plugin to use item models and mechanics designed for Minecraft 1.9-1.13, overriding auto-detection.
• ManuallyOverrideTo_1_14_systems: false - If true, forces the plugin to use item models (like Crossbow) and mechanics designed for Minecraft 1.14+, overriding auto-detection.
• unknownTranslationKeyFixer: false - If true, attempts to apply fixes for potential issues related to missing or incorrect translation keys in item names or lore.
• Enable_Creation_Of_Default_Files: true - If true, the plugin will automatically generate default configuration files (like for guns, ammo, etc.) in its folder if they are missing.
• EnableGlowEffects: false - If true, enables glowing effects on certain items or potentially entities under specific conditions.
• Break-Block-Texture-If-Shot: true - If true, displays block breaking particle effects when a block is hit by a bullet.
• enableRecoil: true - Enables or disables the visual recoil effect when firing weapons.
• experimental.BulletWounds.InitialBloodLevel: 1500.0 - The starting value for the internal “blood level” tracker used by the experimental bleeding system.
• experimental.BulletWounds.BloodIncreasePerSecond: 0.01 - Likely represents the rate at which the “blood level” decreases per second when bleeding (needs verification, name is counter-intuitive).
• experimental.BulletWounds.Medkit_Heal_Bloodloss_Rate: 0.05 - The rate at which using a medkit counteracts bleeding or restores the “blood level”.
• experimental.BulletWounds.enableBleeding: false - Enables the experimental system where players can suffer from bleeding after being shot, potentially requiring a medkit.
• disableHotbarMessages.OutOfAmmo: false - If true, prevents the “Out of Ammo” message from appearing above the hotbar.
• disableHotbarMessages.Shoot: false - If true, prevents the ammo count message from appearing above the hotbar when shooting.
• disableHotbarMessages.Reload: false - If true, prevents the “Reloading…” message from appearing above the hotbar.
• automaticallyReloadGunWhenOutOfAmmo: false - If true, the gun will automatically begin reloading as soon as the player tries to fire with no ammo left.
• generalModifiers.sway.Run: 1.3 - A multiplier affecting the amount of weapon sway while the player is running.
• generalModifiers.sway.Walk: 1.5 - A multiplier affecting the amount of weapon sway while the player is walking.
• generalModifiers.sway.Ironsights: 0.8 - A multiplier affecting the amount of weapon sway while the player is aiming down sights (values < 1 reduce sway).
• generalModifiers.sway.Sneak: 0.7 - A multiplier affecting the amount of weapon sway while the player is sneaking (values < 1 reduce sway).
• deathmessages.enable: true - If true, enables custom death messages indicating kills made with QualityArmory weapons.
• impenetrableEntityTypes: [ARROW] - A list of entity types that bullets cannot pass through (e.g., arrows, potentially other projectiles).
• DefaultResourcepackOverride: false - If true, forces the plugin to use the resource pack URL(s) defined under DefaultResourcepack instead of its internal defaults.
• IronSightsOnRightClick: false - If true, aiming down sights (iron sights) is activated by right-clicking instead of the default (usually sneaking).
• SwapSneakToSingleFire: false - If true, changes the control for single-fire mode on automatic weapons to Sneak + Left-Click.
• DestructableMaterials: [MATERIAL_NAME_HERE] - A list of material names (e.g., GLASS, WHITE_WOOL) that can be broken by bullets if enableExplosionDamage is appropriately configured or via specific weapon properties.
• RegenDestructableBlocksAfter: -1 - The time in seconds after which a block destroyed by a QualityArmory weapon/explosion will regenerate. -1 disables regeneration.
• overrideAttackSpeed: true - If true (primarily for 1.14+), overrides the default item attack speed attribute, potentially allowing faster firing rates.
• enable_lore_gun-info_messages: true - If true, displays weapon statistics like damage, ammo type, etc., in the item’s lore text.
• enable_lore_gun-bullets: false - If true, displays the bullet amount in the item’s lore text. This will make the gun go “up and down” when shooting.
• weaponSwitchDelay: 0 - The delay in seconds before a player can fire after switching weapon. A value of 0 means no delay.
• DefaultResourcepack: Defines the resource pack URLs. Refer to ResourcePack Configuration for more information.
• restoreOffHand: false - If true, restores the off-hand item after iron sights are unaimed.
• hitDistance: 5 - The maximum distance (in blocks) at which a gun can register melee hits on entities when using the gun to hit directly.
• enableUnloadingOnDrop: false - If true, allows players to unload their gun’s magazine by pressing their drop key (default ‘Q’) while holding a gun.