Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.apex-services.site/llms.txt

Use this file to discover all available pages before exploring further.

A faction bell system with an in-game React-based admin UI. Players near a registered bell press E and every online member of that faction gets pinged. Bells are created, edited, and deleted entirely through the in-game manager — no config editing, no server restarts.

​
Features

  • In-game managed — /bellmanager opens a React + Tailwind CRUD panel
  • Pick job + position from a dropdown / “use my position” button
  • Anti-cheat built in — rings from unregistered coordinates trigger ban or kick (configurable)
  • Server-side cooldown per faction (default 5 min)
  • Auto-install — SQL table created on first start
  • 0.00ms idle, marker draw only within Config.NearbyRange

​
Requirements

Required

es_extended, ox_lib, oxmysql

​
Installation

  1. Drop apex-faction-bell into resources/
  2. ensure apex-faction-bell — DB tables auto-create

​
Configuration

config.lua
Config.ManagerCommand         = 'bellmanager'
Config.AllowedGroups          = { 'admin', 'projektleitung' }
Config.CooldownSeconds        = 300
Config.InteractionRange       = 1.5
Config.NearbyRange            = 15.0
Config.UnregisteredRingAction = 'ban'   -- 'ban' | 'kick' | 'ignore'
Marker colors, scale, and key bind all live in config.lua. Two languages ship out of the box.

​
Hooks

See Hooks reference / Faction Bell. Key hooks: Hooks.HasManagerPermission, Hooks.OnPlayerBan, Hooks.OnPlayerKick, Hooks.GetJobs, Hooks.PlayBellSound.

​
Resource info

Code accessible: config.lua, hooks.lua, locales/*, web/*. Approximately 500 lines of Lua + React UI. English + German.