📥 Installation Guide¶

Follow these steps to install RPS AI Medic on your FiveM server.

📋 Requirements¶

Before installing, ensure you have:

• ✔️ FXServer Artifact (Latest Recommended)
• ✔️ RPS Lib
• ✔️ One of the supported frameworks:
• QBX
• QBCore
• ESX

📂 Step 1 — Upload the Resource¶

1. Extract the downloaded ZIP file.
2. Upload the folder:

rps_aimedic

to your server's resources directory.

Example:

resources/
└── [rps]
    └── rps_aimedic

📄 Step 2 — Add to server.cfg¶

Add the following line after your framework and RPS Lib.

ensure rps_lib
ensure rps_aimedic

Example:

ensure ox_lib
ensure qbx_core
ensure rps_lib
ensure rps_aimedic

⚙️ Step 3 — Configure the Script¶

Open:

rps_aimedic/config.lua

Configure the settings to match your server.

Examples include:

• EMS Job Name
• Maximum EMS Online
• Treatment Price
• Cooldown
• Command Name
• Medic Models
• Walking Speed
• Discord Webhook
• Restricted Zones
• Revive Events

🚑 Step 4 — Configure the Ambulance System¶

Choose the revive event that matches your server.

Example:

Config.ReviveEvent = "hospital:client:Revive"

or

Config.ReviveEvent = "esx_ambulancejob:revive"

If your ambulance script uses another event, simply replace it in the configuration.

💰 Step 5 — Configure Payments¶

Choose how players should pay for treatment.

Example:

Config.Price = 2500

Optional:

• Cash
• Bank
• Society Account

🚨 Step 6 — Configure EMS Restrictions¶

Prevent AI Medic from being used while EMS are online.

Example:

Config.MaxEMS = 2

If more than 2 EMS are on duty, players must wait for real medical assistance.

📍 Step 7 — Configure Restricted Zones (Optional)¶

Prevent AI Medic from being used in specific locations.

Example:

Config.RestrictedZones = {
    vector3(450.0, -980.0, 30.0)
}

📢 Step 8 — Discord Logging (Optional)¶

Enable Discord logs by adding your webhook.

Example:

Config.DiscordWebhook = "YOUR_WEBHOOK_URL"

Logs can include:

• AI Medic Requested
• Player Revived
• Payment Processed
• Failed Requests
• Cooldowns Triggered

▶️ Step 9 — Restart the Resource¶

Either restart the resource:

restart rps_aimedic

or restart your server.

✅ Step 10 — Test the Script¶

1. Join the server.
2. Down your character.
3. Use the configured AI Medic command.
4. Verify: - Payment is taken - AI Medic spawns - Medic walks to the player - Treatment animation plays - Countdown appears - Player is revived - Cooldown is applied - Discord logs are sent (if enabled)

🔧 Troubleshooting¶

AI Medic does not spawn¶

Check:

• Resource is started
• RPS Lib is running
• Framework is loaded before RPS AI Medic

Player is not revived¶

Verify:

• Correct revive event
• Ambulance resource is running
• Framework bridge is configured correctly

Payment does not work¶

Verify:

• Money type is configured correctly
• Banking resource is running
• Player has sufficient funds

Command does nothing¶

Check:

• Command name in config.lua
• Resource started successfully
• No script errors in the server console

Discord logs do not appear¶

Verify:

• Webhook URL is valid
• Internet access is available
• Discord webhook has not been deleted

🔄 Updating¶

1. Stop the resource.
2. Replace the old files with the new version.
3. Keep your existing config.lua if applicable.
4. Restart the resource.

💬 Need Help?¶

If you need assistance with installation or configuration, join our Discord server:

Discord

https://discord.gg/realplayscripts

Documentation:

https://docs.realplayscripts.co.za

🎉 You're Ready!¶

Once installed, your players can request an AI Medic whenever emergency medical services are unavailable, providing a smooth and immersive gameplay experience.