OurTeam

# 🏆 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)

| Placeholder | Outputs | Example Return Value | | :--- | :--- | :--- | | `%ourteam_inteam%` | Custom offline check indicator | `Yes` / `No` | | `%ourteam_name%` | Direct team alphabetical identity | `AlphaFaction` / `No Team` | | `%ourteam_tag%` | Styled short team label | `AlphaFaction` | | `%ourteam_displayname%` | Normalized team descriptor | `AlphaFaction` | | `%ourteam_description%` | Custom descriptive block | `The undisputed champions!` | | `%ourteam_score%` | Cumulative calculated score weight | `3528` | | `%ourteam_money%` | Double-precision undivided bank account | `25482. 50` | | `%ou