Перейти к содержимому
Mineforgian

ModLogs Plugin

A server-side plugin that works with ModLog Mod to verify player mods, resource packs, and client versions, helping administrators monitor and prevent cheating.

Загрузки
312
Подписчики
1
Обновлён
23 июня 2026 г.
Лицензия
MIT

Опубликован 8 февраля 2026 г.

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.

Resource Link
ModLog Mod https://modrinth.com/mod/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

Ченджлог

26.3.7Релиз1.21.9, 1.21.10, 1.21.11 · 7 марта 2026 г.

Fix issues

26.2.21Релиз1.21.9, 1.21.10, 1.21.11 · 21 февраля 2026 г.

Version Changelog (Modrinth)

v26.2.11

  • Reworked config.yml to support per-event Discord channels.
  • Added channelid for:
    • notifications.join
    • notifications.resourcepack-change
    • notifications.freecam
  • Added per-event Discord toggles with discord-enabled.
  • Added notifications.freecam.discord-types (all, start, stop).
  • Improved config upgrade system:
    • Automatically adds new config keys
    • Preserves existing server-edited values
    • Preserves config comments/explanations during updates
  • Improved Discord webhook system for multi-channel setups:
    • Webhook handling now works per channel
    • Better webhook cache behavior
  • Added compatibility fallback:
    • discord.channel-id still works
    • Supports both channelid and channel-id formats
  • Expanded config.yml with additional useful options (including viewer settings).
26.2.11Релиз1.21.9, 1.21.10, 1.21.11 · 12 февраля 2026 г.

Fixed: Incorrect Spawn Teleport on Rejoin

This release fixes a bug where some players were returned to the server spawn instead of their previous position after leaving and rejoining, or after a server restart.

What changed

  • Improved last-location restore logic for restricted players.
  • Added persistent storage for return locations across restarts.
  • Updated fallback behavior to avoid forcing spawn teleport unless a player is actually stuck in the restricted holding world.

Result

Players now return to their correct last location reliably instead of being unexpectedly teleported to spawn.

Комментарии

Загружаем…