Entity Logger
Entity Logger 是一款 Minecraft 服务器管理与日志插件,旨在帮助你追踪与实体、容器及其他支持对象的交互行为。
它记录玩家执行的重要操作,并允许管理员在游戏内直接快速搜索和检查日志。你可以使用它来调查可疑活动、查找谁与某个实体进行了交互、检查附近的动态,或审查特定玩家或目标的行为。
功能
- ? 详细的活动日志 — 记录玩家、操作、实体类型、世界、坐标、物品/材料、数量以及实体 UUID。
- ? 强大的日志搜索 — 支持按玩家、目标、时间、实体类型、物品、操作等条件进行搜索。
- ? 附近活动搜索 — 查找你当前位置周围记录的日志活动。
- ? 全局搜索 — 使用
radius:#global 在当前世界中搜索所有匹配的活动。
- ?️ 检查模式 — 启用检查模式后,右键点击支持的方块或实体即可查看其记录的日志活动。
- ? 分页显示 — 大型搜索结果会分页显示,并提供可点击的导航按钮。
- ?️ 交互式结果 — 玩家名称可点击以搜索其活动,坐标可点击以快速使用。
- ? 旁观者传送 — 处于旁观模式的玩家可点击日志中的坐标,直接传送到该位置。
- ⌨️ 自动补全 — 命令和过滤值提供自动建议。
记录的操作
Entity Logger 目前支持以下类型的操作:
ADD — 向实体/容器添加了物品。
REMOVE — 从实体/容器中移除了物品。
DAMAGE — 玩家对实体造成了伤害。
DEATH — 实体被杀死。
PLACE — 放置了支持的实体。
命令
/el near
搜索你当前位置附近的日志活动。
/el near radius:<number> [time:<time>] [include:<type>] [exclude:<type>] [user:<player>] [action:<action>] [page:<number>]
示例:
/el near radius:20
显示你当前位置 20 格范围内的日志活动。
你可以组合多个过滤器:
/el near radius:50 time:1h action:REMOVE
这将搜索过去一小时内 50 格范围内的物品移除活动。
全局搜索
使用 #global 代替数值半径以搜索整个当前世界:
/el near radius:#global
你可以将其与过滤器结合使用:
/el near radius:#global time:1d user:Steve
这将在当前世界的日志中搜索 Steve 在过去一天内执行的活动。
/el lookup
搜索与特定玩家或目标相关的日志。
按玩家搜索
/el lookup user:<player>
示例:
/el lookup user:Steve
你可以添加过滤器:
/el lookup user:Steve time:7d action:DAMAGE
这将显示 Steve 在过去 7 天内造成的与伤害相关的活动。
按目标搜索
/el lookup target:<entity>
示例:
/el lookup target:CHEST_BOAT
你还可以筛选结果:
/el lookup target:HORSE time:1h action:DAMAGE
在同一个 /el lookup 命令中不能同时使用 user: 和 target:。
过滤器
Entity Logger 支持多种过滤器,可以组合使用以缩小搜索结果范围。
时间
使用 time: 仅搜索最近的动态。
支持的单位:
s — 秒
m — 分钟
h — 小时
d — 天
示例:
time:30s
time:10m
time:1h
time:7d
包含 (Include)
仅显示匹配的实体类型或物品:
include:HORSE
include:DIAMOND
排除 (Exclude)
隐藏匹配的实体类型或物品:
exclude:HORSE
exclude:DIAMOND
操作 (Action)
按特定操作筛选:
action:ADD
action:REMOVE
action:DAMAGE
action:DEATH
action:PLACE
用户 (User)
按特定玩家执行的活动进行筛选:
user:Steve
目标 (Target)
搜索与特定支持的实体类型相关的活动:
target:HORSE
页码 (Page)
选择特定的结果页:
page:2
/el i
切换玩家的检查模式。
/el i
启用后,右键点击支持的方块或实体以检查其记录的日志活动。
再次运行 /el i 以禁用检查模式。
交互式日志结果
日志条目包含交互式元素,以便更轻松地进行调查。
点击玩家名称会建议执行 /el lookup user:<player> 命令,让你可以快速查看该玩家的活动。
坐标也是可点击的。在旁观模式下,点击坐标可以直接将你传送到记录的地点。此传送功能仅限于旁观模式使用。
权限
该插件为其命令使用独立的权限:
entlog.use
entlog.near
entlog.lookup
entlog.i
entlog.tpcoords
entlog.use 是使用主要 Entity Logger 命令所必需的,而各个子命令拥有各自的权限。
配置
Entity Logger 提供了用于控制内存中日志保留、搜索结果大小、最大 /el near 半径以及清理频率的配置选项。
示例:
memory-days: 14
check-page-size: 5
max-near-radius: 200
prune-interval-minutes: 60
配置选项
memory-days — 在内存中保留多少天的日志以供检查。磁盘上的日志文件不会被删除。
check-page-size — 每页显示的条目数量。
max-near-radius — /el near 允许的最大半径。
prune-interval-minutes — 多久清理一次旧的内存条目。
用例
Entity Logger 适用于:
- 服务器管理
- 调查玩家活动
- 跟踪容器交互
- 查找附近的实体活动
- 调查伤害和死亡事件
- 检查谁与特定目标进行了交互
- 审核和故障排除
Entity Logger 旨在简化服务器活动的排查过程,无需管理员手动搜索原始日志文件。
Entity Logger
Entity Logger is a Minecraft server administration and logging plugin designed to help you track interactions with entities, containers, and other supported objects.
It records important actions performed by players and allows administrators to quickly search and inspect the logs directly in-game. Use it to investigate suspicious activity, find who interacted with an entity, check nearby activity, or inspect a specific player or target.
Features
- ? Detailed activity logging — records the player, action, entity type, world, coordinates, item/material, amount, and entity UUID.
- ? Powerful log search — search by player, target, time, entity type, item, action, and more.
- ? Nearby activity search — find logged actions around your current location.
- ? Global search — search all matching activity in the current world with
radius:#global.
- ?️ Inspection mode — enable inspection mode and right-click a supported block or entity to view its logged activity.
- ? Pagination — large search results are split into pages with clickable navigation buttons.
- ?️ Interactive results — player names can be clicked to search their activity, and coordinates can be clicked to quickly use them.
- ? Spectator teleportation — players in Spectator mode can click logged coordinates to teleport directly to the location.
- ⌨️ Tab completion — commands and filter values provide automatic suggestions.
Logged Actions
Entity Logger currently supports the following action types:
ADD — an item was added to an entity/container.
REMOVE — an item was removed from an entity/container.
DAMAGE — a player dealt damage to an entity.
DEATH — an entity was killed.
PLACE — a supported entity was placed.
Commands
/el near
Search for logged activity near your current location.
/el near radius:<number> [time:<time>] [include:<type>] [exclude:<type>] [user:<player>] [action:<action>] [page:<number>]
Example:
/el near radius:20
Shows logged activity within 20 blocks of your current location.
You can combine multiple filters:
/el near radius:50 time:1h action:REMOVE
This searches for item removal activity within 50 blocks from the last hour.
Global Search
Use #global instead of a numerical radius to search the entire current world:
/el near radius:#global
You can combine it with filters:
/el near radius:#global time:1d user:Steve
This searches the current world's logs for activity performed by Steve during the last day.
/el lookup
Search logs associated with a specific player or target.
Search by player
/el lookup user:<player>
Example:
/el lookup user:Steve
You can add filters:
/el lookup user:Steve time:7d action:DAMAGE
This shows damage-related activity performed by Steve during the last 7 days.
Search by target
/el lookup target:<entity>
Example:
/el lookup target:CHEST_BOAT
You can also filter the results:
/el lookup target:HORSE time:1h action:DAMAGE
user: and target: cannot be used together in the same /el lookup command.
Filters
Entity Logger supports several filters that can be combined to narrow down search results.
Time
Use time: to search only recent activity.
Supported units:
s — seconds
m — minutes
h — hours
d — days
Examples:
time:30s
time:10m
time:1h
time:7d
Include
Only show matching entity types or items:
include:HORSE
include:DIAMOND
Exclude
Hide matching entity types or items:
exclude:HORSE
exclude:DIAMOND
Action
Filter by a specific action:
action:ADD
action:REMOVE
action:DAMAGE
action:DEATH
action:PLACE
User
Filter activity performed by a specific player:
user:Steve
Target
Search activity related to a specific supported entity type:
target:HORSE
Page
Select a specific results page:
page:2
/el i
Toggles Inspection Mode for the player.
/el i
When enabled, right-click a supported block or entity to inspect its logged activity.
Run /el i again to disable Inspection Mode.
Interactive Log Results
Log entries contain interactive elements to make investigation easier.
Clicking a player name suggests an /el lookup user:<player> command, allowing you to quickly view that player's activity.
Coordinates are also clickable. In Spectator mode, clicking coordinates can teleport you directly to the logged location. This teleport feature is restricted to Spectator mode.
Permissions
The plugin uses separate permissions for its commands:
entlog.use
entlog.near
entlog.lookup
entlog.i
entlog.tpcoords
entlog.use is required to use the main Entity Logger commands, while individual subcommands have their own permissions.
Configuration
Entity Logger provides configuration options for controlling in-memory log retention, search result size, the maximum /el near radius, and cleanup frequency.
Example:
memory-days: 14
check-page-size: 5
max-near-radius: 200
prune-interval-minutes: 60
Configuration options
memory-days — how many days of logs are kept in memory for checking. Log files on disk are not deleted.
check-page-size — number of entries displayed per page.
max-near-radius — maximum radius allowed for /el near.
prune-interval-minutes — how often old in-memory entries are cleaned up.
Use Cases
Entity Logger is useful for:
- Server administration
- Investigating player activity
- Tracking container interactions
- Finding nearby entity activity
- Investigating damage and deaths
- Checking who interacted with a specific target
- Moderation and troubleshooting
Entity Logger is designed to make server activity easier to investigate without requiring administrators to manually search through raw log files.
评论 0
登录后参与评分
还没有评论,来抢沙发吧