Screenshot 1 of 1. MinecraftHub-generated cover art for DiSky: a floating grassy block island with server racks, under a sunset sky
What DiSky works with.
| Platform | Java Edition |
|---|---|
| Loaders | Paper, Purpur, Spigot |
| Minecraft versions | 1.8, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.6, 1.21.11, 26.1.2 |
DiSky is a Skript addon that lets a Minecraft server run Discord bots written in Skript. The disky plugin turns plain scripts into slash commands, embeds and event handlers. It is needed on the server only, and players join with a normal client.
Server software and versions
- Paper and Purpur: Minecraft 1.8 to 26.1.2. The newest build needs no dependencies.
- Spigot: Minecraft 1.12 to 26.1.2. The newest build needs no dependencies.
- Bukkit: Minecraft 1.13 to 1.21.5, builds stopped after April 2025. The newest build needs no dependencies.
- Folia: Minecraft 1.8 to 1.20.4, builds stopped after August 2023. The newest build needs no dependencies.
What DiSky adds
DiSky is built on JDA, and it aims to expose anything a JDA bot can do as Skript syntax. Scripts stay short, so server owners can skip traditional programming.
- Bot creation and login from a script, using a bot token from the Discord Developer Portal.
- Slash commands declared in the script and sent to Discord explicitly.
- Rich embeds with titles, fields, colours and footers.
- Event handling, such as message receive and guild ready, to bridge Minecraft and Discord.
- Voice channel management, audio playback and webhook support.
Installation
- 1.Install Skript on the server first. DiSky does nothing without it.
- 2.Put the DiSky file in the plugins folder, next to Skript. The steps in how to install plugins apply.
- 3.Restart the server.
- 4.Create a bot token in the Discord Developer Portal, place it in a .sk script under plugins/Skript/scripts, and reload that script with /sk reload.
DiSky has no config file. At each boot it writes plugins/DiSky/disky-syntax.json, a list of every syntax it registered, and you do not need to edit it.
How to make a Discord bot with DiSky
Questions about DiSky.
3 questions
What is the DiSky plugin?
DiSky is a Skript addon for writing Discord bots on your Minecraft server. It is built on JDA and exposes Discord features such as slash commands, embeds, components, webhooks and events as Skript syntax, so you script a bot instead of programming one.
Does DiSky work without Skript?
No. DiSky is an addon, so Skript must be installed in the plugins folder beside it. Without Skript there is nothing to read your bot scripts, and the Discord syntax will not be available.
Do players need to install DiSky?
No. DiSky is server-side only and the client is unsupported. Players join with a normal client, and the bot talks to Discord from the server.
![A scene under a blue sky with a floating dark block and a cow-like mob, with a chat line reading /execute as @e[type=cow] run, shown with CommandAPI.](https://minecrafthub.b-cdn.net/media/resources/plugins/commandapi/cover/commandapi-cover-1585x809.avif)
