promotional bannermobile promotional banner

Ranged Weapon API

🏹 Create fully functional bows and crossbows, with ease
Back to Files

3.0.0+1.21.1

File nameranged_weapon_api-fabric-3.0.0+1.21.1.jar
Uploader
daedelus_devdaedelus_dev
Uploaded
Aug 24, 2026
Downloads
170
Size
155.7 KB
Mod Loaders
Fabric
File ID
8723066
Type
R
Release
Supported game versions
  • 1.21.1
  • 1.21

Curse Maven Snippet

Fabric

modImplementation "curse.maven:ranged-weapon-api-962162:8723066"

Learn more about Curse Maven

What's new

3.0.0

Ranged weapon properties are now stored in the ranged_weapon:properties item component, instead of injected instance fields.

  • New ranged_weapon:properties item component: pull_time (definitive pull time, in ticks), optional damage (weapon-physics damage baseline, falls back to 6 for bows and 9 for crossbows) and optional velocity (weapon-physics launch velocity baseline, falls back to 3.0 for bows and 3.15 for crossbows). Component presence is what opts an item into the ranged weapon systems; vanilla bows and crossbows receive defaults automatically. Third-party bows/crossbows can be integrated by attaching this component - no Java integration needed.
  • BREAKING: the ranged_weapon:pull_time entity attribute is now display-only. It renders authentic tooltip lines but no longer participates in pull time calculation - attach the component instead to change pull time.
  • BREAKING: removed CustomRangedWeapon (use the component's damage field instead of setTypeBaseline), CrossbowMechanics, BowMechanics and TooltipUtil.
  • BREAKING: RangedWeaponItem subclasses other than bows and crossbows no longer receive damage scaling implicitly; they participate by carrying the component.
  • New authoring type RangedWeaponConfig using absolute values: damage (full charge), pull_time (ticks), optional velocity bonus and optional attribute list. CustomBow/CustomCrossbow gained constructors taking it.
  • DEPRECATED: RangedConfig (bonus-based values) and the constructors taking it. They keep working (converted via RangedConfig.toAbsolute()) but will be deleted in a future release — migrate to RangedWeaponConfig.
  • Override the vanilla Power enchantment definition: instead of flat arrow damage (which bypasses the attribute system), Power now grants +8% ranged_weapon:damage per level.
  • Mob AI can now use custom ranged weapons: Skeleton family + Illusioners fire custom bows (honoring their pull time), Pillagers and Piglins use custom crossbows, with correct arm poses. Works for any weapon carrying ranged_weapon:properties. (These mixins live in the mixin/ai package, so they can be temporarily disabled together during game version migrations.)

This mod has no additional files