Craze ox_inventory redesign

OX Inventory Redesign Documentation

OX Inventory Redesign is a standalone FiveM UI overhaul for ox_inventory that adds a GTA-style radial menu, modern blue design theme, and smooth animations. It works with ESX, QBCore, and Standalone – no framework dependency required (only ox_inventory and ox_lib).

Overview

  • GTA-style radial menu for quick hotbar access (slots 1-5) with mouse-based selection

  • Simple flow: Press TAB → radial menu opens → hover/click item → item equips

  • Modern blue design unified across all UI elements (buttons, inputs, tooltips, menus)

  • Persistent styles with automatic CSS injection system

  • Framework independent – works with any FiveM server setup

Key Features

ESX / QBCore / Standalone compatible – Works with any framework or standalone setup

GTA-style radial menu – Interactive circular menu for hotbar items (slots 1-5)

Hold-to-use system – Hold TAB to open, release on item to equip, or click to use

ESC support – Press ESC to close radial menu at any time

Modern blue theme – Unified professional blue color scheme (#50A0FF) for all UI elements

Smooth animations – Fluid transitions and hover effects throughout the interface

Fully redesigned UI – All buttons, inputs, tooltips, context menus, and weight bars overhauled

Style injection system – Automatic CSS injection ensures styles apply even if files don't load properly

Fully configurable – Easy to customize colors, sizes, and animations via CSS

Optimized – Lightweight and production-ready, minimal performance impact

Quick Start

Installation

  1. Create a backup of your current ox_inventory folder

  2. Copy files to your ox_inventory directory:

    • Copy web/radial-menu-standalone.htmlox_inventory/web/

    • Copy web/inventory-redesign.cssox_inventory/web/

    • Copy web/inventory-redesign-inject.jsox_inventory/web/

    • Replace web/build/index.htmlox_inventory/web/build/index.html

  3. Patch client.lua:

    • Open ox_inventory/client.lua

    • Find the line: local invHotkeys = false

    • Insert the complete code from client_patch.lua after that line

  4. Update fxmanifest.lua:

    • Open ox_inventory/fxmanifest.lua

    • Add to files {} section:

  5. Restart resource:

Installation Time: ~5 minutes

Basic Usage

Radial Menu (Hotbar):

  • Press TAB to open radial menu with first 5 inventory slots

  • Mouse hover over items to select

  • Click or release TAB on item to equip/use

  • Press ESC or TAB again to close menu

Main Inventory:

  • Press F2 to open redesigned inventory with blue theme

  • All buttons, inputs, and menus use the new design

Configuration

Edit CSS files to customize all visual settings.

Colors

Edit web/inventory-redesign.css to change color scheme:

Radial Menu Size

Edit web/radial-menu-standalone.html to change menu dimensions:

Animation Speed

Edit web/inventory-redesign.css to adjust transitions:

Border Radius

Edit web/inventory-redesign.css to change corner rounding:

How It Works

Radial Menu Logic

  1. Player presses TAB key

  2. Script checks if player has items in slots 1-5

  3. If items exist → radial menu opens via NUI

  4. Player hovers mouse over items to select

  5. On click or TAB release → item is equipped via useSlot() function

  6. Menu closes automatically after item usage

Style System

  1. CSS File: inventory-redesign.css contains all style definitions

  2. HTML Integration: index.html loads CSS via <link> tag

  3. JavaScript Injection: inventory-redesign-inject.js ensures styles apply even if CSS file fails to load

  4. Iframe System: Radial menu runs in separate iframe for isolation

  5. NUI Communication: Lua ↔ JavaScript message passing for menu control

Persistence

  • Styles persist across inventory opens/closes

  • Radial menu state resets on each open

  • Player settings (if any) could be saved via KVP (future feature)

File Structure

After Installation in ox_inventory:

Open Source Version

File
Status

All files

✅ Fully open and editable

All files included:

  • client_patch.lua – Radial menu Lua code

  • radial-menu-standalone.html – Radial menu HTML/JS

  • inventory-redesign.css – Main stylesheet

  • inventory-redesign-inject.js – Style injection script

  • index.html – Modified main UI

  • fxmanifest_example.lua – Manifest example

  • Complete documentation

Troubleshooting

Styles are not applied

Solution:

  1. Check if all files are listed in fxmanifest.lua files {} section

  2. Clear browser cache (Ctrl+F5 in-game)

  3. Check browser console (F12) for errors

  4. Verify files are in correct locations

  5. Restart resource completely

Radial menu does not open

Solution:

  1. Check if client_patch.lua code is correctly inserted in client.lua

  2. Verify code is placed after local invHotkeys = false

  3. Check F8 console for Lua errors

  4. Verify keybind is configured (default: TAB)

  5. Ensure radial-menu-standalone.html is in files {} section

  6. Check if items are in slots 1-5 (menu only shows if items exist)

Solution:

  1. Check F8 console for useSlot errors

  2. Verify NUI callbacks are registered correctly

  3. Check if hotkeys 1-5 are blocked by other scripts

  4. Ensure RegisterNUICallback('radialMenu:useItem') is in code

Double styles or conflicts

Solution:

  1. Ensure only ONE CSS file is loaded

  2. Check if other addons override styles

  3. Use browser DevTools (F12) to find conflicts

  4. Verify CSS file path in index.html is correct

Icons not displaying in radial menu

Solution:

  • This is normal during drag & drop (intended behavior)

  • Icons should be visible in normal inventory (F2)

  • If not, check browser console for image loading errors

  • Verify background-image CSS is not overridden

Solution:

  1. Check if closeRadialMenu() is called after useSlot()

  2. Verify ESC/TAB close handlers are working

  3. Check NUI callback closeRadialMenu is registered

  4. Restart resource to reset state

Requirements

  • ox_inventory (v2.43.5 or higher) – Required

  • ox_lib – Required dependency

  • FiveM Server – Latest build recommended

Design Features

  • Blue Color Palette – Unified blue design (#50A0FF)

  • Glow Effects – Subtle glow effects for interactive elements

  • Smooth Transitions – Fluid animations (0.25s cubic-bezier)

  • Modern Borders – Rounded corners (8px border-radius)

  • Hover States – All interactive elements have hover effects

  • Responsive Design – Works on all screen resolutions

Radial Menu Features

  • Displays first 5 inventory slots

  • Mouse-based selection with visual feedback

  • Click or release to use items

  • Smooth open/close animations

  • Transparent background with centered menu

  • Item icons and labels displayed

  • Real-time slot updates

Support

Discord: [Discordarrow-up-right]

Tebex: https://codecraze-development.tebex.io

For Support:

  • Check this documentation first

  • Check browser console (F12) for errors

  • Check F8 console for Lua errors

  • Provide ox_inventory version

  • Provide FiveM server version

  • Include error messages and screenshots


Note: This is a UI redesign for ox_inventory. You must own ox_inventory to use this product. This product only includes the redesign files, not ox_inventory itself.

Last updated