ZLDiscord is a universal plugin for Minecraft servers that provides advanced features, including a voting system, custom commands with template engine, Discord embeds, data storage, LongPoll connections, and integration with placeholders for voice chats. This plugin is designed to simplify and automate server management.
Version: 1.16.5 - 1.21.x
Minimum Java: 17
Mandatory dependencies:
PlaceholderAPI
Development:
ZLDiscord
Commands in the game:
The plugin provides the following commands for administrators and players in the game:
- /zevent "title" "command" "time" "channel_id" — Creates a new poll. (zoliryzik.zevent)
- /zcc list/run/create/remove/reload <name> — Manage custom commands with template engine. (zoliryzik.zcc)
- /zembed "name" "title" "description" "channel_id" [image] [thumbnail] [footer] [icon] — Creates an embed in Discord. (zoliryzik.zembed)
- /zattr get/set/inc/dec bot|member|player <key> [value] — DataStore attributes. (zoliryzik.zattr)
- /zlongpoll create/list/remove/reload <name> <url> <key> [wait] — LongPoll connections with auto-reconnect. (zoliryzik.zlongpoll)
- /zlink — Link your account to Discord.
- /zunlink — Unlink your account from Discord.
Commands in Discord:
The plugin provides the following commands for administrators and players on the Discord server:
- /zevent — Creates a new poll. (Admin roles required).
- /zcc <name> — Run a custom command from Discord.
- !embed — Creates an Embed message in Discord. (Admin roles required)
- /link <code> — Link your account to Discord. (Bot DMs)
- /unlink — Unlink your account from Discord.
Permisheny:
zoliryzik.use
zoliryzik.zlink
zoliryzik.zunlink
zoliryzik.zembed
zoliryzik.zembed_manage
zoliryzik.zcc
zoliryzik.zattr
zoliryzik.zlongpoll
zoliryzik.zevent
Placeholders (PlaceholderAPI)
ZLDiscord integrates with PlaceholderAPI to display voice chat status. Make sure you have PlaceholderAPI installed.
Available placeholders:
- %zoliryzik_in_vc% — Returns "In voice chat", "Not in voice chat" or "Not linked" based on the linked Discord member's voice status.
- %zoliryzik_attr_member_<key>% — Returns a DataStore attribute for the linked Discord member.
- %zoliryzik_attr_player_<key>% — Returns a DataStore attribute for the player.
- %zoliryzik_attr_bot_<key>% — Returns a DataStore attribute for the bot.
Examples of use
Create a poll for an event:
To create a poll for an event, simply type the following into the chat:
- /zevent "Siege of the ship" "boat run" "20m" "0000000000000000000"
Players will be able to vote in the Discord channel you specified.
Create an embed message in Discord:
To create an embed message in Discord, simply type the following into the chat:
- /zembed "Siege of the ship" "Siege of the ship" "The Siege of the Ship event is underway\nCords X: 0 Y: 0" "0000000000000000000"
Players will be able to see this message in the Discord channel you specified.
Create a custom command:
- /zcc create heal "<do mc.command('effect give ' + _player_name + ' regeneration 10 5')><do mc.broadcast('&a' + _player_name + ' has been healed!')>
Then run: /zcc run heal and /heal — heals the player and broadcasts a message.