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

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