exLog

插件

· 作者 _ForgeUser7530707

可扩展的日志框架。

0 本站下载 0 关注 更新于 9 年前
一键开服(送7天)

exLog 是一款用于 Bukkit 的日志记录插件,也是颇受欢迎的 Log 插件 的官方继任者。那么,它与其他插件(如 LogBlock 和 LogEx)有何不同呢?答案是:模块化。

我们都曾有过这样的烦恼体验:下载一个插件后,不得不翻阅庞大的配置文件,只为启用那 100 个功能中我们真正需要的 1 或 2 个。exLog 则与众不同。它是一个日志平台,自身不提供任何可见功能。日志源和数据提供者的功能由单独的模块提供,其方式类似于 Bukkit 及其插件架构。

通过这种方式,exLog 可以在不牺牲所需功能的前提下,保持尽可能轻量级。

请勿使用主页上的下载按钮

它可能链接到错误的文件!请遵循“基本安装”部分中的说明进行操作!

可用模块

  • exLog core
  • JSON data provider
  • SQLite data provider
  • basic block logging source(方块放置与破坏、水桶使用)

计划中的模块

  • binary data provider
  • redstone logging source(门/按钮/拉杆操作)
  • mob logging source(苦力怕/末影人/凋灵方块交互)
  • WorldEdit logging source
  • chest logging source
  • command logging source

此外,还将提供一个文档完善的 API,供希望基于 exLog 框架实现自定义日志源或数据提供者的任何人使用。

基本安装

  • 从 Files 页面 下载最新的 Core、JSON 和 Block Logging jar 文件。确保 Data API Level 和 Block API Level 匹配。
    • 推荐:Core 0.3.0, JSON 0.3.0/SQLite 0.3.0, Block Logging 0.3.0.
    • 旧版:Core 0.2.0, JSON 0.2.0/SQLite 0.2.0, Block Logging 0.1.0.
  • 将这三个 jar 文件放入你的 Bukkit 安装目录中的 plugins 文件夹。
  • 就这样!该插件现在应已预配置为将方块放置和破坏记录到 Bukkit 目录下的 database.json 文件中。
  • 手持木棍或骨头右键点击方块,即可查看其历史记录。
  • 权限详情可在 plugin.yml 中找到。

高级安装

  • 你可以通过下载并将相应的 jar 文件复制到 Bukkit 安装目录的 plugins 文件夹中来安装额外模块。
  • 这些模块需要在 plugins/ExLog/config.yml 文件中激活。
  • dataProvider 接受单个 String 值,即数据提供者的内部插件名称。
  • loggingSources 接受一个 String 值列表,即日志源的内部插件名称。
  • dateFormat 接受单个 String 值,即用于输入和输出的日期格式。

高级用法

  • 使用 ‘/exlog [command] [args]’ 或等效的 ‘/el [command] [args]’ 访问高级 exLog 命令。
  • 有效命令包括 ‘help’, ‘info’, ‘test’, ‘query’ 和 ‘queryu’。你只需要了解 query/u 即可。
  • query 接受一个 JSON 对象作为参数。有效键包括 ’player’ 和 ‘origin’(接受字符串)、‘x’, ‘y’, ‘z’ 和 ‘dimension’(接受整数)、‘date’(接受长整型)、‘dateMin’ 和 ‘dateMax’(接受字符串,根据 config.yml 中的 dateFormat 格式化),以及 ‘otherData’(接受 JSON 对象)。成功执行命令不需要任何键。
  • queryu 相同,但会同时显示 UUID 和玩家名称。
    • 返回与我相关的所有条目:/el query {"player":"RunasSudo"}
    • 返回所有主世界方块的放置记录:/el query {"dimension":0,"origin":"ExLogBlockLoggingSource","otherData":{"type":"1"}}

回滚与删除

  • 回滚功能仍处于测试阶段。对于因使用回滚而导致的任何世界或数据库损坏,本人不承担责任。但我非常乐意听取你的反馈!
  • 要进行回滚,首先执行 ‘/exlog rollback [query]’ 或 ‘/el rb [query]’。
  • 插件将根据查询列出所有待回滚的事件。
  • 检查列表,如果满意,则执行 ‘/exlog rollback y [query]’ 或 ‘/el rb y [query]’。
  • 要删除条目(不回滚,适用于开启新世界的情况),请使用与回滚相同的方法,但用 ‘rm’/‘remove’ 代替 ‘rb’/‘rollback’。

创建数据提供者和日志源

  • 数据提供者和日志源分别可通过继承 ExLogDataProvider 和 ExLogLoggingSource 来实现。
  • 请参阅现有实现以获取更多信息。

链接

详细的开发进度可在我的 GitHub 页面 上找到。 请在 BukkitDev 论坛 上讨论该项目。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源