AdvancementByPercentage

AdvancementByPercentage
A Paper plugin that calculates player completion percentage based on advancements, hidden advancements, and special advancement (weighted advancement) categories, supporting progress beyond 100% up to 112%.

# Features
- Percentage system inspired by Hollow Knight's 112%.
- Supports progress up to **112%**.
- Visible advancements, hidden advancements all contribute. You can change whether to add hidden advancement to the completion or not, and also choose whether to make hidden advancements compulsory or not.
- PlaceholderAPI support.
- TAB integration.
- Configurable color thresholds.
- Configurable RGB gradients.
- Configurable formatting (bold, italic, underline, etc.).
- Automatic cache management.
- Lightweight and async-friendly.
- Progress automatically updates when advancements are granted or revoked.
# Requirements
- Paper 1.21.11 or better (Older versions may work too, just haven't checked)
- PlaceholderAPI (required)
- Any tab plugin (to show the percentage in tab)

# Installation
1. Download `AdvancementByPercentage-x.x.x.jar`.
2. Place the jar into your server's `plugins/` folder.
3. Install TAB.
4. Install PlaceholderAPI.
5. Restart the server.
6. There's a README.txt file beside the config.yml to guide you further.

# Commands
administrator permission: /abp reload *
| `/abp help`| Shows help menu |
| `/abp version`| Shows plugin information |
| `/abp reload`* | Reloads the configuration |
| `/abp recalculate <player>`* | Recalculates a player's progress |
| `/abp debug <player>`* | Shows detailed progress information |

# PlaceholderAPI
| `%abp_percentage%` | Rounded percentage |
| `%abp_raw%` | Exact percentage |
| `%abp_display%` | Displays `[xx%]` |
| `%abp_tab%` | Colored/Gradient/formatted version for TAB |
Usage: /papi parse <player> %abp_raw%

# TAB Example
....yml
customtabname: '%player% %abp_tab%'

# Progress System
Default weights:
- Visible Advancements: 90%
- Monsters Hunted: 5%
- Adventuring Time: 5%
- Hidden Advancements Bonus: +6%
- How Did We Get Here Bonus: +6%
Maximum possible completion: 112% (can be configured in config.yml)

Made by suvrdudekoi.