| Description |
ArLinking is a premium Discord-Minecraft account linking solution built for modern Paper, Folia, and Velocity networks. Using a secure OAuth2 verification flow, ArLinking allows players to safely connect their Discord accounts while providing advanced risk analysis, blacklist detection, and staff intelligence tools.Designed for Lifesteal, SMP, Practice, KitPvP, Factions, and large Minecraft networks, ArLinking helps server owners identify suspicious users before they become a problem.
Features Include:
Secure OAuth2 Discord Verification
Advanced Risk Detection Engine
Blacklisted Discord Server Scanning
Risk Scoring & Threat Analysis
Staff Alerts via Discord Webhooks
AES-256 Encrypted Data Storage
Fully Async & Performance Optimized
SQLite & MySQL Support
Cross-Server & Network Ready
PlaceholderAPI Integration
Fully Configurable Messages & Settings
Detailed Linking StatisticsBuilt for servers that want more than simple account verification. ArLinking combines secure Discord authentication, intelligent risk detection, and professional moderation tools into one lightweight and powerful solution.
| Plugin Information |
➔ Secure OAuth2 Discord account linking
➔ Advanced Discord risk detection engine
➔ Blacklisted Discord server scanning
➔ Detects users in configured flagged communities
➔ Intelligent risk scoring system
➔ Real-time staff webhook notifications
➔ Secure AES-256 encrypted data storage
➔ SQLite & MySQL database support
➔ Cross-server network compatibility
➔ PlaceholderAPI integration included
➔ Detailed player link information
➔ Discord account age tracking
➔ Linked account history & records
➔ Fully async architecture
➔ Lightweight & optimized performance
➔ Customizable messages & web pages
➔ Built-in OAuth2 web server
➔ Secure token handling system
➔ Staff investigation & moderation tools
➔ Fully configurable risk thresholds
➔ Supports Paper, Purpur & Folia
➔ Velocity network support
➔ Compatible with Minecraft 1.20+ / 1.21+
➔ Modern verification experience
➔ Advanced anti-alt & intelligence tools
➔ Built for Lifesteal, SMP, Practice, KitPvP & large Minecraft networks
| Placeholders |
| Placeholder | Description |
|---|---|
| %arlinking_linked% | Returns whether the player has linked a Discord account |
| %arlinking_discord_name% | Returns the linked Discord username |
| %arlinking_discord_id% | Returns the linked Discord account ID |
| %arlinking_risk_score% | Returns the player’s calculated risk score |
| %arlinking_risk_level% | Returns the player’s risk level (LOW, MEDIUM, HIGH, SEVERE) |
| %arlinking_flagged_guilds% | Returns the number of flagged Discord servers detected |
| %arlinking_account_age% | Returns the age of the linked Discord account |
| %arlinking_linked_since% | Returns when the Discord account was linked |
| %arlinking_is_flagged% | Returns whether the account is flagged |
| %arlinking_link_status% | Returns a formatted linked/unlinked status |
| %arlinking_discord_tag% | Returns the player’s Discord tag |
| %arlinking_blacklist_matches% | Returns the number of blacklist matches |
| %arlinking_last_scan% | Returns the timestamp of the latest risk scan |
| %arlinking_risk_reasons% | Returns the reasons contributing to the risk score |
| Commands |
| Command | Description | Permission |
|---|---|---|
| /link | Opens the Discord linking process and generates a secure OAuth2 verification link | arlinking.use |
| /unlink | Unlinks your currently linked Discord account | arlinking.use |
| /arlink status <player> | View a player’s Discord linking information and risk status | arlinking.admin |
| /arlink forceunlink <player> | Forcefully unlink a player’s Discord account | arlinking.admin |
| /arlink relink <player> | Reset a player’s link and allow them to verify again | arlinking.admin |
| /arlink lookup <player> | View detailed Discord account information for a player | arlinking.admin |
| /arlink scan <player> | Manually run a risk scan on a linked account | arlinking.admin |
| /arlink stats | View plugin statistics and linking metrics | arlinking.admin |
| /arlink reload | Reload all plugin configuration files | arlinking.admin |
| /arlink purge | Remove expired sessions and unused link data | arlinking.admin |
| /arlink help | Displays all available commands | arlinking.admin |
|
Installation |Step 1 — Install the Plugin
1. Download the ArLinking JAR file.
2. Place the JAR into your server's /plugins/ folder.
3. Restart your server.
4. A new folder called ArLinking will automatically be generated inside your plugins directory.
Step 2 — Configure Your Bot
1. Navigate to:
plugins/ArLinking/config.yml
2. Open config.yml.
3. Paste your Discord Bot Token into the appropriate configuration field.
4. Save the file.
At this point, your Discord bot connection is configured.
Don't have a Discord bot yet? Check out the bot creation guide:
|
OAuth2 Setup Guide |Step 1 — Create an Additional Port
Create an additional port on your hosting provider or server panel.
Example:
| 25556 |
Step 2 — Create a Discord Application
1. Open the Discord Developer Portal.
2. Create a new application.
3. Navigate to the OAuth2 section.
Copy the following values:
- Client ID
- Client Secret
Step 3 — Configure Redirect URL
Under OAuth2 → Redirects click Add Redirect.
Use the following format:
http://YOUR_DOMAIN_OR_IP ORT/callback |
Examples:
After entering your redirect URL:
1. Click Save Changes.
2. Verify the redirect appears in your Redirect List.
Step 4 — Configure OAuth2 Scopes
Navigate to:
OAuth2 → URL Generator
Enable the following scopes:
identify guildsScroll down to Select Redirect URL and choose the redirect URL you created earlier.
No additional settings are required.
Step 5 — Configure ArLinking
Return to your server.
Open:
plugins/ArLinking/config.yml
Configure the OAuth section:
yaml oauth:
enabled: true
host: 0.0.0.0
port: 25556
public-url: "http://example.fun:25556"
client-id: "YOUR_CLIENT_ID"
client-secret: "YOUR_CLIENT_SECRET"
Replace the example values with your own information.
Save the file.
Step 6 — Restart the Server
Restart your Minecraft server.
ArLinking will now:
Start the OAuth2 web server Connect to Discord Generate secure verification links Allow players to link their Discord accounts Perform risk analysis and server checks
Finished!Your ArLinking installation is now complete.
Players can begin linking their Discord accounts using:
| /link |
Blacklisted Guild Detection Example
Example of the alert generated when a linked Discord account is detected in a configured blacklisted Discord server.
© 2026 Aurex Studios . All rights reserved.
