EventLoggerForIM

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 disable|disable the events you want to log.

Enable or disable the integrations

```yaml enableSlack: true|false enableDiscord: true|false ```

Enable or disable specific events:

```yaml 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 ```yaml

List of server.properties to log on server startup.

logServerProperties: - online-mode - pvp - difficulty - level-type ```

Configure the language for the interface: ```yaml

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.