Event Logger For IM (ELFIM)

ELFIM (pronounced "elf eye em") is a light-weight event logging plugin that posts selected events to Slack and Discord. It's a convienient way to keep track of who logged on when, or what commands they used while playing. (see below for complete list of events)

NOTE: Version 2.3.0 adds Internationalization support (with an included localized German properties file). I'd love for anyone fluent in other languages to contribute translations.

Usage

After starting the server with ELFIM-<version>.jar in the plugins folder, edit plugins/EventLoggerForIM/config.yml with the details of your configured webhook and enable|disable the events you want to log.

Enable or disable the integrations

enableSlack: true|false
enableDiscord: true|false

Enable or disable specific events:

events:
  logBroadcasts: true|false
  logChat: true|false
  logPlayerAdvancement: true|false
  logPlayerCommands: true|false
  logPlayerDeath: true|false
  logPlayerJoinLeave: true|false
  logPlayerRespawn: true|false
  logPlayerTeleport: true|false
  logServerCommand: true|false
  logServerStartStop: true|false
  logStartupPlugins: true|false
  logUnsuccessfulLogin: true|false

Log a custom set of server.properties

# List of server.properties to log on server startup.
logServerProperties:
  - online-mode
  - pvp
  - difficulty
  - level-type

Configure the language for the interface:

# Specify the locale to use for messages (NOTE: must have a corresponding locale file in the plugin config folder)
# example: ./plugins/EventLoggerForIM/i18n/en_US.properties or ./plugins/EventLoggerForIM/i18n/de.properties
locale: en_US

To add a new translation, duplicate en_US.properties and save it with a new locale-specific filename using UTF-8 encoding (e.g., ja_JP.properties), and update the values accordingly. Then, set locale: ja_JP in config.yml to enable your new translations to appear in generated messages.

If you would like your translation to be included in this project, please open an issue on GitHub and attach the translated file. I will review and integrate it as appropriate.

NOTE: The included de.properties file was generated using AI and may contain inaccuracies. Contributions from native German speakers to improve this translation are welcome and appreciated.

Slack Configuration and Examples

See the Slack readme.

Discord Configuration and Examples

See the Discord readme.

Support

If you encounter any issues or have any questions, please open an issue on GitHub.