🏆 OurTeam | Professional & Competitive Minecraft Guilds System

OurTeam is a high-performance, enterprise-grade competitive team/faction-guilds plugin built to power high-concurrency Paper, Purpur, and Spigot (1.20 - 1.21+) servers. Engineered with modern architectural design, OurTeam balances pristine graphical GUIs, a dynamic micro-economy bank system, automated team settings, and an highly optimized, ultra-scalable in-memory score caching registry designed to hold stable 20 TPS performance even at extreme player configurations.

✨ Outstanding Features & Capabilities

• ⚡ 20-TPS Immunity Cache Registry: Roster-based checks, bank balances, and PAPI query calculations are conducted entirely in a fast, thread-safe, memory-mapped local layout to prevent database locking or main-thread bottlenecks.
• 📂 Multi-engine Local JSON Persistence: Thread-safe, atomic GSON structure writes team profiles and transactional rosters to direct individual files instantly upon saves, safely avoiding any data corruption or race conditions.
• 💼 Enterprise-Grade Guild Economy (Team Bank): Native Vault economy integration supports direct quick deposits/withdrawals or custom chat-prompted transactions. It includes automatic recurring compound interest distribution and precise deposit-contribution logging.
• 🌌 Dynamic Home & Warp Navigation: Complete with sound indicators, aesthetic portal particle trails, and standard cooldown timers / movement-damage disruption logic to maintain strict PvP and gameplay balancing.
• 👁️ Visual Control Panels (GUI Engine): Features elegant, responsive double-row and custom-grid inventories built for rapid, mouse-driven team administration.
• 📁 Direct Interactive Team Directory: Access all active teams in the server via /team list with an interactive menu. Players can browse teams and instantly send active requests by left/right-clicking on any team card.
• 🛡️ Role-based Permission Hierarchy: Four organizational ranks (Owner, Admin, Moderator, Member) manage specific command actions, controlled by a customizable teampermissions.yml configuration.
• 💬 Dual-Channel Team Chat: A dedicated private communication frequency with custom formatting and built-in setting checks that auto-reverts players to global chat if a team's moderators toggle their private channel off.

🏎️ Key Structural Columns

1. Hardened TeamScore™ Competition Algorithm

To eliminate passive alternate account padding and preserve actual competitive integrity on leaderboard scoreboards, OurTeam calculates live competitive standings using a unique, triple-axis validation check:

$$TeamScore = \sum (ActiveMemberPoints) + \frac{BankBalance}{BankScaleValue} + PvPPoints$$

• Roster Member Validation & Decay: Active roster players award a base point value (default: +50 points). The core registry continuously queries the getLastPlayed() attribute. Any account inert/offline for longer than 24 hours automatically decays to a 0-point contribution—guaranteeing that active, grinding guilds dominate the standings over dead, inflated ones.
• Financial Liquid Conversions: Cash deposited inside the Team Bank translates to permanent leaderboard standing score. For example, at 10000.0 conversion, every $10,000 accrued triggers +1 TeamScore point.
• Pro-PvP Active Combat Grinding: Defeating an enemy clan member injects instant score credits to the team pool (default: +5) and extracts score from the victim's pool (default: -2).
• Anti-Farming Exploitation Protection: Uses a sliding 60-second in-memory tracker to block repeated farming of the same target, logging fraudulent kills as 0-point spam events.
• External Integration Events: Dedicated admin command entries allow seamless integration with automated server events (e.g., King of the Hill wins, Dungeons, Envoy conquers) via direct console commands.

📋 Comprehensive PlaceholderAPI Expansion Guide

OurTeam hosts a complete native PlaceholderAPI (PAPI) expansion directory under the %ourteam_*% namespace. It exposes everything required to feed real-time team stats into scoreboards (e.g. FeatherBoard, TitleManager), dynamic TAB headers, chat formatting engines, or holograms.

1. Play-Context Placeholders (Evaluates for the Subject Player)

2. Leaderboard & Universal Standings (Rank-Position Placeholders)

Allows displaying global leaderboard rankings for top teams in holograms or sidebar widgets. Simply replace <property> with any general field (e.g., name, score, money, members) and <rank> with an index (e.g., 1, 2, 3):

• 🏆 Placeholders Ordered by TeamScore Standings:
  • %ourteam_position_name_<rank>% — e.g. %ourteam_position_name_1% ➔ Returns DeltaGroup
  • %ourteam_position_score_<rank>% — e.g. %ourteam_position_score_1% ➔ Returns 12980
  • %ourteam_position_money_<rank>% — e.g. %ourteam_position_money_2% ➔ Returns 50000.00
• 💰 Placeholders Ordered by Wealth / Bank Balance:
  • %ourteam_balanceposition_name_<rank>% — e.g. %ourteam_balanceposition_name_1% ➔ Returns name of wealthiest team.
  • %ourteam_balanceposition_money_<rank>% — e.g. %ourteam_balanceposition_money_1% ➔ Returns 157942.50
• 👥 Placeholders Ordered by Faction Roster Sizes:
  • %ourteam_membersposition_name_<rank>% — e.g. %ourteam_membersposition_name_1% ➔ Returns name of largest group.
  • %ourteam_membersposition_members_<rank>% — e.g. %ourteam_membersposition_members_1% ➔ Returns 18

3. Static Multi-Target Mapping (Queries Specific Targets)

Evaluate calculations for specific remote targets irrespective of who is querying:

• 🏡 Query by Raw Team Name:
  • %ourteam_static_<property>_<teamName>% — e.g. %ourteam_static_score_DeltaGroup% ➔ Returns 12980
  • %ourteam_static_money_DeltaGroup% ➔ Returns 50000.00
• 👤 Query by Player Account Target Name:
  • %ourteam_staticplayer_<property>_<playerName>% — e.g. %ourteam_staticplayer_name_Notch% ➔ Returns the name of Notch's team.
  • %ourteam_staticplayer_rank_Notch% ➔ Returns Notch's position/role inside their respective team.

4. Global System Toggle Query Interface

• %ourteam_command_<feature_or_command_name>% — Evaluates if a command action is enabled in the global configuration (returns on/off):
  • Examples: %ourteam_command_create%, %ourteam_command_bank%, %ourteam_command_teleport%, %ourteam_command_echest%.

🛠️ Complete Command Directory & Permissions

Player Command Hierarchy (Permission Node: ourteam.use)

Administrative Commands (Permission Node: ourteam.admin)

🎨 Professional Configuration File (config.yml)

Customize parameters, telemetry, banking, limits, and sounds instantly:

# =============================================================================
#              OurTeam - Premium Guilds & Roster Ecosystem File
# =============================================================================

# Dynamic Leaderboard Standing calculations config
team-score:
  points-per-active-member: 50
  active-member-timeframe-hours: 24
  currency-per-point: 10000.0
  points-per-kill: 5
  points-lost-per-death: 2
  spam-threshold-seconds: 60

# Teleport delays, movement disruption and particle animations
cooldowns-and-teleportation:
  teleport-cooldown: 45                 # General teleport cooldown (in seconds)
  warp-warmup-seconds: 5                # Teleport delay interval (in seconds)
  cancel-on-movement: true              # Cancel teleport if player moves
  cancel-on-damage: true                # Cancel teleport if player takes damage
  teleport-particle: "PORTAL"           # Particle types spawned at warmup tick
  teleport-sound: "ENTITY_ENDERMAN_TELEPORT" # Sound played upon successful teleport
  max-homes-per-team: 3                 # Max homing locations per team
  max-warps-per-team: 5                 # Max warps per team

# Guild Banking, compound interest ledger
bank-settings:
  starting-balance: 0.0
  max-balance-cap: 10000000.0
  paytoggle-by-default: true
  interest:
    enabled: true
    rate-percent: 0.5                   # Teammates gain 0.5% interest on bank wealth
    interval-seconds: 3600              # Interest accrued and calculated every hour
    minimum-balance-required: 1000.0    # Minimum funds required to gain accrued interest