🚀 RPS_LIB

Advanced Multi-Framework Bridge Library for FiveM

RPS_LIB is a powerful compatibility framework inspired by ak47_lib, designed to provide developers with a single API that works across multiple frameworks and third-party resources.

Instead of maintaining separate code for ESX, QBCore, QBX, inventories, target systems, fuel scripts, vehicle keys, and garages, RPS_LIB automatically detects and bridges everything for you.

Build once. Support everything.

---

✨ Features

🔹 Multi-Framework Support

Automatic framework detection for:

• ESX Legacy
• QBCore
• QBX Core

No framework-specific code required.

---

🔹 Unified API

Access all systems through one export:

local RPS = exports['rps_lib']:GetLibObject()

Giving you a consistent interface for:

• Players
• Jobs
• Money
• Items
• Vehicles
• Metadata
• Stress
• Notifications
• Progress Bars
• Targets
• Garages
• Vehicle Keys

---

📦 Inventory Support

Compatible with:

• ox_inventory
• qb-inventory
• qb-inventory-old
• qs-inventory
• ps-inventory
• lj-inventory
• codem-inventory
• origen_inventory
• tgiann-inventory
• core_inventory
• jaksam_inventory
• cheeza_inventory
• ak47_inventory
• ak47_qb_inventory

---

🎯 Target Systems

Supports:

• ox_target
• qb-target
• qtarget
• ak47_target
• rps_target

Create interactions once and let RPS_LIB handle the rest.

---

🔔 Notification Systems

Integrated support for:

• ox_lib
• ESX notifications
• QB-Core notifications
• QBX notifications
• Custom notification systems

---

⏳ Progress Bars

Supports:

• ox_lib progress bars
• ESX progress bars
• QB-Core progress bars
• Custom systems

---

⛽ Fuel Systems

Compatible with:

• LegacyFuel
• ox_fuel
• ps-fuel
• lc_fuel

---

🔑 Vehicle Key Systems

Supports:

• tgiann-hotwire
• qs-vehiclekeys
• wasabi_carlock
• qb-vehiclekeys
• qbx_vehiclekeys
• vehiclekeys
• cd_garage
• ak47_vehiclekeys
• ak47_qb_vehiclekeys
• rps_vehiclekeys

---

🚗 Garage Support

Works with:

• jg-advancedgarages
• qb-garages
• cd_garage
• rps_garage

---

🏦 Banking Support

Compatible with:

• Renewed-Banking
• okokBanking
• qb-banking

---

🧠 Stress Systems

Supports:

• jg-stress-addon
• ps-stress
• QB stress
• Ox stress
• Custom systems

Functions include:

RPS.AddStress()
RPS.RemoveStress()

---

🎨 Interface Helpers

Built-in helpers for:

• Notifications
• Progress bars
• Context menus
• Input dialogs
• 3D text
• Objectives
• Checklists

---

📋 Player Utilities

Retrieve:

• Character information
• Jobs
• Job grades
• Identifiers
• Metadata
• Duty status

Using a standardized API regardless of framework.

---

📦 Inventory Utilities

Includes functions for:

• Add items
• Remove items
• Search items
• Open stashes
• Item image links
• Metadata support

---

🎯 Target Utilities

Easily create:

• Box zones
• Entity targets
• Interaction options
• Zone removal

Without worrying about which target script the server uses.

---

⚡ Auto Detection

Set everything to:

Config.Framework = 'auto'
Config.Inventory = 'auto'
Config.Target = 'auto'
Config.VehicleKey = 'auto'
Config.FuelScript = 'auto'
Config.Garage = 'auto'
Config.Banking = 'auto'
Config.Stress = 'auto'

RPS_LIB automatically detects installed resources and configures itself.

---

🔧 Installation

Add to your fxmanifest.lua:

dependency 'rps_lib'

Then simply use:

local RPS = exports['rps_lib']:GetLibObject()

and start building framework-independent resources.

---

⭐ Why RPS_LIB?

✅ One API

✅ Automatic Detection

✅ Multi-Framework Support

✅ Extensive Third-Party Integrations

✅ Lightweight and Optimized

✅ Developer Friendly

✅ Future Proof

---

🌟 RPS_LIB

Advanced Multi-Framework Bridge System

Develop Once. Support Everything.

# 🚑 RPS AI Medic

Bring immersive emergency assistance to your FiveM server with **RPS AI Medic**. When no EMS personnel are available, players can call an AI-controlled medic who travels to their location, performs treatment, and revives them—all while respecting configurable restrictions, cooldowns, and framework integrations.

---

## ✨ Features

- 🤖 AI Medic automatically travels to the player's location

- ❤️ Revives players directly at their current position

- 💰 Configurable treatment pricing

- 🚑 Automatically disables when enough EMS are online

- ⏳ Server-side cooldown system (persists across reconnects)

- 🛡️ Anti-spam request protection

- 📍 Restricted zone support

- 🎭 Random AI medic models

- 📢 Discord webhook logging

- 🔄 Compatible with multiple ambulance systems

- ⚙️ Fully configurable through `config.lua`

- 🔒 Escrow protected with editable configuration

---

# 📦 What's Included

- AI Medic NPC

- Automatic player treatment

- Revive system

- EMS online checking

- Payment handling

- Cooldown management

- Anti-spam protection

- Discord logging

- Configurable revive events

- Restricted area support

---

# ⚙️ Configuration

Everything can be configured including:

- EMS job name

- Maximum EMS online

- Treatment cost

- Society account

- Revive duration

- Command name

- Cooldown

- Anti-spam timer

- Medic models

- Walking speed

- Restricted zones

- Discord webhook

- Revive events

---

# 🚑 How It Works

1. Player becomes incapacitated.

2. Player uses the AI Medic command.

3. Script checks:

- EMS online count

- Cooldown

- Restricted zones

- Anti-spam timer

4. Payment is processed.

5. AI Medic spawns nearby.

6. Medic walks to the player.

7. Treatment countdown begins.

8. Player is revived in place.

9. Optional ambulance events are triggered.

10. Call is logged to Discord (optional).

---

# 🔧 Requirements

- **rps_lib**

Compatible with:

- QBX

- QBCore (via RPS Lib bridge)

- ESX (via RPS Lib bridge)

---

# 💬 Commands

| Command | Description |

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

| `/aimedic` | Request an AI Medic |

---

# 🛠️ Changelog Highlights (v1.0.1)

### Added

- Server-side cooldown

- Request throttling

- Restricted zones

- Random medic models

- Discord webhook logging

- Multiple revive event support

- Native revive system

- Floating treatment countdown

### Fixed

- Payment verification

- Infinite treatment loop

- Revive event timing

- Cooldown tracking

- Debug permissions

- Request handling

- Network revive issues

---

# 🎯 Perfect For

- Roleplay Servers

- Economy Servers

- Survival Servers

- Public Communities

- Private Communities

---

# 🔒 Escrow Information

- Configuration is fully editable.

- Script is protected using FiveM Asset Escrow.

- No core file modifications required.

---

# 📚 Documentation

Documentation:

> https://docs.realplayscripts.co.za/

---

# 💬 Support

Need help?

Join our Discord community for support, updates, and feature requests.

**Discord**

> https://discord.gg/realplayscripts

---

# 🛒 Purchase

Available exclusively from the Real Play Scripts Tebex Store.

**Store**

> https://tebex.realplayscripts.co.za

---

# ❤️ Why Choose RPS AI Medic?

Whether your server has a full EMS team or players are online during quiet hours, RPS AI Medic ensures nobody is left stranded. It provides an immersive AI-powered medical response while maintaining server balance through pricing, cooldowns, and EMS availability checks.

# Introduction

**RPS Small Resources** is a modular collection of lightweight, performance-focused FiveM resources designed to provide useful roleplay, quality-of-life, and server utility features while remaining easy to configure, maintain, and integrate into existing FiveM servers.

The main goal of **RPS Small Resources** is to provide multiple useful features without forcing server owners to completely change their existing framework, inventory, notification, target, fuel, dispatch, radial, door-lock, or gang systems.

Instead, RPS Small Resources is designed to work together with the **RPS Lib (`rps_lib`) advanced bridge system**, which acts as the central integration layer between the individual resources and the systems installed on your server.

---

## What Is RPS Small Resources?

RPS Small Resources is a collection of independent FiveM resources that can be used individually or together.

The package is designed around the idea that small gameplay features should not require large, complicated dependencies or extensive framework-specific modifications.

Depending on the resources included in your installation, RPS Small Resources can provide features such as:

- Player interaction systems

- Hands-up functionality

- Kneeling functionality

- Carry systems

- Crosshair controls

- Map and ESC menu customisation

- Vehicle radio controls

- Roleplay utility features

- Target interactions

- Framework job checks

- Inventory interactions

- Notifications

- Fuel integration

- Dispatch integration

- Radial menu integration

- Door-lock integration

- Gang integration

- Server-side transaction handling

- Permission checks

- Developer integration APIs

Each feature is designed to perform a specific task while remaining compatible with the larger RPS ecosystem.

---

# RPS Lib Integration

One of the most important components of the RPS ecosystem is **`rps_lib`**.

`rps_lib` provides a central bridge system that allows RPS resources to communicate with different FiveM frameworks and third-party resources without requiring every individual script to contain separate integrations.

Instead of writing:

```lua

local QBCore = exports['qb-core']:GetCoreObject()

local Player = QBCore.Functions.GetPlayer(source)

if Player.PlayerData.job.name == 'police' then

-- Police functionality

end

# 📢 RPS Ads — Released!

A clean, modern advertisement system for your city. Businesses, gangs and civilians can broadcast ads to the whole server with one command.

## ✨ Features

- **One simple command:** `/ads "your message"`

- **Job-aware:** the script reads your job and posts as your business automatically, with its logo and title

- **Gang ads:** QBCore and QBox read your **gang**, ESX reads your **job**

- **Lifeinvader fallback:** no listed job? Your ad posts as a public Lifeinvader classified

- **Modern NUI:** top-center card, smooth animations, countdown bar, and its own colour for each ad type (business, gang, Lifeinvader)

- **Configurable pricing:** separate prices for business/gang ads and Lifeinvader ads, bank or cash, or free

- **Anti-spam:** per-player cooldown and a message length limit

- **Discord logs:** every ad is logged with the player name, job and message

- **Easy config:** add businesses and gangs in seconds

## 🧩 Frameworks

✅ ESX ✅ QBCore ✅ QBox ✅ Standalone

Powered by **rps_lib**, so there's no framework editing needed.

## 📦 Dependencies

- `ox_lib`

- `rps_lib`

## ✨ Feature List

**📣 Advertising**

- `/ads "message"` posts an ad to every player on the server

- Players write their own message, while the title and logo come from the config

- Quotes are optional: `/ads Open 24/7!` works too

- Chat suggestion shows how to use the command

- The command name can be changed in the config

**🏢 Business Ads**

- Detects the player's job automatically

- Each business has its own title, logo and on-screen time

- Add as many businesses as you want

**🔫 Gang Ads**

- QBCore and QBox read the player's **gang**

- ESX reads the player's **job**

- Gang ads have their own red style

**🌐 Lifeinvader Ads**

- Players without a listed job post a public Lifeinvader ad

- Title, category, logo and price can all be changed

- Can be turned off completely

**🎨 Modern UI**

- Clean dark card at the top center of the screen

- Smooth slide-in and fade-out animations

- Countdown bar for how long the ad stays up

- Colour for each ad type: blue for businesses, red for gangs, pink for Lifeinvader

- Business logo shown on every ad

- Doesn't take mouse or keyboard focus, so players can keep playing

**💰 Economy**

- Charge per ad from **bank** or **cash**

- Separate price for Lifeinvader ads

- Set the price to `0` for free ads

**🛡️ Anti-Spam**

- Per-player cooldown, in seconds

- Maximum message length

- Cooldowns reset when a player leaves

**📜 Logging**

- Discord webhook log for every ad

- Includes the player's name, ID, job, ad title, price and full message

- Each ad type has its own embed colour

**🧩 Compatibility**

- ESX, QBCore, QBox and Standalone through **rps_lib**

- Framework is detected automatically, no code edits needed

- Light on resources: nothing runs in a loop