TDR Discord Event Sync is a plugin that creates the link between your Discord server and your ingame Minecraft server. This plugin makes sure that you can link the events in your Discord server to ingame information about these events.
You can create holograms for an overview of your server events, your players can get information about these events by using different commands and it is the easiest way to connect your Minecraft server to one of your platforms.
If you have any issues, please read the GitHub Wiki page and if you use this plugin, please leave a review.
Put the plugin in your plugins directory and reboot your server. This will create a plugin folder with two configuration files, config.yml and discord.yml. In the discord.yml you fill in your discord server’s guild identifier, bot code and optional, your discord invite url.
If you are not familiar with discord bot code and/or guild identifiers follow the instructions “Create an Application on Discord”, “Authorize your Bot”, “Find your Guild ID (Server ID)” on https://poshbot.readthedocs.io/en/latest/guides/backends/setup-discord-backend/
With the config.yml you can customize the date format which will be used by placeholderAPI and messages in the chat. The default setting is dd-MM-yyyy (19-02-2022).
As already said this plugin creates a link between your Discord server and your Minecraft server. The first section gives you the commands you can use when using this plugin.
Discord Event Sync commands
- /discordevent : shows all of the commands of this plugin
- /discordevent help : shows all of the commands of this plugin
- /discordevent list : see all of the planned events on the Discord server
- /discordevent info <discordevent> : gives more information about the event
- /discordevent create <name> <date> <time> <place> : create a event ingame
- /discordevent reload : reloads all of the Discord events
- /discordevent sethologram <name> <type>: Set a hologram you can use the types NEXT COMMING_UP
- /discordevent removehologram <name> : Remove a hologram
- /discord : Gives the discord invite url in chat
To make sure the right commands can be used by the right players, the plugin uses a few different permissions. There are different permissions you can set when using this plugin.
Discord Event Sync permissions
- /discordevent : discordeventsync.command.discordevent
- /discordevent help : discordeventsync.command.discordevent.help
- /discordevent info : discordeventsync.command.discordevent.info
- /discordevent create : discordeventsync.command.discordevent.create
- /discordevent list : discordeventsync.command.discordevent.list
- /discordevent reload : discordeventsync.command.discordevent.reload
- /discordevent sethologram : discordeventsync.command.discordevent.sethologram
- /discordevent removehologram: discordeventsync.command.discordevent.removehologram
- /discord : discordeventsync.command.discord
TDR Discord Event Sync also gives you access to the collected data so you can use it with other plugins. So this plugin is an expansion to the PlaceHolderApi. You can use the following placeholders:
- %discordeventsync_count% : Amount of events
- %discordeventsync_invite_url% : Configured discord invite url
- %discordeventsync_next_event_name% : Name of next up event
- %discordeventsync_next_event_description% : Description of next up event
- %discordeventsync_next_event_date% : Start date of next up event
- %discordeventsync_next_event_count% : Amount of discord users who clicked the interested button
- %discordeventsync_cycle_event_name% : Name of the current selected event
- %discordeventsync_cycle_event_description% : Description of the current selected event
- %discordeventsync_cycle_event_date% : Start date of the current selected event
- %discordeventsync_cycle_event_count% : Amount of discord users who clicked the interested button of the current selected event
It is possible to place a hologram with the plugin with information about the events.
The hologram types are NEXT_EVENT and COMING_EVENTS, NEXT_EVENT shows the next event and COMING_EVENTS changes the scheduled event every minute.
It is possible to adjust the layout of the holograms in the config.yaml the following placeholders are possible.
- {EVENT_NAME} : The name of the event
- {EVENT_LOCATION}: The location of the event
- {EVENT_START_TIME}: The start time of the event
- {EVENT_END_TIME}: The end time of the event
- {EVENT_DATE}: The date of the event
