Modules

Core Focus ships with built-in modules that add ready-to-use interactions. Each module can be customized in its own file under modules/.

Interactive Props

Pick Up & Place

Players can pick up props, carry them, and place them down. Physics-based with animations.

Push & Throw

Push objects across the ground or throw them with force. Configurable force values.

Stack

Stack compatible props on top of each other. Max stack height configurable.

Flip Tables

Flip tables for cover during intense situations. Uses physics-based flipping.

Prop Categories:

Category	Examples	Stackable
Light	Chairs, stools, cardboard boxes	Yes
Medium	Wooden boxes, crates	Yes
Heavy	Tables, desks	No
Specialized	Ladders, scaffolding, barriers	No

-- modules/props.lua settings
MaxDistance = 2.5
ForceColor = "#ff6b35"
PickupOffset = vector3(0.0, 0.2, 0.0)
FlipForce = 8.0
PushForce = 8.0
ThrowForce = 35.0
StackDistance = 1.0
MaxStackHeight = 5

Server-side tracking: All prop interactions are logged. Props auto-cleanup after 5 minutes. Configurable per-player prop limit (default: 10).

Bench Sitting

Players can sit on benches throughout the map with proper animations.

Sit Down

Walk up to any supported bench and sit with a natural animation. Male and female variants.

Stand Up

Press the interaction key to stand up and return to normal state.

Supported bench models include: Standard park benches, wooden benches, metal benches, bus stop benches, picnic tables, and various prop variants — over 30 models total.

-- modules/benches.lua settings
MaxDistance = 2.0
ForceColor = "#f5ef42"
SitOffset = vector3(0.0, -0.3, -0.5)
SitHeading = 180.0

Bone Interactions

Pre-configured vehicle bone interactions for doors, hood, and trunk — with colored targeting dots.

-- modules/bones.lua settings
MaxDistance = 3.0
ForceColor = "#42f554"     -- Green dots for vehicle bones

Pre-configured interactions:

• Toggle Left Front Door
• Toggle Right Front Door
• Toggle Hood
• Additional options based on vehicle model

TIP

You can add more bone interactions through the AddTargetBone export without modifying the module file. See Exports & API.

Player Interactions

Escort

Escort a nearby player — they follow your movement. Job-restricted for EMS/Police.

Carry

Carry a player on your back. Useful for downed players.

Vehicle

Put players into or take them out of vehicles. Essential for EMS and police roleplay.

QB-Core EMS options: Check Health, Revive, Heal Wounds, Escort ESX Ambulance options: Revive, Heal, Put in Vehicle, Take Out

Admin Interactions

Admins get additional targeting options on players:

Ban

Ban a player directly from targeting them.

Kick

Kick a player from the server.

Freeze / Unfreeze

Toggle player movement freeze.

-- modules/admininteractions.lua settings
MaxDistance = 5.0
ForceColor = "#FF0000"     -- Red dots for admin actions
AdminGroups = { "admin", "superadmin", "owner", "god" }

WARNING

Admin permission checking uses QB-Core's GetPermission or ESX's getGroup. In standalone mode, admin checks return true by default — customize the check function for production use.

Vehicle Info Windows

The augmented window module automatically displays floating info panels near vehicles.

Displayed data:

• Plate number
• Engine health (%)
• Body health (%)
• Fuel level (%)
• Engine status (Running/Off)
• Lock status (Locked/Unlocked)

-- modules/augmentedwindow.lua settings
UpdateInterval = 3000      -- Data refresh rate (ms)
MaxDistance = 3.0           -- Detection range
WindowDistance = 10.0       -- Render distance
WindowLength = 2.5
WindowHeight = 1.0
WindowColor = "#00AAFF"
WindowStyle = "default"