Main Configuration
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.,enfor English). - FriendlyFireEnabled:
false- Iftrue, allows players on the same team or party to damage each other with guns. - KickPlayerIfDeniedResourcepack:
false- Iftrue, players who decline the server resource pack prompt will be kicked. - useDefaultResourcepack:
true- Iftrue, the plugin uses its built-in default resource pack URLs. Iffalse, it uses the URLs specified inDefaultResourcepackOverride. - EnableWeaponDurability:
false- Iftrue, 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- Iftrue, bullets will be stopped by door blocks. - BlockBullets.halfslabs:
false- Iftrue, bullets will be stopped by half-slab blocks. - BlockBullets.leaves:
false- Iftrue, bullets will be stopped by leaf blocks. - BlockBullets.water:
false- Iftrue, bullets will be stopped upon entering water blocks. - BlockBullets.glass:
false- Iftrue, bullets will be stopped by glass blocks. - enableInteract.Chests:
false- Iftrue, allows players to open chests while holding a QualityArmory weapon. - overrideAnvil:
false- Iftrue, replaces the standard anvil interface with the QualityArmory crafting bench when interacting with an anvil. - showPossibleCrashHelpMessage:
true- Iftrue, displays a message suggesting/qa getResourcepackif 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- Iftrue, prints detailed information to the console during the loading of guns, ammo, and other items. - enable_permssionsToShoot:
false- Iftrue, players require the permissionqualityarmory.shoot.<gun_name>to fire specific guns. - sendOnJoin:
true- Iftrue, automatically prompts players to download the resource pack when they join the server. - sendTitleOnJoin:
false- Iftrue, displays a title message related to the resource pack when players join. - resourcepackInvincibility:
false- Iftrue, 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 (ifsendOnJoinis true). - enableBulletTrails:
true- Iftrue, displays particle trails following bullets. - BulletTrailsSpacing:
0.5- The distance (in blocks) between particles in a bullet trail. - enableIgnoreArmorProtection:
false- Iftrue, bullets ignore the protection value of armor worn by the target. - enableIgnoreUnbreakingChecks:
false- Iftrue, the Unbreaking enchantment on items is ignored when calculating durability loss (ifEnableWeaponDurabilityis true). - enableIgnoreSkipForBasegameItems:
false- A legacy or internal setting likely related to how the plugin handles interactions with vanilla Minecraft items. - Items.enable_Unbreaking:
true- Iftrue, makes QualityArmory items inherently unbreakable, regardless of theEnableWeaponDurabilitysetting. - enableReloadingOnDrop:
false- Iftrue, allows players to reload by pressing their drop key (default ‘Q’) while holding a gun. - enableReloadingWhenSwapToOffhand:
true- Iftrue, allows players to reload by pressing their swap-to-offhand key (default ‘F’) while holding a gun. - enableReloadOnlyWhenSwapToOffhand:
false- Iftrue, reloading is only possible using the swap-to-offhand key (‘F’), disabling other methods like right-click (if applicable). - allowGunHitEntities:
true- Iftrue, allows guns to register melee damage when hitting entities directly. - preventHiddenPlayers:
true- Iftrue, players hidden with the hidePlayer api method will not be able to be hit by bullets. - preventGunsInHoppers:
true- Iftrue, guns cannot be moved with hoppers, this feature prevents some exploits related to item duplication. - showOutOfAmmoOnTitle:
false- Iftrue, displays a large title message on the screen when the player tries to shoot with an empty gun. - showReloadingTitle:
false- Iftrue, displays a large title message on the screen while the player is reloading. - showAmmoInXPBar:
false- Iftrue, displays the current gun’s ammo count in the player’s experience bar. - perWeaponPermission:
false- Iftrue, requires players to have individual permissions (qualityarmory.use.<item_name>) to use each specific gun, ammo, or misc item. - useMoveForRecoil:
true- Iftrue, recoil is simulated by directly moving the player’s camera view. Iffalse, other methods might be used. - enableExplosionDamage:
false- Iftrue, explosions caused by QualityArmory projectiles can destroy blocks. - enableExplosionDamageDrop:
false- IftrueandenableExplosionDamageis true, blocks destroyed by explosions will drop their corresponding items. - enablePrimaryWeaponLimiter:
false- Iftrue, 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 craftcommand and the crafting system for QualityArmory items. - enableShop:
true- Enables the/qa shopcommand and the GUI shop for buying QualityArmory items. - AUTO-UPDATE:
true- Iftrue, the plugin will attempt to automatically download and install updates on server start. - Swap-Reload-and-Shooting-Controls:
false- Iftrue, swaps the default mouse button actions (e.g., makes right-click shoot and left-click aim/reload). - Order-Shop-By-Price:
false- Iftrue, items listed in the/qa shopGUI will be sorted by their configured price. - enable_lore_gun-info_messages:
true- Iftrue, displays weapon statistics like damage, ammo type, etc., in the item’s lore text. - enable_lore_control-help_messages:
true- Iftrue, displays basic control instructions (e.g., “[LMB] Shoot”) in the item’s lore text. - Enable_Headshot_Instantkill:
true- Iftrue, landing a headshot on a player or mob results in an instant kill. - Enable_Headshot_Notification_Sound:
true- Iftrue, 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- Iftrue, 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- Iftrue, 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- Iftrue, 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- Iftrue, the plugin attempts to automatically select the correct resource pack version based on the detected Minecraft server version. - ManuallyOverrideTo_1_8_systems:
false- Iftrue, forces the plugin to use item models and mechanics designed for Minecraft1.8, overriding auto-detection. - ManuallyOverrideTo_1_13_systems:
false- Iftrue, forces the plugin to use item models and mechanics designed for Minecraft1.9-1.13, overriding auto-detection. - ManuallyOverrideTo_1_14_systems:
false- Iftrue, forces the plugin to use item models (like Crossbow) and mechanics designed for Minecraft1.14+, overriding auto-detection. - unknownTranslationKeyFixer:
false- Iftrue, 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- Iftrue, the plugin will automatically generate default configuration files (like for guns, ammo, etc.) in its folder if they are missing. - EnableGlowEffects:
false- Iftrue, enables glowing effects on certain items or potentially entities under specific conditions. - Break-Block-Texture-If-Shot:
true- Iftrue, 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- Iftrue, prevents the “Out of Ammo” message from appearing above the hotbar. - disableHotbarMessages.Shoot:
false- Iftrue, prevents the ammo count message from appearing above the hotbar when shooting. - disableHotbarMessages.Reload:
false- Iftrue, prevents the “Reloading…” message from appearing above the hotbar. - automaticallyReloadGunWhenOutOfAmmo:
false- Iftrue, 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- Iftrue, 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- Iftrue, forces the plugin to use the resource pack URL(s) defined underDefaultResourcepackinstead of its internal defaults. - IronSightsOnRightClick:
false- Iftrue, aiming down sights (iron sights) is activated by right-clicking instead of the default (usually sneaking). - SwapSneakToSingleFire:
false- Iftrue, 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 ifenableExplosionDamageis 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.-1disables regeneration. - overrideAttackSpeed:
true- Iftrue(primarily for1.14+), overrides the default item attack speed attribute, potentially allowing faster firing rates. - enable_lore_gun-info_messages:
true- Iftrue, displays weapon statistics like damage, ammo type, etc., in the item’s lore text. - enable_lore_gun-bullets:
false- Iftrue, 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 of0means no delay. - DefaultResourcepack: Defines the resource pack URLs. Refer to ResourcePack Configuration for more information.
- restoreOffHand:
false- Iftrue, 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- Iftrue, allows players to unload their gun’s magazine by pressing their drop key (default ‘Q’) while holding a gun.