Welcome, server owner! This guide contains everything you need to install, configure, and manage the ForcePlugin on your server.

1. Installation
Getting started is simple:

1. Download the `ForcePlugin.jar` file from the main page.
2. Place the jar in your server's `/plugins/` folder.
3. **(Optional but Highly Recommended)** Install the latest version of PlaceholderAPI. This is required to use the placeholders.
4. Start or restart your server.
5. The plugin will generate a `config.yml` and a `ranks.yml` file in the `/plugins/ForcePlugin/` folder. You are now ready to configure the plugin!

2. Player Guide (How it Works)
This is the core experience for your players.

The First Choice:
A player's journey begins with `/force choose <light|dark>`. This is a permanent choice that grants them their unique Holocron and sets them on their path.

The Holocron:
The Holocron is the key to everything. It is a custom-textured head that cannot be dropped or stored in chests.

• Right-Click: Opens the Skill Tree GUI to unlock or manage abilities.
• Hold SHIFT + Scroll: Cycles through all unlocked abilities. The selected power is shown on the action bar.
• Left-Click: Uses the currently selected Force power.

Progression:
Players gain Force XP by using abilities and killing mobs. When they level up, they earn Force Points, which are spent in the Skill Tree GUI to unlock and upgrade abilities. Players can check their progress at any time with `/forcestats`.

3. Commands & Permissions

Player Commands:
/force choose <light|dark>
Permission: forceplugin.use
Default: All Players

/forcestats [player]
Alias: /fs
Permission: forceplugin.use (for self), forceplugin.admin (for others)
Default: All Players (for self)
[/CODE]

Admin Commands:
/forceadmin (or /fa)
Permission: forceplugin.admin
Default: OP

Sub-commands:
- reload: Reloads config.yml and ranks.yml.
- check <player>: Displays detailed Force data for a player.
- setside <player> <light|dark|none>: Sets a player's alignment.
- reset <player>: Completely resets a player's Force data.
- setlevel <player> <level>: Sets a player's Force Level.
- givexp <player> <amount>: Gives a player Force XP.
- givepoints <player> <amount>: Gives a player Force Points.
- giveholocron <player>: Gives a player a new Holocron for their side.

4. Configuration Files
You have full control over the plugin's balance and progression.

File: `config.yml`
This file controls the core mechanics and ability stats.

• progression:
  - `max-force-level`: The level cap for players.
  - `points-per-level`: How many Force Points are awarded on level up.
  - `base-xp` & `xp-per-level-multiplier`: These control the leveling curve. The formula is `BaseXP + ((CurrentLevel - 1) * Multiplier)`.
  - `xp-gain`: Control how much XP is awarded for using abilities, launching with Telekinesis, and killing mobs.
• abilities:
  - Each ability has its own section.
  - `unlock-cost`: The number of Force Points required to unlock the ability for the first time.
  - `max-level`: The maximum level this ability can be upgraded to.
  - `levels`: A section containing the stats for each level.
  - `upgrade-cost`: (Optional) Inside a level's block, you can define the cost to upgrade to the next level. If not defined, it defaults to 1.

File: `ranks.yml`
This file controls the thematic titles players earn.

• ranks:
  - This section defines the linear ranks a player progresses through before level 31.
  - `level-required`: The level needed to achieve the rank.
  - `display-name`: The name of the rank. You can use color codes like `&b`.
• specializations:
  - This section defines the final Master Ranks a player chooses from at level 31.
  - `id`: A unique, one-word uppercase identifier (e.g., "GUARDIAN").
  - `display-name`: The full, colored name of the rank.
  - `description`: The text that appears on the icon in the choice GUI.
  - `material`: The Minecraft item that will be used as the icon for this choice.

5. PlaceholderAPI Integration
If you have PlaceholderAPI installed, you can use these placeholders anywhere on your server.

%forceplugin_side% - Player's side (LIGHT, DARK, NONE)
%forceplugin_side_formatted% - Player's side with color
%forceplugin_rank% - Player's full, colored rank title
%forceplugin_level% - Player's Force Level number
%forceplugin_points% - Player's available Force Points
%forceplugin_xp% - Player's current XP
%forceplugin_xp_needed% - XP needed for the next level
%forceplugin_xp_bar% - A visual text-based XP bar