# VNC Ammo UI - Premium Weapon HUD System

A highly customizable ammunition HUD that enhances your FiveM server with a modern, professional interface. Features **3 unique styles**, full in-game customization, and seamless **ox_inventory** integration.

## ✨ Key Features

| Feature | Description |

|---------|-------------|

| **3 UI Styles** | Classic (Diamond), Minimal (Enhanced), Tactical (Military) || **2 Position Modes** | Centered (near character) or Corner (bottom-right FPS style) || **Full Customization** | Color picker with 8 presets, drag-and-drop positioning, scale adjustment |

| **ox_inventory Support** | Automatic reserve ammo detection from inventory |

| **Multi-Language** | English and Italian included, easily expandable |

| **0.00ms Idle** | Zero performance impact when not in use |

| **Auto-Save** | All player settings saved automatically |

## 🎨 UI Styles

### 🔷 Classic

The original diamond-shaped HUD with animated lines and glowing effects. Perfect for a sleek, modern look that stands out.

### 🔶 Minimal

Enhanced version with corner brackets `[ ]`, pulsing indicator dots, and an ammo bar. Clean, refined, and professional.

### 🔴 Tactical

Military-style box layout inspired by AAA FPS games. Features weapon header, fire mode badge, ammo bar with segments, heat indicator, and READY/RELOADING status. The ultimate tactical experience.

---

## ⚙️ Customization Options

Through the in-game settings panel (`/ammoui` or `F7`):

- **UI Style**: Switch between Classic, Minimal, and Tactical

- **Position Mode**: Centered or Corner placement

- **Accent Color**: 8 presets + custom color picker

- **Show Background**: Toggle diamond/box fill

- **Show Decorations**: Toggle lines, dots, bars, brackets

- **Show Only When Aiming**: Hide when not aiming (recommended)

- **Hide Default HUD**: Remove GTA's weapon HUD

- **Position & Scale**: Visual drag-and-drop editor with scale slider

Each style + position combination saves its own coordinates independently!

---

## 🔫 Weapon Support

Automatically detects and displays correct information for:
- ✅ All vanilla GTA V weapons
- ✅ Pistols, Revolvers, SMGs
- ✅ Assault Rifles, Machine Guns
- ✅ Shotguns, Sniper Rifles
- ✅ All MK2 weapon variants
- ✅ Launchers and Special weapons
- ✅ Common addon weapons (M4, M4A1, etc.)

Custom weapon names and fire modes included (SEMI, AUTO, PUMP, BOLT, etc.)

---

## 📦 ox_inventory Integration

VNC Ammo UI seamlessly integrates with **ox_inventory** to display reserve ammunition from the player's inventory.

Supports all standard ammo types:
`ammo-9`, `ammo-45`, `ammo-50`, `ammo-44`, `ammo-rifle`, `ammo-rifle2`, `ammo-shotgun`, `ammo-sniper`, `ammo-heavysniper`, and more!

**No configuration needed** - works automatically!

---

## 🌐 Multi-Language

Built-in localization support:
- 🇬🇧 **English** (default)
- 🇮🇹 **Italian**

Easy to add new languages via config file.

---

## 📋 Requirements

| Requirement | Status |
|------------|--------|
| FiveM Server | Required |
| ESX Legacy | Optional |
| ox_inventory | Optional (for reserve ammo) |

---

## 🚀 Installation

1. Download and extract to `/resources`
2. Add `ensure vnc_ammo_ui` to `server.cfg`
3. (Optional) Set language in `shared/config.lua`
4. Restart server

**Installation time: ~1 minute**

---

## 🔌 Developer Exports

```lua
-- Show/Hide UI
exports['vnc_ammo_ui']:ShowAmmoUI(data)
exports['vnc_ammo_ui']:HideAmmoUI()

-- Update ammo
exports['vnc_ammo_ui']:UpdateAmmoUI(current, reserve)

-- Settings
exports['vnc_ammo_ui']:OpenSettings()
exports['vnc_ammo_ui']:CloseSettings()
exports['vnc_ammo_ui']:GetCurrentSettings()
```

---

## 💡 Why Choose VNC Ammo UI?

✅ **Professional Design** - Clean, modern interface that looks AAA quality
✅ **3 Unique Styles** - Something for every server theme
✅ **Player Customization** - Each player personalizes their own HUD
✅ **Optimized Performance** - 0.00ms when idle, minimal impact when active
✅ **Plug & Play** - Works immediately, no complex setup
✅ **Active Development** - Regular updates and new features
✅ **Dedicated Support** - Fast help via Discord

---

## 📊 Performance

| State | Usage |
|-------|-------|
| Idle (no weapon) | 0.00ms |
| Active (aiming) | ~0.01ms |
| Settings open | ~0.02ms |

---

## 🎬 Preview

📺 **YouTube**: [Watch Demo](https://www.youtube.com/watch?v=EPFp9qPveuk)


---

## 🔒 License & Terms

- ✅ Use on unlimited servers you own
- ✅ Modify for personal use
- ❌ Resale or redistribution prohibited
- ❌ Sharing with third parties prohibited

---

## 🤝 Support

| Channel | Link |
|---------|------|
| Documentation | [GitBook](https://vnc-shop.gitbook.io/vnc-shop-docs/vnc-script/vnc-ammo-ui) |
| Discord | [VNC Shop](https://discord.gg/KtBNSEaRDA) |
| Issues | Discord Ticket System |


**Transform your server's weapon experience with VNC Ammo UI!**

*Professional design • Multiple styles • Full customization • ox_inventory ready*