BasicStats
📊 简单。轻量。可配置。
BasicStats 是一款现代化的独立 Minecraft 统计插件,适用于运行 Paper、Spigot、Purpur 或 Bukkit 的 Java 服务器。追踪有意义的玩家活动、游戏时长、击杀数、死亡数、方块破坏与放置、合成及生存进度;构建基于矿石的等级进阶系统;比较玩家数据;在游戏中显示统计数据;并通过可选的本地仪表板管理你的服务器。当前 2.9.0 版本新增了安全的备份中心,包含已验证的备份列表、明确的恢复确认机制以及每次恢复前的自动安全副本,同时保留了以同意优先的公开玩家档案、可靠的指标面板和已知玩家覆盖范围。
如果你正在寻找一款 Minecraft 玩家统计插件、生存统计数据工具、游戏时长追踪器、死亡计数器、Minecraft 排行榜插件、矿石等级系统、类似 CraftAttack 的 Tab 列表显示、PlaceholderAPI 统计支持、Minecraft 服务器仪表板、Discord Webhook 警报、对 Aternos 友好的统计插件或 Velocity/Bungee 网络统计功能,BasicStats 将这些工具整合为一个可配置的插件。
🇩🇪 Deutsche Kurzbeschreibung
BasicStats ist ein übersichtliches Statistik- und Rangplugin für Minecraft Java Server mit Paper, Spigot, Purpur oder Bukkit. Es bietet Spielzeit, Kills, Tode, Blöcke, Crafting, Leaderboards, ein Erz-Rangsystem, einen CraftAttack-ähnlichen Todeszähler in der Tablist, Streaks, Achievements, Dashboard, Explorer, Discord-Webhooks und optionale PlaceholderAPI-Unterstützung. Die wichtigsten Funktionen bleiben einzeln konfigurierbar und sind standardmäßig serverfreundlich eingerichtet.
🎥 Preview the BasicStats Dashboard
🌟 Support the Project
Enjoying BasicStats? A follow on Modrinth helps the project gain visibility and makes it easier for other server owners to discover.
⭐ Follow BasicStats on Modrinth
Need help, want to report a bug or suggest a feature?
💬 Join the BasicStats Community Discord
✨ Features
BasicStats is designed for survival servers, SMPs, community servers, events and networks that want useful Minecraft statistics without forcing players to learn a large command system first.
📊 Player Statistics
- Lifetime, daily and weekly statistics
- Player kills, mob kills and deaths
- Persistent death log with causes, timestamps, coordinates and rank-point loss
- Jumps, playtime, sessions and walking distance
- Blocks broken and placed
- Items crafted
- Damage dealt and damage taken
- Optional historical import of exact vanilla-backed values from before BasicStats was installed
- First join date, online status and server uptime
- Configurable number, time and date formats
- Player profiles and player comparison
🏆 Ore-Based Rank System
- 27 rank stages based on Minecraft materials
- Stone, Coal, Copper, Iron, Gold, Redstone, Lapis, Quartz, Emerald, Diamond, Ancient Debris and Netherite
- Material sublevels such as cobblestone, stone, blocks, raw ores, scraps and ingots where available
- Configurable rank factors, weights and score targets
- The
balanced-v2 model combines playtime, blocks, crafting, kills, distance, damage, jumps, goals, achievements and best streak
- A capped diversity bonus rewards progress across multiple activities
- Configurable milestone gates prevent one farmed statistic from carrying every major rank section
- Detailed factor contributions and progress to the next rank
- Rank-ups and rank-downs through normal progression
- Deaths remove 50 rank points by default, with configurable penalties and cooldowns
- Rank announcements and personal notification settings
- Rank shown in menus, profiles, displays, tablist, leaderboards and dashboard
- Detailed breakdown of base score, factor coverage, diversity bonus and gate limits
🎮 In-Game Interface
- Paginated inventory GUI for statistics, ranks, goals, achievements, death logs and leaderboards
- Player profiles with rank progress and achievement progress
- Player comparison with statistics and ranks
- Rank overview with all available stages and factor details
- Configurable lifetime, daily and weekly leaderboards
- Personal display settings through
/basicstats settings
- Clickable commands and links in help, setup, settings, dashboard and reward messages
- Interactive setup wizard through
/basicstats setup
- Setup presets for Simple, Community and Full local feature set, with every choice still adjustable before saving
- New servers receive a clear setup reminder until the wizard is completed
- Health center through
/basicstats health with safe checks, actionable fixes and an optional admin repair pass
- Admin-only
/basicstats import vanilla with preview, confirmation, safety backup and duplicate protection
📺 CraftAttack-Style Death Counter
Display every player's death count directly in the Minecraft player list/tablist.
- Familiar survival-event style, similar to what many players know from CraftAttack
- Updates automatically when players die
- Optional rank display next to player names
- Customizable tablist header, footer and player-name format
- Can be enabled or disabled in
config.yml
tab:
death-count-enabled: true
show-rank: true
🎭 Nickname and display-name integration
BasicStats uses the Bukkit display name for visible output by default. This lets nickname plugins such as NameMask or EssentialsX integrate without creating a second identity system.
- Nicknames are reflected in menus, tablist, displays, leaderboards, event feeds and dashboard views
- UUIDs, stored statistics and command targets remain tied to the real Minecraft account
- Nickname changes refresh visible BasicStats views automatically
- Protected dashboard profiles can optionally show the real username to administrators
names:
use-display-name: true
show-real-name-in-dashboard: true
🖥️ 显示
- 侧边计分板
- 动作栏 (Actionbar)
- Boss 栏 (Bossbar)
- Tab 列表页眉和页脚
- Tab 列表中可选的死亡计数和排名
- 可配置的默认、紧凑和以排名为主的布局
- 每位玩家的个性化显示选择
- 完全本地化的消息和显示文本
🔥 连续登录与奖励
- 每日登录连续记录
- 每日游戏时长连续记录
- 每日活动连续记录
- 可配置计入“一天”所需的最小游戏时长
- 当前连续记录、最佳连续记录和进度追踪
- 在选定的连续里程碑处可配置的控制台命令奖励
- 个人通知控制,用于连续记录和纪录
👥 团队与氏族统计
BasicStats 不会创建竞争性的团队系统。它可以改用现有的团队数据:
- 原版计分板团队
- 来自其他 Bukkit 插件的已注册团队/氏族提供者
- 共享的团队或氏族积分、击杀、死亡、游戏时长和排名进度
- 团队占位符和仪表板信息
- 保持另一个插件作为成员资格的唯一真实来源
🌐 Velocity 和 Bungee 网络模式
- 多个后端服务器的可选共享网络统计
- 兼容 Velocity 和 Bungee 风格网络
- 共享 MySQL/MariaDB 存储
- 每个后端服务器拥有唯一的服务器 ID
- 按 UUID 聚合玩家数据
- 当共享数据库不可用时,回退到本地 YAML 存储
🏅 成就与里程碑
- 可配置的游戏时长、击杀、方块、排名和连续记录的成就
- 自定义目标、标签、描述和图标
- 游戏内和仪表板中的进度追踪
- 可选的奖励消息和控制台命令
- 成就占位符
- 奖励安全存储,不会重复发放
🗓️ 可选赛季
赛季为服务器提供清晰的时间有限进展目标,同时不改变终身统计数据或正常的矿石基础排名系统。
- 从保存的起始基线计算的独立赛季进度
- 可配置的
season-points 公式,支持正权重或负权重
- 积分、游戏时长、击杀、死亡、方块、制作、距离、伤害和跳跃的赛季视图
- 自动过期和管理员安全重置支持
- 上一个已完成赛季的归档结果
- 前三名可配置的控制台命令奖励
%player%、%uuid%、%season%、%place% 和 %season_points% 奖励占位符
/basicstats season status、top、history、start、end confirm 和 reset confirm
- 受保护的仪表板快照中的赛季状态和玩家进度
赛季默认禁用。当服务器准备开始第一个赛季时,请在 config.yml 中启用它们。
🌐 本地或托管 Web 仪表板
BasicStats 包含一个可选的管理员仪表板。它默认禁用,启用时绑定到 127.0.0.1,因此本地访问默认保持私密。托管服务器可以在其提供商分配额外 Web 端口时暴露该仪表板。
仪表板包括:
- 📊 实时服务器概览
- 👥 在线及被跟踪的玩家
- 👤 可点击的玩家详情页面
- 🏆 带有材料、因素和进度的可视化排名系统阶梯
- 📈 在线玩家、游戏时长、死亡和排名积分的趋势图表
- ⏱️ 24小时、7天和30天的历史视图
- 🥇 按排名、游戏时长、击杀、死亡和时期筛选的排行榜
- 🎯 目标和进度
- 🏅 成就和里程碑进度
- 💀 死亡日志
- 📰 实时服务器事件流
- 📦 峰值玩家、活跃会话和备份信息
- 💾 本地存储和数据库状态
- 📤 JSON 和 CSV 报告导出
- ❓ 内置帮助页面,含社区 Discord 链接
- ⚙️ 分组管理员设置
管理员可以单独启用或禁用仪表板的各个部分。这些开关仅影响仪表板,不会移除 Minecraft 统计数据或游戏内命令。
仪表板分为专注的页面,而不是一个过载的屏幕:
- 仪表板: 实时服务器状态、玩家数量、总玩家数、平均游戏时长、运行时间、今日峰值玩家、活跃会话、最新/下次备份和存储健康状况
- 玩家: 可搜索的玩家列表和带有统计、排名进度、目标、成就、死亡历史和比较的可点击详情页面
- 排行榜: 排名、游戏时长、击杀或死亡,带有终身、每日或每周过滤器
- 排名: 每个矿石/材料阶段作为可视化阶梯,加权因素和到达下一阶段的进度
- 目标、成就和死亡日志: 进度、解锁状态和最近的死亡(包括排名积分损失)
- 事件流: 加入、死亡、排名变化、目标、成就、纪录和连续记录事件
- 帮助与设置: 设置指南、Discord 支持链接、分组控制和受保护的 Discord Webhook 设置
趋势历史存储在本地的 dashboard-history.yml 中,并可采样 24 小时、7 天或 30 天。JSON 和 CSV 导出受临时管理员会话保护。保存设置会保持该会话处于活动状态,直到仪表板在安全插件重载后重新连接。
要创建临时管理员链接,请使用:
/basicstats dashboard
链接和令牌是临时的,需要相应管理员权限。仪表板也可以完全禁用:
dashboard:
enabled: false
当禁用时,BasicStats 不会打开仪表板端口。
🌍 托管服务器设置
插件无法创建您的主机商未提供的端口。如果您的主机提供额外的 TCP/Web 端口,请直接使用正常服务器地址和分配的端口:
dashboard:
enabled: true
bind-address: 0.0.0.0
port: 8765 # 替换为您主机商分配的端口
public-url: ""
例如,运行 /basicstats dashboard setup hosted BasicStats.enderman.cloud 33416。BasicStats 会自动创建 HTTP 浏览器链接,因此无需输入 http:// 或 https://。仅当反向代理提供 HTTPS 时才使用 HTTPS。如果共享主机不允许额外的 Web 端口或反向代理,则无法从该主机外部访问嵌入式仪表板,必须保持禁用状态。
⚙️ 仪表板管理员设置
受保护的“设置”区域将服务器控制选项分为常规、显示、功能、Discord、等级、排行榜和备份。
- 保存设置时不会丢失管理员会话
- 安全插件重载后自动重新连接浏览器
- 对受保护设置的服务器端验证
- 仪表板访问和功能开关
- 显示和排行榜默认值
- 备份和历史记录控制
- Discord Webhook 路由和事件过滤器
- 托管仪表板 URL 和远程访问指南
🧭 公共资源管理器推送
BasicStats 2.9.0 包含了面向推荐主机的 BasicStats Explorer 集成方案。Explorer Push 默认处于禁用状态,并通过出站 HTTPS 请求发送一个小型公共快照。配置的最小间隔为 15 分钟,但 Cloudflare Free 配额保护会将定期上传间隔拉长至约 55 分钟或更久。它永远不会打开 Minecraft HTTP 端口,不需要反向代理,也不需要服务器端的 TLS 证书。
这使得它适用于允许出站 HTTPS 请求的共享主机环境,如 FreeMCServer、Artisan 风格的主机平台以及其他类似的共享环境。Aternos 在此模式下不需要额外端口,但 BasicStats 仍需作为可安装的插件存在。
explorer-push:
enabled: false
endpoint: "https://basicstats-explorer.pages.dev/api/publish/v1/summary"
public-address: "play.example.net:25565"
interval-seconds: 900
expose-player-names: true
expose-player-profiles: true
expose-player-heads: true
player-limit: 20
expose-recent-events: true
leaderboard-limit: 20
event-limit: 20
world-description: "A public Minecraft world."
只需一次配对即可:
- 启用
explorer-push.enabled 并设置 public-address。
- 重启或重载 BasicStats。
- 以拥有
basicstats.explorer 权限的 OP 身份运行 /basicstats explorer claim。
- 打开一次性链接并确认地址。
- 检查
/basicstats explorer status 以查看配对和上传诊断信息。
如需故障排除,请使用 /basicstats explorer diagnose。安全的自检功能会检查本地配置、配对状态、快照大小、每日配额以及上次上传结果。当启用 Explorer Push 时,它还会探测 HTTPS 端点而无需认证。它绝不会发布快照,不会消耗上传配额,也不会显示任何密钥。
玩家名称默认是匿名的。当隐私同意设置激活时,每位玩家都会收到一个可点击的一次性询问。使用 /basicstats explorer privacy 查看决定,使用 /basicstats explorer privacy yes|no 更改决定,使用 /basicstats explorer privacy reset 再次被询问。未回答的提示将自动变为匿名。拥有 basicstats.explorer 权限的管理员可以使用 /basicstats explorer privacy <player> 检查或重置其他玩家的隐私设置,或使用 /basicstats explorer privacy reset <player> 重置。仅在同时具备明确同意和 expose-player-names: true 的情况下才会使用公开名称;否则,Explorer 将使用 Player 1、Player 2 等标识。
同意的默认设置优先考虑隐私,服务器管理员可以进行调整:
privacy:
explorer-name-consent:
enabled: true
ask-on-first-join: true
default: false
timeout-seconds: 60
Explorer 仅在 Cloudflare D1 中存储每个服务器的最新快照。它绝不会接收 UUID、IP 地址、坐标、聊天内容、仪表板令牌、管理员令牌、密钥或私人玩家数据。启用后,它可以显示有界限的匿名或已同意玩家的个人资料,包括等级进度、死亡数、击杀数、游戏时长、行走方块数、方块数、合成、伤害、图腾使用、成就、目标和连胜记录。名称和可选的 mc-heads.net 头像需要明确的同意以及匹配的管理员开关;expose-player-profiles: false 会移除个人资料网格,但聚合数据仍然可用。高级 K/D、死亡数、游戏时长和方块数排行榜为可选开启,且 K/D 仅使用玩家的击杀数和死亡数。如果未能成功上传,快照将在三小时后过期;免费设置每个服务器每天最多接受 26 次上传(UTC 时间)。在启用公共个人资料之前,请阅读 隐私说明。
旧的 public-web-api 仍作为可选的传统/自托管功能保留,但它不再是标准的 Explorer 路径:
public-web-api:
enabled: false
bind-host: "127.0.0.1"
port: 8081
public-address: ""
allowed-origins:
- "https://basicstats-explorer.pages.dev"
expose-player-names: true
expose-recent-events: true
leaderboard-limit: 20
event-limit: 20
cache-seconds: 30
world-description: "A public Minecraft world."
传统端点为 /basicstats/public/v1/summary。对于自托管,管理员必须通过反向代理或 Cloudflare Tunnel 将本地 API 路由到 HTTPS/443。BasicStats 本身不提供 TLS 终止:
https://play.example.net/basicstats/public/v1/summary
仅暴露聚合总数、可配置的等级排行榜以及选定的无坐标事件。UUID、IP 地址、坐标、物品栏、聊天内容、内部诊断信息和密钥永远不会返回。使用 curl -i https://<host>/basicstats/public/v1/summary 验证传统路由;当不需要时,使用 public-web-api.enabled: false 将其禁用。
🔔 Discord 通知
BasicStats 可以通过标准 Discord Webhook 将选定的服务器事件发送到 Discord。通知默认处于禁用状态,并以异步方式交付。
仪表盘支持传统的 Default Webhook,以及针对以下目标的独立 Webhook:
- 👥 玩家
- 🏆 等级
- 🎯 目标与成就
- 🔥 连击与纪录
每个目标都有各自的启用状态、Webhook URL 和事件过滤器。支持的事件包括:
- 👋 玩家加入
- 💀 玩家死亡
- ⬆️ 等级提升
- ⬇️ 等级降低
- 🎯 完成的目标
- 🆕 新检测到的目标
- ✨ 成就解锁
- 🥇 新纪录
- 🔥 长连击
Webhook URL 在受保护的仪表盘设置 → Discord 区域中输入。保存的 URL 绝不会在设置响应中返回,也不会写入控制台日志。仅接受官方的 Discord Webhook 主机,禁用提及功能,并在有界延迟后重试临时速率限制。
🧭 命令
/basicstats – 显示交互式帮助菜单
/basicstats menu – 打开物品栏 GUI
/basicstats stats [player] – 查看统计数据
/basicstats compare <player> – 比较统计数据和等级
/basicstats profile [player] – 查看玩家资料
/basicstats rank [player] – 查看等级进度
/basicstats rank list – 查看所有等级阶段
/basicstats rank details – 查看等级因素贡献
/basicstats streak [player] – 查看当前和历史最佳连击
/basicstats team [player] – 查看团队或公会统计数据
/basicstats network – 显示网络同步状态
/basicstats season status – 显示当前赛季及剩余时间
/basicstats season top [stat] – 查看赛季排行榜
/basicstats season history – 查看上一个归档赛季的结果
/basicstats season start <name> <days> – 开始一个赛季(操作员)
/basicstats season end confirm – 结束当前赛季并发放奖励(操作员)
/basicstats season reset confirm – 重置赛季进度而不更改终身数据(操作员)
/basicstats deathlog – 查看最近的死亡记录
/basicstats goals – 查看个人目标
/basicstats achievements [player] – 查看成就进度
/basicstats topstats [stat] [lifetime|daily|weekly] – 查看可配置的排行榜
/basicstats top [stat] [lifetime|daily|weekly] – topstats 的简短别名
/basicstats daily – 查看今日统计数据
/basicstats weekly – 查看本周统计数据
/basicstats settings – 查看个人显示设置
/basicstats settings toggle – 切换你的显示模式
/basicstats settings display <sidebar|actionbar|bossbar|none> – 选择显示模式
/basicstats settings layout <layout> – 选择已配置的布局
/basicstats settings notifications [type] [on|off|toggle] – 管理个人通知
/basicstats display <sidebar|actionbar|bossbar|none> – 选择显示模式
/basicstats playtime [player] – 查看游戏时长
/basicstats firstjoin [player] – 查看首次加入日期
/basicstats online – 列出在线玩家
/basicstats uptime – 查看服务器运行时间
/basicstats session – 查看你当前的会话
/basicstats setup – 通过设置向导配置服务器默认值(操作员)
/basicstats info – 显示插件、服务器、Java 和存储信息
/basicstats debug – 显示安全的支持诊断信息
/basicstats health – 运行健康中心并提供修复指导
/basicstats health fix – 重新应用缺失的默认值和配置验证,而不更改玩家数据(操作员)
/basicstats dashboard – 创建临时的仪表盘链接
/basicstats dashboard setup <local|hosted> [address] [port] – 配置仪表盘访问权限
/basicstats dashboard token – 直接显示临时的仪表盘令牌
/basicstats explorer claim – 打开一次性的公共 Explorer 配对链接(操作员)
/basicstats explorer status – 显示安全的 Explorer 推送状态和上传时间
/basicstats explorer diagnose – 运行安全的 Explorer 自检,不发布快照
/basicstats explorer privacy [yes|no|reset] – 管理你的 Explorer 名称同意设置
/basicstats explorer privacy <player> – 检查玩家的同意设置(管理员)
/basicstats explorer privacy reset <player> – 重置玩家的同意设置(管理员)
/basicstats import vanilla [player] [confirm] – 预览或导入历史原版统计数据(操作员)
/basicstats reset <player> <stat|daily|weekly|all> confirm – 重置数据
/basicstats backup – 创建手动备份
/basicstats backup list – 列出经过验证的本地备份
/basicstats backup restore <file> confirm – 在创建安全副本后恢复备份(操作员)
/basicstats reload – 重新加载配置和消息
根命令也接受别名 /bs 和 /bstats。旧版命令如 /stats, /uptime, /session, /deathlog, /sidebar, /playtime, /firstjoin, /online, /topstats, /daily, /weekly, /goals 和 /achievements 仍然可用。
🔗 PlaceholderAPI
PlaceholderAPI 完全是可选的。当安装 PlaceholderAPI 时,扩展会自动注册。
核心与身份占位符:
%basicstats_deaths% · %basicstats_player_kills% · %basicstats_mob_kills% · %basicstats_jumps%
%basicstats_walked_km% · %basicstats_playtime_hours% · %basicstats_blocks_broken% · %basicstats_blocks_placed%
%basicstats_items_crafted% · %basicstats_damage_dealt% · %basicstats_damage_taken%
%basicstats_display_name% · %basicstats_username% · %basicstats_real_name%
%basicstats_session% · %basicstats_uptime% · %basicstats_online% · %basicstats_playtime_rank% · %basicstats_display_mode%
等级占位符:
%basicstats_rank% · %basicstats_rank_next% · %basicstats_rank_max% · %basicstats_rank_score%
%basicstats_rank_progress% · %basicstats_rank_points_to_next% · %basicstats_rank_activity_score% · %basicstats_rank_death_penalty%
进度占位符:
%basicstats_goals_completed% · %basicstats_goals_total% · %basicstats_achievements_completed% · %basicstats_achievements_total%
%basicstats_streak% · %basicstats_best_streak% · %basicstats_streak_progress%
赛季占位符:
%basicstats_season_active% · %basicstats_season_name% · %basicstats_season_points% · %basicstats_season_days_remaining%
团队占位符:
%basicstats_team% · %basicstats_team_members% · %basicstats_team_playtime_hours% · %basicstats_team_player_kills%
%basicstats_team_deaths% · %basicstats_team_rank_points%
每个核心统计数据都有每日和每周变体,例如 %basicstats_daily_blocks_placed%、%basicstats_weekly_items_crafted%、%basicstats_daily_damage_taken% 和 %basicstats_weekly_playtime_hours%。
⚙️ 配置与存储
生成的 config.yml 支持:
- 🇬🇧 英文和 🇩🇪 德文本地化
- 首次运行设置状态及引导式设置的默认值
- 简单、社区和完整本地安装的设置预设
- 通过
/basicstats health 进行健康中心检查及安全配置修复
- 显示布局与更新间隔
- 侧边栏、动作栏、Boss 栏和标签页(tablist)设置
- 昵称/显示名称的使用及受保护的真实用户名可见性
- 个人显示与通知偏好
- 排名因素、目标与死亡惩罚
- 目标、成就与奖励
- 可选的赛季、赛季积分权重、排行榜及赛季末奖励
- 排行榜统计数据与大小
- 数字、时间和日期格式
- 自动轮换备份与手动备份
- 经认证的备份列表以及带自动预恢复安全副本的安全还原
- 仪表板访问、历史记录与功能控制
- Discord Webhook 路由与事件过滤器
- 连胜规则与最低每日游戏时间
- 团队提供程序选择
- Velocity/Bungee 网络设置
- Explorer Push 端点、配对状态与隐私同意
- 可选的传统公共 API 设置
添加新选项时,现有的配置值和自定义翻译将被保留。在独立模式下,数据存储在本地 YAML 文件中。存档使用临时文件和替换步骤,损坏的数据可以从有效的备份中恢复。
在新服务器上,操作员会收到一个可点击的设置提醒,直到完成 /basicstats setup。向导涵盖语言、默认显示、核心功能和可选集成,并且可以在不删除玩家数据的情况下稍后重新打开。设置 dashboard.enabled: false 或 explorer-push.enabled: false 以禁用这些面向网络的功能。
🔐 权限
重要的权限节点包括:
basicstats.use · basicstats.menu · basicstats.stats · basicstats.stats.others
basicstats.compare · basicstats.profile · basicstats.rank · basicstats.streak
basicstats.team · basicstats.network · basicstats.achievements · basicstats.info
basicstats.debug · basicstats.health · basicstats.deathlog · basicstats.display · basicstats.settings
basicstats.setup · basicstats.topstats · basicstats.goals · basicstats.reset
basicstats.backup · basicstats.backup.restore · basicstats.import · basicstats.reload · basicstats.explorer
basicstats.dashboard.manage · basicstats.season · basicstats.season.admin
查看个人统计数据和显示设置默认对所有玩家开放。设置、导入、重置、备份、备份还原、重载和仪表板管理由操作员保护。还原仅接受经过验证的 BasicStats 备份文件名,并且需要显式的 confirm 参数;在替换之前会创建一个新的安全备份。
历史数据导入
Minecraft 在其自身的按玩家统计文件中保留了大量的终身统计数据。BasicStats 已经读取了原版中的死亡、击杀、跳跃、行走距离和游戏时间等数值。对于可以精确恢复的插件拥有计数器,操作员可以运行 /basicstats import vanilla 来预览可用的历史记录,然后确认它。导入器不会合并到现有的非零 BasicStats 计数器中,因此不会静默地重复计算数据。详细的死亡日志、方块放置和历史时间戳无法从原版统计 API 中获得,因此不会被虚构。
✅ 兼容性
- Minecraft Java Edition 1.17.1 及更高版本
- Spigot、Paper、Purpur 和 Bukkit 兼容服务器
- Java 17 或更高版本
- Bukkit API 基线 1.17
- 无需 NMS 或特定于版本的内部实现
- PlaceholderAPI 为可选
- 一个 JAR 文件适用于所有支持的服务器版本
始终测试您的网络所使用的确切服务器版本。
📥 安装
- 下载最新的
.jar 文件。
- 将其放入服务器的
plugins 文件夹中。
- 启动或重启服务器。
- 运行
/basicstats setup 并保存引导式设置。
- 在游戏中使用
/basicstats menu。
Minecraft 记分牌侧边栏右侧显示的小数字是由 Minecraft 本身生成的,用于行排序。
📄 许可证
BasicStats 根据 MIT 许可证授权。
BasicStats
📊 Simple. Lightweight. Configurable.
BasicStats is a modern, standalone Minecraft statistics plugin and Minecraft server plugin for Java servers running Paper, Spigot, Purpur or Bukkit. Track meaningful player activity, playtime, kills, deaths, blocks, crafting and survival progress; build an ore-based rank progression; compare players; display stats in-game; and manage your server through an optional local dashboard. The current 2.9.0 release adds a safe Backup Center with verified backup listings, explicit restore confirmation and an automatic safety copy before every restore while retaining consent-first public player profiles, reliable metric boards and known-player coverage.
If you are looking for a Minecraft player stats plugin, survival statistics, a playtime tracker, death counter, Minecraft leaderboard plugin, ore rank system, CraftAttack-style tablist, PlaceholderAPI statistics, a Minecraft server dashboard, Discord webhook alerts, an Aternos-friendly stats plugin or Velocity/Bungee network statistics, BasicStats combines these tools in one configurable plugin.
🇩🇪 Deutsche Kurzbeschreibung
BasicStats ist ein übersichtliches Statistik- und Rangplugin für Minecraft Java Server mit Paper, Spigot, Purpur oder Bukkit. Es bietet Spielzeit, Kills, Tode, Blöcke, Crafting, Leaderboards, ein Erz-Rangsystem, einen CraftAttack-ähnlichen Todeszähler in der Tablist, Streaks, Achievements, Dashboard, Explorer, Discord-Webhooks und optionale PlaceholderAPI-Unterstützung. Die wichtigsten Funktionen bleiben einzeln konfigurierbar und sind standardmäßig serverfreundlich eingerichtet.
🎥 Preview the BasicStats Dashboard
🌟 Support the Project
Enjoying BasicStats? A follow on Modrinth helps the project gain visibility and makes it easier for other server owners to discover.
⭐ Follow BasicStats on Modrinth
Need help, want to report a bug or suggest a feature?
💬 Join the BasicStats Community Discord
✨ Features
BasicStats is designed for survival servers, SMPs, community servers, events and networks that want useful Minecraft statistics without forcing players to learn a large command system first.
📊 Player Statistics
- Lifetime, daily and weekly statistics
- Player kills, mob kills and deaths
- Persistent death log with causes, timestamps, coordinates and rank-point loss
- Jumps, playtime, sessions and walking distance
- Blocks broken and placed
- Items crafted
- Damage dealt and damage taken
- Optional historical import of exact vanilla-backed values from before BasicStats was installed
- First join date, online status and server uptime
- Configurable number, time and date formats
- Player profiles and player comparison
🏆 Ore-Based Rank System
- 27 rank stages based on Minecraft materials
- Stone, Coal, Copper, Iron, Gold, Redstone, Lapis, Quartz, Emerald, Diamond, Ancient Debris and Netherite
- Material sublevels such as cobblestone, stone, blocks, raw ores, scraps and ingots where available
- Configurable rank factors, weights and score targets
- The
balanced-v2 model combines playtime, blocks, crafting, kills, distance, damage, jumps, goals, achievements and best streak
- A capped diversity bonus rewards progress across multiple activities
- Configurable milestone gates prevent one farmed statistic from carrying every major rank section
- Detailed factor contributions and progress to the next rank
- Rank-ups and rank-downs through normal progression
- Deaths remove 50 rank points by default, with configurable penalties and cooldowns
- Rank announcements and personal notification settings
- Rank shown in menus, profiles, displays, tablist, leaderboards and dashboard
- Detailed breakdown of base score, factor coverage, diversity bonus and gate limits
🎮 In-Game Interface
- Paginated inventory GUI for statistics, ranks, goals, achievements, death logs and leaderboards
- Player profiles with rank progress and achievement progress
- Player comparison with statistics and ranks
- Rank overview with all available stages and factor details
- Configurable lifetime, daily and weekly leaderboards
- Personal display settings through
/basicstats settings
- Clickable commands and links in help, setup, settings, dashboard and reward messages
- Interactive setup wizard through
/basicstats setup
- Setup presets for Simple, Community and Full local feature set, with every choice still adjustable before saving
- New servers receive a clear setup reminder until the wizard is completed
- Health center through
/basicstats health with safe checks, actionable fixes and an optional admin repair pass
- Admin-only
/basicstats import vanilla with preview, confirmation, safety backup and duplicate protection
📺 CraftAttack-Style Death Counter
Display every player's death count directly in the Minecraft player list/tablist.
- Familiar survival-event style, similar to what many players know from CraftAttack
- Updates automatically when players die
- Optional rank display next to player names
- Customizable tablist header, footer and player-name format
- Can be enabled or disabled in
config.yml
tab:
death-count-enabled: true
show-rank: true
🎭 Nickname and display-name integration
BasicStats uses the Bukkit display name for visible output by default. This lets nickname plugins such as NameMask or EssentialsX integrate without creating a second identity system.
- Nicknames are reflected in menus, tablist, displays, leaderboards, event feeds and dashboard views
- UUIDs, stored statistics and command targets remain tied to the real Minecraft account
- Nickname changes refresh visible BasicStats views automatically
- Protected dashboard profiles can optionally show the real username to administrators
names:
use-display-name: true
show-real-name-in-dashboard: true
🖥️ Displays
- Sidebar scoreboard
- Actionbar
- Bossbar
- Tablist header and footer
- Optional death counter and rank in the tablist
- Configurable default, compact and rank-focused layouts
- Personal display choices for every player
- Fully localizable messages and display text
🔥 Streaks and Rewards
- Daily login streaks
- Daily playtime streaks
- Daily activity streaks
- Configurable minimum playtime required to count a day
- Current streak, best streak and progress tracking
- Configurable console-command rewards at selected streak milestones
- Personal notification controls for streaks and records
👥 Team and Clan Statistics
BasicStats does not create a competing team system. It can use existing team data instead:
- Vanilla scoreboard teams
- A registered team/clan provider from another Bukkit plugin
- Shared team or clan points, kills, deaths, playtime and rank progress
- Team placeholders and dashboard information
- Keeps another plugin as the source of truth for memberships
🌐 Velocity and Bungee Network Mode
- Optional shared network statistics for multiple backend servers
- Compatible with Velocity and Bungee-style networks
- Shared MySQL/MariaDB storage
- Unique server IDs for every backend
- Player data aggregated by UUID
- Local YAML fallback when the shared database is unavailable
🏅 Achievements and Milestones
- Configurable achievements for playtime, kills, blocks, ranks and streaks
- Custom targets, labels, descriptions and icons
- Progress tracking in-game and in the dashboard
- Optional reward messages and console commands
- Achievement placeholders
- Rewards are stored safely and are not granted twice
🗓️ Optional Seasons
Seasons give a server a clear, time-limited progression goal without changing lifetime statistics or the normal ore-based rank system.
- Separate seasonal progress calculated from a saved start baseline
- Configurable
season-points formula with positive or negative weights
- Seasonal views for points, playtime, kills, deaths, blocks, crafting, distance, damage and jumps
- Automatic expiry and safe reset support for administrators
- Archived results from the last completed season
- Configurable console-command rewards for the top three places
%player%, %uuid%, %season%, %place% and %season_points% reward placeholders
/basicstats season status, top, history, start, end confirm and reset confirm
- Seasonal status and player progress in the protected Dashboard snapshot
Seasons are disabled by default. Enable them in config.yml when the server is ready to start its first season.
🌐 Local or Hosted Web Dashboard
BasicStats includes an optional dashboard for server administrators. It is disabled by default and binds to 127.0.0.1 when enabled, so local access stays private by default. Hosted servers can expose it when their provider assigns an additional web port.
The dashboard includes:
- 📊 Live server overview
- 👥 Online and tracked players
- 👤 Clickable player detail pages
- 🏆 Visual rank-system ladder with materials, factors and progress
- 📈 Trend charts for online players, playtime, deaths and rank points
- ⏱️ 24-hour, 7-day and 30-day history views
- 🥇 Leaderboards filtered by rank, playtime, kills, deaths and period
- 🎯 Goals and progress
- 🏅 Achievements and milestone progress
- 💀 Deathlog
- 📰 Live server event feed
- 📦 Peak players, active sessions and backup information
- 💾 Local storage and database status
- 📤 JSON and CSV report exports
- ❓ Built-in help page with community Discord link
- ⚙️ Grouped administrator settings
Dashboard sections can be enabled or disabled individually by an administrator. These switches affect the dashboard only and do not remove Minecraft statistics or in-game commands.
The dashboard is split into focused pages instead of one overloaded screen:
- Dashboard: live server status, player count, total players, average playtime, uptime, peak players today, active sessions, latest/next backup and storage health
- Players: searchable player list and clickable detail pages with statistics, rank progress, goals, achievements, death history and comparison
- Leaderboards: Rank, Playtime, Kills or Deaths with Lifetime, Daily or Weekly filters
- Ranks: every ore/material stage as a visual ladder, weighted factors and progress to the next stage
- Goals, Achievements and Deathlog: progress, unlock state and recent deaths including rank-point loss
- Event Feed: joins, deaths, rank changes, goals, achievements, records and streak events
- Help and Settings: setup guidance, Discord support link, grouped controls and protected Discord webhook settings
Trend history is stored locally in dashboard-history.yml and can be sampled for 24 hours, 7 days or 30 days. JSON and CSV exports are protected by the temporary administrator session. Saving settings keeps that session active while the dashboard reconnects after a safe plugin reload.
To create a temporary administrator link, use:
/basicstats dashboard
The link and token are temporary and require the appropriate administrator permission. The dashboard can also be disabled completely:
dashboard:
enabled: false
When disabled, BasicStats does not open a dashboard port.
🌍 Hosted-server setup
The plugin cannot create a port that your hoster does not provide. If your host offers an additional TCP/web port, use the normal server address and assigned port directly:
dashboard:
enabled: true
bind-address: 0.0.0.0
port: 8765 # replace with the port assigned by your hoster
public-url: ""
For example, run /basicstats dashboard setup hosted BasicStats.enderman.cloud 33416. BasicStats creates the HTTP browser link automatically, so you do not need to type http:// or https://. Use HTTPS only when a reverse proxy provides it. If a shared host does not allow extra web ports or reverse proxies, the embedded dashboard cannot be reached from outside that host and must remain disabled.
⚙️ Dashboard Admin Settings
The protected Settings area groups server controls into General, Display, Features, Discord, Ranks, Leaderboards and Backups.
- Save settings without losing the administrator session
- Automatic browser reconnect after a safe plugin reload
- Server-side validation for protected settings
- Dashboard access and feature switches
- Display and leaderboard defaults
- Backup and history controls
- Discord webhook routing and event filters
- Hosted dashboard URL and remote-access guidance
🧭 Public Explorer Push
BasicStats 2.9.0 includes the recommended hoster-friendly integration for the BasicStats Explorer. Explorer Push is disabled by default and sends one small public snapshot through an outgoing HTTPS request. The configured minimum is 15 minutes, but Cloudflare Free quota protection spaces regular uploads to about 55 minutes or more. It never opens a Minecraft HTTP port, needs no reverse proxy and requires no TLS certificate on the server.
That makes it suitable for shared hosts such as FreeMCServer, Artisan-style hoster platforms and similar shared environments when outgoing HTTPS requests are allowed. Aternos does not need an extra port for this mode, but BasicStats still has to be available as an installable plugin.
explorer-push:
enabled: false
endpoint: "https://basicstats-explorer.pages.dev/api/publish/v1/summary"
public-address: "play.example.net:25565"
interval-seconds: 900
expose-player-names: true
expose-player-profiles: true
expose-player-heads: true
player-limit: 20
expose-recent-events: true
leaderboard-limit: 20
event-limit: 20
world-description: "A public Minecraft world."
Pair a server once with:
- Enable
explorer-push.enabled and set public-address.
- Restart or reload BasicStats.
- Run
/basicstats explorer claim as an OP with basicstats.explorer.
- Open the one-time link and confirm the address.
- Check
/basicstats explorer status for pairing and upload diagnostics.
For troubleshooting, use /basicstats explorer diagnose. The safe self-test checks the local configuration, pairing state, snapshot size, daily quota and last upload result. When Explorer Push is enabled, it also probes the HTTPS endpoint without authentication. It never publishes a snapshot, consumes upload quota or displays secrets.
Player names are anonymous by default. When the privacy consent setting is active, each player receives a clickable one-time question. Use /basicstats explorer privacy to view the decision, /basicstats explorer privacy yes|no to change it and /basicstats explorer privacy reset to be asked again. An unanswered prompt becomes anonymous automatically. Admins with basicstats.explorer can inspect or reset another player with /basicstats explorer privacy <player> or /basicstats explorer privacy reset <player>. A public name is used only when both explicit consent and expose-player-names: true are present; otherwise the Explorer uses Player 1, Player 2, etc.
The consent defaults are privacy-first and can be adjusted by the server administrator:
privacy:
explorer-name-consent:
enabled: true
ask-on-first-join: true
default: false
timeout-seconds: 60
The Explorer stores only the newest snapshot per server in Cloudflare D1. It never receives UUIDs, IPs, coordinates, chat, dashboard tokens, admin tokens, secrets or private player data. When enabled, it can show bounded anonymous-or-consented player profiles with rank progress, deaths, kills, playtime, walked blocks, blocks, crafting, damage, Totems Used, achievements, goals and streaks. Names and optional mc-heads.net heads require explicit consent and the matching administrator switches; expose-player-profiles: false removes the profile grid while aggregate data remains available. Advanced K/D, deaths, playtime and blocks boards are opt-in and K/D uses player kills and deaths only. Snapshots expire after three hours without a successful upload; the free setup accepts at most 26 uploads per server and UTC day. Read the privacy explanation before enabling public profiles.
The old public-web-api remains available as an optional legacy/self-hosting feature, but it is no longer the standard Explorer path:
public-web-api:
enabled: false
bind-host: "127.0.0.1"
port: 8081
public-address: ""
allowed-origins:
- "https://basicstats-explorer.pages.dev"
expose-player-names: true
expose-recent-events: true
leaderboard-limit: 20
event-limit: 20
cache-seconds: 30
world-description: "A public Minecraft world."
The legacy endpoint is /basicstats/public/v1/summary. For self-hosting, an administrator must route the local API through HTTPS/443 with a reverse proxy or Cloudflare Tunnel. BasicStats does not provide TLS termination itself:
https://play.example.net/basicstats/public/v1/summary
Only aggregated totals, the configurable rank leaderboard and selected coordinate-free events are exposed. UUIDs, IP addresses, coordinates, inventories, chat, internal diagnostics and secrets are never returned. Validate the legacy route with curl -i https://<host>/basicstats/public/v1/summary; disable it with public-web-api.enabled: false when it is not needed.
🔔 Discord Notifications
BasicStats can send selected server events to Discord through standard Discord webhooks. Notifications are disabled by default and are delivered asynchronously.
The dashboard supports a legacy Default webhook plus separate targets for:
- 👥 Players
- 🏆 Ranks
- 🎯 Goals and Achievements
- 🔥 Streaks and Records
Each target has its own enabled state, webhook URL and event filters. Supported events include:
- 👋 Player joins
- 💀 Player deaths
- ⬆️ Rank-ups
- ⬇️ Rank-downs
- 🎯 Completed goals
- 🆕 Newly detected goals
- ✨ Achievement unlocks
- 🥇 New records
- 🔥 Long streaks
Webhook URLs are entered in the protected Dashboard Settings → Discord area. Saved URLs are never returned in settings responses or written to console logs. Only official Discord webhook hosts are accepted, mentions are disabled, and temporary rate limits are retried with bounded delays.
🧭 Commands
/basicstats – Show the interactive help menu
/basicstats menu – Open the inventory GUI
/basicstats stats [player] – View statistics
/basicstats compare <player> – Compare statistics and ranks
/basicstats profile [player] – View a player profile
/basicstats rank [player] – View rank progress
/basicstats rank list – View all rank stages
/basicstats rank details – View rank-factor contributions
/basicstats streak [player] – View the current and best streak
/basicstats team [player] – View team or clan statistics
/basicstats network – Show network synchronization status
/basicstats season status – Show the active season and remaining time
/basicstats season top [stat] – View the seasonal leaderboard
/basicstats season history – View the last archived season results
/basicstats season start <name> <days> – Start a season (operator)
/basicstats season end confirm – End the active season and process rewards (operator)
/basicstats season reset confirm – Reset seasonal progress without changing lifetime data (operator)
/basicstats deathlog – View recent deaths
/basicstats goals – View personal goals
/basicstats achievements [player] – View achievement progress
/basicstats topstats [stat] [lifetime|daily|weekly] – View configurable leaderboards
/basicstats top [stat] [lifetime|daily|weekly] – Short alias for topstats
/basicstats daily – View today's statistics
/basicstats weekly – View this week's statistics
/basicstats settings – View personal display settings
/basicstats settings toggle – Toggle your display
/basicstats settings display <sidebar|actionbar|bossbar|none> – Choose a display mode
/basicstats settings layout <layout> – Choose a configured layout
/basicstats settings notifications [type] [on|off|toggle] – Manage personal notifications
/basicstats display <sidebar|actionbar|bossbar|none> – Choose a display mode
/basicstats playtime [player] – View playtime
/basicstats firstjoin [player] – View first join date
/basicstats online – List online players
/basicstats uptime – View server uptime
/basicstats session – View your current session
/basicstats setup – Configure server defaults through the setup wizard (operator)
/basicstats info – Show plugin, server, Java and storage information
/basicstats debug – Show safe support diagnostics
/basicstats health – Run the health center with repair guidance
/basicstats health fix – Reapply missing defaults and config validation without changing player data (operator)
/basicstats dashboard – Create a temporary dashboard link
/basicstats dashboard setup <local|hosted> [address] [port] – Configure dashboard access
/basicstats dashboard token – Show the temporary dashboard token directly
/basicstats explorer claim – Open the one-time public Explorer pairing link (operator)
/basicstats explorer status – Show safe Explorer push status and upload timing
/basicstats explorer diagnose – Run a safe Explorer self-test without publishing a snapshot
/basicstats explorer privacy [yes|no|reset] – Manage your Explorer name consent
/basicstats explorer privacy <player> – Inspect a player's consent (admin)
/basicstats explorer privacy reset <player> – Reset a player's consent (admin)
/basicstats import vanilla [player] [confirm] – Preview or import historical vanilla statistics (operator)
/basicstats reset <player> <stat|daily|weekly|all> confirm – Reset data
/basicstats backup – Create a manual backup
/basicstats backup list – List verified local backups
/basicstats backup restore <file> confirm – Restore a backup after creating a safety copy (operator)
/basicstats reload – Reload configuration and messages
The root command also accepts the aliases /bs and /bstats. Legacy commands such as /stats, /uptime, /session, /deathlog, /sidebar, /playtime, /firstjoin, /online, /topstats, /daily, /weekly, /goals and /achievements remain available.
🔗 PlaceholderAPI
PlaceholderAPI is completely optional. The expansion is registered automatically when PlaceholderAPI is installed.
Core and identity placeholders:
%basicstats_deaths% · %basicstats_player_kills% · %basicstats_mob_kills% · %basicstats_jumps%
%basicstats_walked_km% · %basicstats_playtime_hours% · %basicstats_blocks_broken% · %basicstats_blocks_placed%
%basicstats_items_crafted% · %basicstats_damage_dealt% · %basicstats_damage_taken%
%basicstats_display_name% · %basicstats_username% · %basicstats_real_name%
%basicstats_session% · %basicstats_uptime% · %basicstats_online% · %basicstats_playtime_rank% · %basicstats_display_mode%
Rank placeholders:
%basicstats_rank% · %basicstats_rank_next% · %basicstats_rank_max% · %basicstats_rank_score%
%basicstats_rank_progress% · %basicstats_rank_points_to_next% · %basicstats_rank_activity_score% · %basicstats_rank_death_penalty%
Progress placeholders:
%basicstats_goals_completed% · %basicstats_goals_total% · %basicstats_achievements_completed% · %basicstats_achievements_total%
%basicstats_streak% · %basicstats_best_streak% · %basicstats_streak_progress%
Season placeholders:
%basicstats_season_active% · %basicstats_season_name% · %basicstats_season_points% · %basicstats_season_days_remaining%
Team placeholders:
%basicstats_team% · %basicstats_team_members% · %basicstats_team_playtime_hours% · %basicstats_team_player_kills%
%basicstats_team_deaths% · %basicstats_team_rank_points%
Every core statistic also has a daily and weekly variant, for example %basicstats_daily_blocks_placed%, %basicstats_weekly_items_crafted%, %basicstats_daily_damage_taken% and %basicstats_weekly_playtime_hours%.
⚙️ Configuration and Storage
The generated config.yml supports:
- 🇬🇧 English and 🇩🇪 German localization
- First-run setup state and guided setup defaults
- Setup presets for simple, community and full local installations
- Health-center checks and safe configuration repair through
/basicstats health
- Display layouts and update intervals
- Sidebar, actionbar, bossbar and tablist settings
- Nickname/display-name usage and protected real-username visibility
- Personal display and notification preferences
- Rank factors, targets and death penalties
- Goals, achievements and rewards
- Optional seasons, seasonal point weights, leaderboards and end-of-season rewards
- Leaderboard statistics and sizes
- Number, time and date formats
- Automatic rotating and manual backups
- Verified backup listing and safe restore with an automatic pre-restore safety copy
- Dashboard access, history and feature controls
- Discord webhook routing and event filters
- Streak rules and minimum daily playtime
- Team provider selection
- Velocity/Bungee network settings
- Explorer Push endpoint, pairing state and privacy consent
- Optional legacy public API settings
Existing configuration values and custom translations are preserved when new options are added. Data is stored locally in YAML files in standalone mode. Saves use temporary files and replacement steps, and damaged data can be recovered from valid backups.
On a new server, an operator receives a clickable setup reminder until /basicstats setup is completed. The wizard covers language, default display, core features and optional integrations, and can be reopened later without deleting player data. Set dashboard.enabled: false or explorer-push.enabled: false to keep those network-facing features disabled.
🔐 Permissions
Important permission nodes include:
basicstats.use · basicstats.menu · basicstats.stats · basicstats.stats.others
basicstats.compare · basicstats.profile · basicstats.rank · basicstats.streak
basicstats.team · basicstats.network · basicstats.achievements · basicstats.info
basicstats.debug · basicstats.health · basicstats.deathlog · basicstats.display · basicstats.settings
basicstats.setup · basicstats.topstats · basicstats.goals · basicstats.reset
basicstats.backup · basicstats.backup.restore · basicstats.import · basicstats.reload · basicstats.explorer
basicstats.dashboard.manage · basicstats.season · basicstats.season.admin
Viewing personal statistics and display settings is available to everyone by default. Setup, import, reset, backup, backup restore, reload and dashboard administration are operator-protected. Restores accept only verified BasicStats backup filenames and require an explicit confirm argument; a fresh safety backup is created before replacement.
Historical data import
Minecraft keeps many lifetime statistics in its own per-player statistics files. BasicStats already reads the vanilla values for deaths, kills, jumps, walking distance and playtime. For plugin-owned counters that can be recovered exactly, an operator can run /basicstats import vanilla to preview the available history and then confirm it. The importer never merges into an existing non-zero BasicStats counter, so it cannot silently double-count data. A detailed deathlog, block placements and historical timestamps are not available from the vanilla statistics API and are therefore not invented.
✅ Compatibility
- Minecraft Java Edition 1.17.1 and newer
- Spigot, Paper, Purpur and Bukkit-compatible servers
- Java 17 or newer
- Bukkit API baseline 1.17
- No NMS or version-specific internals
- PlaceholderAPI is optional
- One JAR for supported server versions
Always test the exact server version used by your network.
📥 Installation
- Download the latest
.jar file.
- Put it into your server's
plugins folder.
- Start or restart the server.
- Run
/basicstats setup and save the guided setup.
- Use
/basicstats menu in-game.
The small numbers shown on the right side of a Minecraft scoreboard sidebar are generated by Minecraft itself and are used for line ordering.
📄 License
BasicStats is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧