> For the complete documentation index, see [llms.txt](https://duddzy-scripts.gitbook.io/duddzy-scripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://duddzy-scripts.gitbook.io/duddzy-scripts-docs/scripts/duddzy-jail-1.md).

# Duddzy Pets

Version 1.0

The Pet System is a fully featured companion framework for FiveM servers, allowing players to own, manage, and interact with persistent pets across the server.

Designed for performance, multiplayer synchronization, and easy configuration, the system includes advanced AI behaviours, pet needs, vehicle support, multilingual localization, and full server-side validation.

***

## Features

### Persistent Pet Ownership

Players can:

* Purchase Pets
* Rename Pets
* Spawn and Dismiss Pets
* Switch Between Owned Pets
* Sell Pets

All pet data is saved to the database and restored automatically.

***

## Pet Behaviours

Pets support multiple interactive behaviours including:

* Follow owner
* Stay in position
* Attack targets
* Play Fetch
* Eat from Food Bowls
* Enter and Exit Vehicles
* Idle and Ambient Animations

***

## Pet Needs System

Pets include persistent status systems such as:

* Health
* Food
* Illnesses

If neglected, pets can:

* Become Hungry
* Become Sick
* Eventually Die From Starvation

Players can:

* Feed Pets
* Heal Pets at Clinics
* Revive Collapsed Pets

***

## Vehicle System

Pets can:

* Enter Vehicles
* Remain Seated Correctly
* Exit Vehicles Safely

***

## Pet Shop & Clinic

Integrated locations allow players to:

* Purchase Pets
* Buy Pet Food
* Buy Tennis Balls
* Heal Sick Pets

Both systems support:

* Target Interactions
* Configurable Blips
* Configurable Locations

***

## Localization Support

The resource includes a fully modular locale system.

Supported languages:

* English
* French
* Dutch
* Spanish
* German
* Italian
* Portuguese
* Polish
* Russian
* Turkish

Additional languages can easily be added by creating a new locale file inside:

```
locales/
```

Then setting:

```
Config.Locale = 'YOURLOCALENAME' -- E.G. 'en', 'fr', 'es' etc...
```

inside the `config.lua`

***

## Server Security

The resource includes server-side validation for:

* Pet Purchases
* Pet Selling
* Renaming
* Healing
* Spawning
* Inventory Items

This prevents common exploit methods and protects against client-side event abuse.

***

## Performance

The system is designed to remain lightweight and optimized:

* Efficient Loops
* Minimized Entity Usage
* Proper Cleanup Handling
* Resource Stop Protection
* Multiplayer Safe Syncing

***

## Configuration

Most aspects of the resource are configurable, including:

* Pet Prices
* Shop Locations
* Clinic Locations
* Blips
* Food Values
* Animations
* Vehicle Seat Behaviour
* Locale Selection

All configuration options are located inside:

```
config.lua
```

***

## Database

Pet data is stored persistently inside the `pets` table.

Stored data includes:

* Pet Name
* Pet Model
* Health
* Food
* Ownership Information

***

## Dependencies

Required dependencies:

* ESX Legacy
* oxmysql
* ox\_lib
* ox\_inventory
* ox\_target