ZLDiscord Documentation

Introduction

ZLDiscord is a versatile plugin for your Minecraft server, providing advanced features including a voting system, integration with placeholders for voice chats, and custom message creation. This plugin is designed to simplify and automate server management.

Installation

To install the plugin, follow these steps:

  1. Download the latest version of the plugin from the official page.
  2. Place the ZoLiryzik.jar file into your server's /plugins/ folder.
  3. Restart or reload your server (using the /reload).
  4. After restarting, configuration files will be generated in the /plugins/ZoLiryzik/ folder.

In-Game Commands

The plugin provides the following commands for administrators and players in-game:

  • /zevent "title" "command" "time" "channel_id" — creates a new poll. (requires administrator privileges).
  • /zembed "Unique Name" "Title" "Description" "Channel ID" "Image URL" "Thumbnail URL" "Footer Text" "Footer Icon URL" — creates a new embed message. (requires administrator privileges).
  • /zembedmanage "action" "unique_name" "new_value" — edits an embed message. (requires administrator privileges).
  • /zlink — links your Minecraft account to Discord.
  • /zunlink— unlinks your Minecraft account from Discord.

Discord Commands

The plugin provides the following commands for administrators and players on the Discord server:

  • /zevent — creates a new poll. (requires administrator privileges).
  • !embed — creates an embed message in Discord. (requires administrator privileges).
  • /link < code > — links your Minecraft account to Discord. (in the bot's private messages)
  • /unlink — unlinks your Minecraft account from Discord.

Placeholders (PlaceholderAPI)

ZLDiscord integrates with PlaceholderAPI to display voice chat status. Ensure you have PlaceholderAPI installed.

Available placeholders:

  • %zoliryzik_in_vc% — returns "In Voice Chat", "Not in Voice Chat", and "Not Linked".

Configuration

The main configuration file is located at /plugins/ZoLiryzik/config.yml. You can configure messages, permissions, and other parameters.

Example config.yml file:

Loading...

Usage Examples

Create a poll for an event

To create a poll for an event, simply enter the following in the chat:

/zevent "Ship Siege" "boat run" "20m" "0000000000000000000"

Players will be able to vote in the specified Discord channel.

Create an embed message in Discord

To create an embed message in Discord, simply enter the following in the chat:

/zembed "Ship Siege" "Ship Siege" "The Ship Siege event is underway\nCoords X: 0 Y: 0" "0000000000000000000"

Players will be able to see this message in the specified Discord channel.