? OurTeam | 专业竞技型 Minecraft 公会系统
OurTeam 是一款高性能、企业级的竞争性团队/阵营/公会插件,专为支撑高并发的 Paper、Purpur 和 Spigot (1.20 - 1.21+) 服务器而构建。采用现代架构设计,OurTeam 在提供精美图形化 GUI、动态微型经济银行系统、自动化团队设置的同时,还内置了高度优化且极具扩展性的内存分数缓存注册表,旨在极端玩家配置下依然保持 稳定的 20 TPS 性能。
✨ 卓越功能与能力
- ⚡ 20-TPS 免疫缓存注册表: 基于名册的检查、银行余额查询以及 PAPI 占位符计算完全在快速、线程安全、内存映射的本地布局中进行,以防止数据库锁定或主线程瓶颈。
- ? 多引擎本地 JSON 持久化: 线程安全的原子 GSON 结构将团队档案和事务性名册即时写入独立的直接文件,安全地避免任何数据损坏或竞态条件。
- ? 企业级公会经济(团队银行): 原生支持 Vault 经济集成,允许直接快速存取款或通过自定义聊天提示进行交易。包含自动复利分配和精确的存款贡献记录。
- ? 动态家园与传送导航: 配备声音指示器、美观的传送门粒子轨迹,以及标准的 冷却计时器 / 移动伤害中断逻辑,以维持严格的 PvP 和游戏平衡。
- ?️ 可视化控制面板(GUI 引擎): 提供优雅、响应式的双行和自定义网格库存界面,专为快速的鼠标驱动团队管理而设计。
- ? 直接交互式团队目录: 通过
/team list 访问服务器中的所有活跃团队,并配有交互式菜单。玩家可以浏览团队,并通过左键/右键点击任何团队卡片 即时发送活跃请求。
- ?️ 基于角色的权限层级: 四个组织等级(所有者、管理员、版主、成员)管理特定的命令操作,由可自定义的
teampermissions.yml 配置文件控制。
- ? 双通道团队聊天: 专用的私有通信频道,具有自定义格式和内置设置检查,如果团队的版主关闭了其私有频道,会自动将玩家切换回全局聊天。
?️ 核心结构列
1. 强化 TeamScore™ 竞争算法
为了消除被动使用小号刷分的行为并维护排行榜计分板上的实际竞争完整性,OurTeam 使用独特的三轴验证检查来计算实时的竞争排名:
$$TeamScore = \sum (ActiveMemberPoints) + \frac{BankBalance}{BankScaleValue} + PvPPoints$$
- 名册成员验证与衰减: 活跃的名册玩家奖励基础点数(默认:
+50 点)。核心注册表持续查询 getLastPlayed() 属性。任何闲置/离线超过 24 小时 的账户会自动衰减为 0 点贡献——确保活跃、努力升级的公会在排名中占据主导地位,而非死寂或被注水的公会。
- 金融资产转换: 存入团队银行的现金转化为永久的排行榜积分。例如,在
10000.0 的转换率下,每积累 $10,000 就会触发 +1 TeamScore 积分。
- 支持 PvP 的活跃战斗刷分: 击败敌方公会成员会向团队池注入即时积分(默认:
+5),并从受害者池中扣除积分(默认:-2)。
- 防刷分剥削保护: 使用滑动 60 秒内存跟踪器阻止对同一目标的重复刷分,并将欺诈性击杀记录为 0 点垃圾事件。
- 外部集成事件: 专用的管理员命令条目允许通过直接控制台命令无缝集成到自动化的服务器事件中(例如,山丘之王胜利、地下城、特使征服等)。
? 全面的 PlaceholderAPI 扩展指南
OurTeam 在 %ourteam_*% 命名空间下托管了一个完整的原生 PlaceholderAPI (PAPI) 扩展目录。它暴露了所有必要的占位符,以便将实时团队统计数据馈送到计分板(例如 FeatherBoard、TitleManager)、动态 TAB 标题、聊天格式化引擎或全息图。
1. 游戏上下文占位符(针对主体玩家评估)
| 占位符 |
输出内容 |
示例返回值 |
%ourteam_inteam% |
自定义离线状态指示器 |
Yes / No |
%ourteam_name% |
团队字母顺序标识 |
AlphaFaction / No Team |
%ourteam_tag% |
带样式的简短团队标签 |
AlphaFaction |
%ourteam_displayname% |
标准化团队描述符 |
AlphaFaction |
%ourteam_description% |
自定义描述性文本块 |
The undisputed champions! |
%ourteam_score% |
累计计算得分权重 |
3528 |
%ourteam_money% |
双精度未分割的银行账户余额 |
25482.50 |
%ourteam_moneyshort% |
紧凑的科学计数法数值转换 |
25.5k / 1.2M |
%ourteam_members% |
团队名册中的活跃玩家数量 |
6 |
%ourteam_online% |
实时并发在线成员数量 |
3 |
%ourteam_maxmembers% |
基于等级的名册软上限限制 |
8 |
%ourteam_onlinelist% |
所有当前在线队友的名称列表 |
Notch, Dinnerbone |
%ourteam_offlinelist% |
自定义的离线队友列表 |
Jeb_ |
%ourteam_level% |
名册竞技等级层级 |
4 |
%ourteam_maxmoney% |
账户容量阈值限制 |
200000.00 |
%ourteam_maxwarps% |
允许的传送点总数 |
5 |
%ourteam_pvp% |
友军伤害标志状态 |
true / false |
%ourteam_rank% |
查询玩家的职位层级 |
MODERATOR |
%ourteam_title% |
玩家的本地化角色头衔 |
Moderator |
%ourteam_owners% |
氏族领袖的实时用户名 |
Steve |
%ourteam_admins% |
以逗号分隔的所有者和管理员列表 |
Steve, Notch |
%ourteam_defaultmembers% |
以逗号分隔的标准层级玩家列表 |
Dinnerbone, Jeb_ |
%ourteam_positionscore% |
服务器上的最高分排名位置 |
1 |
%ourteam_positionbal% |
服务器上的财富排名位置 |
3 |
%ourteam_positionmembers% |
服务器上的名册规模排名位置 |
2 |
%ourteam_hashome% |
已建立的家坐标状态 |
Yes / No |
%ourteam_teamchat% |
活动聊天切换追踪频道 |
Team / Global |
2. 排行榜与通用排名(排名位置占位符)
允许在全息图像或侧边栏小部件中显示顶级团队的全球排行榜排名。只需将 <property> 替换为任何通用字段(例如 name、score、money、members),并将 <rank> 替换为索引(例如 1、2、3):
- ? 按团队得分排序的占位符:
%ourteam_position_name_<rank>% — 例如 %ourteam_position_name_1% ➔ 返回 DeltaGroup
%ourteam_position_score_<rank>% — 例如 %ourteam_position_score_1% ➔ 返回 12980
%ourteam_position_money_<rank>% — 例如 %ourteam_position_money_2% ➔ 返回 50000.00
- ? 按财富/银行余额排序的占位符:
%ourteam_balanceposition_name_<rank>% — 例如 %ourteam_balanceposition_name_1% ➔ 返回最富有团队的名称。
%ourteam_balanceposition_money_<rank>% — 例如 %ourteam_balanceposition_money_1% ➔ 返回 157942.50
- ? 按派系名册规模排序的占位符:
%ourteam_membersposition_name_<rank>% — 例如 %ourteam_membersposition_name_1% ➔ 返回最大团队的名称。
%ourteam_membersposition_members_<rank>% — 例如 %ourteam_membersposition_members_1% ➔ 返回 18
3. 静态多目标映射(查询特定目标)
评估针对特定远程目标的计算结果,无论谁在进行查询:
- ? 通过原始团队名称查询:
%ourteam_static_<property>_<teamName>% — 例如 %ourteam_static_score_DeltaGroup% ➔ 返回 12980
%ourteam_static_money_DeltaGroup% ➔ 返回 50000.00
- ? 通过玩家账号目标名称查询:
%ourteam_staticplayer_<property>_<playerName>% — 例如 %ourteam_staticplayer_name_Notch% ➔ 返回 Notch 所在团队的名称。
%ourteam_staticplayer_rank_Notch% ➔ 返回 Notch 在其各自团队中的职位/角色。
4. 全局系统切换查询接口
%ourteam_command_<feature_or_command_name>% — 评估全局配置中是否启用了某项命令操作(返回 on/off):
- 示例:
%ourteam_command_create%、%ourteam_command_bank%、%ourteam_command_teleport%、%ourteam_command_echest%。
?️ 完整命令目录与权限
玩家命令层级(权限节点:ourteam.use)
| 主指令 |
别名 / 子命令 |
操作描述 |
/team create <name> |
c |
注册并创建属于你所有权的新团队名册。 |
/team invite <player> |
i |
邀请另一名玩家加入你的团队(需要邀请权限)。 |
/team join <team> |
j |
直接加入有有效邀请的团队,或 OPEN JOIN 类型的团队。 |
/team request <team> |
req |
向私有团队发送待处理的加入请求。 |
/team leave |
l |
辞去成员资格并离开当前团队名册。 |
/team kick <player> |
k |
将成员从你的团队名册中驱逐(仅限管理员/所有者)。 |
/team disband |
dis |
永久删除你的团队注册信息(仅限所有者)。 |
/team promote <player> |
prom |
将队友晋升至更高的等级状态。 |
/team demote <player> |
dem |
将队友降级至更低的等级层级。 |
/team chat |
c |
在专用团队聊天和公共聊天之间切换聊天模式。 |
/team msg <msg...> |
m |
向在线的队友发送私密消息的直接渠道。 |
/team pvp |
ff |
切换队友之间是否可以互相造成伤害。 |
/team bank |
b |
打开带有利息账目信息的图形界面团队银行。 |
/team list |
l |
打开所有活跃团队 GUI 以浏览团队或发送请求。 |
/team sethome [name] |
— |
在当前位置建立家庭检查点。 |
/team home [name] |
— |
启动传送序列前往选定的团队家园。 |
/team delhome [name] |
— |
删除自定义的团队家园检查点。 |
/team setwarp <name> |
— |
设置一个动态团队传送点,供队友访问。 |
/team warp <name> |
— |
将玩家传送到指定的传送检查点位置。 |
/team delwarp <name> |
— |
撤销并删除团队传送检查点。 |
/team top |
— |
渲染按分数排序的前几名活跃团队的丰富列表。 |
/team gui |
settings |
打开主要的图形化设置菜单以进行自定义。 |
管理指令(权限节点:ourteam.admin)
| 管理指令 |
别名 |
操作描述 |
/teamsadmin r |
reload |
立即重新加载所有配置、规则和文件。 |
/teamsadmin score add <t> <val> |
— |
直接向团队的永久总分中添加分数点数。 |
/teamsadmin score take <t> <val> |
— |
从团队的缓存中扣除分数点数。 |
/teamsadmin score set <t> <val> |
— |
重写并将团队的分数参数设置为严格值。 |
/teamsadmin resetbank <team> |
— |
清除属于目标团队的所有现金余额持有量。 |
/teamsadmin info <team> |
— |
在聊天中运行对团队存储配置的深层结构审计。 |
? 专业配置文件 (config.yml)
即时自定义参数、遥测、银行、限制和声音:
# =============================================================================
# OurTeam - Premium Guilds & Roster Ecosystem File
# =============================================================================
# 动态排行榜排名计算配置
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
# 传送延迟、移动干扰和粒子动画
cooldowns-and-teleportation:
teleport-cooldown: 45 # 通用传送冷却时间(秒)
warp-warmup-seconds: 5 # 传送延迟间隔(秒)
cancel-on-movement: true # 如果玩家移动则取消传送
cancel-on-damage: true # 如果玩家受到伤害则取消传送
teleport-particle: "PORTAL" # 在预热刻度生成的粒子类型
teleport-sound: "ENTITY_ENDERMAN_TELEPORT" # 成功传送时播放的声音
max-homes-per-team: 3 # 每队最大家园数量
max-warps-per-team: 5 # 每队最大传送点数量
# 公会银行、复利账目
bank-settings:
starting-balance: 0.0
max-balance-cap: 10000000.0
paytoggle-by-default: true
interest:
enabled: true
rate-percent: 0.5 # 队友在银行存款财富上获得 0.5% 的利息
interval-seconds: 3600 # 每小时累计并计算一次利息
minimum-balance-required: 1000.0 # 获得累计利息所需的最低资金
? 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 |
%ourteam_moneyshort% |
Compact scientific numeric conversion |
25.5k / 1.2M |
%ourteam_members% |
Active count of players on team roster |
6 |
%ourteam_online% |
Real-time concurrent online member count |
3 |
%ourteam_maxmembers% |
Roster soft-cap limit based on level |
8 |
%ourteam_onlinelist% |
Names of all currently online teammates |
Notch, Dinnerbone |
%ourteam_offlinelist% |
Custom offline listing of teammates |
Jeb_ |
%ourteam_level% |
Roster competitive leveling tier |
4 |
%ourteam_maxmoney% |
Account threshold capacity limit |
200000.00 |
%ourteam_maxwarps% |
Total allowed warp checkpoints |
5 |
%ourteam_pvp% |
Friendly fire flag status |
true / false |
%ourteam_rank% |
Role tier of the querying player |
MODERATOR |
%ourteam_title% |
Localized role title of the player |
Moderator |
%ourteam_owners% |
Clan leader's real-time username |
Steve |
%ourteam_admins% |
Comma-separated owners and admins |
Steve, Notch |
%ourteam_defaultmembers% |
Comma-separated list of standard tier players |
Dinnerbone, Jeb_ |
%ourteam_positionscore% |
Top-Score ranking position on the server |
1 |
%ourteam_positionbal% |
Wealth ranking position on the server |
3 |
%ourteam_positionmembers% |
Roster-size ranking position on the server |
2 |
%ourteam_hashome% |
Home coordinates established state |
Yes / No |
%ourteam_teamchat% |
Active chat toggle tracking channel |
Team / Global |
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)
| Primary Command |
Alias / Subcommand |
Action Description |
/team create <name> |
c |
Registers and creates a new Team roster under your ownership. |
/team invite <player> |
i |
Invites another player to join your team (Requires Invite Perms). |
/team join <team> |
j |
Directly joins a team with an active invite, or OPEN JOIN teams. |
/team request <team> |
req |
Sends a pending Join Request to a private team. |
/team leave |
l |
Resigns your membership and leaves your current team roster. |
/team kick <player> |
k |
Evicts a member from your team roster (Admin/Owner only). |
/team disband |
dis |
Permanently deletes your team registry (Owner only). |
/team promote <player> |
prom |
Promotes a teammate to the next higher rank status. |
/team demote <player> |
dem |
Demotes a teammate to a lower rank tier. |
/team chat |
c |
Toggles your chat mode between Dedicated Team-Chat and Public-Chat. |
/team msg <msg...> |
m |
Direct private messaging channel to your online teammates. |
/team pvp |
ff |
Toggles whether teammates can deal damage to each other. |
/team bank |
b |
Opens the GUI Team Bank with interest ledger information. |
/team list |
l |
Opens the ALL ACTIVE TEAMS GUI to browse teams or send requests. |
/team sethome [name] |
— |
Establishes a home checkpoint at your current location. |
/team home [name] |
— |
Initiates teleport sequence to the selected team home. |
/team delhome [name] |
— |
Deletes a customized team home checkpoint. |
/team setwarp <name> |
— |
Sets a dynamic team warp point accessible to teammates. |
/team warp <name> |
— |
Teleports player to the specified warp checkpoint location. |
/team delwarp <name> |
— |
Revokes and deletes a team warp checkpoint point. |
/team top |
— |
Renders a rich list of the top active teams sorted by Score. |
/team gui |
settings |
Opens the main Graphical Settings Menu for customization. |
Administrative Commands (Permission Node: ourteam.admin)
| Admin Command |
Alias |
Action Description |
/teamsadmin r |
reload |
Instantly reloads all configurations, rules and files. |
/teamsadmin score add <t> <val> |
— |
Directly awards score points to a team's permanent total. |
/teamsadmin score take <t> <val> |
— |
Penetrates/deducts score points from a team's cache. |
/teamsadmin score set <t> <val> |
— |
Rewrites and sets a team's score parameter to a strict value. |
/teamsadmin resetbank <team> |
— |
Clears all cash balance holdings belonging to a target team. |
/teamsadmin info <team> |
— |
Runs deep structural audits on team storage configurations in chat. |
? 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧