Turn rulebreakers into productive citizens! One Community Service is a fully featured, highly optimized, and interactive punishment system designed for both QBCore and ESX frameworks. Instead of just sending players away to a traditional jail, assign them community labor tasks across customized zones that you can manage entirely in-game.
🚀 Key Features
🛠️ In-Game Zone & Task Builder
No more messing with configuration files to add coordinates! The script includes a complete In-Game Builder Menu (ox_lib integration) allowing server admins to:
- Create & Delete Zones: Instantly establish new labor environments anywhere on the map.
- Interactive Waypoints: Stand on a spot to physically set the Player Spawn Point and the Release/Freedom Point.
- Dynamic Task Placement: Drop task coordinates live on the map for various chore types (e.g., Sweeping, Gardening).
🧹 Immersive Work Mechanics
- Cleaning & Gardening Tasks: Features built-in animations, scenarios, and attached props (like brooms or spatulas) to make the physical labor look authentic.
-
Skill Check Minigames: Includes optional
ox_libskill checks. Players must actively succeed at the minigame to complete their task. - Smart Activity Pooling: Tasks randomly regenerate within the zone to ensure players aren't standing in the exact same spot repeating the same chore.
🔒 Exploit Prevention & Anti-Escape
- Perimeter Enforcement: If a sentenced player tries to run away or escape the designated work zone area, they are instantly teleported back to the spawn point.
- Sentence Extensions: Attempting to escape automatically slaps additional remaining tasks onto their sentence as a penalty.
- Action & Combat Restrictions: Violent controls, firing weapons, and punching are fully disabled while serving time.
- Inventory Confiscation: The script automatically backs up and strips player inventories upon entering service, securely returning all items only when their tasks hit zero.
👗 Outfit & Uniform Management
- Save Outfits on the Fly: Grab your current clothing components directly through the admin menu and save them as the official prison uniform.
- Gender Compatibility: Distinct uniform profiles automatically apply to both male and female player models.
- Automatic Restores: Restores the player's civilian clothes perfectly once they are released.
📊 Modern UI & Data Persistence
- Sleek HUD Display: A custom NUI display tracking current tasks remaining, overall actions assigned, reason for the sentence, and the supervising administrator.
- SQL Connectivity: Sentences persist through server crashes or player disconnects. If a player logs out, they log right back into their zone with their tasks waiting.
- Global Chat Announcements: Sends out local city alerts whenever a resident gets sentenced or finishes their community service.
⚙️ Administration Commands
-
🏽 /darbarridas- Opens an interactive dialog to select a Player ID, choose a labor zone, type a reason, and set the task count. -
❌ /quitarbarridas [ID]- Manually terminates a player's sentence and releases them immediately. -
🔨 /crearbarridas- Opens up the interactive management suite to build or modify zones and save uniforms.
🪵 Advanced Discord Logging
Stay up to date with full server logs! Includes an active Webhook framework tracking three main vectors:
- Sentence Issued: Logs the admin name, target player, assigned task count, reason, and selected labor zone.
- Sentence Completed: Automatically logs when a player completes their labor and earns their freedom.
- Staff Overrides: Records whenever an admin manually cuts a sentence short via commands.
📋 Dependencies
- Framework: QBCore or ESX
- Database: oxmysql / Standard MySQL Wrapper
- UI Interactivity: ox_lib
