M0-CoreCord

Discord integration for the famous Anti-Griefing plugin CoreProtect.

FEATURES

• Lookups for player issued commands; • Lookups for player messages; • Lookups for log ins and log outs; • Lookups for player placed and destroyed blocks; • Lookups for items taken and placed into containers; • Lookups for dropped and picked up items; • Block whitelist using b: for a:block lookups; • PlaceholderAPI support for certain messages; • Customizable Discord BOT prefix; • MySQL & SQLite support; • Customizable date format; • Customizable discord message output; • Customizable allowed roles to use the commands; • Customizable messages, embed; • Output results into a log file; • Action logging via webhooks;

ABOUT

DISCORD COMMAND USAGE

`co!lookup u:username a:command t:time` `co!lookup user:username action:command time:time`

Time variable can be defined as: unseparated: `time:2h30m`, `t:1m16s`, etc. comma separated: `time:1d,30m` `t:2h,30m,10s`, etc.

Currently only supports one user lookup at a time.

ADDITIONAL FEATURES

LOOKUP COMMAND FILTER

You can filter issued commands and other results using `f:` or `filter:` flag: Usage: `co!lookup u:M0dii a:command f:gmc,gmsp t:24h`

REVERSE RESULTS

You can reverse the lookup results using `-r` or `-reverse` at the end of command: Usage: `co!lookup u:M0dii a:command t:24h -reverse`

You can reload the configuration with: `co!reload` - in discord. `/corecord reload` - in game.

You can check plugin and server version with: `co!version` - in discord. `/corecord version` - in game.

LOG FILE

You can upload results into a log file instead of an embed using `-f` or `-file` flag: Usage: `co!lookup u:M0dii a:command t:24h -f`

FEATURES TO BE IMPLEMENTED:

Block excludes (e:<exclude>) Radius rollbacks from specific XYZ coordinates; Player interactions (button clicks, etc.); Mob kills; Sign messages; Rollbacks;

To create a discord bot head to Discord Developer Portal at https://discord.com/developers, log in with your account and create a new application.

After, go to its settings menu and add a bot user, here you will also find the token that has to be put in the config.

From there you can go to OAUTH section and invite your bot to your discord server.

For more information and more detailed process, go to the wiki page on github: Discord BOT · M0diis/M0-CoreCord Wiki

CONFIGURATION

Configuration is pretty simple and easy to understand. For more detailed explanation, visit Github wiki page: Configuration · M0diis/M0-CoreCord Wiki (github.com)

```yml

MySQL Configuration

Make sure the values are the exact same

as in your CoreProtect config.

By default table prefix is co_

You can also use SQLite, but I strongly recommend

using MySQL instead.

use-mysql: true mysql-host: "host-name" mysql-port: 3306 mysql-database: "database-name" mysql-username: "database-user"

Leave '' if password not required

mysql-password: "user-password"

Discord BOT Token

https://discord.com/developers/applications

discord-bot-token: "your-token" command-prefix: "co!"

Embed configuration

Embed page buttons use unicode symbols

Leave them as it is if you don't know what you're doing

Do not use high values for rows in one page

Date format uses Java SimpleDataFormat

https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

date-format: "yyyy-MM-dd HH:mm:ss"

Whether to delete the embed when close button pressed

If false, it will only hide the buttons.

delete-on-close: false embed-page-left: '⬅️' embed-page-right: '➡️' embed-close: '❌' rows-in-page: 5

Whether to always show number of results in embed description

without need to #count

always-show-count: true

Role IDs that are allowed to use the commands

You have to have developer mode enabled on discord

To get the ID right click on the role and copy

allowed-roles: - 'role-one-id' - 'role-two-id'

Debugging

Only enable if you need to find out what's wrong

Sends a lot of extra messages to the console

debug: false

webhook-loggers: 1: url: 'webhook-url-goes-here' actions: - '+block' # Place a block (+block, place) - '-block' # Break a block (-block, break)

- '+item' # Item pickup (+item, pickup, pickupitem)

- '-item' # Item drop (-item, drop, dropitem)

- '-session' # Player join (-session, quit, playerquit)

- '+session' # Player quit (+session, join, playerjoin)

- 'container' # Open a container

- 'chat' # Message send

- 'command' # Command execution

- 'kill' # Monster/animal kill (kill, mobkill)

```

Please leave a positive review if the plugin works as intended, if you have an issue contact me on discord provided or open an issue on github.

METRICS

M0-CoreCord collects anonymous server statistics through bStats, an open-source statistics service for Minecraft software. If you'd like to disable metrics collection via bStats, you can edit the /plugins/bStats/config.yml file.