Solifex Studios
DiscordSynthesisWiki
Browse the wiki

Features

Authorization

Gate entry behind Discord roles, with penalties, trusted IPs, and login alerts.

Module

modules.authorization

Config

features.authorization

Platform

All (AuthMe: Spigot)

Require players to hold (or not hold) certain Discord roles before they can play. Unauthorized players can be held with potion effects until they pass.

Role requirements

yamlfeatures.yml
authorization:
  requiredRoles:
    - '123456789012345678'
  # ALL = need every role · ANY = need at least one · NONE
  requirementType: ANY
  blackListedRoles: []

Holding unauthorized players

yamlfeatures.yml
authorization:
  applyEffects: true
  potionEffects:
    - BLINDNESS
  # Deny join if someone with the same name is already online
  denyJoinIfAlreadyOn: true

Trusted IPs

Once a player authorizes via Discord, remember their IP so future logins from it skip the challenge. Trusted IPs are revoked automatically when the player's Discord roles change.

yamlfeatures.yml
authorization:
  trustedIpEnabled: false
  trustedIpDurationDays: 30    # 0 = never expires

Login notifications & AuthMe

loginNotificationEnableddefault: false
DM the linked Discord account on every login — a lightweight security alert.
authMeAutoLogindefault: false
Spigot only. Auto-logs-in players already linked to Discord, skipping the AuthMe password prompt. Only enable on offline/cracked servers that trust the Discord link as identity.