NeonClans

NeonClans is a modern, modular clan management plugin designed for Paper and Spigot Minecraft servers running 1.20 through 1.21+. Built for competitive survival, factions, and community networks, it combines dynamic tag styling, territory buffs, team-based progression, cloud vaults, and 24-hour bank-raiding clan wars into an intuitive GUI-driven experience.

---

Features

Dynamic Tag Progression and Rank Hierarchy

• Built-in role hierarchy: Owner, Moderator, and Member.
• Automatic role suffixes (for example, double asterisk for Owner, single asterisk for Moderator).
• Level-based tag colorization that updates automatically in chat, scoreboards, and tablists.
• Max-level clans unlock custom tag formatting, allowing owners to customize their tag layout freely.

Clan Nexus and Territory Defense

• Deploy a Clan Nexus block to establish territory for your group.
• Active clan members within the nexus radius gain passive buffs (Speed, Regeneration, and Haste).
• Territory radius scales upward as the clan advances in levels.
• Intruder detection warns online members whenever non-allied players cross into their territory.

Daily Clan Quests

• Daily objectives generated automatically for all clans (Mining, Mob Kills, PvP Kills).
• Progress is shared collectively across all active members.
• Completing objectives deposits monetary rewards directly into the Clan Bank.

Clan Wars and Rivalries

• Formal 24-hour war declarations with interactive commands.
• Real-time PvP kill trackers between engaged clans.
• The winning clan automatically loots a configurable percentage (15% by default) of the defeated clan's bank balance.

Clan Skill Tree and Perks

• Unlock passive clan abilities through an interactive menu:
  • Loot Harvester: +15% mob experience and drop boosts.
  • Teleport Haste: 50% warmup reduction on /clan home teleports.
  • Experience Sharing: Shares 10% earned experience with nearby online members.
  • Vault Protection: Restricts vault access to clan staff.

Virtual Clan Vault

• Persistent shared cloud storage backed by asynchronous SQLite serialization.
• Storage capacity grows from 9 slots to a full 54-slot double chest as the clan levels up.

Administrative Audit Logs

• Complete in-game tracking of clan transactions, vault modifications, promotions, demotions, and war declarations via a dedicated GUI.

Visual Effects

• Toggleable neon player glow outlines.
• End Rod particle synergy rings triggered when clan members group within 5 blocks of each other.

---

Commands and Permissions

Command	Permission	Description
/clan	neonclans.use	Opens the main interactive Clan GUI.
/clan create	neonclans.use	Creates a new clan.
/clan info [clan]	neonclans.use	Views statistics, balance, and member counts.
/clan invite	neonclans.use	Sends a membership invitation.
/clan join	neonclans.use	Accepts a pending invitation.
/clan leave	neonclans.use	Leaves your current clan.
/clan kick	neonclans.use	Removes a member from the clan.
/clan promote	neonclans.use	Promotes a member to Moderator.
/clan demote	neonclans.use	Demotes a Moderator back to Member.
/clan transfer	neonclans.use	Transfers clan ownership.
/clan sethome	neonclans.use	Sets the clan home waypoint.
/clan home	neonclans.use	Teleports to clan home coordinates.
/clan bank <deposit/withdraw/balance>	neonclans.use	Manages clan funds.
/clan ally <add/remove/chat> [clan]	neonclans.use	Manages diplomatic alliances.
/clan chat [message]	neonclans.use	Toggles or sends messages in clan chat.
/clan top	neonclans.use	Opens the Top Clans Leaderboard GUI.
/clan nexus <place/remove/info>	neonclans.use	Manages the territory nexus beacon.
/clan quest	neonclans.use	Opens the Daily Quests GUI.
/clan war <declare/accept/status/surrender>	neonclans.use	Declares or manages clan wars.
/clan perks	neonclans.use	Opens the Clan Skill Tree GUI.
/clan logs	neonclans.use	Views clan audit logs.
/clan glow	neonclans.use	Toggles neon player glow effect.
/clan reload	neonclans.admin	Reloads plugin configuration and database.

---

PlaceholderAPI Identifiers

• %neonclans_name% - Name of the player's clan.
• %neonclans_tag% - Colorized tag formatted with rank suffix.
• %neonclans_raw_tag% - Unformatted clan tag.
• %neonclans_role% - Player's role in the clan (Owner, Moderator, Member).
• %neonclans_role_suffix% - Suffix assigned to the player's role.
• %neonclans_level% - Current level of the clan.
• %neonclans_balance% - Formatted clan bank balance.
• %neonclans_members_count% - Current member count.
• %neonclans_max_members% - Maximum allowed members for current clan level.

---

Dependencies and Requirements

• Required:
  • Server Software: Paper, Purpur, or Spigot (Minecraft 1.20 - 1.21+)
  • Java: Java 17 or higher
  • Vault: Required for economy transactions (bank, clan creation costs, level upgrades)
• Optional:
  • PlaceholderAPI: For scoreboard, chat, and tablist placeholders