Public documentation repository for the HyGuns mod.

If you are a player, modpack author, or content creator, start with these pages:

• Quick Start
• Content Reference
• Migration Guide v3.5.2 -> v3.6.0
• Changelog v3.6.1

• custom weapons
• custom ammo items
• ammo selection UI
• ammo-based weapon overrides
• custom projectile behavior
• ammo impact interactions
• wall penetration
• auto-guided ammo
• repair flow and repair kit content

For normal weapon fire-rate behavior, weapons should define both:

• Interactions.Primary.Cooldown.Cooldown
• HyGuns.Settings.Fire.Cooldown

Recommended rule:

• keep both values equal for the base weapon
• use ammo overrides only when special ammo should add extra server-side delay

Current documented release:

• v3.6.1