Guilds

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What is this?

Players form guilds that grow together. Mining, fighting, fishing, farming — every action contributes shared XP. Guilds level up, unlock perks, complete tasks, earn achievements, and compete in seasonal rankings.

Everything is configurable. XP curves, perk values, task targets, reward amounts, bank limits, season length — all in clean YAML. No code required.

Works as a guild, clan, or team plugin — whatever fits your server.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙ Features

XP & Leveling

• Shared guild XP from vanilla actions — configurable % (default 10%)
• Geometric XP curve with 4 presets: easy / normal / hard / no-life — or fully custom base + growth values
• Milestone bonuses at configurable member count thresholds
• Optional money reward on level-up (amount, scaling, cap — all configurable)
• Max level configurable

⭐ Perks

• 13 tiers from Level 1–100 — every value configurable in perks.yml
• Grants: XP boost, task reward bonus, extra member cap, extra task slots
• Persist through prestige — progress never feels wasted

Tasks

• 4 rotating weekly pools with Easy / Normal / Hard tasks
• Daily hard challenge — configurable reward multiplier (default 2.2×), resets at midnight
• 60+ task templates: mining, combat, farming, fishing, brewing, building
• All targets, rewards, and refresh timers configurable per task
• Deepslate ore variants count toward mining tasks
• Anti-abuse cooldown for place-block tasks
• Optional task scaling by guild size — configurable multiplier and bounds
• Optional money payout per completed task — configurable
• Task slot caps configurable to keep the GUI manageable

Prestige

• After max level: reset and earn permanent stacking bonuses
• Configurable bonuses per tier: XP boost, task reward, member cap, task slots
• Overflow XP carries over into the new cycle
• Max level requirement and reset level are configurable

Achievements

• 17 built-in achievements — tasks, level, members, seasonal XP, prestige
• Every target, reward XP, badge name, and enabled state configurable in achievements.yml
• Add as many custom achievements as you want

Guild Bank

• Vault-based shared bank — unlocks at a configurable guild level
• Daily deposit limits per rank — configurable, can be disabled
• Daily withdraw limits per rank — configurable, disabled by default
• Withdraw cooldown per player — configurable
• Max guild balance cap — configurable (0 = unlimited)
• Paginated transaction log — length configurable
• Can be fully toggled via feature flag

Seasons

• Configurable season length with optional auto-reset
• Reward commands per placement rank — any console command, configurable per rank
• Rewards distributed to all guild members, not just the owner
• Seasonal XP leaderboard
• History stored in seasons.yml

Allies

• Send, accept, deny, cancel, and remove alliances
• Max allies per guild configurable
• Request expiry time configurable
• Fully toggleable via feature flag

Name & Tag Filter

• Exact blacklist, contains blacklist, regex blacklist, whitelist — per field
• Normalization: leetspeak map, lowercase, space removal, repeating char collapse — all configurable
• Actions configurable: block creation, custom message, console logging, log format

⚡ Other

• Inactivity kick — threshold, exempt ranks, exempt permissions (works offline via Vault)
• Guild home with configurable cooldown and Officer+ permission
• Guild chat channel (/gc shortcut), tag in chat unlocks at configurable level
• Guild log with timestamps
• All 7 major systems togglable at runtime — no restart needed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

GUI

• Main menu — profile, XP bar, tasks, members, bank, achievements, leaderboard
• Tasks menu — Weekly / Daily Hard / Random sections with progress bars
• Members menu — sorted by rank then XP contributed
• Bank menu — quick deposit/withdraw buttons + paginated transaction log
• Achievements menu — locked/unlocked state with progress
• Leaderboard — Total (level + XP) or Seasonal (seasonal XP)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Dependencies

• Required: Paper 1.21+
• Optional: Vault — bank and money rewards
• Optional: PlaceholderAPI — %guilds_tag%, %guilds_name%, %guilds_rank%
• Optional: Skills plugin — cross-plugin perk bonuses

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Config Files

• general.yml — XP curve, caps, bank, inactivity, prestige, rewards, unlocks
• perks.yml — Perk tiers and values
• tasks.yml — Weekly pools, daily hard pool, all task templates
• achievements.yml — Achievement definitions and rewards
• seasons.yml — Season config and reward commands
• blacklist.yml — Name filter rules, regex, normalization
• messages.yml — All 160+ messages in MiniMessage format — hot-reloadable
• features.yml — Toggle features at runtime without restart

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━