SENX KOTH PLUGIN

The SenX KOTH Plugin adds capture-the-zone gameplay to your server. Admins define capture zones as spherical areas on the map (rendered with safe-zone bubbles). Factions fight to hold each hill, earning points for their faction over time, and the plugin tracks and rewards them across weekly, monthly, and yearly leaderboards.

WHAT IT DOES Capture mechanics
• Each zone is a spherical capture area with configurable radius, position, and color.
• Factions capture a hill by having players (and/or occupied, powered grids) inside it.
• Capture progress is measured in points, with a per-tick gain rate and an interval you control. When a single faction holds the zone it captures; when two or more factions are present it becomes contested and the hill is blocked from capturing.
• Suits (players on foot) and grids can be worth different amounts, so you can reward bringing ships.
• Captured zones earn points for the holding faction on an award interval. The more assets you keep on the hill, the faster you gain.
• If everyone leaves, the capture progress decays back toward neutral.

Scoring and leaderboards • Points accumulate in a per-faction bank and in weekly, monthly, and yearly standings.
• Weekly scores roll into monthly, and monthly roll into yearly, automatically.
• Players can view current standings in-game, broken down per zone.

Faction bank and raffle • Each faction has a persistent points bank that earns from captured hills.
• Faction founders and leaders can spend bank points on raffle tickets.
• The plugin runs a scheduled raffle draw (weekly or monthly, day and time configurable), picks first, second, and third place winners, and clears tickets after each draw.

Rewards • Live capture rewards: run any Torch command when a specific zone is captured, optionally on every capture.
• Rank rewards: run commands for factions that finish 1st, 2nd, 3rd, etc. at the end of each period.
• Threshold rewards: run commands for any faction that reaches a minimum points threshold.
• Raffle rewards: run commands for raffle winners.
• Commands support per-member execution, online-only options, and placeholders for faction id, name, tag, and player steam id.

Evictions • Zones can periodically evict everyone (a configurable frequency and duration), temporarily flipping the safe zone to whitelist access, optionally resetting capture progress, and optionally running during scheduled downtime.
• Admins can also trigger a manual eviction.

Dynamic zones • A zone can be set to move to a new random position within a min/max distance of an origin on an interval, with optional GPS announcements to all players.

Scheduling • Each zone can be restricted to specific days of the week and a start/end time, so hills only run when you want them.

Player feedback • In-game on-screen notifications showing capture state, progress, time remaining, enemies inside/outside, and points earned.
• Optional Rich HUD integration (requires the companion client-side mod) for a live quest-style display.
• Win/lose fireworks at the zone via the companion mod.
• HUD sound cues for capturing, enemy entering, point earned, and match won/lost.

Discord webhooks • Configure one or more Discord webhooks, each with its own toggles for which events to receive and an optional zone filter.
• Events include captures, decay, points earned, enter alerts, evictions, rank results, and raffle winners.

COMMANDS Player commands (all under the !KoTH category):
• !KoTH Week - show the current weekly leaderboard
• !KoTH Month - show the current monthly leaderboard
• !KoTH Year - show the current yearly leaderboard
• !KoTH Zone - show per-zone breakdowns for all periods
• !KoTH Bank - show your faction bank balance and raffle tickets (founder/leader only)
• !KoTH BuyTicket [count] - buy raffle tickets with bank points (founder/leader only)
• !KoTH About - list commands

Admin commands: • !KoTH GivePoint - add or remove faction bank points
• !KoTH ForceTest - send a test Discord webhook

REQUIREMENTS
• Torch server plugin (the main plugin).
• A companion client mod for the Rich HUD display and fireworks. This mod depends on the Rich HUD Framework, and is optional if you only want notification-based display.

CONFIGURATION
Everything is configured through the Torch plugin UI (zones, rewards, webhooks, raffle, eviction, and scheduling), and settings persist to JSON. Zones are stored in a Zones.json file and can be edited from the UI.

For more information or help, join my discord server!