qbx-communityservice

Persistent, server-authoritative community service for Qbox.

Dependencies

• qbx_core
• ox_lib
• ox_target
• oxmysql

Installation

1. Put qbx-communityservice in your resources folder.
2. Import install.sql into your database.
3. Add these lines after the dependencies in server.cfg:

ensure oxmysql
ensure ox_lib
ensure ox_target
ensure qbx_core
ensure qbx-communityservice

add_ace group.admin communityservice.manage allow

4. Adjust locations and behavior in config.lua.

Commands

• /comserv [playerId] [actions]
• /endcomserv [playerId]
• /comservcheck [playerId]

Commands require the communityservice.manage ACE. Console is always permitted.

Exports

Server

exports['qbx-communityservice']:AssignService(playerId, actions, assignedBySource)
exports['qbx-communityservice']:ReleaseService(playerId)
local remaining = exports['qbx-communityservice']:GetRemainingActions(playerId)

Security model

• The server stores the authoritative action count.
• The server selects the active task.
• Completion is accepted only for that task, near its configured coordinates, after the configured duration/cooldown.
• Leaving the service radius can add actions and teleport the player back.
• Progress persists by citizen ID across reconnects and restarts.

Notes

The script uses its own table and does not modify Qbox-owned database tables. Change Config.UseTarget to false to use marker + E-key interaction instead of ox_target.