For the complete documentation index, see llms.txt. This page is also available as Markdown.

🩺Veterinary System

🩺 Veterinary System

📋 Overview

The Veterinary System introduces complete pet healthcare to your server. Veterinarians can revive dead pets on-the-spot with Quick Heal or provide comprehensive treatment using Treatment Tables that restore health, hunger, and thirst.

Perfect for:

  • 🏥 Medical roleplay opportunities

  • 🐕 Pet owner immersion

  • 💼 Veterinarian job content

  • 🎭 Emergency pet rescue scenarios


✨ Key Features

💉 Quick Heal

Emergency revival for dead pets with partial HP recovery

🛏️ Treatment Tables

Full medical care restoring HP, hunger, and thirst to 100%

🎮 Dual Interaction

Choose between DrawText or Target/Raycast systems

🏗️ In-Game Setup

Place treatment tables directly with /pscreator command

Complete Feature List

  • ✅ Quick Heal - Revive dead pets instantly with configurable HP recovery

  • ✅ Treatment Tables - Full medical care with hunger/thirst restoration with configurable configs

  • ✅ DrawText Support - Press E/K/L prompts for interactions with configurable keybinds

  • ✅ Target Support - ox_target/qb-target or custom target from lib

  • ✅ Custom Animations - Configure treatment animations and durations

  • ✅ Permission System - Job-based veterinarian access control

  • ✅ Owner Notifications - Inform pet owners when their pet is treated

  • ✅ Anti-Spam Protection - Prevents treatment spam and conflicts

  • ✅ In-Game Creator - Place tables without database editing

  • ✅ Fully Localized - All text customizable in language files


🎮 How to Use

Setting Up Treatment Tables

Permission: /pscreator command need admin permission inside server.cfg or permissions.cfg file example image bellow


Managing Veterinarian Permissions

First Add or doublecheck if exist new Shop Job inside your jobs files:

Second, hire a member with the Veterinarian role to be able to use the functions of the new veterinary system:

Bringing Your Pet to the Vet

Step-by-Step:

  1. Locate Veterinary Clinic

    • Find a pet shop with treatment tables

    • Look for 🏥 icon on map (configured by admin)

  2. Spawn Your Pet

    • Open pet bag: /petbag or TAB

    • Select your pet

    • Spawn it near the clinic

  3. Place Pet on Table

    • DrawText Mode: Stand near table, press K (default)

    • Target Mode: Look at table, select "Place Pet on Table"

    • Pet must be within 5 meters of table

    • Pet must be alive (dead pets can't be placed)

  4. Wait for Treatment

    • Veterinarian will approach table

    • Treatment takes ~5 seconds

    • Notification appears when complete

  5. Remove Pet from Table

    • DrawText Mode: Press L (default)

    • Target Mode: Select "Remove Pet from Table"

    • Pet appears next to you, fully healed!

What Gets Restored?

Treatment Table (Full Treatment):

  • ❤️ Health: Restored to 100% (configurable)

  • 🍖 Hunger: Restored to 100% (configurable)

  • 💧 Thirst: Restored to 100% (configurable)

Quick Heal (Emergency Only) Only for dead pets found on the streets or in public places:

  • ❤️ Health: Restored by 25% (configurable)

  • 🍖 Hunger: Not restored

  • 💧 Thirst: Not restored

Quick Heal (Emergency Revival)

When to use:

  • Pet is dead on the ground

  • Owner needs immediate help

  • No treatment table available

How it works:

  1. Find Dead Pet

    • Look for unconscious pet on ground

    • Pet owner may call for help

  2. Approach Pet

    • Get within 3 meters (configurable)

    • System detects you're a veterinarian

  3. Revive Pet

    • DrawText Mode: Press E when prompt appears

    • Target Mode: Look at pet, select "Revive Pet"

  4. Healing Animation

    • Veterinarian plays kneeling animation

    • Takes ~3 seconds (configurable)

  5. Pet Revived!

    • Pet stands up with 25 HP (configurable)

    • Owner receives notification

    • You receive confirmation message


Treatment Table (Full Medical Care)

When to use:

  • Pet needs full restoration

  • Owner brought pet to clinic

  • Scheduled appointments

How it works:

  1. Locate Treatment Table

    • Find table with pet placed by owner

    • Look for pet sitting on table

  2. Approach Table

    • Get within 2 meters (configurable)

    • System detects veterinarian status

  3. Start Treatment

    • DrawText Mode: Press E when prompt appears

    • Target Mode: Select "Treat Pet on Table"

  4. Treatment Animation

    • Veterinarian plays repair/examination animation

    • Takes ~5 seconds (configurable)

    • Pet remains sitting on table

  5. Treatment Complete!

    • Pet fully restored (100 HP, hunger, thirst)

    • Owner receives detailed notification

    • Pet can now be removed by owner

Professional Tip: Roleplay the examination! Describe what you're checking while the animation plays.

Permission Requirements

To access veterinary features:

  • Grade:


⚙️ Configuration

Complete Configuration Structure


Configuration Options Explained

Quick Heal Recovery

When Used: Emergency revival of dead pets

Purpose: Quick Heal is meant for emergencies, not full restoration.

Best Practice: Keep Quick Heal partial (25-35%) to encourage full treatment visits


Table Treatment Recovery

When Used: Full medical treatment on treatment tables

Purpose: Complete medical care that fully restores the pet.

Quick Treatment Animation

Played when: Veterinarian revives a dead pet

Options:

Setting
Description
Recommended

dict

Animation dictionary

Medical/kneeling animations

anim

Animation name

Examination/treatment anims

flag

Animation flag

1 = normal

duration

Animation length

2000-5000ms

Alternative Animations:

Sitting Medic:


Table Treatment Animation

Played when: Veterinarian treats pet on table

Recommended Duration: 4000-7000ms (4-7 seconds)

Alternative Animations:

Clipboard Examination:

Maximum Heal Distance

What it controls: How close veterinarian must be to revive dead pet

Examples:

Distance
Experience
Recommended For

1.5

Very close, realistic

Roleplay-heavy servers

3.0

Comfortable range (default)

Most servers

5.0

Generous range

Busy/casual servers


Table Interaction Distance

What it controls: How close player must be to interact with treatment table

Examples:

Distance
Experience

1.5

Must be very close to table

2.0

Comfortable range (default)

3.0

Can interact from further away

Choose Your System

Quick Heal Interaction:

Table Interaction:

Notification Toggles

Control which notifications appear to players:

Set to false to disable specific notifications.


Notification Timing

Notification
When It Appears
Recipient

ShowQuickHealStart

Vet starts reviving

Veterinarian

ShowQuickHealSuccess

Pet successfully revived

Veterinarian

ShowQuickHealToOwner

Pet revived by vet

Pet Owner

ShowTableTreatStart

Vet starts table treatment

Veterinarian

ShowTableTreatSuccess

Treatment complete

Veterinarian

ShowTableTreatToOwner

Pet treated on table

Pet Owner

ShowPlacePetSuccess

Owner places pet on table

Pet Owner

ShowRemovePetSuccess

Owner removes pet from table

Pet Owner


Keybind Configuration

Used only when DrawText mode is enabled.


Common Key Codes

Key
Code
Default Use

E

38

Quick Heal, Table Heal

K

311

Place Pet on Table

L

182

Remove Pet from Table


Key Conflict Prevention

Avoid these keys:

❌ W, A, S, D - Movement ❌ SHIFT - Sprint ❌ CTRL - Crouch ❌ SPACE - Jump ❌ LEFT MOUSE - Attack ❌ RIGHT MOUSE - Aim ❌ R - Reload ❌ ESC, TAB, ENTER - Menus ❌ F1-F3 - Phone/radio (common)



🎯 Interaction Methods Comparison

DrawText vs Target

Feature
DrawText Mode
Target Mode

Setup

No dependencies

Requires ox_target/qb-target

Visual

Text prompt on screen

Icon on raycast

Activation

Press key (E, K, L)

Look + click/key

Conflicts

Possible key conflicts

No key conflicts

Immersion

Text blends naturally

Icon more obvious

Best For

Roleplay servers

Target-heavy servers


💡 Best Practices

For Server Owners

Setting Up Clinics:

  1. Location Selection

    • Choose accessible locations (near roads)

    • Consider adding map blips for visibility

    • Multiple locations encourage activity

  2. Table Placement

    • Space tables 2-3 meters apart

    • Face tables toward clinic entrance

    • Place 2-4 tables per clinic

  3. Job Configuration

    • Set appropriate veterinarian grades

    • Balance pay with responsibility


For Veterinarians

Professional Roleplay:

Quick Heal (Emergency):

  1. Assess the situation (ask owner what happened)

  2. Explain you're providing emergency care

  3. Mention pet needs full treatment later

  4. Perform revival animation

  5. Advise owner to visit clinic

Table Treatment (Full Care):

  1. Greet the pet owner

  2. Examine the pet (roleplay the animation)

  3. Discuss findings ("Pet is dehydrated...")

  4. Perform treatment

  5. Give care instructions ("Keep pet fed/watered")


For Pet Owners

Seeking Treatment:

  1. Notice Pet Needs Care

    • Low HP, hunger, or thirst

    • Pet is dead/unconscious

  2. Locate Veterinarian

    • Check job list or ask in chat

    • Call for help if emergency

  3. Bring Pet to Clinic

    • Spawn pet near clinic

    • Place on treatment table

    • Wait for veterinarian

  4. After Treatment

    • Thank the veterinarian

    • Pay (if using payment system)

    • Remove pet from table

Roleplay Enhancement: Describe your pet's symptoms to the vet for better immersion!


⚠️ Troubleshooting

DrawText Not Appearing

Problem: No text prompt shows when near pet/table

Solutions:

  1. ✅ Verify UseDrawTextForQuickHeal or UseDrawTextForTables is true

  2. ✅ Check you're within interaction distance

  3. ✅ Reconnect to server (DrawText initializes on join)

  4. ✅ Verify you have veterinarian permissions (for vet actions)

  5. ✅ Check pet is dead (for Quick Heal) or alive (for table placement)


Target Not Working

Problem: No target icon appears when looking at pet/table

Solutions:

  1. ✅ Verify UseDrawTextForQuickHeal or UseDrawTextForTables is false

  2. ✅ Ensure target system is installed (ox_target, qb-target or custom (cdev_lib))

  3. ✅ Check target system is started before cdev_pets

  4. ✅ Verify target system is configured correctly

  5. ✅ Look directly at the pet/table (raycast required)

  6. ✅ Check you have veterinarian permissions


Can't Place Pet on Table

Problem: "Place Pet" option doesn't work or doesn't appear

Solutions:

  1. ✅ Pet must be spawned (not in bag) - use /petbag first

  2. ✅ Pet must be alive - dead pets cannot be placed

  3. ✅ Pet must be nearby - within 5 meters (DetectionDistance)

  4. ✅ Table must be empty - no other pet on the table

  5. ✅ You must own the pet - can't place other players' pets

  6. ✅ Check you're within TableInteractionDistance (2m default)


Can't Treat Pet

Problem: "Treat Pet" option doesn't work

Solutions:

  1. ✅ Must be a veterinarian - Check job and grade

  2. ✅ Pet must be on table - Owner must place it first

  3. ✅ Can't already be treating - Wait for current treatment to finish

  4. ✅ Table must have pet - Verify pet is actually sitting on table

  5. ✅ Check you're within TableInteractionDistance (2m default)


Treatment Animation Doesn't Play

Problem: No animation or wrong animation plays

Solutions:

  1. ✅ Verify animation dict/name are correct in config

  2. ✅ Check animation duration isn't too short (<1000ms)

  3. ✅ Test animation manually with /e command

  4. ✅ Ensure animation isn't blocked by other resources

  5. ✅ Try a different animation (see configuration tab)

Testing Animations:


Pet Doesn't Revive

Problem: Quick Heal animation plays but pet stays dead

Solutions:

  1. ✅ Check HealthRecover in config is > 0

  2. ✅ Verify pet is actually dead (not just low HP)

  3. ✅ Check server console for errors

  4. ✅ Verify pet sync event is firing (check F8 console)


Owner Doesn't Get Notification

Problem: Owner doesn't see "Pet was healed" message

Solutions:

  1. ✅ Check ShowQuickHealToOwner or ShowTableTreatToOwner is true

  2. ✅ Verify notification system is working (test with other notifications)

  3. ✅ Check owner is online and in range

  4. ✅ Ensure pet ownership is correctly stored in database


❓ FAQ

Can I have both DrawText and Target enabled?

No. The system prevents conflicts by disabling one when the other is enabled.

If UseDrawTextForQuickHeal = true, Target for Quick Heal is automatically disabled.

Why? To prevent duplicate interactions and key conflicts.

Solution: Choose one system per interaction type.

Can non-veterinarians see the interactions?

No. Veterinary-specific interactions (Quick Heal, Table Treatment) only appear for players with veterinarian job/grade.

Pet owners can see "Place Pet" and "Remove Pet" interactions regardless of job.

This prevents: Non-vets from trying to heal pets.

What happens if pet owner disconnects during treatment?

The treatment completes anyway.

  • Pet health/hunger/thirst are saved to database

  • Next time owner connects, pet will be fully healed

  • Veterinarian still receives completion notification

Table behavior: Pet remains on table until manually removed or server restart.

Can I charge players for treatment?

Currently not built-in. You can add payment manually

How many treatment tables can I have per clinic?

No hard limit. You can place as many tables as needed.

Recommendations:

  • Small Clinic: 2-3 tables

  • Medium Clinic: 4-6 tables

  • Large Hospital: 8-12 tables

Performance: Tables are lightweight and don't impact performance.

Best Practice: Space tables 2-3 meters apart for easy navigation.

Can I delete a table after placing it?

Yes! Two methods:

Method 1: In-Game Creator

  1. /pscreator

  2. Select shop

  3. Manage Treatment Tables

  4. Select table from list

  5. Click "Delete Table"

Method 2: Database

  • Edit vetTables JSON in cdev_pets_petshops table

  • Remove the table entry

  • Restart resource's

Does Quick Heal restore hunger/thirst?

No by default system.

Why separate? To encourage full treatment visits for complete care.

Can I customize the animations?

Yes! Animations are fully configurable.

Edit in config:

Finding Animations:

  1. Search for medical/examination animations

  2. Test with /e animname in-game

  3. Add to config

Popular Medical Animations:

  • amb@medic@standing@kneel@idle_a - Kneeling examination

  • mini@repair - Repair/fixing motion

  • amb@world_human_bum_wash@male@low@idle_a - Cleaning motion


Last updated