BasicStats

插件

· 作者 Basicstats

适用于 Paper、Purpur、Spigot 和 Bukkit 的 Minecraft 统计插件,提供玩家统计数据、基于矿石的排名、CraftAttack 风格的死亡计数器、排行榜、仪表盘、Discord Webhook、连续登录记录、成就以及 PlaceholderAPI 支持。

0 本站下载 0 关注 更新于 10 小时前

最新 2.9.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

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."

只需一次配对即可:

  1. 启用 explorer-push.enabled 并设置 public-address。
  2. 重启或重载 BasicStats。
  3. 以拥有 basicstats.explorer 权限的 OP 身份运行 /basicstats explorer claim。
  4. 打开一次性链接并确认地址。
  5. 检查 /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 文件适用于所有支持的服务器版本

始终测试您的网络所使用的确切服务器版本。

📥 安装

  1. 下载最新的 .jar 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 启动或重启服务器。
  4. 运行 /basicstats setup 并保存引导式设置。
  5. 在游戏中使用 /basicstats menu。

Minecraft 记分牌侧边栏右侧显示的小数字是由 Minecraft 本身生成的,用于行排序。

📄 许可证

BasicStats 根据 MIT 许可证授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源