StatsAPI - 开发者数据统计API

StatsAPI 是一款为 Minecraft 服务器设计的轻量级、高性能的玩家数据统计插件。它支持多种统计类型，并允许开发者通过简单的 API 轻松集成到自己的插件中，同时为玩家提供查看个人数据的便捷命令。

💡核心特性

• 高性能：运行快速，对服务器影响极小。
• UUID 支持：完美支持 UUID，确保玩家数据在用户名更改后依然准确。
• MySQL 支持：支持 MySQL 数据库，便于数据长期存储和管理。
• 玩家缓存：缓存玩家数据以减少数据库查询，提升性能。
• 异步任务：采用异步任务处理数据，避免阻塞服务器主线程。
• 可配置命令：所有命令都可以在配置文件中启用或禁用。

🎮支持的统计数据

插件内置了多种玩家统计数据，包括

• 参与游戏场次 (Games)
• 获胜次数 (Wins)
• 击杀数 (Kills)
• 死亡数 (Deaths)
• 击杀/死亡比率 (K/D)
• 技能点数 (Skillpoints)
• 打开的箱子数 (Open Chests)
• 破坏的方块数 (Broken Blocks)
• 放置的方块数 (Placed Blocks)

计划新增的统计项

未来版本计划添加更多有趣的统计类型，例如

• 游戏币 (coins)
• 移动距离 (distance traveled)
• 进食次数 (times you have eaten)

🔧命令与权限

• /stats - 查看自己的统计数据。
• /stats <player> - 查看指定玩家的统计数据。

命令的启用状态可以在 messages.yml 文件中进行配置。

✨配置与集成

配置文件示例

以下是主要配置文件的示例结构

config.yml

CONFIG:
  COMMAND:
    STATS: true

database.yml

DATABASE:
  HOST: localhost
  PORT: '3306'
  USER: username
  PASSWORD: password
  DATABASE: database

messages.yml

MESSAGE:
  STATS:
    PREFIX: '&8[&7StatsAPI&8]'
    NOSTATS: '%PREFIX% &cNo Stats available'
    NOPLAYER: '%PREFIX% &cNo Player with this Minecraftname exists'
    ONKOWNCOMMAND: '%PREFIX% &cuse: &e/stats [player]'
    COMMAND:
    - '&7-=-=] &eStats %PLAYERNAME% &7[=-=-'
    - ' &7Games: &e%GAMES%'
    - ' &7Wins: &e%WINS%'
    - ' &7Kills: &e%KILLS%'
    - ' &7Deaths: &e%DEATHS%'
    - ' &7K/D: &e%KD%'
    - '&7-=-=-=-=-=-=-=-=-=-=-=-'

开发者 API 示例

开发者可以轻松地在自己的插件中调用 StatsAPI 来获取和修改玩家数据。

public StatsManager statsManager;
PlayerStats stats = statsManager.getPlayerStats(event.getPlayer().getUniqueId());

// 获取数据示例
int kills = stats.getKills();
int deaths = stats.getDeaths();
double kd = stats.getKD();

// 修改数据示例
stats.addKills(1);
stats.addSkillPoints(10);
stats.setWins(5);

// 排行榜功能示例
UUID uuid = StatsAPI.getRankingManager().getUUID(RankedType, 1);
int rank = StatsAPI.getRankingManager().getValues(RankedType, uuid);

⭐附加功能与未来计划

• Top10 排行榜墙 (开发中，进度 85%)：一个可视化的排行榜附加组件。
• UUID 显示开关：计划在 config.yml 中增加选项，以启用或禁用 UUID 在输出中的显示。
• 广泛的插件兼容性：已知可与 SurvivalGames、Leaderboard (Addon)、HolographicDisplays (Addon) 等插件协同工作。

❓支持与反馈

如果您有任何想法、建议或需要技术支持，欢迎加入我们的 Discord 社区进行交流。

Discord 支持服务器：Click me

对于希望将插件列入官方列表的开发者，请通过私人消息联系我们并提供插件链接。