Перейти к содержимому
Mineforgian

Ranged Weapon API

🏹 Create fully functional bows and crossbows, with ease

Загрузки
4.6M
Подписчики
233
Обновлён
24 августа 2026 г.
Лицензия
MIT

Опубликован 14 января 2024 г.

Ranged Weapon API

This mod is an API for developers, allowing easy bow and crossbow creation.

bow

Features:

  • Bows and Crossbow construction
  • Customizable weapon properties: damage, pull time, projectile velocity (optional)
  • Automatic item model predicate registration (matching vanilla model predicates)
  • Correct rendering first and third person rendering
  • Correct pull FOV

Read all technical details in the GitHub readme.

Ченджлог

3.0.0+1.21.1-neoforgeРелиз1.21, 1.21.1 · 24 августа 2026 г.

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.)
3.0.0+1.21.1-fabricРелиз1.21, 1.21.1 · 24 августа 2026 г.

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.)
2.3.4+1.21.1-fabricРелиз1.21, 1.21.1 · 19 августа 2026 г.

2.3.4

  • Fully translated content, now supporting 20 languages
  • Marked as library for Fabric
  • Updated project icons
2.3.4+1.21.1-neoforgeРелиз1.21, 1.21.1 · 19 августа 2026 г.

2.3.4

  • Fully translated content, now supporting 20 languages
  • Marked as library for Fabric
  • Updated project icons
2.3.4+1.21.1-fabricРелиз1.21, 1.21.1 · 19 августа 2026 г.

2.3.4

  • Fully translated content, now supporting 20 languages
  • Marked as library for Fabric
  • Updated project icons
2.3.4+1.21.1-neoforgeРелиз1.21, 1.21.1 · 19 августа 2026 г.

2.3.4

  • Fully translated content, now supporting 20 languages
  • Marked as library for Fabric
  • Updated project icons
2.3.3+1.21.1-neoforgeРелиз1.21, 1.21.1 · 3 декабря 2025 г.

2.3.3

  • Fix ranged weapon damage dealt by Bow using mobs (such as Skeletons, Illusioners, etc.)
2.3.3+1.21.1-fabricРелиз1.21, 1.21.1 · 3 декабря 2025 г.

2.3.3

  • Fix ranged weapon damage dealt by Bow using mobs (such as Skeletons, Illusioners, etc.)

Комментарии

Загружаем…