Features
- Creates a secure link between an in game player and a Discord user in your Discord server.
- This link can be accessed by any Discord Link compatible plugin.
- Add/Remove Oxide Group / Discord Role on link / unlink
Note: This plugin only performs discord link functionality and should not be loaded otherwise.
Discord Link
This plugin supports Discord Link provided by the Discord Extension.All plugins that support Discord Link can use this plugin as the discord linking plugin.
Permissions
discordcore.use
- Allows players to use the/dc
chat command
Linking
Note:
- In order for the bot to work the user who is trying to link must be in the Discord server with the Discord bot.
Starting In-Game
- Option 1: Type /dc join code in game and write the command in a private message to the bot
- Option 2: Type /dc join username#discrimiator and respond to the private message to the bot
Starting in Discord
- Option 1: Type /dc join and paste the command in game chat.
- Option 2: If enabled click on the link button in the guild channel and paste the command in game chat.
Player Commands
Game Server
/dc code
- to start the link process using a code/dc user username
- to start the link process by discord username/dc user userid
- to start the link process by discord userid/dc leave
- to to to unlink yourself from discord/dc
to see this message again
Discord Server
/dc code
- to start the link process using a code/dc user
- to start the link process by steam name/dc leave
- to to to unlink yourself from discord
Admin Commands
Discord Server
/dca link
- admin link player game account and Discord user/dca unlink
- admin unlink player game account and Discord user/dca search player
- search by server player/dca search user
- search by Discord user/dca unban player
- unban a linked banned player/dca unban user
- unban a linked banned Discord user
Getting Your Bot Token
Click Here to learn how to get an Discord Bot Token
Configuration
{
"Discord Bot Token": "",
"Discord Server ID (Optional if bot only in 1 guild)": "",
"Discord Server Name Override": "",
"Discord Server Invite Url": "",
"Link Settings": {
"Announcement Channel Id": "",
"Link Code Generator Characters": "123456789",
"Link Code Generator Length": 6,
"Automatically Relink A Player If They Leave And Rejoin The Discord Server": true,
"Inactive Settings": {
"Automatically Unlink Inactive Players": false,
"Player Considered Inactive After X (Days)": 90.0,
"Automatically Relink Inactive Players On Game Server Join": true
}
},
"Welcome Message Settings": {
"Enable Welcome DM Message": true,
"Send Welcome Message On Discord Server Join": false,
"Send Welcome Message On Role ID Added": [
"559471108240310292"
],
"Add Link Accounts Button In Welcome Message": true
},
"Guild Link Message Settings": {
"Enable Guild Link Message": true,
"Message Channel ID": "824633181336371250"
},
"Link Permission Settings": {
"On Link Server Permissions To Add": [],
"On Unlink Server Permissions To Remove": [],
"On Link Server Groups To Add": [
"Linked"
],
"On Unlink Server Groups To Remove": [
"Linked"
],
"On Link Discord Roles To Add": [
"759424466119032832"
],
"On Unlink Discord Roles To Remove": [
"759424466119032832"
]
},
"Link Ban Settings": {
"Enable Link Ban": true,
"Ban Announcement Channel ID": "564966011292614667",
"Ban Link After X Join Declines": 3,
"Ban Duration (Hours)": 24
},
"Discord Extension Log Level (Verbose, Debug, Info, Warning, Error, Exception, Off)": "Info"
}
Guild Link Message
Guild link message will place a message in a guild discord channel with a button users can use to start the linking process.The players will be sent a message in the same channel that only they can see and isn't displayed to any other users.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.