OgiPlayerStats

插件

· 作者 ogidevs

用于显示用户统计信息的综合 GUI

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.5 · Paper / Purpur

一键开服(送7天)

OgiPlayerStats Banner

OgiPlayerStats

一款现代、强大且完全免费的 Minecraft 服务器玩家统计信息 GUI。
以性能和多功能性为设计核心。


? 目录


? 开发者寄语

我厌倦了看到那些essential(基础且高质量)的服务器插件被锁定在付费墙之后。我相信强大的工具应该能让 Minecraft 社区的每个人都能够使用。这就是为什么我创建了 OgiPlayerStats——旨在免费提供高端、功能丰富的体验。希望你能喜欢它!


? 关于该插件

OgiPlayerStats 提供了一个美观直观的游戏中菜单,用于显示玩家统计信息。与其他统计类插件不同,它是从底层构建的,可以通过简单的 config.yml 文件实现 100% 可配置。你可以显示从原版 Minecraft 统计(如 PLAYER_KILLS、DIAMONDS_MINED)到使用强大的 PlaceholderAPI 集成功能从 Vault 或 EssentialsX 等其他插件获取的自定义数据。

OgiPlayerStats Banner

默认统计信息 GUI 的示例。

✨ 主要功能

  • 完全免费且开源:没有高级版本,没有隐藏费用。所有功能对所有人开放。
  • 完全可配置的 GUI:控制每个统计项的标题、大小、物品、名称、描述和插槽位置。
  • 广泛的统计支持:追踪任何原版统计信息,包括带有子类型的统计(如方块、实体)。
  • 强大的 PlaceholderAPI 集成:
    • 导入:显示来自 任何 其他支持 PAPI 的插件的占位符。
    • 导出:为你配置的每个统计项创建动态占位符(例如 %ogiplayerstats_player_kills%)。
  • 动态物品皮肤:使用带有 skull-owner 的 PLAYER_HEAD 材质来显示特定玩家的皮肤。
  • 优化性能:轻量级设计,确保对服务器的影响降至最低。
  • 通用兼容性:单个 JAR 文件支持从 1.16.5 到 1.21+ 的所有服务器版本。

? 安装

  1. 从 Releases Page、SpigotMC 或 Modrinth 下载最新版本。
  2. 将 OgiPlayerStats-X.X.X.jar 文件放入服务器的 /plugins 目录中。
  3. (可选但推荐) 安装 PlaceholderAPI 以解锁插件的全部潜力。
  4. 重启服务器。默认配置文件将在 /plugins/OgiPlayerStats/config.yml 生成。

⚙️ 配置

所有配置均在 config.yml 文件中处理。你可以在 displayed-stats 列表中添加、删除或修改任何统计项。

? 安装

  1. 从 Releases Page、SpigotMC 或 Modrinth 下载最新版本。
  2. 将 OgiPlayerStats-X.X.X.jar 文件放入服务器的 /plugins 目录中。
  3. (可选但推荐) 安装 PlaceholderAPI 以解锁插件的全部潜力。
  4. 重启服务器。默认配置文件将在 /plugins/OgiPlayerStats/config.yml 生成。

⚙️ 配置

所有配置均在 config.yml 文件中处理。你可以在 displayed-stats 列表中添加、删除或修改任何统计项。

添加内置统计项

要显示 Minecraft 原生的统计信息,请使用 statistic 键。对于需要子类型的统计项(如破坏特定方块),还需包含 type 和 sub-type。

- slot: 14
  material: "DIAMOND_PICKAXE"
  name: "&b钻石开采量"
  lore:
    - "&7已破坏的钻石矿石方块数。"
    - ""
    - "&a数值: &f{value}"
  statistic: "MINE_BLOCK"
  type: "BLOCK"
  sub-type: "DIAMOND_ORE"

添加 PlaceholderAPI 统计项

要显示来自其他插件的值,只需使用 placeholder 键代替 statistic。描述中的 {value} 将被占位符的输出所替换。

- slot: 13
  material: "GOLD_INGOT"
  name: "&e玩家余额"
  lore:
    - "&7您当前的余额。"
    - ""
    - "&a数值: &f{value}"
  placeholder: "%vault_eco_balance_formatted%"

要显示 Minecraft 原生的统计信息,请使用 statistic 键。对于需要子类型的统计项(如破坏特定方块),还需包含 type 和 sub-type。

有关可用统计信息和材质名称的完整列表,请参阅 Spigot Javadocs。

? 命令与权限

命令 权限 描述
/stats [player] ogiplayerstats.view / ogiplayerstats.view.others 查看你自己或其他玩家的统计数据。
/stats reload ogiplayerstats.reload 重新加载插件的配置文件。

? PlaceholderAPI 集成

OgiPlayerStats 会根据你配置中每个统计项的 name 字段自动生成其专属的占位符。名称会被转换为小写,移除颜色代码,并将空格替换为下划线。

示例: 一个名为 name: "&bPlayer Kills" 的统计项会变成 %ogiplayerstats_player_kills%。 一个名为 name: "&ePlayer Balance" 的统计项会变成 %ogiplayerstats_player_balance%。

你可以在任何支持 PlaceholderAPI 的插件中使用这些占位符,例如记分板、聊天格式化器或全息图。

GUI 配置示例


displayed-stats:
  # --- 玩家信息(顶部居中) ---
  - slot: 4
    material: "PLAYER_HEAD"
    skull-owner: "{player}"
    name: "&b{player}'s Stats"
    lore:
      - "&7玩家旅程概览。"
      - ""
      - "&e游戏时长: &f%statistic_time_played%"
      - "&e加入日期: &f%player_first_join_date%"

  # --- 核心 PvP 数据(第二行) ---
  - slot: 11
    material: "DIAMOND_SWORD"
    name: "&a玩家击杀数"
    lore:
      - "&7在战斗中被击败的对手。"
      - ""
      - "&e数值: &f{value}"
    statistic: "PLAYER_KILLS"

  - slot: 12
    material: "NETHERITE_SWORD"
    name: "&c被玩家杀死次数"
    lore:
      - "&7被其他玩家击败的次数。"
      - ""
      - "&e数值: &f{value}"
    statistic: "ENTITY_KILLED_BY"
    type: "ENTITY_TYPE"
    sub-type: "PLAYER"

  - slot: 13
    material: "DRAGON_HEAD"
    name: "&5末影龙击杀数"
    lore:
      - "&7玩家征服末影龙的次数。"
      - ""
      - "&e击杀: &f{value}"
    statistic: "KILL_ENTITY"
    type: "ENTITY_TYPE"
    sub-type: "ENDER_DRAGON"

  - slot: 14
    material: "SKELETON_SKULL"
    name: "&c总死亡次数"
    lore:
      - "&7玩家遭遇终结的时刻。"
      - ""
      - "&e数值: &f{value}"
    statistic: "DEATHS"

  - slot: 15
    material: "TOTEM_OF_UNDYING"
    name: "&e图腾使用次数"
    lore:
      - "&7玩家战胜死亡的次数。"
      - ""
      - "&e数值: &f{value}"
    statistic: "USE_ITEM"
    type: "ITEM"
    sub-type: "TOTEM_OF_UNDYING"

  # --- 生命偷取与资源(第三行) ---
  - slot: 20
    material: "GOLDEN_APPLE"
    name: "&6金苹果食用数"
    lore:
      - "&7PVP冠军的果实。"
      - ""
      - "&e数值: &f{value}"
    statistic: "USE_ITEM"
    type: "ITEM"
    sub-type: "GOLDEN_APPLE"
 
  - slot: 21
    material: "DIAMOND"
    name: "&b钻石开采量"
    lore:
      - "&7财富与力量的基石。"
      - ""
      - "&e数值: &f{value}"
    statistic: "MINE_BLOCK"
    type: "BLOCK"
    sub-type: "DIAMOND_ORE"

  - slot: 22 # 核心生命偷取数据
    material: "HEART_OF_THE_SEA"
    name: "&c❤ 生命偷取之心"
    lore:
      - "&7当前最大生命值。"
      - ""
      - "&e心数: &f{value}"
    placeholder: "%lifestealz_hearts%"

  - slot: 23
    material: "NETHERITE_SCRAP"
    name: "&8远古残骸开采量"
    lore:
      - "&7锻造最强护甲的材料。"
      - ""
      - "&e数值: &f{value}"
    statistic: "MINE_BLOCK"
    type: "BLOCK"
    sub-type: "ANCIENT_DEBRIS"

  - slot: 24
    material: "NETHERITE_CHESTPLATE"
    name: "&6生物击杀数"
    lore:
      - "&7为了战利品和经验值而猎杀的生物。"
      - ""
      - "&e数值: &f{value}"
    statistic: "MOB_KILLS"

  # --- 经济与服务器信息(底部一行) ---
  - slot: 30
    material: "EMERALD"
    name: "&a复活次数"
    lore:
      - "&7玩家被复活的次数。"
      - ""
      - "&e数值: &f{value}"
    placeholder: "%lifestealz_revived%"

  - slot: 31 # 底部核心数据
    material: "GOLD_INGOT"
    name: "&e玩家余额"
    lore:
      - "&7当前财富。"
      - ""
      - "&e余额: &f{value}"
    placeholder: "%vault_eco_balance_formatted%"

  - slot: 32
    material: "COMPASS"
    name: "&b在线状态"
    lore:
      - "&7是否目前在线?"
      - ""
      - "&e状态: &f{value}"
    placeholder: "%player_online%"
 

示例 GUI

? 贡献

欢迎贡献!如果你想为项目做出贡献,请按照以下步骤操作:

  1. Fork 仓库。
  2. 创建一个新分支 (git checkout -b feature/YourAmazingFeature)。
  3. 进行修改。
  4. 提交更改 (git commit -m 'Add some amazing feature')。
  5. 推送到分支 (git push origin feature/YourAmazingFeature)。
  6. 打开一个新的 Pull Request。

? Bug 报告

如果你发现了 Bug,请在 GitHub Issues 页面上提交一个问题。

请在报告中包含以下信息:

  • 服务器版本(例如 Paper 1.21.5)
  • 插件版本
  • 对 Bug 的详细描述
  • 重现 Bug 的步骤
  • 控制台日志中的任何相关错误

Developed by Ogi.

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源