MFPD-PoliceCompanion - Cfx Forum Post - Video Preview in Cfx Forum Post

Overview
MFPD-PoliceCompanion provides AI police companions designed to operate alongside the player as a coordinated police squad. Companions inherit the player's appearance and equipment, follow configurable formations, assist during active threats, adapt to vehicles and respond naturally to the player's current actions. The resource supports English, Portuguese (BR), French, German and Spanish out of the box.

Key Features

• Companion Management

  • /mfpd - spawn up to 10 companions by default

  • /bye - dismiss all companions

  • /stay - toggle hold position or resume following

  • /pullcomp - instantly bring all active companions back to your current location

  • /compstatus - display the number of active companions and their current state

  • /formation - open the formation editor and customize your squad layout

  • /helpcomp - open a modern companion help interface containing all available commands, usage instructions and explanations

  • Command names and supported options can be customized in the configuration

• Modern In-Game Help Interface

  • Dedicated /helpcomp interface for learning and reviewing companion controls

  • Displays all available commands and explains what each one does

  • Includes usage guidance for formations, combat behavior, patrol modes, aiming and companion management

  • Designed to help players use the resource without needing to constantly check external documentation

• Formation and Movement

  • Structured squad formations based on customizable companion positions

  • Movement speed dynamically adapts to the player while walking, running or sprinting

  • Named formation presets can be saved and reused

  • Companions maintain their assigned positions while naturally adjusting to movement and nearby obstacles

• Combat and Threat Response

  • Companions identify and react to genuine hostile threats

  • Active attackers are prioritized during combat

  • Threat awareness is shared across the squad for more consistent group reactions

  • New companions spawned during an ongoing gunfight can immediately recognize and respond to the active threat

  • Companions already engaged in combat help newly spawned squad members understand who the current enemy is

  • Friendly players, police officers and security personnel are protected from incorrect hostile reactions

  • Companions automatically return to normal squad behavior after threats are no longer active

• Intelligent Weapon Behavior

  • Companions prioritize the weapon the player is currently using

  • When the player changes weapons, companions adapt their equipment accordingly

  • The player's current weapon is always preferred before any fallback weapon is considered

  • Fallback weapons are only used as a last resort when the player's current weapon cannot be used

  • Companions will not unexpectedly pull nightsticks or other melee weapons during a gunfight

  • Melee weapons are only used when a companion was intentionally spawned while the player was equipped with a melee weapon

  • Supports compatible addon weapons configured for the resource

  • Weapon attachments and relevant equipment are mirrored where supported

• Aiming Support

  • Press H by default while aiming at an entity to direct all companions toward that target

  • Companions maintain focus on the selected target until the aiming command is cancelled or the target is no longer valid

  • If the target dies, aim mode ends cleanly and companions return to normal formation behavior

  • Invalid targets are safely ignored with an in-game notification

• Cease-Fire Mode

  • /stp - companions remain alert and can aim at nearby threats without opening fire

  • Useful for detainments, traffic stops, high-risk approaches and other situations requiring visible armed presence without immediate engagement

  • Newly spawned companions also respect the current cease-fire state

• Deployment and Patrol

  • /dep - deploy companions to patrol around your current position

  • Use the command again to recall deployed companions

  • Companions automatically leave vehicles when necessary to begin patrol duties

  • Patrol distance and behavior can be adjusted in the configuration

• Patrol Torch Modes

  • /ptrfoot - equip on-foot companions with a visible patrol torch

  • /ptrcar - use a dedicated in-vehicle torch patrol mode

  • Torch animations and visible light effects are synchronized for nearby players

  • Type the active command again to cancel the torch mode

  • Companions temporarily stow their weapon while using the torch and restore appropriate equipment afterward

  • Torch behavior can automatically adapt when transitioning between on-foot and in-vehicle patrol

  • Interrupted torch actions are safely cleaned up when companions need to react to combat or other important situations

• Vehicle Interaction

  • Companions automatically board and leave vehicles to stay with the player

  • Available vehicle seats are assigned automatically

  • Companions that fail to board can be recovered after being left behind

  • After leaving a vehicle, companions restore their appropriate weapon and return to squad behavior

• Appearance and Customization

  • Companions can inherit the player's appearance, including face, skin, hair, hair color, eye color, overlays, clothing and props

  • Supports both male and female freemode characters

  • Companions automatically use compatible weapon flashlights at night when appropriate

  • Multiple companion behavior and appearance options can be adjusted through the configuration

• Multiplayer Sync

  • Companion appearances remain visible and consistent for other players

  • Patrol torch props and effects are synchronized across the session

  • Companions are properly removed when dismissed or when their owner leaves

  • Designed for consistent companion behavior in multiplayer environments

• Multilingual Support

  • Built-in support for English, Portuguese (BR), French, German and Spanish

  • In-game notifications are available in all supported languages

  • Language settings and text can be customized through the configuration

Configuration and Compatibility

• Configuration: user-facing resource settings can be adjusted through config/config.lua

• Frameworks: Standalone, ESX or QBCore

• Allowed Jobs: optional job restrictions can be configured for ESX and QBCore servers

• Commands and keybinds: customizable to better fit your server

• Addon weapons: compatible addon weapons can be added through the configuration

• PvP-friendly: companions are designed to avoid incorrectly attacking friendly players while normal player-versus-player gameplay remains available

• Configuration comments are available in English, Portuguese (BR), French, German and Spanish

Installation

1. Download and extract the MFPD-PoliceCompanion resource.

2. Place the folder into your server's resources directory.

3. Add the following line to your server.cfg:

   ensure MFPD-PoliceCompanion

4. Open config/config.lua and adjust the available settings for your server.