Easy Factions: Objective Control

Establish Dominance. Secure the Objective. Claim the Loot.
An addon for Easy Factions that introduces "King of the Hill" style capture points with configurable rewards.

Objective Control turns your server into a battlefield. Factions and Alliances must fight to maintain control over
specific geographic zones. Stand your ground to earn points, eliminate enemies to steal theirs, and unlock shared
rewards for your entire alliance.

✨ Features

👑 King of the Hill

Define "Core Areas" in your world. As long as you or your faction members stand inside, you generate points. Rewards are
given out periodically to the controlling faction!

⚔️ High-Stakes Combat

It's not just about standing still.

• Kill Areas: Define danger zones around the objective.
• Point Stealing: Killing a rival inside the Kill Area doesn't just send them to respawn, it drains some of their
  points and transfers a percentage of them to your faction.

🤝 Alliance Integration

United we stand.

• Points earned by individual members count toward the total Alliance Score.
• When a reward is unlocked, it is shared among the alliance members. Strong alliances are essential for holding
  high-value objectives!

🛠️ Admin Setup Guide (Operators)

Setting up an objective requires defining two zones: the Core (where players stand for points) and the **Kill Zone
** (where PvP steals points).

Step 1: Define the Area

Stand at the corners of your desired areas and run these commands:

| Command | Description |
|:-------------------------------|:----------------------------------------------|
| /objective setCorePosOne | Sets corner 1 of the Core (Capture) area. |
| /objective setCorePosTwo | Sets corner 2 of the Core (Capture) area. |
| /objective setCoreKillPosOne | Sets corner 1 of the Kill (PvP) area. |
| /objective setCoreKillPosTwo | Sets corner 2 of the Kill (PvP) area. |

Step 2: Create & Manage

Once positions are set, create the objective and define the loot.

| Command | Description |
|:------------------------------------------|:---------------------------------------------------------|
| /objective create <name> | Creates the objective using the positions set in Step 1. |
| /objective remove <name> | Deletes an objective. |
| /objective resetObjectiveRewards <name> | Resets the reward pool. |

Step 3: Add Rewards

Hold an item in your main hand and run:
/objective addHandAsReward <name> <Interval> <Chance>

• Interval: How often (in seconds) the reward tries to generate.
• Chance: The probability (0.0 - 1.0) of generation per interval.

🎮 Player Commands

| Command | Description |
|:---------------------------------|:-----------------------------------------------------------------------------------------------------------|
| /objective claimRewards <name> | Claims earned rewards for your Faction/Alliance. (Officers/Leaders only) |
| /objective listPoints <name> | Displays a leaderboard of points by Faction and Alliance. |
| /objective listRewards <name> | Displays a the possible rewards, their interval and their chances. Operators will still be able to use it. |

⚙️ Configuration

Tune the mechanics to fit your server's difficulty via the config file.

| Option | Description |
|:-----------------------|:--------------------------------------------------------------------------------------|
| controlPointLifetime | Max age (in seconds) a control point can have. |
| controlPointInterval | How often (in seconds) points are awarded to holders. |
| rewardsCheckInterval | How often (in seconds) the system checks to distribute rewards. |
| lossPercentage | Percentage of points a faction loses when a member dies in the Kill Zone (0.5 = 50%). |
| maxPointLoss | The maximum raw amount of points that can be lost in a single kill. |
| conversionPercentage | How much of the "lost" points are given to the killer's faction (0.5 = 50% transfer). |
| disableRewardInfo | Disables the reward info command |