FiveM Punishment System – Community Service + Ped Punishment [QBCore & ESX]

A powerful and fully visual punishment system that allows staff to assign penalties in the form of cleaning tasks or ped restrictions, integrated with an intuitive admin panel, animated UI, and full support for both QBCore and ESX.

Performance

This script is built with efficiency in mind, ensuring smooth operation on all servers.

• Idle: 0.00 ms
• In action: 0.00 ms (max)

Compatibility

Fully compatible with:

• QBCore
• ESX (Legacy & v1)
• Automatic framework detection from config.lua.

Interface & Design

• Clean, modern, and animated NUI panel.
• Fully responsive design across screen sizes.
• Customizable color scheme and language via open files.

Admin Features

Through the integrated panel, staff can:

• View active and historical punishments.
• Apply PED or cleaning-based punishments.
• Remove active punishments.
• See and manage online players.
• Edit Discord webhook for logs.
• Open offline punishments manually.
• Modify sweep locations (garage zone configurable).

Punishment Types

1. PED Punishment
Transforms the player into a custom ped (e.g., dog), disables controls, and teleports them to a locked area. Attempts to escape are automatically blocked.

2. Cleaning Task Punishment
Players are teleported to a cleaning location (prison, ship, garage) where they must complete a number of sweeping tasks. Each task:

• Is animated with prop + emote.
• Has a cooldown.
• Can be configured with custom points for garage zones.

Skin & Clothing Recovery

Upon completion, the original skin is automatically restored with full support for:

• illenium-appearance
• qb-clothing
• esx_skin / skinchanger

Escrow & Customization

This script includes escrow-protected logic but leaves the following files open:

• config.lua (editable settings and coordinates)
• lang.js (translation and text)

Links

• Video: Video PREVIEW
• Store: Store
• Documentation: Click here
• Discord Support: Click here

Update Log

• Staff name and punished player now shown correctly in panel.
• Separated columns in Active Punishments view.
• Fixed table layout for low-res screens.
• Added cleaning point customization per location (garage).
• Disabled melee attacks during cleaning punishments.
• Restored player skin even after reconnect (with full backup).
• Optimized panel stats and webhook sync.
• Improved localization support via lang.js.
• Improved handling of player escape during punishment.