> ## 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.

# APEX Faction Bell

> In-game managed faction alert system with anti-cheat.

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

<Card title="Required" icon="circle-check">
  `es_extended`, `ox_lib`, `oxmysql`
</Card>

## Installation

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

## Configuration

```lua config.lua theme={null}
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](/hooks/apex-faction-bell). Key hooks: `Hooks.HasManagerPermission`, `Hooks.OnPlayerBan`, `Hooks.OnPlayerKick`, `Hooks.GetJobs`, `Hooks.PlayBellSound`.

## Resource info

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