Browse docs

Overview

Install Sky Primitive Weapons and use the Bow, Crossbow, Spear and Slingshot with your inventory.

Sky Primitive Weapons adds four equippable weapons with their own aiming, loading, throwing and recovery behavior. The resource is sky_primitive_weapons and requires Sky Base and OneSync. It can run without Sky Hunting or Jobs Base.

Installation

Install and configure Sky Base for your framework and inventory.
Place the supplied sky_primitive_weapons resource in your server's resources directory. Keep its name unchanged.
Install the weapon and ammunition definitions from Inventory items, then copy the supplied inventory images as described on that page.
Start the resource after Sky Base and your configured inventory:

server.cfg

ensure sky_base
ensure sky_primitive_weapons

If you also use Sky Hunting, start it after sky_primitive_weapons. Replace the retired sky_hunting_bow resource rather than starting both weapon registrations. When installing or updating the weapon assets, stop the server first and reconnect with a fresh FiveM client after startup.

Weapon controls

Equip each weapon through your inventory's normal weapon action. Keyboard and mouse defaults are shown below; controller bindings follow the game's matching controls.

Weapon	Use
Recurve Bow	Hold Aim, hold Attack to nock and draw, then release Attack to shoot.
Crossbow	Press Reload to cock and load, then hold Aim and press Attack to fire. Reload again for the next bolt.
Spear	Press Attack to thrust. Hold Aim and press Attack after raising the Spear to throw. Approach the landed Spear or struck body and press E to recover it.
Slingshot	Hold Aim, hold Attack to load and pull, then release Attack to shoot.

The Bow, Crossbow and Slingshot consume one matching ammunition item for each authorized shot. A thrown Spear consumes the weapon itself; recovery returns that weapon. Do not add a second inventory reload or ammunition-use action.

Configuration

All weapon settings, the selected language and the supplied runtime text are in config/config.lua. Inventory images are directly inside config/images/. Keep any customized ammunition item names aligned with your inventory catalogue.

Changelog

Release notes and update steps for sky_dj.

Inventory items

Copyable weapon and ammunition definitions for Sky Primitive Weapons in the standard inventory formats.