# FX-Accessories — RedM Prop Attachment System
> **The most complete, production-ready accessory system for RedM.**
> No compromises. No dependency hell. Just plug in and play.
---
## Why FX-Accessories?
Most attachment scripts give you a list and a command. FX-Accessories gives your players a **living, breathing accessory experience** — and your admins a full calibration studio, right inside the game.
No Lua knowledge required to add new items. No server restarts to test placements. No spreadsheets for shop stock. Everything works, out of the box, on day one.
---
## What Your Players Get
### 🎭 Radial Accessory Menu
A polished, animated radial menu organised by body part — Head, Neck, Torso, Waist, Arm, Hand, Leg. Players browse, equip and remove items without ever opening a command. Hold to detach. One tap to dress or undress.
### 🛒 In-World Accessory Shops
Place shops anywhere — attached to an NPC, inside a zone, or triggered by `ox_target`. Players see a live 3D preview of every item before they buy, with orbit, zoom and tilt controls. Shopping cart, quantity selection, cash and gold pricing — all included.
### ✨ Equip Animations
Every item can play a unique equip animation when worn — with frame-step control, scrub timeline and cut-point support so the prop appears exactly when it should. `HoldPose` freezes the character at the last frame while the item is equipped. Three animation modes: `auto`, `forceStop`, `disable`.
### 📊 Progress Bar
A sleek progress bar appears automatically when equipping from inventory — always in sync with the animation duration. Shows the item image pulled directly from your inventory folder, with a clean fallback icon.
### 🔔 Built-in Notify System
Info, Success, Error and Warning notifications with custom icons, sounds and a circular countdown timer — all fully locale-aware. Override with your own HUD system in one line.
---
## What Your Admins Get
### 🛠️ Accadmin — In-Game Calibration Studio
A 4-step wizard that lets admins create and fine-tune attachment data **entirely in-game** — no file editing, no restarts.
1. **Setup** — item key, label, model, gender, category and animation
2. **Bone** — visual bone browser with region grouping and live search
3. **Calibrate** — real-time keyboard control, live anim playback with scrubbing
4. **Output** — one-click config copy. Auto-generates VORP SQL and RSG Lua blocks
**Draft system** — save works-in-progress, load them later, delete when done. Multiple drafts, always persistent.
**Access control** — restrict to txAdmin admins, or grant access to specific roles and players via `/giveadminpanel`.
---
## Framework & Inventory Support
- **VORP** — inventory ✓, economy ✓
- **RSG** — inventory ✓, economy ✓
- **None / Custom** — stub mode, no framework needed
Adding a custom framework takes **three steps** — a detection line, a server block, and a restart. The template is inside `frameworks.lua`.
---
## Developer API
```lua
-- Server-side
exports['fx-accessories']:isAttached(serverId, itemName)
exports['fx-accessories']:getAttachments(serverId)
exports['fx-accessories']:attachItem(serverId, itemName)
exports['fx-accessories']:removeItem(serverId, itemName)
```
---
## Everything Included
- ✅ **Accessory System** — full attach, sync, limits, gender filter
- ✅ **Radial Menu** — animated, per-category, multi-item select
- ✅ **Shop System** — NPC/zone, 3D preview, cart, cash & gold
- ✅ **Admin Panel** — 4-step in-game calibration wizard
- ✅ **Animation Library** — 109 pre-configured animations
- ✅ **Notify + Progress bar** — position-editable, locale-aware
- ✅ **Night Menu Light** — auto ambient light, fully configurable
- ✅ **Sample Items** — ready to use on first launch
- ✅ **SETUP.md** — step-by-step installation guide
---
## Configuration
All customer-facing files are **fully open and editable.**
`config.lua` · `config_items.lua` · `config_shops.lua` · `locales.lua` · `frameworks.lua`
Languages included: 🇬🇧 English · 🇹🇷 Turkish · 🇩🇪 German — and easy to extend.
---
## DOCS