【Endstone】天眼插件-TianyanPlugin-适用于Endstone的玩家行为记录查询插件

一款适用于Endstone插件加载器的玩家行为记录查询插件。

最新内容请查看https://github.com/yuhangle/Endstone_TianyanPlugin的文档介绍，此处更新可能不及时

功能介绍行为记录

天眼插件使用endstone的事件API进行行为事件的记录，可以对以下行为事件进行记录：

容器交互和其它交互行为事件

玩家对箱子、陷阱箱、潜影箱、末影箱、木桶、熔炉、高炉、漏斗、发射器、投掷器的交互行为；玩家手持打火石、岩浆桶、火焰弹、水桶（包括生物水桶）、细雪桶对任何方块的交互行为；玩家手持桶对水、岩浆、细雪的交互行为；玩家对床、重生锚的任何交互行为。

方块破坏行为事件

在仅记录人工方块配置下，对玩家直接造成的全部人工方块（非自然方块）和部分自然方块的破坏行为（踩踏农田无法记录）进行记录；在关闭仅记录人工方块配置下，对玩家直接造成的全部方块破坏行为（踩踏农田无法记录）进行记录。

实体受击事件

在仅记录重要生物配置下，仅对马、猪、狼、猫、嗅探兽、鹦鹉、驴、骡子、村民的受击事件进行记录（不是玩家打的也会记录）；在关闭仅记录重要生物配置下，会对全部实体的受击事件进行记录（玩家被实体攻击、实体被非玩家攻击也会记录）。

方块放置事件记录

插件将对全部玩家直接实行的方块放置行为事件进行记录。

玩家信息显示和封禁功能玩家加服信息显示

天眼插件支持玩家加服信息显示和封禁功能。当玩家加入服务器时，将显示玩家的系统名称和设备ID。

封禁功能&防刷屏功能

插件可以通过封禁玩家名阻止玩家进入服务器，还支持通过封禁设备ID将设备拉入封禁名单，使得使用该设备（设备ID不变）的任何玩家都无法进入服务器。当要封禁的玩家仍在服务器中时，使用命令封禁玩家设备ID或通过控制台封禁玩家名只能将玩家加入封禁名单，无法直接踢出玩家。
当玩家在服务器内短时间发送大量消息（10秒内6条消息）时，将被自动封禁；当玩家在服务器内短时间发送大量命令（10秒内12条命令）时将被自动封禁。需要联系管理员才能解除封禁

安装&配置&使用方法安装endstone

这一步请参考endstone官方文档。

安装天眼插件

在release处下载最新版本的插件，放在服务端目录的plugins目录下，运行服务端即可使用。

配置天眼插件

运行天眼插件后，将在服务端目录的plugins目录下生成tianyan_data文件夹，里面有插件的配置文件config.json，打开config.json，里面是默认配置

1. {"是否记录自然方块": false, "是否记录人工方块": true,"是否仅记录重要生物": true}

复制代码

插件默认配置不记录大部分自然方块的破坏行为事件，仅记录大部分人工方块的破坏行为事件，仅记录部分重要生物的受击事件。如果需要记录全部方块的破坏行为事件，请将“是否记录自然方块”后的“false”修改为“true”；如果需要记录全部生物的受击事件，请将“是否仅记录重要生物”后的“false”修改为“true”。

插件命令使用方法

天眼命令使用方法

使用 /ty 命令查询玩家及部分实体行为记录 格式:

1. /ty x坐标 y坐标 z坐标 时间（单位：小时） 半径

复制代码

使用 /tygui 命令使用图形菜单查询玩家及部分实体行为记录 格式:

1. /tygui

复制代码

使用 /tys 命令搜索关键词 格式:

1. /tys 搜索类型 搜索关键词 时间（单位：小时）

复制代码

使用 /tysgui 命令使用图形菜单搜索关键词查询玩家及部分实体行为记录 格式:

1. /tysgui 搜索类型 搜索关键词 时间（单位：小时）

复制代码

搜索类型:player action object(玩家或行为实施者 行为 被实施行为的对象)  搜索关键词:玩家名或行为实施者名 交互 破坏 攻击 放置 被实施行为的对象名。关键词可以为玩家名、行为名、行为实施者名、被实施行为的对象名，其中行为名共以下几种：交互、破坏、攻击、放置；被实施行为的对象名除了以下类型为中文值，其余皆为游戏中的ID：箱子、陷阱箱、潜影盒、末影箱、木桶、漏斗、发射器、投掷器、熔炉、高炉。

使用/ban 命令将一名玩家加入黑名单格式:

1. /ban 玩家名 理由(选填)

复制代码

使用/unban 命令将一名玩家移出黑名单 格式:

1. /unban 玩家名

复制代码

使用/banlist命令列出所有被加入黑名单的玩家名

1. /banlist

复制代码

使用/banid 命令将一名玩家的设备加入黑名单(当目标玩家设备在线时添加黑名单无法直接踢出，请使用其它方法踢出该玩家) 格式:

1. /banid 设备ID

复制代码

使用/unbanid 命令将一名玩家的设备移出黑名单 格式:

/unban 设备ID

使用/banlist 命令列出所有被加入黑名单的玩家的设备ID

1. /banlist

复制代码

 endstone_tianyan-1.1.6-py2.py3-none-any.whl (26.53 KB, 下载次数: 46)

2025-1-26 10:47 上传

点击文件名下载附件

感谢分享