Cross-Ark-Chat

Cross Ark Chat connects all of your Ark Survival Evolved Servers chat together allowing you to talk to anyone from anywhere on your servers/clusters. Cross Ark Chat also has discord support to allow talking to and from servers using discord.

This program uses pure Rcon so it can be ran from anywhere however for best performance i would run it from the same pc that is hosting your Ark servers.

Some things you can do.(Can do more but these are the main things)

Talk to any server even if they are not on the same network or in same cluster. (Does require knowing the ip and admin password)

Run any rcon command even ones that are added in via Ark api system. (Rcon commands only work using discord)

Talk to your servers from discord.

Set up discord roles to limit who can use what rcon command. (Usefull for giving mods some commands without full access)

Get tribe logs sent to discord so tribes can keep track of whats going on in-game.

Set rcon commands to run on a timer.

Show join and leave notificaitons

Replace unicode based words/letters with non unicode based letters/words (This doesnt fix Arks rcon not supporting unicode but does help some)

This is what chat looks like depending on your settings. (Note i can't change the yellow font/size. This is a limit of arks current rcon system.)

Discord: (spikeydragoon): Hello from discord!
Island: (spikeydragoon): Hello from the island!
Center: (spikeydragoon): Hello from the center!

Player Spikeydragoon joined the island server.
Player Spikeydragoon left the island server.

Read the CONTRIBUTING.md file before submitting a issue.

Join us on Discord for support and for latest updates.

If your looking to play on a server with this here is link to my servers

Getting Started

These instructions will get you a copy of Cross Ark Chat up and running.

Prerequisites

This is for both linux and windows.

For linux you must download libunwind8 for CrossArkChat to work.

For Ubuntu/Debian

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install libunwind8

For RedHat/CentOS

sudo yum update
sudo yum install libunwind libicu

If you get any System.Net.Http.CurlHandler errors you might need to install libcurl3

For Linux set the CrossArkChat folder/files permissions to 755 to allow w/r/execute

You must have rcon enabled in the Ark Server Settings.

For tribe logs you must have log tribe logs to rcon enabled in the Ark Server Settings.

Installation

1:Download the version of Cross Ark Chat that you want to use.

2:Extract the CrossArkChat.zip to where ever you want the program to run from.

3: If you are linking the bot to your discord server go throught the discord setup first before continuing otherwise skip to step 4.

4:Open the folder you extracted and configure the programs settings in _configuration.json.

4a:Optionally if you want to setup a badword list or word replacement then configure settings in _wordfilter.json. If you dont plan to use badword filters then can just ignore this file. Do not delete this file as program wont run if its missing.

4b: Optionally if you want to use rcon commands from discord you must set up the role names in _discordroles.json. Role names must be exzactly how they are listed in your discord server settings / role tab. This is case sensitive.

4c: Optionally if you want to use timed rcon commands you must set up the commands in _timedcommands.json.

5:Launch the program.exe and enjoy.

5a:For linux/redhat use ./CrossArkChat to start the bot. You must start the bot from the folder the bot is in. If you want the bot to run in background so you dont have to stay logged in you can run nohup ./CrossArkChat & Note the & is very important and it will not work if thats not there. To find the pid run ps -ef | grep CrossArkChat. Once you have the pid run kill 1234 1234 to end program nicely or kill -9 1234 1234 to force close it. Replace the 1234 1234 with the pid you find from the above command.

Discord set up

Steps on how to get your discord bot token by setting up a bot user, adding the bot to your discord server, and getting your discord channel ids.

Creating your discord bot user

You have to create a discord bot user to get the token and to be able to add the bot to your discord server.

• You need to go to the Discord Developers section here and click Create an Application
• Now name your bot then hit Save Changes. If you want you can provide a picture and you can give your bot a discription that will show up in the bots profile however this is not needed. The name given and picture is what will show up in your discord channel when the bot is online.
• On the left Click Bot then click Add bot. Confirm by clicking Yes, do it~
• Now you can get your bot's token by using the click to reveal token button. Note this is special and shouldnt be shared with anyone. Anyone that has this token can use it to mess with your discord server and bot. If you already gave your token to someone then go back to where it says click to reveal and click Regenerate.
• Paste the bot token in the _configuration.json file where it says DiscordToken

Adding the CrossArk program to discord

You now have to add the bot to your discord server and give it permissions.

• You need to go to the Discord Developers section here and click on the bot you created in the steps above.
• Under General Information copy the Client ID.
• In your browser type in https://discordapp.com/oauth2/authorize?&client_id=YOUR_CLIENT_ID_HERE&scope=bot&permissions=0 Replace where it says You_Client_Id_Here with the Bot Client ID that you copyed above. Example https://discordapp.com/oauth2/authorize?&client_id=123456789&scope=bot&permissions=0
• Once this page loads up select the server you want to add the bot to. Note you must have the Manage Server permission on the server you are tring to invite the bot to.
• Click Authorize

Getting discord channel ids

You have to enable developer mode in discord user settings to be able to get channel ids.

• 1: With discord open press the user settings icon (Gear icon at bottom left of discord)
• 2: Under App Settings section select the Appearance tab.
• 3: Scroll down to the Advance section and next to developer mode press the button to turn it on.
• 4: Press the X to return to your discord server.
• 5: Right click a discord channel and select copy id. This will put the channel id in your clipboard so you can paste it into the config file. Note you can only paste one channel id at a time.

Thats it you can now proceed with step 4 and set up your _configuration file.

Configuration

Formating for the config files is important so make sure to keep all formating or you will have problems. At the bottom it will show examples for the versions with and without discord as they have different configs.

Configuration for _configuration.json

Basic formating for the config should look like this.

For Application Settings.

• VersionCheckUrl: This should be left as is. The bot uses this to check if its running the latest version or not.

• CrossArkChatPatchNotesCheckUrl: This should be left as is. The bot uses this to check the patch notes for cross ark chat.

• LogErrors: True for the bot to log errors to the error file False to ignore errors. This is good for debugging to see what is going on if its not working.

• UseDiscord: True to use discord false to use only rcon. This is for servers who only want cross chat and not discord.

• DiscordLoggingSeverity: info bot uses this to see what type of logging you want for the discord output. For normal use i would leave it set to info but for troubleshooting i would use verbose.

Note there are a few opitions you can set the discordloggingseverity to. Critical = Logs that contain the most severe level of error. This type of error indicate that immediate attention may be required.

Debug = Logs that contain the most detailed messages.

Error = Logs that highlight when the flow of execution is stopped due to a failure.

Info = Logs that track the general flow of the application.

Verbose = Logs that are used for interactive investigation during development.

Warning = Logs that highlight an abnormal activity in the flow of execution.

Example of what the default looks like.

"ApplicationSettings": {
    "VersionCheckUrl": "https://raw.githubusercontent.com/spikeydragoon/Cross-Ark-Chat/master/version.txt",
    "CrossArkChatPatchNotesCheckUrl": "https://raw.githubusercontent.com/spikeydragoon/Cross-Ark-Chat/master/CrossArkChatPatchNotes.txt",
    "LogErrors": true,
    "UseDiscord": true,
    "DiscordLoggingSeverity": "info"
  },

For Server Settings

• Map: is the name of your map. This should not contain spaces or special characters as it will cause the program to not work properly. This is also used for the chat prefix for the server if you have it enabled.

• Ip: is either your local ip if your running bot from your own computer example 192.168.1.2 or if your trying to connect to a server on a hosting provider then you will use the hosting providers public ip address example 75.75.75.75 You should not use your own public ip as this will cause problems.

• RconPort: is the rcon port on the Ark Server. Again you must have rcon enabled.

• QueryPort: is the query port on the Ark Server.

• Password: is the Admin password on the Ark Server. This should not contain spaces or special characters as it will cause the program to not work properly.

• Prefix: is the prefix used to send chat to that server when UsePrefixToSendChat is set to true.

• Active: is used to tell the bot if the server should be used or not. true means bot will load it false means bot will ignore it.

• ServerChannelId: is the discord channel id that the server should send messages to if SendServerChatToOwnChannel is enabled.

Example of what the default looks like.

"Servers": [
    {
      "Map": "Map",
      "IP": "0.0.0.0",
      "RconPort": 0,
      "QueryPort": 0,
      "Password": "Password",
      "Prefix": "/map",
      "Active": false,
      "ServerChannelId": 0
    }
  ],

For Tribe settings.

• TribeId: is the in-game tribe id.

• Active: is used to tell the bot if the server should be used or not. true means bot will load it false means bot will ignore it.

• TribeDiscordId is the discord channel id that the server should send messages to if SendTribeLogsToOwnChannel is enabled.

Example of what the default looks like.

"TribeIDs": [
    {
      "TribeId": "00000",
      "Active": false,
      "TribeDiscordId": 0
    }
  ],

For Game Command Settings.

• Command: is the in-game prefix used to run the command reply.

• Commandreply: is the reply the bot gives when running the Above command.

• Active: tells the bot to use the command or not if the UseGameCommands is set to true

Example of what the default looks like.

"GameCommands": [
    {
      "Command": "/ping",
      "CommandReply": "Pong!",
      "Active": false
    }
  ],

For Custom Tags list.

You just put all the tags you want the bot to filter out. This is used for plugins/mods that use their own tags in chat. Example is ACM uses ACM[CMD] to tag all of the admin commands. When adding your tags make sure you add an extra one for SERVER: yourtag this is due to how it pulls chat from the other servers. Without both it would still send/spam the servers.

Example of what the default looks like.

"CustomTagList": [
    "ACM[CMD]",
    "SERVER: ACM[CMD]"
  ],

For Rcon Settings.

BIG WARNING do not change anything in this section unless you full undertand what you are doing. Depending on what you change will break the bot. The only reason to change the tags is if your server is set to a different culture. IE fr instead of en. This is due to fr using Tribu instead of Tribe like in the en version so you would need to change that tag so bot can see it. If you notice lag when the bot runs you can force the bot to get chat slower by changing the GetchatTimeInMs and the ListPlayersCheckInMS. Note by doing this it may get multi messages at one time due to how arks rcon is coded.

• NoResponceTag: This is the responce that ark gives when it receives the command but doesnt have any values to return.

• NoPlayerTag: This is the responce that ark gives when there are no players on the server.

• ServerRepeatTag: This is the tag that ark puts at the start of a message when it was sent using the serverchat command so it doesnt keep resending it.

• AdminCMDTag: This is the tag that Ark puts at the start of admin commands.

• TribeTag: This is the tag that ark puts at the start of all tribe logs.

• GetChatCmd: This is the command ark uses to get chat from the server.

• ListPlayersCmd: This is the command ark uses to get the player list from the server.

• ListPlayerChatTimeInMs: This is the frequency in milliseconds that the list player command will run.

• GetChatTimeInMs: This is the frequency in milliseconds that the getchat command will run.

• PlayerCountCheckTimeInMs This is the frequency in milliseconds that the player counter will run.

• CrossArkChatVersionCheckTimeInMs: This is the frequency it checks for a new version of crossarkchat.

• RconSendTimeoutInMs: This is the frequency in milliseconds the send commad will wait before timing out.

• RconReceiveTimeoutInMs: This is the frequency in milliseconds the receive command will wait before timing out.

• RconConnectionRetrys: This is how many times rcon will try to connect to the server before moving on.

Example of what the default looks like.

"RconSettings": {
    "NoResponceTag": "Server received, But no response!!",
    "NoPlayerTag": "No Players Connected",
    "ServerRepeatTag": "SERVER:",
    "AdminCMDTag": "AdminCmd:",
    "TribeTag": "Tribe",
    "GetChatCmd": "getchat",
    "ListPlayersCmd": "ListPlayers",
    "ListPlayerCheckTimeInMs": 10000,
    "GetChatTimeInMs": 5,
    "PlayerCountCheckTimeInMs": 30000,
    "CrossArkChatVersionCheckTimeInMs": 3600000,
    "RconSendTimeoutInMs": 3000,
    "RconReceiveTimeoutInMs": 10000,
    "RconConnectionRetrys": 1
  },

For Cross Ark Chat Notification setings.

You can change what the bot says when a player joins and leaves the ark servers. Format looks like this and you can change everything but the location of the {PlayerName} and {MapName}. Player {PlayerName} joined the {MapName} server Player {PlayerName} left the {MapName} server

You can change what the bot shows for your online player counter. Format for player counter looks like this. You can change everything but the {CurrentOnline}. Leftblank {CurrentOnline}/100 Leftblank

• PlayerJoinStart: First part of the join notification.

• PlayerJoinMiddle: Middle part of the join notification.

• PlayerJoinEnd: Last part of the join notification.

• PlayerLeftStart: First part of the left notification.

• PlayerLeftMiddle: Middle part of the left notification.

• PlayerLeftEnd: Last part of the left notification.

• PlayerCountStart: First part of the player count notification.

• PlayerCountMiddle: Middle part of the player count notification.

• MaxPlayerCount: This is the max number your servers can hold so change to what your max number is. Default is 100.

• PlayerCountEnd: Last part of the player count notification.

• CrossArkChatVersionStart: First part of the cross ark chat version notification.

• CrossArkChatVersionEnd: Last part of the cross ark chat version notification.

• CrossArkChatPatchStart: First part of the cross ark chat patch notes notification.

• CrossArkChatPatchEnd: Last part of the cross ark chat patch notes notification.

• ShowFullTribeLog: This tells the bot to show the full unformated version of tribe logs. True will show the full tribe log. False will format the tribe log into a more readable version.

• ShowTribeLogTribeNameInOwnChannel: This tells the bot to show tribe name for the tribe log in the personal tribe channel.

• ShowTribeLogTribeNameInMainChannel: This tells the bot to show tribe name for the tribe logs in the main TribeDiscordChannelID channel.

• ShowTribeLogServerNameInOwnChannel: This tells the bot to show the server name the log came from in the tribes personal channel.

• ShowTribeLogServerNameInMainChannel: This tells the bot to show the server name the log came from in the TribeDiscordChannelId channel.

• ShowTribeLogTribeIdInOwnChannel: This tells the bot to show the Tribe id the log came from in the Tribes personal channel.

• ShowTribeLogTribeIdInMainChannel: This tells the bot to show the Tribe id the log came from in the TribeDiscordChannelId channel.

• EmbedFormattedTribeLog: This tells the bot to embed the tribe log in a nice message bubble or to display it as normal text. True to just show the nice color embedded messages false to show just the text version of the tribe log.

Example of what the default looks like.

"CrossArkChatNotificationSettings": {
    "PlayerJoinStart": "Player",
    "PlayerJoinMiddle": "joined the",
    "PlayerJoinEnd": "server",
    "PlayerLeftStart": "Player",
    "PlayerLeftMiddle": "left the",
    "PlayerLeftEnd": "server",
    "PlayerCountStart": "",
    "PlayerCountMiddle": "/",
    "MaxPlayerCount": "100",
    "PlayerCountEnd": "",
    "CrossArkChatVersionStart": "New CrossArkChat version",
    "CrossArkChatVersionEnd": "is now avaiable",
    "CrossArkChatPatchStart": "Patch notes for new cross ark chat version",
    "CrossArkChatPatchEnd": "",
    "ShowFullTribeLog": false,
    "ShowTribeLogTribeNameInOwnChannel": false,
    "ShowTribeLogTribeNameInMainChannel": true,
    "ShowTribeLogServerNameInOwnChannel": true,
    "ShowTribeLogServerNameInMainChannel": true,
    "ShowTribeLogTribeIdInOwnChannel": false,
    "ShowTribeLogTribeIdInMainChannel": true,
    "EmbedFormattedTribeLog": true
  },

For Embedded Tribe log color settings. Note i may have missed some but I have it set up you can add your own.

• LogType: this is the word the bot will look for to apply colors and ping a discord role.

• LogColor: this is the hex value of the color you want the bot to use for the log type. Note do not put the # from the hex color just the numbers/letters. Example for red its #ff2121 in the config just put ff2121. You can use any online color picker that gives the hex value for that color.

• RoleToPing: this is the discord rolename the bot will ping for the set logtype. Note if you dont want it to ping a role just leave it set to none.

Example of what the default looks like.

"EmbeddedTribeLogColorSettings": [
    {
      "LogType": "killed",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "demolished",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "claimed",
      "LogColor": "03f413",
      "RoleToPing": "none"
    },
    {
      "LogType": "unclaimed",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "tamed",
      "LogColor": "03f413",
      "RoleToPing": "none"
    },
    {
      "LogType": "destroyed",
      "LogColor": "ff7400",
      "RoleToPing": "none"
    },
    {
      "LogType": "froze",
      "LogColor": "d8ddd8",
      "RoleToPing": "none"
    },
    {
      "LogType": "downloaded",
      "LogColor": "03f413",
      "RoleToPing": "none"
    },
    {
      "LogType": "uploaded",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "starved",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    }
  ],

For Chat settings.

• ShowAdminCommands: tells the bot to either show or hide admin commands. true is to show commands and false is to hide them.

• SendAdminCommandsToOWnChannel: tells the bot to send admin commands to its own channel. true is to give admin commands its own discord channe. false is to keep them going to the same channel if showadmincommands is enabled.

• ShowTribeLogsInChat: tells the bot to either show or hide tribe logs in chat. true is to show tribe logs in chat false is to hide them. This only matters if you have show Tribe logs in Rcon enabled in your Ark Server Settings. This settings is mostly for people that wanted to have tribe logs in rcon however dont want it showing up in the bot.

• UsePrefixToSendChat: tells the bot to use the PrefixToSendChat or not. If true you have to type the prefix first before your message will be sent. Example /Island hello

• UseCustomTags: True to filter the custom tags. False to ignore custom tags.

• LogChat: tells the bot to log chat.

• LogAdminCommands: tells the bot to log admin commands if showadmincommands is set to true

• LogTribeChat: tells the bot to log tribe chat if showtribelogsinchat is set to true

• UseGameCommands: tells the bot to enable the CustomGame Commands opition.

• PrefixToSendAllServers: is the prefix that will be used if UsePrefixToSendChat is true. This prefix must be typed before the message to send chat. Example /all hello

Example of what the default looks like.

"ChatSettings": {
    "ShowAdminCommands": false,
    "SendAdminCommandsToOwnChannel": false,
    "ShowTribelogsInChat": false,
    "UsePrefixToSendChat": false,
    "UseCustomTags": false,
    "LogChat": true,
    "LogAdminCommands": true,
    "LogTribeLogs": true,
    "UseGameCommands": false,
    "PrefixToSendAllServers": "/all"
  },

For Discord Settings.

• DiscordChannelID: is the id of the channel you want the bot to send all the chat messages to and from.

• TribeLogsDiscordChannelID: is the id of the channel you want the bot to send tribe logs to if you have them enabled. Note this can be the same as the DiscordChannelID if you want both to show in same chat.

• AdminCommandsDiscordChannelID: is the id of the channel you want the bot to send admin commands to if you have them enabled.

• SupportChannelID: is the id of the channel you want the bot to send support tickets to if enabled.

• JoinLeaveNotificationsDiscordChannelID: is the id of the channel you want the bot to send join/leave notifications if enabled.

• CrossArkChatVersionDiscordChannelId: is the id of the channel you want the bot to send the new version notification if enabled.

• CrossArkChatPatchNotesDiscordChannelId: is the id of the channel you want the bot to send the patch notes notification if enabled.

• prefix: is the tag you use in discord when sending commands.

• DiscordChatPrefix: is the chat prefix used in-game when sending messages from discord.

• DiscordToken: is the Discord Bot Token required for the bot to connect to your server.

• ShowChatPrefixInDiscord: tells the bot to either show or hide the chat prefix in discord. This is mainly for people who only have one server. true shows the chat prefix(MapName) in discord false hides the prefix.

• SendTribeLogsToOwnChannel: tells the bot to send tribe logs to their own discord channels. ShowTribeLogsInChat must be enabled.

• SendServerChatToOwnChannel: tells the bot to send server chat to their own discord channels.

• UseSupportPrefix: tells the bot to use the SupportPrefix or not. If true when you type the supportprefix before your message it will send a message to a set discord channel. Example /help my dinoes are stuck.

• UseJoinLeaveNotifications: Tells the bot to send join/leave notifications to discord.

• SendJoinLeaveNotificationsToServerOwnChannel: Tells the bot to send the join/leave notifications to the servers own channel.

• UseWordReplacementList: Tells the bot to use the word replacement list or not. True to replace words/letters.

• PingRoleName: tells the bot to ping the set rolename in the support channel or not. true it will ping the discord role when it sends a message. false it will only send the message it will not ping anyone.

• ReplyToSupportPing: tells the bot to send a reply message when someone uses the SupportPrefix.

• SendChatToDiscord: tells the bot to send messages to discord or not. If true messages will send as normal. if false you will have to use the PrefixToSendToDiscord to send messages to discord.

• UsePlayerCountChannelUpdater: tells the bot to update channel discription with the online play count or not. true to use the count updater.

• UseCrossArkChatVersionChecker: tells the bot to send a new version notification when one is avaiable.

• UseCrossArkChatPathNotesChecker: tells the bot to send a patch note notification when one is avaiable.

• SupportPrefix: is the prefix that will be used if UseSupportPrefix is true. This prefix must be typed before the messaage to send the message to the support channel. Example /help my dinos are stuck.

• PrefixToSendToDiscord: is the prefix that will be used if SendChatToDiscord is false. Example /discord hello.

• SupportRoleToPing: tell the bot which discord rolename to ping if pingrolename is true. Discord role must match the role name exzactly as its listed in your discord server roles tab. This is case sensitive.

• SupportPingReply: Is the message that will be sent when someone uses the SupportPrefix if ReplyToSupportPing is true.

Example of what the default looks like.

"DiscordSettings": {
    "DiscordChannelID": 0,
    "TribeLogsDiscordChannelID": 0,
    "AdminCommandsDiscordChannelID": 0,
    "SupportChannelID": 0,
    "JoinLeaveNotificationsDiscordChannelID": 0,
    "prefix": "d!",
    "DiscordChatPrefix": "Discord",
    "DiscordToken": "BotToken",
    "ShowChatPrefixInDiscord": true,
    "SendTribeLogsToOwnChannel": false,
    "SendServerChatToOwnChannel": false,
    "UseSupportPrefix": false,
    "UseJoinLeaveNotifications": false,
    "SendJoinLeaveNotificationsToServerOwnChannel": false,
    "UseWordReplacementList": false,
    "PingRoleName": false,
    "ReplyToSupportPing": true,
    "SendChatToDiscord": true,
    "UsePlayerCountChannelUpdater": false,
    "SupportPrefix": "/help",
    "PrefixToSendToDiscord": "/discord",
    "SupportRoleToPing": "rolename",
    "SupportPingReply": "Your support ticket has been sent."
  }

Example of adding more than one server to the bot. Notice the , is required for each additional server however the last one doesnt have one. This is important as if you dont put the , where needed the bot will not work.

"Servers": [
    {
      "Map": "MapName",
      "IP": "0.0.0.0",
      "RconPort": 0,
      "QueryPort": 0,
      "Password": "Password",
      "Prefix": "/map",
      "Active": false,
      "ServerChannelId": 0
    },
    {
      "Map": "MapName",
      "IP": "0.0.0.0",
      "RconPort": 0,
      "QueryPort": 0,
      "Password": "Password",
      "Prefix": "/map",
      "Active": false,
      "ServerChannelId": 0
    }
  ],

Example of adding more than one tribe to the bot. Notice the , is required for each additional tribe however the last one doesnt have one. This is important as if you dont put the , where needed the bot will not work.

"TribeIDs":[
    {
      "TribeId": "00000",
      "Active": false,
      "TribeDiscordId": 0
    },
    {
      "TribeId": "00000",
      "Active": false,
      "TribeDiscordId": 0
    }
  ],

Example of adding more than one Game Command to the bot.

"GameCommands": [
    {
      "Command": "!discord",
      "CommandReply": "https://discord.gg/",
      "Active": false
    },
    {
      "Command": "rules",
      "CommandReply": "These are the rules.",
      "Active": false
    },
    {
      "Command": "/ping",
      "CommandReply": "Pong!",
      "Active": false
    }
  ],

Example of adding more than one Custom Tag.

"CustomTagList": [
    "ACM[CMD]",
    "SERVER: ACM[CMD]"
  ],

Example default config

{
  "ApplicationSettings": {
    "VersionCheckUrl": "https://raw.githubusercontent.com/spikeydragoon/Cross-Ark-Chat/master/version.txt",
    "CrossArkChatPatchNotesCheckUrl": "https://raw.githubusercontent.com/spikeydragoon/Cross-Ark-Chat/master/CrossArkChatPatchNotes.txt",
    "LogErrors": true,
    "UseDiscord": true,
    "DiscordLoggingSeverity": "info"
  },

  "Servers": [
    {
      "Map": "Map",
      "IP": "0.0.0.0",
      "RconPort": 0,
      "QueryPort": 0,
      "Password": "Password",
      "Prefix": "/map",
      "Active": false,
      "ServerChannelId": 0
    },
    {
      "Map": "Map",
      "IP": "0.0.0.0",
      "RconPort": 0,
      "QueryPort": 0,
      "Password": "Password",
      "Prefix": "/map",
      "Active": false,
      "ServerChannelId": 0
    }
  ],

  "TribeIDs": [
    {
      "TribeId": "00000",
      "Active": false,
      "TribeDiscordId": 0
    },
    {
      "TribeId": "00000",
      "Active": false,
      "TribeDiscordId": 0
    }
  ],

  "GameCommands": [
    {
      "Command": "!discord",
      "CommandReply": "https://discord.gg/",
      "Active": false
    },
    {
      "Command": "rules",
      "CommandReply": "These are the rules.",
      "Active": false
    },
    {
      "Command": "/ping",
      "CommandReply": "Pong!",
      "Active": false
    }
  ],

  "CustomTagList": [
    "ACM[CMD]",
    "SERVER: ACM[CMD]"
  ],

  "RconSettings": {
    "NoResponceTag": "Server received, But no response!!",
    "NoPlayerTag": "No Players Connected",
    "ServerRepeatTag": "SERVER:",
    "AdminCMDTag": "AdminCmd:",
    "TribeTag": "Tribe",
    "GetChatCmd": "getchat",
    "ListPlayersCmd": "ListPlayers",
    "ListPlayerCheckTimeInMs": 10000,
    "GetChatTimeInMs": 5,
    "PlayerCountCheckTimeInMs": 30000,
    "CrossArkChatVersionCheckTimeInMs": 3600000,
    "RconSendTimeoutInMs": 3000,
    "RconReceiveTimeoutInMs": 10000,
    "RconConnectionRetrys": 1
  },

  "CrossArkChatNotificationSettings": {
    "PlayerJoinStart": "Player",
    "PlayerJoinMiddle": "joined the",
    "PlayerJoinEnd": "server",
    "PlayerLeftStart": "Player",
    "PlayerLeftMiddle": "left the",
    "PlayerLeftEnd": "server",
    "PlayerCountStart": "",
    "PlayerCountMiddle": "/",
    "MaxPlayerCount": "100",
    "PlayerCountEnd": "",
    "CrossArkChatVersionStart": "New CrossArkChat version",
    "CrossArkChatVersionEnd": "is now avaiable",
    "CrossArkChatPatchStart": "Patch notes for new cross ark chat version",
    "CrossArkChatPatchEnd": "",
    "ShowFullTribeLog": false,
    "ShowTribeLogTribeNameInOwnChannel": false,
    "ShowTribeLogTribeNameInMainChannel": true,
    "ShowTribeLogServerNameInOwnChannel": true,
    "ShowTribeLogServerNameInMainChannel": true,
    "EmbedFormattedTribeLog": true
  },

  "EmbeddedTribeLogColorSettings": [
    {
      "LogType": "killed",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "demolished",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "claimed",
      "LogColor": "03f413",
      "RoleToPing": "none"
    },
    {
      "LogType": "unclaimed",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "tamed",
      "LogColor": "03f413",
      "RoleToPing": "none"
    },
    {
      "LogType": "destroyed",
      "LogColor": "ff7400",
      "RoleToPing": "none"
    },
    {
      "LogType": "froze",
      "LogColor": "d8ddd8",
      "RoleToPing": "none"
    },
    {
      "LogType": "downloaded",
      "LogColor": "03f413",
      "RoleToPing": "none"
    },
    {
      "LogType": "uploaded",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    },
    {
      "LogType": "starved",
      "LogColor": "ff2121",
      "RoleToPing": "none"
    }
  ],

  "ChatSettings": {
    "ShowAdminCommands": false,
    "SendAdminCommandsToOwnChannel": false,
    "ShowTribelogsInChat": false,
    "UsePrefixToSendChat": false,
    "UseCustomTags": false,
    "LogChat": true,
    "LogAdminCommands": true,
    "LogTribeLogs": true,
    "UseGameCommands": false,
    "PrefixToSendAllServers": "/all"
  },

  "DiscordSettings": {
    "DiscordChannelID": 0,
    "TribeLogsDiscordChannelID": 0,
    "AdminCommandsDiscordChannelID": 0,
    "SupportChannelID": 0,
    "JoinLeaveNotificationsDiscordChannelID": 0,
    "CrossArkChatVersionDiscordChannelId": 0,
    "CrossArkChatPatchNotesDiscordChannelId": 0,
    "prefix": "d!",
    "DiscordChatPrefix": "Discord",
    "DiscordToken": "BotToken",
    "ShowChatPrefixInDiscord": true,
    "SendTribeLogsToOwnChannel": false,
    "SendServerChatToOwnChannel": false,
    "UseSupportPrefix": false,
    "UseJoinLeaveNotifications": false,
    "SendJoinLeaveNotificationsToServerOwnChannel": false,
    "UseWordReplacementList": false,
    "PingRoleName": false,
    "ReplyToSupportPing": true,
    "SendChatToDiscord": true,
    "UsePlayerCountChannelUpdater": false,
    "UseCrossArkChatVersionChecker": false,
    "UseCrossArkChatPathNotesChecker": false,
    "SupportPrefix": "/help",
    "PrefixToSendToDiscord": "/discord",
    "SupportRoleToPing": "rolename",
    "SupportPingReply": "Your support ticket has been sent."
  }
}

Configuration for _wordfilter.json

Basic formating for the config should look like this. Only note as before the , is important you only need the , when adding more words. Important thing to notice is the , shouldnt go on the last word. Failure to put the , where it belongs will cause the program to not run.

Make sure if you dont use this list then keep the example words in there as if it is left blank the server will not work. However you can change the words to what ever you want.

Last thing to note is this only deletes the words when the bots sends it to all servers it does not change what the player types in game.

The word replacement list will replace words or letters in chat. Note this is mostly for discord to ark as since ark rcon doesnt support unicode it will still show as a ? when coming from ark.

Example _WordFilter.json

{
  "WordFilterList": [
    "exampleword",
    "examplewords"
  ],

  "WordReplacementList": [
    {
      "OldWord": "ö",
      "NewWord": "o"
    },
    {
      "OldWord": "raptor",
      "NewWord": "dragon"
    }
  ]
}

Configuration for _discordroles.json

Basic formating for the config should look like this. If your not using the rcon commands in discord you can skip this.

Just change rolename to what ever role you want to use that rcon command. Note they must be typed exzactly like its listed in the discord settings role tab. These are case sensitive. So if the role is listed as AdMinRole your would type it just like that caps and all in the config.

You can also only have one role name per command so if you want multi roles to be able to run the command you must also give them that role in discord as well. So as an admin you will need all roles listed in the config to run all commands. This is how discord roles should be set up anyways meaning admins have all roles mods have mod role and lower esc.

Example _discordroles.json

{
  "DiscordRoles": {
    "Rconcommand": "rolename",
    "AllowPlayerToJoinNoCheck": "rolename",
    "BanPlayer": "rolename",
    "Broadcast": "rolename",
    "DestroyAll": "rolename",
    "DestroyAllEnemies": "rolename",
    "DestroyStructures": "rolename",
    "DestroyWildDinos": "rolename",
    "DisallowPlayerToJoinNoCheck": "rolename",
    "DoExit": "rolename",
    "GetChat": "rolename",
    "GiveItemNumToPlayer": "rolename",
    "GiveExpToPlayer": "rolename",
    "KickPlayer": "rolename",
    "KillPlayer": "rolename",
    "ListPlayers": "rolename",
    "PlayersOnly": "rolename",
    "RenamePlayer": "rolename",
    "RenameTribe": "rolename",
    "SaveWorld": "rolename",
    "ServerChat": "rolename",
    "ServerChatTo": "rolename",
    "ServerChatToPlayer": "rolename",
    "SetMessageOfTheDay": "rolename",
    "SetTimeOfDay": "rolename",
    "ShowMessageOfTheDay": "rolename",
    "Slomo": "rolename",
    "UnBanPlayer": "rolename",
    "PurgeMessage": "rolename",
    "StartChat": "rolename",
    "StopChat": "rolename",
    "RestartChat": "rolename",
    "ClearChat": "rolename",
    "RebootProgram": "rolename",
    "ServerList": "rolename",
    "ServerInfo": "rolename"
  }
}

Configuration for _timedcommands.json

Basic formating for the config should look like this. If your not using the rcon command timers you can skip this.

Below are three exzamples of how you can configure your timers.

• Name: Name of the timer should be different than the other timers.

• Server: Name of the server to run it on. This should match the map name. You can also say all to run it on all active servers.

• Commands: List of all commands for the timer to run.

• Command: Name of the command to run OR type message to send. For list of commands see the discord role config above.

• Type: You have two types Command for rcon commands and Broadcast for sending messages. The type depends on what you have in command.

• Active: Set to true to active it or false for bot to ignore it.

• Frequency: You have three options here minute, hour, day for how often it happens.

• Timespan: The interval you want it to run based on the Frequency.

• TimeOffset: 24 hour format of when time of day you want the timer to start from. So instead of just every random hour you can tell it to do every hour after 4am.

{
  "TimedCommands": [
    {
      "Name": "Test 1",
      "Server": "",
      "Commands": [
        {
          "Command": "messageoftheday",
          "Type": "Command"
        }
      ],
      "Active": "false",
      "Frequency": "minute",
      "Timespan": "30",
      "TimeOffset": "00:00:00"
    },
    {
      "Name": "Test 2",
      "Server": "",
      "Commands": [
        {
          "Command": "About to save the world",
          "Type": "Broadcast"
        },
        {
          "Command": "saveworld",
          "Type": "Command"
        }
      ],
      "Active": "false",
      "Frequency": "hour",
      "Timespan": "1",
      "TimeOffset": "00:00:00"
    },
    {
      "Name": "Test 3",
      "Server": "",
      "Commands": [
        {
          "Command": "About to wipe all wild dinos",
          "Type": "Broadcast"
        },
        {
          "Command": "wilddinowipe",
          "Type": "Command"
        }
      ],
      "Active": "false",
      "Frequency": "day",
      "Timespan": "1",
      "TimeOffset": "00:00:00"
    }
  ]
}

FAQ

• Q: Can you change the font, color, or size of the in-game chat to something besides the bold yellow?

• A: Sadly no this is a limitation of Rcons sendchat command and is hard coded into Arks Rcon. Until they make an option to be able to change this we are stuck with the yellow :(

• Q: Are you open to ideas and code changes?

• A: Yes i am all for adding new ideas and optimizing the code. If you want to contribute by making better guides, correcting my many typos, or giving ideas read the Contributing section then hit me up.

• Q: Do you plan to charge for this program?

• A: No i like "moneys" however this project was for fun and for the community to enjoy so if you paid for this then you have been scammed. If you want to help me you can feed me new ideas, help with making better guides, or fixing typos. Im to lazy to set up a paypal for donations but i may in the future since a free dr pepper would be nice.

• Q: Do you plan to add more features or is this it?

• A: I plan to keep updating the program for a good while mostly for the experience and to see what all we can do with it. Check my to-do list for my planned updates. Due to working full time i dont give etas since work might get busy depending on the season but i plan to at the bare min make sure the bot at least runs. If this ever changes i will let everyone know.

Thats all i can think of for now :)

To-Do List

• For a updated list check here

Built With

• QueryMaster - Lib used to handle all steam and rcon connections.
• Discord.net - Lib used to handle all discord connections.
• C# .Net - Codeing langue and project used to run the program.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

• Spikeydragoon - Initial work - Spikeydragoon

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• Shout out to Bletch1971 looking over your rcon code helped a lot and the ASM program you and your team developed is amazing.