ModLogs 插件
面向 Minecraft 服务器的服务端验证与监控插件。
? 简介
| 项目 |
描述 |
| 类型 |
服务端插件 |
| 用途 |
客户端验证、管理 & 日志记录 |
| 配套 |
ModLog Mod(客户端模组) |
| 版本 |
Java 版(兼容 Paper / Spigot) |
| 基岩版 |
自动忽略(Geyser/Floodgate) |
| 账号模式 |
离线模式 & 在线模式 |
? 概览
ModLog Plugin 是一款服务端管理与验证插件,它接收来自 ModLog Mod 的客户端环境数据,并用于日志记录、监控及反作弊目的。
该插件允许服务器管理员:
- 检查玩家的模组和资源包使用情况
- 实时监控客户端变化
- 执行服务器加入规则
- 接收游戏内通知或通过 Discord Webhook 发送通知
该插件不修改游戏玩法,并在后台独立运行。
? 所需的客户端模组
此插件要求玩家使用 ModLog Mod。
服务器可以拒绝那些尝试在缺少所需模组的情况下加入的 Java 版玩家访问。
? 接收的客户端数据
该插件处理由客户端模组发送的以下信息:
| 数据 |
描述 |
| 用户名 |
玩家名称 |
| 模组 |
已加载的客户端模组列表 |
| 资源包 |
启用 & 禁用的资源包 |
| 版本 |
Minecraft 客户端版本 |
不会收集任何个人数据或系统级数据。
? 服务端强制策略与行为
| 功能 |
行为 |
| 加入验证 |
玩家加入时检查其数据 |
| 缺少模组 |
玩家可能会被阻止加入 |
| 变更追踪 |
检测资源包的变化 |
| 通知 |
支持游戏内 & Discord |
该系统有助于检测:
- 通过可疑资源包实现的 X-Ray
- 未经授权的客户端模组
- 被篡改的客户端环境
- 版本不匹配
⚙️ 配置
该插件完全可通过单个 YAML 配置文件进行配置。
? 完整配置
discord:
# 所有 Discord webhook 通知的主开关
enabled: false
# 用于在目标频道创建/验证 webhooks 的机器人令牌
bot-token: ""
# 任何未定义自己频道的备用事件频道
# 建议为每个事件配置 channelid 时将其留空
channel-id: ""
notifications:
join:
# 游戏内管理员通知开关
enabled: true
# 支持的值:all, mods, resourcepack_all, resourcepack_enabled, resourcepack_disabled, version
# 可以使用字符串 ("all") 或 yaml 列表
types: "all"
# Discord 控制选项
discord-enabled: true
channelid: ""
resourcepack-change:
# 游戏内管理员通知开关
enabled: true
# 支持的值:all, show-enabled, show-disabled
# 可以使用字符串 ("all") 或 yaml 列表
types: "all"
# Discord 控制选项
discord-enabled: true
channelid: ""
freecam:
# 游戏内管理员通知开关
enabled: true
# 启用后,拥有 modlogs.notify 权限的管理员可以看到活跃自由视角用户的实时浮动标记
admin-view: true
# Discord 控制选项
discord-enabled: true
# 支持的值:all, start, stop
discord-types: "all"
channelid: ""
viewer:
# 如果为 true,则 /modlog show 命令仅对在线目标生效
require-online-player: false
# 在 /modlog show 输出中显示上次快照的时间间隔
show-last-update: true
ModLogs Plugin
Server-side verification and monitoring plugin for Minecraft servers.
? Summary
| Item |
Description |
| Type |
Server-side plugin |
| Purpose |
Client verification, moderation & logging |
| Works With |
ModLog Mod (client-side) |
| Edition |
Java Edition (Paper / Spigot compatible) |
| Bedrock |
Ignored automatically (Geyser/Floodgate) |
| Accounts |
Offline & Online |
? Overview
ModLog Plugin is a server-side moderation and verification plugin that receives client environment data from ModLog Mod and processes it for logging, monitoring, and anti-cheat purposes.
The plugin allows server administrators to:
- Inspect player mods and resource packs
- Monitor client-side changes in real time
- Enforce server join rules
- Receive notifications in-game or via Discord webhooks
The plugin does not modify gameplay and runs independently in the background.
? Required Client Mod
This plugin requires players to use ModLog Mod.
Servers may deny access to Java players who attempt to join without the required mod.
? Received Client Data
The plugin processes the following information sent by the client mod:
| Data |
Description |
| Username |
Player name |
| Mods |
List of loaded client mods |
| Resource Packs |
Enabled & disabled resource packs |
| Version |
Minecraft client version |
No personal or system-level data is collected.
? Server Enforcement & Behavior
| Feature |
Behavior |
| Join verification |
Player data checked on join |
| Missing mod |
Player may be blocked |
| Change tracking |
Resource pack changes detected |
| Notifications |
In-game & Discord supported |
This system helps detect:
- X-Ray via suspicious resource packs
- Unauthorized client mods
- Modified client environments
- Version mismatches
⚙️ Configuration
The plugin is fully configurable using a single YAML configuration file.
? Full Configuration
discord:
# master switch for all Discord webhook notifications
enabled: false
# bot token used to create/validate webhooks in target channels
bot-token: ""
# fallback channel for any event that does not define its own channel
# recommended to keep this empty when you configure channelid per event
channel-id: ""
notifications:
join:
# in-game admin notification switch
enabled: true
# supported: all, mods, resourcepack_all, resourcepack_enabled, resourcepack_disabled, version
# you can use either a string ("all") or a yaml list
types: "all"
# Discord controls
discord-enabled: true
channelid: ""
resourcepack-change:
# in-game admin notification switch
enabled: true
# supported: all, show-enabled, show-disabled
# you can use either a string ("all") or a yaml list
types: "all"
# Discord controls
discord-enabled: true
channelid: ""
freecam:
# in-game admin notification switch
enabled: true
# when enabled, admins with modlogs.notify can see a live floating marker for active freecam users
admin-view: true
# Discord controls
discord-enabled: true
# supported: all, start, stop
discord-types: "all"
channelid: ""
viewer:
# if true, /modlog show only works for online targets
require-online-player: false
# show how old the last snapshot is in /modlog show output
show-last-update: true
评论 0
登录后参与评分
还没有评论,来抢沙发吧