ModsFinder

Ranged Weapon API

by ZsoltMolnarrr

Ranged Weapon API is a developer library for building bows and crossbows on Fabric, Forge and NeoForge, with the game's own rendering and pull behavior.

FabricForgeNeoForgeClient and serverMIT LicenseOpen source1.20.1 – 26.3

What it does

Developers use the library to create bow and crossbow items without writing the full rendering and firing code themselves. Weapon properties such as damage, pull time and projectile velocity can be set per item, and projectile velocity is optional. Item model predicates are registered automatically to match the vanilla bow and crossbow predicates, so the weapons animate the way players expect.

The library handles first and third person rendering and the pull field of view, which are the parts that usually require the most manual work. It is open source under the MIT License and is intended for mod authors rather than for players installing content. Required by 19 other mods in the catalog, including Jewelry (RPG Series), Marium's Soulslike Weaponry and Archers (RPG Series). EMI is an optional dependency that adds recipe viewing when present. Servers that run it need every player to install it too. Files are published for 1.20.1, 1.21, 1.21.1, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2 and 26.3, and the most recent builds target 26.3 on Fabric and NeoForge.

Key features

  1. Bow and crossbow construction

    The library provides the base structure needed to build a bow or crossbow item in code.

  2. Configurable weapon properties

    Damage, pull time and projectile velocity can each be set per weapon, with velocity left optional.

  3. Vanilla-matching model predicates

    Item model predicates are registered automatically so weapon models switch frames the same way vanilla ones do.

  4. First and third person rendering

    Held weapons render correctly from both the first person and third person camera views.

  5. Correct pull field of view

    The field of view narrows while a bow is drawn, matching the vanilla behavior for custom weapons.

Compatibility

Latest build for each game version and loader.

26.x5 of 5 versions with builds
26.34.0.0+26.3-fabricNot available4.0.0+26.3-neoforge
26.24.0.0+26.2-fabricNot available4.0.0+26.2-neoforge
26.1.24.0.0+26.1.2-fabricNot available4.0.0+26.1.2-neoforge
26.1.14.0.0+26.1.2-fabricNot available4.0.0+26.1.2-neoforge
26.14.0.0+26.1.2-fabricNot available4.0.0+26.1.2-neoforge
1.21.x3 of 3 versions with builds
1.21.114.0.0+1.21.11-fabricNot available4.0.0+1.21.11-neoforge
1.21.13.0.0+1.21.1-fabricNot available3.0.0+1.21.1-neoforge
1.213.0.0+1.21.1-fabricNot available3.0.0+1.21.1-neoforge
1.20.x1 of 1 version with builds
1.20.12.3.4+1.20.1-fabric2.3.4+1.20.1-forge2.3.4+1.20.1-forge
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Optional 1

EMIA featureful and accessible item and recipe viewer
Optional

Required by 19 mods

Jewelry (RPG Series)1.19.2 – 26.3Marium's Soulslike Weaponry1.18.2 – 1.21.1Archers (RPG Series)1.20.1 – 26.3MC Dungeons Weapons1.20 – 1.20.1Relics (RPG Series)1.20.1 – 26.3Arsenal (RPG Series)1.20.1 – 26.3

Use cases

Custom bows for a new weapon set

A mod author adds a longbow or a heavy crossbow with its own damage and pull time, relying on the library for rendering.

Crossbow variants in a themed pack

A modpack author defines several crossbow types that differ only in their properties, reusing the same construction code.

Who it’s for: Mod developers building bow or crossbow content for Fabric, Forge or NeoForge. Players who only install finished weapon mods do not need to work with the API directly.

How it compares

Full comparison

TT's Lib│特特的庫 is server-side required with client optional, open source under the MIT License, and published for 1.21.9 – 1.21.11 on Fabric, Forge, NeoForge and Quilt. More RPG Library is client and server, open source under the MIT License, and covers 1.20.1 – 1.21.1 on Fabric, Forge and NeoForge. Crossbow is a Forge-only mod for 1.12.2 under a custom license and is not open source, so it does not offer a library for other loaders.

ModLoadersGame versionsEnvironmentUpdated
Ranged Weapon APIFabric, Forge and NeoForge1.20.1 – 26.3Client and server2026-09-28
TT's Lib│特特的庫Fabric, Forge, NeoForge and Quilt1.21.9 – 1.21.11Server required, client optional2026-04-13
More RPG LibraryFabric, Forge and NeoForge1.20.1 – 1.21.1Client and server2026-10-11
CrossbowForge1.12.2Client and server2025-12-14

Questions

Does Ranged Weapon API need to be installed on the server?

Yes. Installation covers the server and each player's game.

Which loaders does Ranged Weapon API support?

Fabric, Forge and NeoForge are supported. The latest Forge file is 2.3.4+1.20.1-forge for 1.20.1, while Fabric and NeoForge have builds for 26.3.

Does Ranged Weapon API require EMI?

No. EMI is an optional dependency, and the library works without it.

In the catalog

Ranged Weapon API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.

Library mods3,514Fabric modsMods for 26.38,071

More from ZsoltMolnarrr

All projects
Better Combat1.18.2 – 26.3Combat Roll1.18.2 – 26.3Spell Engine1.19 – 26.3Spell Power Attributes1.19 – 26.3Wizards (RPG Series)1.19 – 26.3Runes1.19 – 26.3

Similar mods

Fabric API1.14 – 26.3Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Just Enough Items (JEI)1.8 – 26.3Geckolib1.12.2 – 26.3

What the author says

This mod is an API for developers, allowing easy bow and crossbow creation. 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…
ZsoltMolnarrr, on the Modrinth page

Official listing

Owner
ZsoltMolnarrr
Published
2024-01-14
Updated on Modrinth
2026-09-28
Facts verified
2026-10-15

Tags

EquipmentLibrary
Open on ModrinthCompare