NC Wings — Animated Demonic Wings & Tail

Animated demonic wings and tail worn on the back of the player ped. Admins assign them from a panel, players put them on and off with /wings and switch between 4 animations. The tail burns with a red fire effect. One pair per player, saved in the database and put back on by itself when the player comes back.

Works with Qbox, QBCore, ESX or without a framework (detected automatically at start).
9 languages: Italian, English, German, French, Spanish, Portuguese, Chinese, Japanese, Korean.
5 colours: Original, Golden, Blood red, Midnight blue, Emerald green.
4 animations: idle, fly, hungry, listen.
Red fire particles on the tip of the tail, started by every client on its own copy (nothing heavy on the network).
The server decides everything: permissions, assignments and anti-spam are checked on the server.
Everything ships inside the resource: models, textures, animations and the effect.

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

Requirements

ox_lib
oxmysql with a MySQL / MariaDB database
Optional: a framework (Qbox, QBCore or ESX). Without it the resource runs standalone.

Installation

Copy the nc_wingstails folder into resources/.
In server.cfg, after ox_lib, oxmysql and your framework:

ensure ox_lib
ensure oxmysql
ensure qbx_core
ensure nc_wingstails

Replace qbx_core with qb-core or es_extended, or leave that line out to run standalone.

Restart the server. The table nc_wingstails_assigned is created by itself (you can also import sql/install.sql; it never deletes data).
In game, as an admin: /wingstails → choose the player, the colour and the animation → Assign. The player types /wings.

What's inside

Part	What it does
Admin panel	`/wingstails` opens a compact panel: player (online, or offline by Citizen ID) → wings → colour → animation → Assign or Revoke. It shows the current assignment of the player.
Player toggle	`/wings` puts the wings on or takes them off; also a key every player can set in the FiveM settings.
Animations	`/wings idle`, `/wings fly`, `/wings hungry`, `/wings listen` switch the animation; the choice is saved.
Fire effect	Red fire on the tail bone `nc_wingstails_tail_28`; you can turn it off or change its size in the config.
Saved	One row per character in `nc_wingstails_assigned`: wings, colour, animation and whether they are worn. Restored on character load.
Other players	The wings of other players are shown only within `Config.StreamDistance` metres.

Commands

Command	Who	What it does
`/wingstails`	admin (see `Config.Permission`)	Opens the admin panel to assign or revoke wings.
`/wings`	player with assigned wings	Puts the wings on / takes them off.
`/wings <animation>`	player with assigned wings	Switches the animation: `idle`, `fly`, `hungry`, `listen`.
`/wingspos x y z rx ry rz [bone]`	only with `Config.Debug = true`	Moves your wings live and prints the `pos` / `rot` / `bone` line to paste in `config.lua`.

The command names can be changed in Config.Command and Config.ToggleCommand.

Permissions

The admin panel is allowed when at least one rule of Config.Permission matches: everyone, an ACE (nc_wingstails.use), a framework group, a job or an identifier. Example with ACE in server.cfg:

add_ace group.admin nc_wingstails.use allow

/wings does not need a permission: every player can wear the wings an admin assigned to them.

Open and editable files

File	What you can change
`config.lua`	Every option (see CONFIG_GUIDE.md).
`locales/*.lua`	Every text, in 9 languages.
`bridge/framework/*.lua`	How the framework is read (player id, name, groups, jobs, notifications).

Problems

Problem	What to check
`/wingstails` says you are not allowed	No rule of `Config.Permission` matches you: add the ACE, your group or your identifier.
`/wings` says you have no wings	An admin must assign them first with `/wingstails`.
Wings not back after a relog	Start `nc_wingstails` after the framework in `server.cfg`.
Error when assigning	`oxmysql` not started before the resource, or no database connection.
No fire on the tail	`effect.enabled` is `false` in `Config.Props`, or `red_effect.ypt` was removed from `stream/`.

Languages

Set Config.Locale to 'it', 'en', 'de', 'fr', 'es', 'pt', 'zh', 'ja' or 'ko'. Chinese, Japanese and Korean are shown in the panel and in the notifications; the key name in the FiveM settings stays in English.

Version

3.0.0 — 9 languages, NC Wings name in panel and notifications, cleaned files for sale.
2.0.0 — new script: admin panel, one pair per player saved in the database, 5 colours, 4 animations, fire effect, Qbox / QBCore / ESX / standalone.

The full guide in 9 languages is also in the resource's docs/ folder.