Lorenzo0111's Plugins
Discord
QualityArmory
QualityArmory
  • Installation
  • Configuration
    • Main Configuration
    • ResourcePack Configuration
  • Items Config
    • ResourcePack Model
    • Gun Configuration
    • Ammo Configuration
    • Armor Configuration
  • Developers
    • Adding the Dependency
    • QualityArmory API
  • Downloads
    • SpigotMC
    • Modrinth
    • CurseForge
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
Export as PDF
  1. Configuration

Main Configuration

PreviousInstallationNextResourcePack Configuration

Last updated 14 days ago

Was this helpful?

This is the documentation of the main configuration, also known as config.yml. Below you can find a list of all the options that you can configure and their explanation.

  • 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.

  • 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: false - If true, allows guns to register melee damage when hitting entities directly.

  • 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_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 server ticks 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.

  • DefaultResourcepack: Defines the resource pack URLs. Refer to for more information.

ResourcePack Configuration