NC Attack — Fantasy Weapons for Players

Fantasy weapons for players: greatsword, sword, katana, dagger, hatchet, great axe, magic staff, bow and dual pistols. They are held in hand as props with their own animations, sounds and particle effects, never GTA weapons. Combos, heavy attacks, stamina, mana, two aim modes, arrows you pick back up and weapons visible on the body. The server decides every hit: the client only says who it hit.

• Works with Qbox, QBCore, ESX or without a framework (detected automatically through nc_bridge).
• Hits players (PvP can be turned off), GTA NPCs, mobs and rift portals of NC Rift, mobs of NC Dungeon.
• No friendly fire between members of the same NC Party.
• 2 languages: English and Italian (each player gets the language of their game).
• The UI follows the NC Bridge themes (and the theme of NC Rift / NC Party when they run).
• Works with ox_target: clicking with the eye never starts an attack.

Full config guide (every option): CONFIG_GUIDE.md.

Requirements

• FiveM server with OneSync on (the server checks the hits with the player positions).
• The nc_bridge resource (shared library of the NC resources) in resources/.
• The nc_attack_assets resource (weapon models, animations, particle effects, sounds) in resources/.
• Optional: ox_inventory (or the Qbox / QBCore / ESX inventory) for the weapon items, NC Party, NC Rift, NC Dungeon, nc_hud (mana linked to its classes).

Installation

1. Copy the nc_bridge, nc_attack_assets and nc_attack folders into resources/.
2. Items:
   • ox_inventory: copy the items of nc_attack/install/ox_items.lua into ox_inventory/data/items.lua (inside return { ... }).
   • Qbox / QBCore / ESX without ox_inventory: create items with the same names (nc_spadone, nc_spada, nc_katana, nc_daga, nc_ascia_piccola, nc_ascia_grande, nc_bastone, nc_arco, nc_pistole, nc_arrow, nc_pistol_ammo). nc_attack makes them usable by itself.
3. In server.cfg, after the framework and the inventory:

ensure nc_bridge
ensure nc_attack_assets
ensure nc_party      # optional
ensure nc_rift       # optional
ensure nc_attack

4. Admins (positions editor, test commands):

add_ace group.admin nc_attack.admin allow

5. Restart the server, join and test with nc_attack_give <id> <weapon> (server console or admin).

Start nc_attack_assets only with the server: never ensure / restart it with players inside, the clients crash. If you own several NC packs keep only one nc_bridge folder, the newest.

The weapons

Without a weapon in hand the GTA punches are off and fists use their own combo (left) and a kick (right) (Config.Fists). Every weapon (models, combos, damage, range, angle, stamina, sounds, effects) is in config/weapons.lua.

How to play

• Use the item from the inventory = draw / holster that weapon. H = draw the last weapon / holster.
• Melee: left click = combo, right click = heavy attack. You turn toward the nearest target and close small gaps (lock-on circle on the target). While you move the attack plays from the waist up.
• Ranged (bow, pistols, staff): B switches aim mode.
  • *Quick*: click = shot at once, aim snaps to the nearest target in front of the camera.
  • *Precision*: hold right click = first-person zoom, no spread, headshot bonus; bow: hold left click to draw, release to shoot.
• R = reload (pistols) or ground slam (staff). E = pick up an arrow from the ground.
• Space = backward dodge with a weapon in hand (costs stamina; with the fists only during a fight).
• F7 or /armi = holster menu (where each weapon sits on the body).
• Stamina bar for every swing, shot and draw; mana bar for the staff. At 0 stamina you cannot attack for a moment.
• Damage numbers over the targets, red numbers for the damage you take, combo counter on screen.

Every player can change the keys in Settings > Key Bindings > FiveM.

Weapons on the body (/armi, F7)

The weapons you own are visible on the body (back, crossed on the back, low back, hips, thighs, chest). In the menu each player picks the place of every weapon, fine-tunes it with sliders or hides it. The choice is saved on the player's PC and seen by everyone.

Admins (nc_attack.admin) also see an Admin section in the same menu: the position chosen there is saved for everyone in data/positions.json and becomes the starting position of every player.

Weapon in hand: admin editor (/armimano)

Admin only (nc_attack.admin). Optional key: assign it in Settings > Key Bindings > FiveM (Config.Keys.handEditor).

• Every weapon in the list (even if you do not own it), right / left hand for the pistols.
• Position X / Y / Z and rotation sliders with exact number fields and ±90° buttons.
• Bone: SKEL_R_Hand, PH_R_Hand, SKEL_L_Hand, PH_L_Hand.
• An attack of the weapon in a loop with pause, speed and frame, orbit camera and a button that frames the hand.
• Save for everyone = data/positions.json (wins over the config). Back to config removes the saved value.
• Copy for config = the hand = { ... } line to paste into config/weapons.lua (also printed in F8).

Commands

With the other NC resources

Each one can be turned off in Config.Combat / Config.Bridge. Without them nc_attack works on its own (players and NPCs).

For developers

• exports.nc_attack:UseWeapon(src, item) (server): draws / holsters a weapon as if the player used the item.
• server/bridge.lua is open: job of the player, owned items, usable items for other inventories.
• Readable and editable: config.lua, config/weapons.lua, locales/*.lua, server/bridge.lua, web/style.css. The rest of the code is protected with Cfx escrow; nc_attack_assets is encrypted except the sounds (web/sounds, replaceable with your .ogg / .mp3 / .wav).

Problems

• Weapon not drawn when using the item: check the item names and, with ox_inventory, the server.export line of each item (install/ox_items.lua).
• Weapon in a strange position in the hand: fix it with /armimano and save for everyone.
• No damage to rift mobs or portals: nc_rift must start before nc_attack and Config.Combat.riftMobs / riftPortals must be true.
• Animations or models missing: nc_attack_assets must start before nc_attack; restart the whole server after adding it.