BeardStat 是一款用于 Bukkit 的统计数据追踪插件。它可记录多种用户行为数据,并将其提供给玩家群体和其他插件使用。
记录的统计项
- 上次登录和退出时间
- 总游戏时长
- 方块放置与破坏(包括带有子/元数据的方块,如羊毛、原木等)
- 拾取/丢弃的物品
- 造成伤害与受到伤害
- 击杀数与死亡数
- 消耗的食物
- 剪羊毛与染色次数
- TNT 引爆次数
- 步行/船/矿车/马/猪的移动距离
- 制作的物品
- 驯服的动物
- 传送次数
- 钓鱼活动
Web 界面(开发中)
BeardStat 还附带一个 Web 界面,允许玩家在服务器网站上查看自己及好友的统计数据。该 Web 界面还包括一个记分板系统,可根据各项统计数据对玩家进行排名(例如游戏时长、苦力怕击杀数)。
命令
统计数据按世界分别记录,你可以将特定世界或游戏模式加入黑名单以禁止追踪。
BeardStat 还提供了以下命令:
* /stats - 访问所有统计信息
* /played - 显示玩家的游戏时长。
* /laston - 返回玩家上次上线的时间。
* /statpage - 允许展示一组玩家统计信息,结合 Bukkit 的命令别名功能非常有用。
开发版本
此项目的开发构建版本可从提供的持续集成服务器获取。
这些构建版本未经 BukkitDev 工作人员批准。请自行承担使用风险。
(请注意,当前开发版本中的 ZIP 文件包含损坏的 Web 界面实现,请改为下载 .jar 文件。Web 界面位于本页面右侧。)
来自 Jenkins 的最新开发构建
问题反馈
BeardStat 在 GitHub 上设有问题追踪器:。
提交错误报告时请包含以下内容:
* 完整的错误堆栈跟踪
* 插件版本(如果使用 CI 构建的版本,请注明构建编号)
* Bukkit 版本
* 使用的数据库类型(SQLite / MySQL)
插件集成
BeardStat 为插件开发者提供了丰富的 API,以便接入 BeardStat 并读取/记录统计数据。
面向开发者
BeardStat 的统计项可通过由 4 个子组件生成的唯一 ID 来识别:
* Domain(域)
* World(世界)
* Category(类别)
* Statistic(统计项)
Domain 是统计集合的主要命名空间。“default” 域由 BeardStat 使用,我建议你为自己的插件使用唯一的域名称(例如,如果你制作了一个 PvP 竞技场插件,可以使用 “pvparena” 作为域)。
World 表示记录该统计项的世界,通常即为世界名称。
但存在两种特殊情况。“__global__” 是一个保留的世界名称,用于不属于任何特定世界的统计项。第二种情况是 “__imported__”,这是一个保留的世界名称,用于从旧版 BeardStat 导入的统计项(在实现按世界存储之前)。
虽然并非官方意图,但你也可以使用 world ID 来表示非完整世界的独特区域(回到之前的 PvP 竞技场示例,你可以使用竞技场名称,例如 old_forge、broken_bow,而不是世界名称)。
已知与 BeardStat 集成的插件:
* BeardAch - 成就插件
* SimpleSpleef Evolution
指标收集
BeardStat 包含了由 Hidendra(LWC 作者)开发的插件指标代码,用于收集关于插件部署情况的匿名信息(Minecraft 版本、服务器信息、插件版本、基于国家级别的假设服务器位置以及 BeardStat 使用的数据库类型),并以图表形式汇总展示。有关此系统的更多信息,包括如何禁用它,请参阅 此处。
BeardStat is statistics tracking plugin for bukkit. It tracks a wide variety of user statistics and makes them available to your playerbase and plugins.
Recorded stats
- last Login and logout time
- Total playtime
- block placement and breaking (including sub/metadata blocks like wool, logs etc)
- Items picked up/dropped
- Damage dealt and recieved
- Kills and deaths
- Food consumed
- Sheep sheared and dyed
- TNT detonated
- Distance travelled on foot/boat/cart/horse/pig
- Items crafted
- Animals tamed
- Teleports
- Fishing
Web interface (under development)
BeardStat also comes with a web interface for stats, this allows players to view their own and friends stats on your servers website. the Web interface also includes a scoreboard system to rank players based on various statistics (playtime, creepers killed)
Commands
Stats are recorded per world, and you can blacklist worlds/gamemodes from tracking.
BeardStat also has a number of commands:
* /stats - access to all stats information
* /played - shows a players playyime.
* /laston - Returns the last time the player was on
* /statpage - Allows showing a selection of player stats, useful with Bukkit's command aliasing
Dev builds
Development builds of this project can be acquired at the provided continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk.
(Please note, zips in dev builds currently contain a broken implementation of the web interface, please instead download the .jar file instead. The web interface available on the right of this page)
Development builds fresh from Jenkins
Issues
BeardStat has an issue tracker on github, .
For error reports please include the following:
* full stacktrace of the error
* plugin version (inc. build number if using one from CI)
* Bukkit version
* Database type used (SQLite / MySQL)
Plugin integration
BeardStat provides a rich API for plugin developers to hook into BeardStat and read / record statistics.
For Developers
BeardStat stats are identifiable by a unique Id generated from 4 sub components:
* Domain
* World
* Category
* Statistic
Domain is the primary namespace for a collection of stats, the "default" domain is used by BeardStat, I ask that you use
your own unique domain for your plugin (i.e. if you make a PvP arena plugin, you could use the domain "pvparena").
World represents the world in which this stat was recorded, these are for the most part the name of the world.
Two special cases exist however. "__global__" is a reserved world name, meant for stats that do not pertain to a world. The second case is "__imported__", this is a reserved world for stats that have been imported from an older version of BeardStat before per world storage was implemented.
While not intended, you can use the world id for a unique area that is not a whole world (Going back to our pvp arena example, you could use the arena names instead, such as old_forge, broken_bow instead of a world name)
Current plugins that are known to integrate BeardStat:
* BeardAch - Achievements plugin
* SimpleSpleef Evolution
Metrics
BeardStat includes the plugin metrics code developed by Hidendra (author of LWC), which collects anonymous information about the plugins deployment (minecraft, server, plugin version, assumed server location at country level and database type used by BeardStat, aggregated into graph form.) More information on this system, including how to disable it can be found here
评论 0
登录后参与评分
还没有评论,来抢沙发吧