# btc-officers — Law Enforcement Script for RedM
**btc-officers** is a police management script for **RedM** servers. Built on the **BTC-CORE** bridge, it is fully compatible with both **RSG-Core** and **VORP-Core** frameworks.
The script includes a 3-tier jurisdictional structure (Municipal, State, and Federal), a modern **Vue 3 Mobile Data Terminal (MDT)**, an interactive **Federal Prison system with minigames and escapes**, field missions, and city security level management.
---
## Features Overview
-
**RSG & VORP Support**: Works on both frameworks via `btc-core`.
-
**3 Jurisdictional Tiers**: Municipal, State, and Federal levels with independent balances and salaries.
-
**Vue 3 MDT**: Far West themed UI with complete tabs and permission controls per rank and jurisdiction.
-
**Local & Federal Prison**: City lockups + Federal Penitentiary with sentence-reducing tasks (hay, apples, sacks, cotton) and an outlaw yard system (brawls, tunnels, and boat escapes).
-
**Field Missions**: Patrols, Escorts with random outlaw ambushes, Investigations, and Bounty Hunting.
-
**City Security Level**: Security bar decays over time, encouraging officers to patrol actively.
-
**Police Stables & Wagons**: Patrol horse (with `btc-stable` support or internal fallback) and police wagons (patrol, prisoner transport, armored, and Gatling).
-
**Discord Audit Logs**: Logs sensitive actions to Discord webhooks.
---
## Detailed Breakdown
### 1. MDT (Police Terminal)
NUI panel built in Vue 3 with tabs for:
-
**Identities**: Search and edit citizen records.
-
**Occurrences**: Create and review incident reports.
-
**Sanctions & Penal Code**: Apply preset penal code fines and prison time.
-
**Fines**: Issue fines, pay in-game, cancel with reason, and track due dates.
-
**Roster**: Recruit, promote, warn, and dismiss officers.
-
**Finances**: Bank balance with deposits and withdrawals.
-
**Licenses**: Issue and revoke hunting licenses and weapon permits.
-
**Armory & Chests**: Weapon stock and department chests (General and Restricted).
### 2. Hierarchy & Jurisdictions
-
**Municipal**: City law enforcement (Annesburg, Valentine, Rhodes, Strawberry, Saint Denis, Blackwater, Tumbleweed, Armadillo).
-
**State**: Extended jurisdiction across the state (State Rangers).
-
**Federal**: Global authority and Federal Penitentiary management (U.S. Marshals).
-
**Multi-Job Support**: Link multiple jobs per department (e.g., Sheriff and Deputy in the same office).
### 3. Prison & Minigames
-
**Federal Transport**: Sentence transport with distance and escape alerts.
-
**Prison Labor Tasks**: Sentence-reducing jobs inside and outside the prison.
-
**Dining Hall**: Scheduled food distribution.
-
**Yard Activities**: Yard brawls, tunnel digging, and boat escapes with pursuing NPCs.
### 4. Field Missions
-
**Patrol**: Checkpoint objectives for officer teams.
-
**Escort**: Transport missions with dynamic outlaw ambushes.
-
**Investigation**: Find clues and confront gang hideouts.
-
**Bounty Hunting**: Locate targets, eliminate guards, and deliver targets to lockup.
-
**City Security**: Completing missions keeps the city security level high.
### 5. Handcuffs & Player Search
-
**Handcuffs**: Item-based handcuffing with optional police-only restriction.
-
**Player Search (`/search`)**: Search inventory of cuffed, hands-up, knocked out, or dead players with item blacklists.
### 6. Stables & Wagons
-
**Service Horse**: Patrol horse per city (supports `btc-stable` or built-in fallback).
-
**Police Wagons**: Patrol wagons, prisoner transports, armored stagecoaches, and Gatling wagons unlocked by rank.
### 7. Emergency Dispatch Alerts
- Citizens send alerts via command or `birdpost` item.
- Sound alert, GPS markers, and accept/decline menu for officers.
### 8. Discord Webhook Logs
- Logs fines, withdrawals, arrests, searches, hires, and completed missions.
---
## Requirements
-
**Frameworks**: RSG-Core and VORP-Core.
-
**Required Dependency**: `btc-core`.
-
**Recommended Dependency**: `PolyZone`.
-
**Optional Integration**: `btc-stable`.
---
## Key Benefits
-
**Dual Framework Compatibility**: Runs on RSG and VORP without separate script builds.
-
**Interactive Prison Content**: Inmates have tasks to reduce time and escape options.
-
**Street Patrol Incentives**: City security levels and group missions encourage active patrolling.
-
**Granular Permissions**: Control who can withdraw money, open restricted chests, or manage roster.
VIDEO: [SOON]