NodeTAB

一个功能丰富的 Minecraft 服务器 TAB 列表管理插件，支持自定义玩家列表显示、日本风格日历系统和玩家属性实时展示。

English | 简体中文

✨ 特性

📋 TAB 列表自定义

• 自定义头部和底部：完全可配置的 TAB 列表头部和底部显示
• 丰富的变量支持：在线玩家数、最大玩家数、时间等动态变量
• 颜色与格式：支持 Minecraft 颜色代码和格式化选项
• 实时更新：可配置的更新间隔，保持信息实时显示

📅 幕府日历系统

• 日本风格日历：基于日本传统月份命名（睦月、如月、弥生等）
• 自动时间流逝：现实时间映射到游戏内日历（24小时 = 1年）
• 季节系统：四季轮换显示（初春之季、花开之季、丰收之季、寒霜之季）
• 星期系统：日本风格星期命名（月曜日、火曜日等）
• 灵活配置：支持自动和手动时间模式

📊 玩家属性展示

• 实时属性显示：在 TAB 页脚显示玩家当前属性修饰符
• 智能过滤：可选择只显示被装备/效果修改的属性
• 美化显示：
  • 彩色数值显示（正值绿色↑，负值红色↓，零值黄色）
  • 居中对齐选项
  • 精美的分隔线设计
• 属性类型：支持攻击伤害、攻击速度、护甲、移动速度等多种属性
• 自定义屏蔽：可配置需要隐藏的属性类型

📦 安装

前置要求

• Minecraft 1.21.1
• Paper/Spigot 服务端
• Java 21 或更高版本

安装步骤

1. 从 Releases 页面下载最新版本的 JAR 文件
2. 将 JAR 文件放入服务器的 plugins 文件夹
3. 重启服务器
4. 编辑 plugins/NodeTAB/config.yml 文件来自定义配置
5. 使用 /nodetab reload 重新加载配置

🎮 使用方法

命令

命令	描述	权限
/nodetab reload	重新加载插件配置	nodetab.admin
/nodetab info	查看当前配置信息	nodetab.admin

权限

权限节点	描述	默认
nodetab.admin	允许管理插件	OP

⚙️ 配置

基础配置

# 更新间隔（20 ticks = 1秒）
update-interval: 20

header:
  enabled: true
  lines:
  - '&eNodeMC'

footer:
  enabled: true
  lines:
  - '&a在线: &e{online}&f/&e{max}'
  - '&6&LNode历: &f&L{mufu_year}年 {mufu_season} {mufu_month_name} {mufu_day}日 {mufu_weekday_name}'

可用变量

变量	描述
{online}	当前在线玩家数
{max}	最大玩家数
{time}	当前时间（使用 time-format 格式）
{time_24h}	当前时间（24小时格式）
{mufu_year}	幕府日历年份
{mufu_month}	幕府日历月份数字（1-12）
{mufu_month_name}	幕府日历月份名称（如"睦月"）
{mufu_day}	幕府日历日期（1-30）
{mufu_weekday}	幕府日历星期几数字（1-7）
{mufu_weekday_name}	幕府日历星期几名称（如"月曜日"）
{mufu_season}	当前季节（如"丰收之季"）

颜色代码

代码	颜色	代码	颜色
&0	黑色	&8	深灰色
&1	深蓝色	&9	蓝色
&2	深绿色	&a	绿色
&3	深青色	&b	青色
&4	深红色	&c	红色
&5	深紫色	&d	粉色
&6	金色	&e	黄色
&7	灰色	&f	白色

格式代码

代码	效果
&l	加粗
&n	下划线
&o	斜体
&k	随机字符
&m	删除线
&r	重置格式

玩家属性显示配置

player-info:
  enabled: true
  # 是否显示玩家属性修饰符效果
  attribute-modifiers: true
  # 是否将属性信息居中显示
  center-attributes: true
  # 是否只显示被装备或效果修改过的属性
  only-modified-attributes: true
  # 屏蔽的属性修饰符列表
  blocked-modifiers: []

支持的属性类型：

• generic.attack_damage - 攻击伤害
• generic.attack_speed - 攻击速度
• generic.armor - 护甲
• generic.armor_toughness - 护甲韧性
• generic.knockback_resistance - 击退抗性
• generic.max_health - 最大生命值
• generic.movement_speed - 移动速度
• generic.luck - 幸运
• player.entity_interaction_range - 实体交互距离
• generic.flying_speed - 飞行速度

幕府日历配置

mufu-calendar:
  enabled: true
  # 是否启用自动时间流逝
  auto-time: true
  # 起始年份（默认应仁之乱）
  base-year: 1467
  # 固定时间配置（auto-time为false时使用）
  current-year: 1467
  current-month: 1
  current-day: 1
  current-weekday: 1

时间流逝规则（auto-time 为 true 时）：

• 24小时现实时间 = 1年
• 2小时现实时间 = 1月
• 4分钟现实时间 = 1日

🔧 构建

前置要求

• JDK 21 或更高版本
• Gradle（项目包含 Gradle Wrapper）

构建步骤

# Windows
gradlew.bat shadowJar

# Linux/Mac
./gradlew shadowJar

构建完成后，JAR 文件将位于 build/libs/ 目录下。

🤝 贡献

欢迎贡献！请随时提交 Pull Request 或创建 Issue。

贡献指南

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📝 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 感谢 Paper 团队提供优秀的服务端 API
• 感谢所有为本项目做出贡献的开发者

📮 联系方式

如有问题或建议，欢迎：

• 提交 Issue
• 发起 Discussion

---

⬆ 回到顶部

Made with ❤️ by NodeMC Team