Linking System

depends on

Image Library

Works with

Server Panel

Notify

About Linking System

Introducing Linking System, the ultimate Discord integration plugin for your Rust server! Seamlessly connect your players Rust accounts with their Discord profiles, automatically assign roles, and reward linked players with exclusive perks. With a beautiful UI, complete Discord bot solution, and powerful automation features, Linking System is the perfect tool to enhance your community engagement and keep your Discord server active.

️ Features of Linking System

Complete Discord integration system with automatic role assignment for linked players, enhancing community engagement and server security.
Beautiful, customizable UI with ServerPanel V1 and V2 template support for seamless integration with your existing server interface.
Secure code generation system with configurable cooldown periods to prevent abuse while ensuring smooth linking process.
Automatic permission group assignment for linked players with customizable UI elements displaying potential benefits and server perks.
Complete Python Discord bot included with comprehensive installation guides for Windows, Linux, and Pterodactyl hosting platforms.
Multi-server support allowing one Discord bot to manage linking across multiple Rust servers simultaneously.
Automatic group management with configurable group assignment for linked players, perfect for permissions and role-based systems.
Real-time synchronization between Discord and Rust server through RCON communication for instant updates and status changes.
Data persistence with automatic saving and loading of linking data, ensuring no loss of player connections across server restarts.
Plugin integration support with ImageLibrary, ServerPanel, and Notify plugins for enhanced functionality and user experience.
Developer-friendly API for custom integrations, allowing other plugins to check linking status and trigger custom actions.
Comprehensive notification system with support for multiple notification plugins to keep players informed about linking status.
Flexible interface options with configurable UI settings - use "Use UI" set to false for command-only operation without graphical interface.

Complete Discord Bot Solution

LinkingSystem includes a complete Python Discord bot with everything you need for seamless integration. No complex setup required - just follow our step-by-step guides!

Important: Python 3.12 is required! Python 3.13 is not compatible due to library issues.

Windows Installation

Complete guide for Windows servers with automatic startup configuration and service management.

Linux Installation

Full Linux support with systemd service configuration for Ubuntu, Debian, CentOS, and RHEL systems.

Pterodactyl Support

Optimized for Pterodactyl game panel with dedicated setup instructions and panel integration.

Multi-Server

One bot can manage multiple Rust servers simultaneously with individual RCON configurations.

Video Overview

Commands

/link - Opens the linking interface for players to connect their Discord account
/link status - Shows your current linking status with Discord
/link code - Generates a new linking code for Discord connection
/link remove - Removes the existing link between Discord and Rust accounts

Permissions

linkingsystem.use - Permission to access the linking system and connect Discord account

How It Works

LinkingSystem provides a seamless three-step process for connecting Discord and Rust accounts, with both UI and command-only options:

Generate Code - Players use the /link command to open the UI interface, or /link code for direct command-only code generation with built-in cooldown protection.
Discord Verification - Players share their code in the designated Discord channel where the bot automatically processes the connection.
Instant Benefits - Once linked, players immediately receive their Discord role and start enjoying exclusive in-game perks and rewards.

The system maintains real-time synchronization between Discord and your Rust server, ensuring that role changes and connections are processed instantly!

FAQ

Q: Do I need to create my own Discord bot?
A: Yes, but we provide complete step-by-step instructions for creating and configuring your Discord bot, including all necessary permissions and settings.

Q: Can LinkingSystem work with multiple Rust servers?
A: Absolutely! The Discord bot supports multiple servers simultaneously. Simply add your server configurations to the bot's config file.

Q: How do I add LinkingSystem to ServerPanel?
A: LinkingSystem automatically integrates with ServerPanel. Create a new category with "Type": "Plugin", "Plugin Name": "LinkingSystem", "Plugin Hook": "API_OpenPlugin".

Q: How do linked players receive their rewards?
A: Rewards are granted automatically when a player successfully links their Discord account. The system automatically assigns the configured permission group to linked players.

Q: Are the rewards shown in the UI actually given to players?
A: The reward items displayed in the UI are visual representations only. The actual benefit is the automatic assignment to a permission group (default: "discord") which can be configured to provide various server perks through your permission system.

Q: Can I customize the rewards for linked players?
A: Yes! You can customize which permission group linked players receive and configure what benefits that group provides through your server's permission system. The visual reward elements in the UI are also fully customizable.

Q: What happens if a player leaves the Discord server?
A: The bot automatically detects when linked players leave the Discord server and can remove their in-game benefits accordingly.

Q: Is the linking data saved if the server restarts?
A: Yes, all linking data is automatically saved and persisted across server restarts, ensuring no loss of player connections.

Q: Can I use LinkingSystem without the UI interface?
A: Yes! Set "Use UI" to false in the configuration to enable command-only mode. Players can use /link code to generate linking codes, /link status to check their connection, and /link remove to unlink their accounts directly through chat commands.

Migrations