Flake Physical Therapy

Overview

Physical therapy brings immersive rehabilitation to your server. Injured players visit a therapy location, complete guided exercise steps, and have crutches removed upon completion.

Features

• Dual Framework — Auto-detects ESX, QBX, or QB-Core.
• Multi-Step Therapy — Configurable 3-step exercise chain per location.
• Crutch Integration — Compatible with Wasabi Crutch and AK47 Crutch.
• Doctor Slip Item — Optional item to bypass payment.
• EMS Check — Require minimum EMS online or allow always.
• Cooldown System — Prevent spam with per-player cooldowns.
• Flexible Interaction — ox_target, qb-target, or TextUI + E key.
• Per-Location Pricing — Set different costs for each therapy site.
• Custom Animations — Each step supports its own animation dictionary and clip.

Requirements

Installation

Step 1 — Ensure the Resource

Place the flake_physicaltherapy folder into your server's resources directory and add to server.cfg:

Step 2 — Add Items (Optional)

If you want to use the doctor slip item bypass, add the configured item to your inventory:

Config.DoctorSlipItem = {
    enable = true,
    item   = 'docslip'
}

Step 3 — Configure

Edit config/config.lua to set your framework, interaction system, EMS jobs, locations, and pricing.

File Structure

flake_physicaltherapy/
├── client/
│   ├── client.lua            -- Therapy logic, animations, steps
│   └── cl_notifications.lua  -- Notification overrides
├── server/
│   ├── server.lua            -- EMS checks, money, cooldowns
│   └── sv_notifications.lua  -- Notification server bridge
├── config/
│   ├── config.lua            -- Main settings (escrow-ignored)
│   └── editable.lua          -- Notifications and TextUI (escrow-ignored)
└── fxmanifest.lua        -- Resource manifest

Configuration

All tunables live in config/config.lua and config/editable.lua. These files are escrow-ignored.

Framework & Interaction

EMS & Availability

Cooldowns

Config.Cooldown = {
    enable = true,
    time   = 600  -- seconds (10 minutes)
}

Doctor Slip

When enabled, players with the item skip payment entirely. The item is consumed on use.

Config.DoctorSlipItem = {
    enable = true,
    item   = 'docslip'
}

Location Settings

Step Configuration

{
    coords = vec4(322.37, -592.38, 43.28, 68.94),
    progress = {
        duration  = 20000,
        label     = 'Leg Stretching...',
        canCancel = false,
        disable   = { move = true, combat = true },
        anim = {
            dict = 'mini@triathlon',
            clip = 'idle_e',
            flag = 7
        }
    }
}

Usage

Starting Therapy

1. Visit a therapy location (marked with a green blip if enabled).
2. Approach the NPC and interact via target or press E (TextUI).
3. The server validates EMS count, cooldown, and payment / doctor slip.
4. If approved, follow the yellow markers to each exercise step.
5. Complete all steps to finish therapy and have your crutch removed.

Payment Flow

• If you have a doctor slip, it is consumed and therapy is free.
• Otherwise, the location's cost is deducted from your cash.
• If you cannot afford it, the session is denied.

Step Markers

Each therapy step spawns a yellow marker visible from 50 meters. Stand within 2 meters and press E to begin the progress bar animation. Movement and combat are disabled during each step.

Crutch Support

Integrates with popular crutch scripts to automatically remove crutches after therapy completion.

Supported Scripts

Crutch Requirement

When wasabi_crutch is running, therapy can only be started if the player is actively using a crutch. Other crutch systems do not expose an active check and will allow therapy regardless.

Doctor Slip Removal

Players can also use a doctor slip item to remove their crutch immediately without visiting a therapy location.

Adding Locations

New therapy sites can be added by copying the existing location block in config/config.lua:

Config.TherapyLocations = {
    MyNewLocation = {
        coords   = vec4(100.0, 200.0, 30.0, 90.0),
        cost     = 1000,
        showBlip = true,
        ped = {
            model  = 's_m_m_doctor_01',
            coords = vec4(100.0, 200.0, 30.0, 90.0),
        },
        steps = {
            {
                coords = vec4(102.0, 202.0, 30.0, 0.0),
                progress = {
                    duration  = 15000,
                    label     = 'Warm Up...',
                    canCancel = false,
                    disable   = { move = true, combat = true },
                    anim = {
                        dict = 'mini@triathlon',
                        clip = 'idle_e',
                        flag = 7,
                    },
                },
            },
            -- Add up to 3 steps
        },
    },
}

Troubleshooting