Installer tes
armes ONYXInstall your
ONYX weapons

Avant de commencerBefore you start

Quelle est ta base ?Which base do you run?

Les armes ONYX marchent sur tous les serveurs FiveM : la ressource elle-même ne dépend d’aucun framework. Ce qui change d’une base à l’autre, c’est uniquement l’endroit où tu déclares les armes pour que ton inventaire les reconnaisse. Repère ta ligne :

ONYX weapons work on every FiveM server: the resource itself does not depend on any framework. The only thing that changes from one base to another is where you declare the weapons so your inventory recognises them. Find your row:

01 · Récupérer ton packGet your pack

Télécharger depuis Cfx.reDownload from Cfx.re

Ce qu’il faut pour que ça marcheWhat you need for it to work

02 · Installer la ressourceInstall the resource

Déposer et lancer le packDrop in and start the pack

1. Décompresse le .zip, puis place le dossier onx_…_pack dans ton dossier resources. Tu peux ranger tous tes packs dans un dossier [onyx] (les crochets en font une catégorie).
2. Ne renomme pas le dossier et ne modifie pas les fichiers du dossier stream : ils sont protégés.
3. Ajoute le pack dans server.cfg, après ton framework et ton inventaire.
4. Redémarre complètement le serveur (pas seulement un refresh), puis reconnecte-toi.

1. Unzip the .zip, then place the onx_…_pack folder in your resources folder. You can keep all your packs in an [onyx] folder (brackets make it a category).
2. Do not rename the folder and do not edit files in the stream folder: they are protected.
3. Add the pack to server.cfg, after your framework and your inventory.
4. Fully restart the server (not just a refresh), then reconnect.

# ONYX STUDIO · add-on weapons
ensure onx_halloween_pack
ensure onx_frostbite_pack

# or start the whole [onyx] folder at once:
# ensure [onyx]

Sur un serveur standalone (sans framework), c’est terminé : les armes existent dans le jeu et n’importe quel script peut les donner avec leur nom de spawn. Sur les autres bases, il reste à les déclarer dans ton inventaire.

On a standalone server (no framework), you are done: the weapons exist in the game and any script can give them by spawn name. On other bases, you still need to declare them in your inventory.

03 · Configurer l’inventaireSet up your inventory

Ton code, généré pour ta baseYour code, generated for your base

Coche les packs que tu as achetés et choisis ton inventaire. Tout ce que tu dois coller apparaît en dessous, fichier par fichier, avec le chemin exact. Les valeurs (poids, munitions, durabilité) sont celles fournies dans le README de chaque pack.

Tick the packs you bought and choose your inventory. Everything you need to paste shows up below, file by file, with the exact path. The values (weight, ammo, durability) match the README shipped with each pack.

Astuce : chaque bloc a un bouton Télécharger qui te donne un fichier .lua avec exactement le même contenu, pratique pour l’ouvrir à côté du tien.

Tip: every block has a Download button that gives you a .lua file with exactly the same content, handy to open next to yours.

04 · Images d’inventaireInventory images

Des PNG déjà prêtsReady-made PNGs

Chaque image est détourée sur fond transparent et porte exactement le nom de spawn de l’arme, en majuscules : WEAPON_ONX_HGLOCK.png. Tu les déposes, et l’image apparaît avec l’arme dans l’inventaire, sans rien renommer.

Every image is cut out on a transparent background and named exactly like the weapon’s spawn name, in uppercase: WEAPON_ONX_HGLOCK.png. Drop them in and the image shows up with the weapon in the inventory, with nothing to rename.

05 · Tester en jeuTest in game

Vérifier en une commandeCheck with one command

Connecte-toi avec un compte admin, puis donne-toi une arme. Remplace 1 par ton ID joueur.

Join with an admin account, then give yourself a weapon. Replace 1 with your player ID.

Ce que tu dois voirWhat you should see

• L’arme apparaît dans l’inventaire avec son image.
• Une fois équipée, elle est bien tenue en main et s’affiche avec son nom dans la roue des armes.
• Le rechargement marche avec les munitions indiquées dans la section Munitions.

• The weapon shows in the inventory with its image.
• Once equipped, it sits properly in the hand and shows its name in the weapon wheel.
• Reloading works with the ammo listed in the Ammo section.

Un souci ? Va voir le dépannage.

Something off? Check troubleshooting.

Aller plus loinGoing further

MunitionsAmmo

Les armes ONYX utilisent les munitions de base de ton inventaire : tu n’as aucun nouvel item de munitions à créer.

ONYX weapons use your inventory’s standard ammo: there is no new ammo item to create.

Le type exact de chaque arme est indiqué dans la liste des armes. Tu peux changer de munition : sur ox_inventory, modifie ammoname ; sur QBCore, modifie ammotype dans items.lua et weapons.lua.

Each weapon’s exact ammo is shown in the weapon list. You can switch ammo: on ox_inventory, change ammoname; on QBCore, change ammotype in items.lua and weapons.lua.

Aller plus loinGoing further

Personnaliser tes armesCustomise your weapons

Le nom dans la roue des armesThe name in the weapon wheel

Il se trouve dans le fichier client.lua du pack, qui reste modifiable. Change seulement le texte entre guillemets, puis redémarre le serveur.

It lives in the pack’s client.lua file, which stays editable. Only change the text between quotes, then restart the server.

local labels = {
    WT_ONX_HGLOCK = "Glock hanté",   -- texte affiché / displayed text
    WT_ONX_HSMG = "SMG hantée",
}

Le nom affiché dans l’inventaire est un autre réglage : c’est le label que tu as collé à l’étape 03.

The name shown in the inventory is a separate setting: it is the label you pasted in step 03.

Poids et durabilitéWeight and durability

Ils se règlent dans ton inventaire : weight (en grammes) et durability sur ox_inventory, weight et Config.DurabilityMultiplier sur QBCore.

They are set in your inventory: weight (in grams) and durability on ox_inventory, weight and Config.DurabilityMultiplier on QBCore.

Dégâts, chargeur, cadenceDamage, magazine, fire rate

Chaque arme a son fichier meta/onx_…/weapons.meta, lui aussi modifiable. Les réglages les plus utiles : <Damage value="…"/>, <ClipSize value="…"/> et <TimeBetweenShots value="…"/>. Fais une copie du fichier avant d’y toucher.

Each weapon has its own meta/onx_…/weapons.meta file, also editable. The most useful settings: <Damage value="…"/>, <ClipSize value="…"/> and <TimeBetweenShots value="…"/>. Make a copy of the file before you edit it.

Aller plus loinGoing further

Mises à jourUpdates

1. Quand un pack est mis à jour, retélécharge-le depuis portal.cfx.re → Assets → Granted Assets.
2. Si tu avais modifié client.lua ou des fichiers .meta, garde-en une copie.
3. Remplace l’ancien dossier par le nouveau, remets tes fichiers modifiés, puis redémarre le serveur.

1. When a pack is updated, download it again from portal.cfx.re → Assets → Granted Assets.
2. If you had edited client.lua or .meta files, keep a copy.
3. Replace the old folder with the new one, put your edited files back, then restart the server.

Avec ALL ACCESS, les nouvelles armes arrivent dans onx_all_weapon_pack. Reviens sur le configurateur : il est toujours à jour, il te suffit d’ajouter les lignes des nouvelles armes.

With ALL ACCESS, new weapons land in onx_all_weapon_pack. Come back to the configurator: it is always up to date, just add the lines for the new weapons.

Aller plus loinGoing further

DépannageTroubleshooting

RéférenceReference

Liste des armesWeapon list

Toutes les armes ONYX avec leur nom de spawn exact, leur type, leur poids et leur munition ox_inventory. Clique sur l’icône pour copier un nom, ou sur PNG pour télécharger une image seule.

Every ONYX weapon with its exact spawn name, type, weight and ox_inventory ammo. Click the icon to copy a name, or PNG to download a single image.

Support

Besoin d’aide ?Need help?