OgiPlayerStats
一款现代、强大且完全免费的 Minecraft 服务器玩家统计信息 GUI。
以性能和多功能性为设计核心。
? 目录
? 开发者寄语
我厌倦了看到那些essential(基础且高质量)的服务器插件被锁定在付费墙之后。我相信强大的工具应该能让 Minecraft 社区的每个人都能够使用。这就是为什么我创建了 OgiPlayerStats——旨在免费提供高端、功能丰富的体验。希望你能喜欢它!
? 关于该插件
OgiPlayerStats 提供了一个美观直观的游戏中菜单,用于显示玩家统计信息。与其他统计类插件不同,它是从底层构建的,可以通过简单的 config.yml 文件实现 100% 可配置。你可以显示从原版 Minecraft 统计(如 PLAYER_KILLS、DIAMONDS_MINED)到使用强大的 PlaceholderAPI 集成功能从 Vault 或 EssentialsX 等其他插件获取的自定义数据。
默认统计信息 GUI 的示例。
✨ 主要功能
- 完全免费且开源:没有高级版本,没有隐藏费用。所有功能对所有人开放。
- 完全可配置的 GUI:控制每个统计项的标题、大小、物品、名称、描述和插槽位置。
- 广泛的统计支持:追踪任何原版统计信息,包括带有子类型的统计(如方块、实体)。
- 强大的 PlaceholderAPI 集成:
- 导入:显示来自 任何 其他支持 PAPI 的插件的占位符。
- 导出:为你配置的每个统计项创建动态占位符(例如
%ogiplayerstats_player_kills%)。
- 动态物品皮肤:使用带有
skull-owner 的 PLAYER_HEAD 材质来显示特定玩家的皮肤。
- 优化性能:轻量级设计,确保对服务器的影响降至最低。
- 通用兼容性:单个 JAR 文件支持从 1.16.5 到 1.21+ 的所有服务器版本。
? 安装
- 从 Releases Page、SpigotMC 或 Modrinth 下载最新版本。
- 将
OgiPlayerStats-X.X.X.jar 文件放入服务器的 /plugins 目录中。
- (可选但推荐) 安装 PlaceholderAPI 以解锁插件的全部潜力。
- 重启服务器。默认配置文件将在
/plugins/OgiPlayerStats/config.yml 生成。
⚙️ 配置
所有配置均在 config.yml 文件中处理。你可以在 displayed-stats 列表中添加、删除或修改任何统计项。
? 安装
- 从 Releases Page、SpigotMC 或 Modrinth 下载最新版本。
- 将
OgiPlayerStats-X.X.X.jar 文件放入服务器的 /plugins 目录中。
- (可选但推荐) 安装 PlaceholderAPI 以解锁插件的全部潜力。
- 重启服务器。默认配置文件将在
/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%"

? 贡献
欢迎贡献!如果你想为项目做出贡献,请按照以下步骤操作:
- Fork 仓库。
- 创建一个新分支 (
git checkout -b feature/YourAmazingFeature)。
- 进行修改。
- 提交更改 (
git commit -m 'Add some amazing feature')。
- 推送到分支 (
git push origin feature/YourAmazingFeature)。
- 打开一个新的 Pull Request。
? Bug 报告
如果你发现了 Bug,请在 GitHub Issues 页面上提交一个问题。
请在报告中包含以下信息:
- 服务器版本(例如 Paper 1.21.5)
- 插件版本
- 对 Bug 的详细描述
- 重现 Bug 的步骤
- 控制台日志中的任何相关错误
Developed by Ogi.
OgiPlayerStats
A modern, powerful, and 100% free player statistics GUI for Minecraft servers.
Built with performance and versatility in mind.
? Table of Contents
? A Note From The Developer
I was tired of seeing essential, high-quality server plugins locked behind a paywall. I believe powerful tools should be accessible to everyone in the Minecraft community. That's why I created OgiPlayerStats—to provide a premium, feature-rich experience for free. I hope you enjoy it!
? About the Plugin
OgiPlayerStats provides a beautiful and intuitive in-game menu to display player statistics. Unlike other stat plugins, it's built from the ground up to be 100% configurable via a simple config.yml file. You can display anything from vanilla Minecraft stats (PLAYER_KILLS, DIAMONDS_MINED) to custom data from other plugins like Vault or EssentialsX using the powerful PlaceholderAPI integration.
An example of the default stats GUI.
✨ Key Features
- Completely Free & Open Source: No premium versions, no hidden costs. All features are available to everyone.
- Fully Configurable GUI: Control the title, size, items, names, lore, and slot for every stat.
- Extensive Stat Support: Track any vanilla statistic, including those with subtypes (Blocks, Entities).
- Powerful PlaceholderAPI Integration:
- Import: Display placeholders from any other PAPI-enabled plugin.
- Export: Creates dynamic placeholders for every stat you configure (e.g.,
%ogiplayerstats_player_kills%).
- Dynamic Item Skins: Use
PLAYER_HEAD material with a skull-owner to display player-specific skins.
- Optimized Performance: Lightweight and designed to ensure minimal server impact.
- Universal Compatibility: A single JAR file supports all server versions from 1.16.5 to 1.21+.
? Installation
- Download the latest release from the Releases Page, SpigotMC, or Modrinth.
- Place the
OgiPlayerStats-X.X.X.jar file into your server's /plugins directory.
- (Optional but Recommended) Install PlaceholderAPI to unlock the full potential of the plugin.
- Restart your server. The default configuration file will be generated at
/plugins/OgiPlayerStats/config.yml.
⚙️ Configuration
All configuration is handled in the config.yml file. You can add, remove, or modify any stat in the displayed-stats list.
? Installation
- Download the latest release from the Releases Page, SpigotMC, or Modrinth.
- Place the
OgiPlayerStats-X.X.X.jar file into your server's /plugins directory.
- (Optional but Recommended) Install PlaceholderAPI to unlock the full potential of the plugin.
- Restart your server. The default configuration file will be generated at
/plugins/OgiPlayerStats/config.yml.
⚙️ Configuration
All configuration is handled in the config.yml file. You can add, remove, or modify any stat in the displayed-stats list.
Adding a Built-in Stat
To display a statistic native to Minecraft, use the statistic key. For stats that need a subtype (like breaking a specific block), also include type and sub-type.
- slot: 14
material: "DIAMOND_PICKAXE"
name: "&bDiamonds Mined"
lore:
- "&7Diamond ore blocks broken."
- ""
- "&aValue: &f{value}"
statistic: "MINE_BLOCK"
type: "BLOCK"
sub-type: "DIAMOND_ORE"
Adding a PlaceholderAPI Stat
To display a value from another plugin, simply use the placeholder key instead of statistic. The {value} in the lore will be replaced by the placeholder's output.
- slot: 13
material: "GOLD_INGOT"
name: "&ePlayer Balance"
lore:
- "&7Your current balance."
- ""
- "&aValue: &f{value}"
placeholder: "%vault_eco_balance_formatted%"
To display a statistic native to Minecraft, use the statistic key. For stats that need a subtype (like breaking a specific block), also include type and sub-type.
For a full list of available statistics and material names, please refer to the Spigot Javadocs.
? Commands & Permissions
| Command |
Permission |
Description |
/stats [player] |
ogiplayerstats.view / ogiplayerstats.view.others |
View your own or another player's statistics. |
/stats reload |
ogiplayerstats.reload |
Reloads the plugin's configuration file. |
? PlaceholderAPI Integration
OgiPlayerStats automatically generates its own placeholders based on the name field of each stat in your configuration. The name is converted to lowercase, stripped of color codes, and spaces are replaced with underscores.
Example:
A stat with name: "&bPlayer Kills" becomes %ogiplayerstats_player_kills%.
A stat with name: "&ePlayer Balance" becomes %ogiplayerstats_player_balance%.
You can use these placeholders in any plugin that supports PlaceholderAPI, such as scoreboards, chat formatters, or holograms.
Example Config for GUI
displayed-stats:
# --- Player Info (Top Center) ---
- slot: 4
material: "PLAYER_HEAD"
skull-owner: "{player}"
name: "&b{player}'s Stats"
lore:
- "&7An overview of player's journey."
- ""
- "&ePlaytime: &f%statistic_time_played%"
- "&eJoin Date: &f%player_first_join_date%"
# --- Core PvP Stats (Row 2) ---
- slot: 11
material: "DIAMOND_SWORD"
name: "&aPlayer Kills"
lore:
- "&7Foes vanquished in battle."
- ""
- "&eValue: &f{value}"
statistic: "PLAYER_KILLS"
- slot: 12
material: "NETHERITE_SWORD"
name: "&cDeaths by Player"
lore:
- "&7Times player was bested by another."
- ""
- "&eValue: &f{value}"
statistic: "ENTITY_KILLED_BY"
type: "ENTITY_TYPE"
sub-type: "PLAYER"
- slot: 13
material: "DRAGON_HEAD"
name: "&5Ender Dragon Kills"
lore:
- "&7How many times player've conquered"
- "&7the Ender Dragon."
- ""
- "&eKills: &f{value}"
statistic: "KILL_ENTITY"
type: "ENTITY_TYPE"
sub-type: "ENDER_DRAGON"
- slot: 14
material: "SKELETON_SKULL"
name: "&cTotal Deaths"
lore:
- "&7Every time player've met end."
- ""
- "&eValue: &f{value}"
statistic: "DEATHS"
- slot: 15
material: "TOTEM_OF_UNDYING"
name: "&eTotems Popped"
lore:
- "&7How many times player've defied death."
- ""
- "&eValue: &f{value}"
statistic: "USE_ITEM"
type: "ITEM"
sub-type: "TOTEM_OF_UNDYING"
# --- Lifesteal & Resources (Row 3) ---
- slot: 20
material: "GOLDEN_APPLE"
name: "&6Golden Apples Eaten"
lore:
- "&7The fruit of PvP champions."
- ""
- "&eValue: &f{value}"
statistic: "USE_ITEM"
type: "ITEM"
sub-type: "GOLDEN_APPLE"
- slot: 21
material: "DIAMOND"
name: "&bDiamonds Mined"
lore:
- "&7The foundation of wealth and power."
- ""
- "&eValue: &f{value}"
statistic: "MINE_BLOCK"
type: "BLOCK"
sub-type: "DIAMOND_ORE"
- slot: 22 # Centerpiece Lifesteal Stat
material: "HEART_OF_THE_SEA"
name: "&c❤ Lifesteal Hearts"
lore:
- "&7Current maximum health."
- ""
- "&eHearts: &f{value}"
placeholder: "%lifestealz_hearts%"
- slot: 23
material: "NETHERITE_SCRAP"
name: "&8Ancient Debris Mined"
lore:
- "&7Forging the strongest armor."
- ""
- "&eValue: &f{value}"
statistic: "MINE_BLOCK"
type: "BLOCK"
sub-type: "ANCIENT_DEBRIS"
- slot: 24
material: "NETHERITE_CHESTPLATE"
name: "&6Mob Kills"
lore:
- "&7Creatures slain for loot and XP."
- ""
- "&eValue: &f{value}"
statistic: "MOB_KILLS"
# --- Economy & Server Info (Bottom Row) ---
- slot: 30
material: "EMERALD"
name: "&aRevived"
lore:
- "&7How many times was a player revived"
- ""
- "&eValue: &f{value}"
placeholder: "%lifestealz_revived%"
- slot: 31 # Bottom Centerpiece
material: "GOLD_INGOT"
name: "&ePlayer Balance"
lore:
- "&7Current wealth."
- ""
- "&eBalance: &f{value}"
placeholder: "%vault_eco_balance_formatted%"
- slot: 32
material: "COMPASS"
name: "&bOnline Status"
lore:
- "&7Is currently online?"
- ""
- "&eStatus: &f{value}"
placeholder: "%player_online%"

? Contributing
Contributions are welcome! If you'd like to contribute to the project, please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/YourAmazingFeature).
- Make your changes.
- Commit your changes (
git commit -m 'Add some amazing feature').
- Push to the branch (
git push origin feature/YourAmazingFeature).
- Open a new Pull Request.
? Bug Reports
If you find a bug, please open an issue on the GitHub Issues page.
Please include the following information in your report:
- Server version (e.g., Paper 1.21.5)
- Plugin version
- A detailed description of the bug
- Steps to reproduce the bug
- Any relevant errors from your console log
Developed by Ogi.
评论 0
登录后参与评分
还没有评论,来抢沙发吧