SimpleEventLogger

A lightweight MySQL audit logger for BungeeCord networks with durable event replay and optional ping logging.

1 downloads

SimpleEventLogger

SimpleEventLogger is a lightweight audit-log plugin for BungeeCord networks. It records proxy joins, quits, and backend-server switches in MySQL. Events are first written to a durable local journal and are replayed automatically after a database outage, helping preserve the audit trail.

Features

  • MySQL event log for joins, quits, and server switches
  • Stores player UUID, username, raw client IP address, proxy address, source server, and destination server
  • Optional server-list ping log in a separate table (log-pings: true)
  • Configurable database connection, table names, retry settings, and SSL settings
  • SSL is disabled by default for straightforward local/Docker setups

Requirements and installation

  • BungeeCord-compatible proxy
  • MySQL 8.0+ recommended
  • Copy the JAR into the proxy plugins folder, start once, then edit plugins/SimpleEventLogger/config.yml.

Privacy

This plugin can store raw IP addresses when players connect or ping the proxy. Tell your players how their data is collected and retained, and configure a retention policy appropriate for your server.


日本語

SimpleEventLogger は、BungeeCord ネットワーク向けの軽量な監査ログプラグインです。プロキシへの参加・退出・バックエンドサーバー間の移動を MySQL に記録します。イベントはまずローカルの耐久ジャーナルへ書き込まれ、MySQL 障害後には自動で再送されるため、監査ログを残しやすくなっています。

機能

  • 参加・退出・サーバー移動を MySQL に記録
  • UUID、ユーザー名、生IP、プロキシIP、移動元・移動先サーバーを保存
  • log-pings: true でサーバーリストへの ping を別テーブルに記録
  • 接続先、テーブル名、再試行、SSL を設定ファイルから変更可能
  • Docker/ローカル環境で扱いやすいよう SSL は初期設定で無効

導入

  1. JAR をプロキシの plugins フォルダへ入れます。
  2. 一度起動して plugins/SimpleEventLogger/config.yml を生成します。
  3. MySQL の接続情報を設定して、プロキシを再起動します。

プライバシー

このプラグインは、プレイヤーの接続時や ping 時に生IPを保存できます。サーバーのプライバシーポリシーで収集・保管を案内し、適切な保持期間を設定してください。

No gallery available for this project.