Skip to content

Commands

Jump to bottom
spikeydragoon edited this page Nov 20, 2019 · 2 revisions

Commands you can run from the bot.

Biggest thing to note is these commands can only be ran from discord so you will be unable to use them if you have not set up discord yet.

To run commands you must set up the _discordroles.json file. You just put the discord role name you want to be able to run the command. Note at this time only one role per command however in discord this is not an issue since you can have multi roles and should due to how discord works. Meaning as an admin i have my admin role and the mod role so i can set commands to mod and i will still be able to use them.

Make sure to set up a new channel just for commands to be sent. This channel does not go in the config since Cross Ark Chat auto listens for commands in any channel you give it read/send permissions to. Due to it auto listening you can have multi channels for commands. Personally i have a public one for all users and an admin one for my mods and me to use.

Do not run commands in channels you setup for chat to come to due to the way discord works it would treat the command as normal chat if the command uses a reply so the bot will not know you are replying to it.

To see a list of commands you have access to run the d!help command. Replace the d! with whatever you set the CommandPrefix to under discord settings in the _configuration.json. Going forward i will only refer to the prefix as d! to keep guide simple. If commands do not show up then double check the discord role to make sure you have the role you set to use the command.

To see more about a command run d!help commandname Example d!help broadcast will tell you how to use broadcast and what the parameters are. The bot would return a usage and summary of the command. Example Usage: Broadcast a message to all players on the server. Summary: broadcast message Usage: Broadcast a message to all players on the server. Summary: broadcast serverName message

This means when using the command i should type a message after the command broadcast like this. d!broadcast hello all players After i run this command it will ask for a server to send to and you would reply with the correct number for that server however if you know the server nametag from the config you can just run it directly on that server like this. d!broadcast island hello all players for just the island or d!broadcast all hello all players for every server.

Cross Ark Chat commands

  • StartChat - Starts CrossArkChat. Note CrossArkChat auto starts so unless you run stop first it will cause chat to show up twice. Example d!startchat
  • StopChat - Stops CrossArkChat. Example d!stopchat
  • RestartChat - Stops then Starts CrossArkChat. Example d!restartchat
  • ClearChat - Deletes all pending messages that are in the que(not sent). Example d!clearchat
  • RebootProgram - Restarts the program. Example d!reboot

Rcon commands

Due to rcon commands not really having a lot of information on them and some have not worked since day 1 over rcon some of these commands may not work over rcon. There is not anything i can do about this so if you run into a command that doesnt work just shoot me a message so i can double check and if it really doesnt work i can remove it from the bots list.

  • RconCommand - allows any custom rcon command to be ran. This was added for ark beyond api extended rcon plugin. Due to this allowing any command to be ran its important not to give anyone access to this command unless you fully trust them. Example d!rcon broadcast hello all or d!rcon doexit
  • AllowPlayerToJoinNoCheck - Adds the specified player to the server's whitelist. Example d!allowplayertojoinnocheck playersteamid
  • BanPlayer - Add the specified player to the server's banned list. Example d!banplayer playersteamid
  • Broadcast - Broadcast a message to all players on the server. Example d!broadcast messagehere
  • DestroyAll - Destroys ALL creatures of the specified class. Example d!destroyall creatureclassname
  • DestroyAllEnemies - Destroys all non-player creatures on the map, including tamed creatures. This does not prevent new ones from spawning as usual. Example d!destroyallenemies
  • DestroyStructures - Destroys all structures owned by all players on the map. d!destroystructures
  • DestroyWildDinos - Destroys all untamed creatures on the map. Useful for helping newly-released creatures to spawn. Example d!destroywilddinos
  • DisallowPlayerToJoinNoCheck - Removes the specified player from the server's whitelist. Example d!DisallowPlayerToJoinNoCheck playersteamid
  • DoExit - Shuts down the server as soon as possible. Example d!doexit
  • GetChat - Returns the latest chat buffer (the same amount that the clients see). Note the bot uses this command to get chat so running this command will cause chat it returns to not show up in normal chat. Example d!getchat
  • GiveItemNumToPlayer - Adds the specified item to the player's inventory (or its blueprint) in the specified quantity and with the specified quality. d!giveitemnumtoplayer playerId itemId quantity quality blueprint
  • GiveExpToPlayer - Gives the specified player the specified amount of experience points. Example d!giveexptoplayer playerId howMuchXp fromTribeShare preventSharingWithTribe
  • KickPlayer - Forcibly disconnect the specified player from the server. Example d!kickplayer steamid
  • KillPlayer - Kills the specified player. Example d!killplayer playerid
  • ListPlayers - List all connected players and their Steam IDs. Example d!listplayers
  • PlayersOnly - Stops all creature movement in the game world and halts crafting. Players can still move normally. Repeat the command to disable its effects. Example d!playersonly
  • RenamePlayer - Renames the player specified by their in-game string name. Example d!renameplayer playerName newPlayerName
  • RenameTribe - Renames the tribe specified by it's string name. Example d!renametribe tribeName newTribeName
  • SaveWorld - Forces the server to save the game world to disk in its current state. Example d!saveword
  • ServerChat - Sends a chat message to all currently connected players. Example d!serverchat messagetosend
  • ServerChatTo - Sends a direct chat message to the player specified by their int64 encoded steam id. Example d!serverchatto steamID messagetosend
  • ServerChatToPlayer - Sends a direct chat message to the player specified by their in-game player name. Example d!serverchattoplayer playername messagetosend
  • SetMessageOfTheDay - Sets the server's 'message of the day', displayed to players when they connect to it. Example d!setmessageoftheday messagetosetto
  • SetTimeOfDay - Sets the game world's time of day to the specified time. Example d!settimeofday hour:minute:second
  • ShowMessageOfTheDay - Displays the message of the day. Example d!showmessageoftheday
  • Slomo - Sets the game speed multiplier. Lower values slow time, change back to 1 to set back to normal. Example d!slomo speed
  • UnBanPlayer - Remove the specified player from the server's banned list. Example d!unbanplayer steamid

Server Query commands

  • ServerList - List server info for your servers marked as active. This also includes direct connection link. Example d!serverlist
  • ServerInfo - Polls the given server for information. Example d!serverinfo serverip queryport

Discord commands

  • Purge - Deletes a set number of discord messages. Max of 100 at a time and it will not delete messages older than 2 weeks. Example d!purge amounttodelete
Clone this wiki locally