ktoxktox docs

Getting Started

Installation and setup guide for ktx_cases, an animated loot case system for FiveM.

Getting Started

ktx_cases is an animated loot case system for FiveM. Server-authoritative reward selection with rarity tiers and a React NUI animation. Supports money, items, weapons, vehicles, and coins as reward types.

Requirements

  • ox_lib - utility library
  • oxmysql - async MySQL driver (required if database logging is enabled)
  • OneSync - must be enabled on your server
  • es_extended - default framework (adaptable via custom hooks)

Installation

  1. Download from Keymaster
  2. Extract to your server's resources folder
  3. Import install.sql into your database (required for opening logs)
  4. Add to server.cfg
ensure ox_lib
ensure ktx_cases

Usage

Open cases in two ways:

  • /cases command - opens the case selection UI
  • Use a case item from inventory - triggers the opening animation directly

Rewards are rolled server-side. The client animation plays while the server determines the result.