OurTeam

插件

· 作者 MySie

这是一个 Minecraft 团队插件

1 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 26.1.2 · Paper / Spigot

一键开服(送7天)

? 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    # 获得累计利息所需的最低资金

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源