TeamHUD 组队插件

简介

TeamHUD 是一款轻量级 Minecraft 服务器组队插件，支持队伍创建/邀请/聊天、侧边栏队友 HUD、头顶队友信息显示、队伍持久化，零外部依赖。

功能特性

功能	说明
队伍管理	创建/邀请/接受/离开/解散，支持邀请过期
队伍聊天	/队伍 说 <消息> 仅队员可见
侧边栏 HUD	右侧计分板显示队友名+距离+方位，标题为队伍名
头顶 HUD	靠近队友头顶显示信息+小头像，距离>50格自动隐藏
跨世界隐藏	队友在不同世界时自动隐藏 HUD
个人开关	`/队伍 面板 on
持久化	队伍数据存 teams.yml，重启不丢失
管理员指令	强制解散/踢出/加入，无需权限

命令

命令	说明	权限
/队伍 创建 <名>	创建队伍	所有人
/队伍 邀请 <玩家>	邀请玩家入队	队长
/队伍 接受	接受邀请	被邀请者
/队伍 拒绝	拒绝邀请	被邀请者
/队伍 离开	离开队伍	队员
/队伍 解散	解散队伍	队长
/队伍 列表	查看队伍成员	队员
/队伍 说 <消息>	队伍聊天	队员
`/队伍 面板 on	off`	切换 HUD 显示
/队伍 重载	重载配置	OP
/队伍 管理列表	查看所有队伍	OP
/队伍 强制解散 <队长>	强制解散队伍	OP
/队伍 强制踢出 <队长> <玩家>	强制踢出队员	OP
/队伍 强制加入 <队长> <玩家>	强制加入队伍	OP

安装

1. 将 teamhud-1.0.0.jar 放入服务器的 plugins/ 文件夹
2. 重启服务器或执行 /reload confirm
3. 插件自动生成 plugins/TeamHUD/config.yml 和 teams.yml

配置说明

hud:
  sidebar:
    title: "&a{team}"          # 侧边栏标题，{team} 替换为队伍名
    format: "§a{name} §r| §f{dist}m §7{dir}"  # 队友显示格式
    refresh: 20                 # 刷新间隔（tick）
  head:
    enabled: true               # 头顶 HUD 开关
    distance: 50                # 最大显示距离（格）

兼容性

• Paper / Spigot 1.16 ~ 最新版
• Java 17+

开源

本项目以 MIT 协议开源，欢迎提交 Issue 和 Pull Request。

Copyright (c) 2026 TinyAII

---

TeamHUD - Team Plugin for Minecraft

Introduction

TeamHUD is a lightweight Minecraft server team plugin featuring team creation/invite/chat, sidebar teammate HUD, overhead teammate info display, and persistent data. Zero external dependencies.

Features

Feature	Description
Team Management	Create/invite/accept/leave/disband, with invite expiration
Team Chat	/team chat <message> visible only to teammates
Sidebar HUD	Right sidebar shows teammate name+distance+direction, title = team name
Overhead HUD	Shows info+avatar above nearby teammates, auto-hides beyond 50 blocks
Cross-world Hide	Auto-hides HUD when teammates are in different worlds
Personal Toggle	`/team hud on
Persistent Data	Saved to teams.yml, survives server restarts
Admin Commands	Force disband/kick/join, no permission required

Commands

Command	Description	Permission
/team create <name>	Create a team	everyone
/team invite <player>	Invite player	leader
/team accept	Accept invite	invited
/team deny	Deny invite	invited
/team leave	Leave team	member
/team disband	Disband team	leader
/team list	View members	member
/team chat <msg>	Team chat	member
`/team hud on	off`	Toggle HUD
/team reload	Reload config	OP
/team admin list	View all teams	OP
/team admin disband <leader>	Force disband	OP
/team admin kick <leader> <player>	Force kick	OP
/team admin join <leader> <player>	Force join	OP

Compatibility

• Paper / Spigot 1.16 ~ latest
• Java 17+

License

MIT License - Copyright (c) 2026 TinyAII