DLAW

DLAW

Spigot plugin for Discord based whitelisting over a custom discord bot

> IMPORTANT !!! > You can request an AUTH TOKEN from me directly via the discord server https://discord.gg/pgmupvqvsm. The signup and management page is still very much beta. Auth Token lets you have /verify and /unverify commands working.

> ACCOUNT LINKING ISSUES? Please join support discord https://discord.gg/pgmupvqvsm and explain your issue! Most llikley is that you have lost access to the older discord account and still want to play on your server. I can unlink your accounts manually for now

Features

- Cloud synced account linking - Direct server integration (join, leave, death, advancements, player chat) - On death cords DM - Customisable colors for embeds - Player count in bot status - HTTP REST API (for web developers)

Discord Slash Commands

These are all the available discord commands:

- `/verify` Links a Minecraft Java account to a Discord account - `/unverify` Removes the existing account link - `/ip` Returns the server IP (from `config.yml`) - `/lookup` Allows you to find a Discord account from a Minecraft username - `/rcon` Executes a command on the server - `/seed` Returns the world seed - `/status` Displays current online players and server version

HTTP Endpoints

This feature is very useful for integration data and status from your minecraft server on your webpage. For general users this feature might not be needed

> The web server can be enabled or disabled in `config.yml` based on your needs

- `GET /api/status` Complete server status - `GET /api/status/players` Online player list - `GET /api/status/plugins` List of plugins - `GET /api/status/world` World information - `GET /api/players` List of all players who joined the server - `GET /api/players/<uuid>` Get player from server by UUID (useful for details page) - `GET /api/user/<uuid>` Discord account information from Minecraft account UUID - `GET /api/auth/<uuid>` Authenticate player (exposes same auth logic as when player joins the server itself for needs of other plugins/servers)

> Endpoint `/api/auth` exposes the same authentiticaion process during player login for use in other plugins or other servers. If you want to use this type of login auth on multiple servers but keep DLAW (ex. You have a test server or one in another region) you can use the plugin DasherLink via GitHub.

> If you develop an extension (ex. web page) or a custom plugin that uses DLAW please notify me on Discord for me to feature it here

Setup

Download the latest version from releases and put it in your plugins folder.

Make sure to start the minecraft server once, after so go to `/plugins/DLAW/config.yml` and edit the lines corresponding to your settings

In order to create a Discord Bot and get its token you need to go here. After creating the application also create the bot, copy the token to clipboard for later use in configs. Make sure to enable all privileged intentions like PRESENCE_UPDATE, GUILD_MEMBERS and MESSAGE_CONTENT. After that go and generate the invite url with scopes `bot` and `application.commands`. For permission, you can choose Administrator since it's your private bot

Configuration example

```yaml discord: token: token-goes-here guild: 553568657410883604 channel: chat: 1024426048932302878 role: join: enabled: true # Toggles if role auth is in use id: 553568657410883604 # Role ID of the required role to join the server staff: 707598912768442489 verified: 1221230313271853086 dm-death-cords: true include-global-bans: true api: enable: true port: 8010 minecraft: address: play.beocraft.net color: system: 65535 join: 65280 leave: 16711680 death: 16749128 advancement: 16751104 ```