Merch Reviews Music About Codex Creators Contact Join Discord
WhalleyBot Setup Guide banner
SCUM Server Automation

WhalleyBot Setup Guide

A complete setup and configuration guide for using WhalleyBot with your SCUM server, covering Discord channels, panel setup, IGC options, task commands, troubleshooting, and core administration workflows.

WhalleyBot Features

WhalleyBot offers different tiers of functionality to suit your server's needs. Choose between the Free version or upgrade to Premium for additional features.

Free Version

$0 USD / Month

Connect the bot to your Discord and tailor all admin channels, member channels and so much more. Including but not limited to:

  • Kill experiences - Kill feed in discord, rankings, hall of fame, etc
  • Chat logs - Admin only logs, public logs, in-game local, squad and global chat logs
  • Commands - Admin only, player only for pack purchase, coin bank info, server info, etc
  • PvP Tracking - Monitor kills, deaths, and other PvP statistics
  • Bank System - Basic coin economy for your server
  • Scheduled Tasks - Create automated tasks for your server
  • Outpost Config - Configure your server's outposts
  • API Access - Basic API endpoints for developers
RECOMMENDED

Premium Version

$15 USD / Month

All features listed in the free version are included with Premium. For most modern SCUM servers, WhalleyBot V3 is the recommended Premium self-hosted setup. Use the tabs below to review V3, panel features, modular options, and the older IGC workflow.

Current Setup Direction: Free self-hosted bots use WhalleyBot Connect. Premium self-hosted bots should use WhalleyBot V3.

Premium Overview

Premium includes everything from the Free version, plus expanded automation, advanced panel controls, and improved server management tools.

  • Includes everything from the Free version.
  • Uses WhalleyBot V3 as the recommended Premium self-hosted setup.
  • Unlocks the full custom WhalleyBot panel experience.
  • Gives server owners more control over in-game interactions, tasks, automation, and server workflows.

WhalleyBot V3 Recommended Setup

WhalleyBot V3 is the recommended setup for Premium self-hosted bots. Most major SCUM server providers now support V3, making it the preferred path for modern Premium deployments.

  • Recommended for Premium self-hosted WhalleyBot users.
  • Supported by many major SCUM hosting providers.
  • Uses the V3 plugin installed on the SCUM server.
  • Download the latest V3 plugin from the WhalleyBot panel.
  • The plugin can update itself on server start, helping keep the installation current.

Custom Bot Panel

The WhalleyBot panel contains the options used to customize the bot for Discord and in-game server workflows.

Owner and admin interface with full customization access:
  • Complete Discord channel customization
  • BattleMetrics server information
  • WhalleyBot Overwatch ban list and relevant Steam ban checks
  • Supported host workflows including GPORTAL, PingPerfect, GGHost, Deranged Hosting, and other supported providers
Manage in-game interactions and tasks like:
  • PVP and PVE
  • World events
  • Banking system
  • Fully customizable packs and items
  • Auto and boat trader
  • Taxi service
  • Lottery
  • Server messages and scheduled tasks

Fully Modular Design

WhalleyBot is designed so server owners can enable the systems they want and leave unused systems disabled. This keeps the bot flexible for different server styles, communities, and administration needs.

Legacy / Optional IGC Workflow

IGC is no longer the main recommended focus for most Premium self-hosted setups. It remains useful in specific cases, but Premium self-hosted servers should generally use V3 when possible.

  • IGC may still apply to older or special workflows.
  • To run IGC yourself, you need a PC capable of running SCUM and a separate copy of the game for that machine.
  • You cannot use the same computer as the IGC machine while also playing at the same time.
  • For most Premium self-hosted users, use V3 instead of WhalleyBot Connect or IGC.
Segment 1 of 5

IGC Hosting Service

If you do not have a 2nd PC, we offer IGC hosting at an additional cost of $45 USD/Month. See more below.

What does this mean for WhalleyBot users?

You will no longer need a 2nd PC to run the IGC if you don't have one and don't want to buy a PC to run 24/7 and skyrocket those power bills. We can host it for you (yes at a cost obviously) with almost no down time.

We supply the Steam account with the game, we set up the IGC for you and put it into your server for you, you just have to add the Steam ID we supply you with as admin to do the bot's tasks... I know, simple right!

Monthly Subscription
$45 USD
One-time Setup Fee
$15 USD
WhalleyBot Premium Subscription
Required

NOTE: Slots are LIMITED so make sure to get your spot while they last!

Q & A

Q: Will the cost of the IGC Hosting include the price of the bot itself?
A: No, unfortunately the cost of hosting the IGC is too costly.
Q: Will I have access to the PC where the bot is running?
A: No you will not have this access but in time we will allow you to see a screen capture of the PC and buttons to reset the IGC and Game.
Q: What if I have problems with the bot not delivering or not connecting to the server?
A: Let us know in our ⁠hosted-igc-support channel and we will have one of our Team members look into it and get it back online for you.

For current hosting availability, billing options, or addon questions, check with the official WhalleyBot Discord for the latest information.

Ask in Official WhalleyBot Discord

Need billing, account, or addon assistance? Open a support ticket in the official WhalleyBot Discord.

Owner's Manual Setup Guide

Welcome

Yay! You got a WhalleyBot! ….. Now what?

Lots of configuring. But first, please add your server/bot name to your nickname in the Whalley Bot discord so we know who you are. Next, link your profile in the panel so you can see all the support channels in the discord.

VERY IMPORTANT:

After making any changes in the panel, ALWAYS RESTART THE CONSOLE by pushing STOP and then START.

You don't need to do it after every change but when you're done with all of your changes for that session, make sure to restart so the bot picks up all your new changes. The only things that don't require a restart is adding/changing packs or editing existing tasks.

You will need to set up all the log channels in your discord for the bot to list the server log files in. You don't NEED all of the log channels but they're all handy to have for their own purposes. An example of the channels you might need is in #suggested-discord-channels. Alternatively you can use the onetimesetup command in your discord to let the bot create channels for you (not exhaustive). This command can only be used once, best used immediately.

Your bot needs to be running to use the onetimesetup command. Make sure you push Start in your console before using the command.

Once you have all your discord channels set up, you can start setting up your bot.

When ready, make sure to push "Start" on the console page. (This generally fixes the "My bot is offline!" comment we often get)

Discord Setup

At this point, you have the WhalleyBot already connected and in your Discord. You can now set up all of your custom Discord channels in the panel.

Before selecting the channels in your panel, you need to do the following:

  1. Create the channels in your Discord yourself. Review what channels you want to be private vs public. This may take some trial and error. We do not offer support for Discord setup and expect if you have questions on how to use Discord, please Google it.
  2. Make sure the bot has ADMIN access in your discord and to all channels. If it does not, the bot will not respond to commands.

You can now select which discord channels you want to use for what sections in the panel; scroll down and click save when finished.

NOTE: In the panel, under 'Admin Roles', only the Discord users who have this role can run admin commands. You can run the help command using your configured bot prefix, or use /help if slash commands are enabled, to show all commands.

Suggested Discord Channels

Here's a list of recommended Discord channels to create for your SCUM server with Whalley Bot:

Channel Name Purpose Access
welcome Welcome messages and server rules Public
announcements Server announcements and updates Public
server-info Information about the server settings and features Public
bot-commands Channel for players to use bot commands Public
kill-feed Automatic logging of player kills Public
death-feed Automatic logging of player deaths Public
chat-logs Logs of in-game chat Admin
admin-logs Logs of admin actions Admin
login-logs Player login/logout notifications Admin
lock-alerts Notifications for lockpicking attempts Admin
bot-shop Channel for the bot shop listings Public
rankings Player rankings and statistics Public
world-events Announcements for world events Public
taxi-service Channel for taxi commands Public
lottery Lottery announcements and winners Public
bounties Active bounties and completions Public
faction-overview Information about factions Public
quests Available quests and updates Public
igc-service IGC monitoring and control Admin
admin-commands Channel for admins to use bot commands Admin

Using the OneTimeSetup Command

To quickly set up the basic channels needed for your bot, you can use the !onetimesetup command in your Discord. The examples in this guide use the default ! prefix; replace ! with your configured bot prefix if your server uses something different. This will create a set of channels and automatically assign them in the panel.

The onetimesetup command can only be used once, and it's best used immediately after setting up your bot. Make sure your bot is running (press Start in the console) before using this command.

Channel Permissions

When setting up your Discord channels, consider the following permission recommendations:

  • Public Channels: Allow all members to view but consider restricting who can post in channels like announcements, server-info, kill-feed, etc.
  • Admin Channels: Restrict visibility to admin roles only
  • Command Channels: Make sure the bot has permissions to read and write messages, embed links, and attach files

It's a good practice to create separate categories in your Discord for public channels, admin channels, and log channels to keep everything organized.

Panel Setup

Prefix Note: Command examples use ! as a placeholder. Replace it with the command prefix configured in your own WhalleyBot settings.

After setting up your Discord channels, you'll need to configure the various sections in the Whalley Bot panel. Here's a step-by-step guide for each major section:

Remember: After making changes in any section, always click "Save" at the bottom of the page, and then refresh the page before continuing with your setup.

Commands

  • Use the !help or /help command to show ALL available commands.
  • As an admin, you can use all bot commands in any channel the bot has permission to write in.
  • Save changes.

Rankings

  1. Turn on, scroll down - click save, refresh. You can now start editing the settings.
  2. Customize when and how often your rankings are updated and reset.
  3. Save changes.

PvP

  1. Turn on, scroll down - click save, refresh. You can now start editing the settings.
  2. Select Discord channels and customize options.
  3. Save changes.

World Event

  1. Turn on, scroll down - click save. You can now start editing the settings.
  2. Update Change Time and Additional Loot Time
  3. Select Available Packs and Dedicated Channel
  4. Enter Event Locations

    You will have to use coordinates in this form: -331184.938 183572.828 85328.711

  5. Save changes.

Bank

  1. Turn on, scroll down - click save, refresh. You can now start editing the settings.
  2. Customize all options and select Discord channels.
  3. Setup your welcomepack, this is how players get linked in Discord to start earning/using coins. You need to create this under the Packs section in the panel, then select it in the dropdown in Bank
  4. Save changes.

Packs

How to Make Packs

  1. Create Categories for your pack:
    • Whalley Panel > Packs (Left Side) > Categories Tab (Top)
  2. Create a pack:
    • Whalley Panel > Packs (Left Side) > Create Pack Button (Top Right – Green)
  3. Fill in New Pack's Info:
    • Give it a name, Description (e.g., "3x Ammo"), Price in Coins, and DON'T forget Category!
    • Pack names have to be one word, do not include the word buy. The command will be !buy packname or /buy packname
  4. Once pack is made it will appear in your pack list. Click on the Pack's Name in the list!
  5. Upload Pack Image:
    • Click the "Upload Pack Image" button, then hit the purple "Select Image" Button, and select the image from your local files on your computer.
    • When you have the file selected, click Upload Image (White Button).
  6. Add Items to Pack:
    • Click the "Add Item to Pack" Button.
    • Type in item you want to add. (example: #spawnitem Canteen)
    • Repeat until you have all items in your pack submitted.
  7. Restart Panel when you have made all your packs.

Listing Packs in Discord

List by Category:

  1. Go to your Specific Shop section. Example Category guns, Discord Shop Section of Guns.
  2. Type in Discord !listcat guns
  3. This will automatically start pasting your shop items in that section for your players to see.

List by Pack:

  1. If you want to list by packs in a certain order, go to the specific section of Discord.
  2. Type in discord !listpack mp5k and hit Enter
  3. Type in discord !listpack mp5 and hit Enter
  4. Continue until all the packs you want are listed appropriately.

You can have multiple categories - vehicles, food, guns, ammo, etc. You can set up separate Discord channels for each category if you want.

Taxi

  1. Turn on, scroll down - click save, refresh. You can now start editing the settings.
  2. Setup Discord channel
  3. Customize Taxi locations
  4. Set up taxi rules by Discord roles NEW FEATURE
  5. Save changes.

Lottery

  1. Turn on, scroll down - click save, refresh. You can now start editing the settings.
  2. Setup randomized lottery when minimum players connect to the server.
  3. Select packs players can win, chances can be edited in each pack.
  4. Save changes.

You can force the lottery with Discord command !flottery and bot will pick the pack, or !flottery packname to force lottery with specific pack.

Auto Trade

  1. Turn on, scroll down - click save, refresh. You can now start editing the settings.
  2. Set custom pricing on all vehicles and boats.
  3. Add a vehicle trader to anywhere on the map; select car only OR boat only OR both.
  4. Save changes.

Additional Panel Sections

Depending on whether you have a free or premium bot, you'll have access to different sections in the panel. Here's a quick overview of other important sections you might need to configure:

Server Messages

Set up automated messages that will be broadcast in-game at regular intervals.

Premium Only

Scheduled Tasks

Create automated tasks that run at specified times or intervals.

Free & Premium

Language

Customize the bot's in-game messages and responses.

Premium Only

Interactive Map

Monitor player, flag, and vehicle locations in near real-time.

Premium Only

Bounty

Configure the bounty system where players can place bounties on other players.

Premium Only

Factions

Set up faction-based gameplay with territory control and rewards.

Premium Only

Quests

Create quests for players to complete for rewards.

Premium Only

Dead Drops

Set up locations where players can trade items for rewards.

Premium Only

Important: After making changes in the panel, ALWAYS RESTART THE CONSOLE by pushing STOP and then START to ensure your changes take effect.

WhalleyBot V3 Setup

You can now run the Premium version of WhalleyBot without a second dedicated PC.

This applies if you are self-hosted or using a supported SCUM server host.

Requirements

  • You must have a Premium license for WhalleyBot.
  • You must either be self-hosted or use a supported host.
  • Current supported hosts: Deranged Hosting, PingPerfect, XLGames, GGHost, Gaming Evolved, and GPORTAL.
  • If you are self-hosted, you must know how to edit your startup parameters and configure an RCON port.

How to Set Up V3

  1. Go to your bot's Main Settings.
  2. Set Connection Type to WhalleyBot V3.
  3. Download the WhalleyBot V3 Plugin.
  4. Stop your SCUM server.
  5. Extract the plugin into the root of your SCUM server folder.
  6. The root folder is the folder containing SCUM, Engine, and BattlEye.
  7. Generate your token from the panel.
  8. Place the WhalleyBotAPI.json file in SCUM\Saved\Config\WindowsServer\.
  9. For self-hosted servers, make sure your startup arguments include -RCONPort=YOUR-PORT.
  10. The RCON port number should be a port you have opened in your router or firewall.
  11. Add the RCON argument in the same command line area where -log is already located.
  12. If you use one of the supported hosts, they will usually handle the RCON port step for you.
  13. You may need to contact your host and ask them to enable the RCON port.

Plugin Update Note: Download the V3 plugin directly from your WhalleyBot panel instead of relying on older saved zip files. The plugin can update itself on server start, helping keep the server on the correct version going forward.

Things to Know About V3

  • The bot uses white in-game chat notifications instead of local chat. These notifications look similar to the game's standard status messages, such as the "I have to pee" notification.
  • If a message is intended for one player, only that player receives it.
  • If a message is intended for everyone, it is sent to everyone.
  • Scheduled tasks that required the bot to teleport before running other commands can no longer be done in V3.
  • Scheduled tasks using SpawnInventoryFullOf will no longer work, but that command can now be used in a pack.
  • Admin command logs have been corrected and should now report properly in V3.

V3 Note: WhalleyBot V3 reduces the need for a separate in-game controller PC, but setup still depends on your server host, connection type, RCON configuration, and current WhalleyBot panel options.

Supported Host Spotlight: Deranged Hosting

Deranged Hosting

Deranged Hosting is now a supported server host for WhalleyBot V3. When you host your SCUM server with Deranged Hosting, you receive WhalleyBot Premium for free.

Deranged Hosting is currently the only hosting company offering WhalleyBot Premium included with hosting, making it a strong option for server owners who want a supported host and premium bot features without a separate WhalleyBot Premium subscription.

  • WhalleyBot Premium included for free with hosting
  • Currently the only hosting company offering free WhalleyBot Premium with hosting
  • Official WhalleyBot V3 supported host
  • SCUM server hosting available
  • NVMe SSD storage
  • DDoS protection
  • US and EU server locations
  • Full control panel for server management
  • Free server transfer assistance from another host

WhalleyBot Connection Setup

Important: WhalleyBot Connect is for the Free self-hosted bot. If you are running a Premium self-hosted bot, use WhalleyBot V3 instead.

If you are self-hosting your SCUM server but want to use WhalleyBot, you have two options:

Option 1: Install/Setup an FTP server

Set up a traditional FTP server on your machine

Option 2: Use the Latest WhalleyBot Connect from the Panel

Use this only for the Free self-hosted bot. Premium self-hosted users should use WhalleyBot V3 instead.

What is WB Connect? Sweet and simple - It will quickly connect your SCUM server to WhalleyBot. It's faster than FTP and more stable.

How to Set Up WhalleyBot Connect for Free Self-Hosted Bots

1

Open the WhalleyBot Panel

Go to your WhalleyBot panel and open your bot's Main Settings.

2

Generate or Confirm Your Connection Key

Use the Self Hosted section in the panel to generate or confirm the connection key, then save the page so the setting is stored.

3

Download the Current Panel Version

Download WhalleyBot Connect directly from the WhalleyBot panel instead of using an old saved zip file from a guide page. The panel version is the one you should treat as current.

4

Run WhalleyBot Connect

  1. Extract or place the panel-provided files on your server machine.
  2. Start WhalleyBot Connect.
  3. Enter your connection key when prompted.
  4. Enter the root path of your SCUM server folder.
  5. The root folder is the folder that contains SCUM, Engine, and BattlEye.

Current Version Reminder: Do not rely on older downloadable zip files from this page. Always use the WhalleyBot panel for the newest available WhalleyBot Connect files and setup instructions.

Troubleshooting

You see "a connection attempt failed..." error?

Start your console. If it's already started, restart it.

A warning that you're not using the Self Hosted option

Enable the self hosted option in the Main Settings page.

Anything else?

Read the instructions again carefully or contact support.

Pro Tip: WhalleyBot Connect is the recommended method for self-hosted servers as it provides better performance and stability compared to traditional FTP.

Task Commands

Below is a comprehensive list of all available task commands for the Whalley Bot. These commands can be used in scheduled tasks to automate various functions on your SCUM server.

Task tips:

  • Remember to think about if the command is an in-game command or something you are running in discord and use the appropriate prefix (# vs ! or whatever your prefix is).
  • To add zombies to tasks, you will need to use "SpawnRandomZombie" or else the zombies will despawn. Be aware, there is a chance bombies will spawn in with this.
  • Packs can trigger #ftask for a while now but we've added the ability for this command to pass on the ordering player's Steam ID by adding [SteamID] to the command. The Steam ID will be passed on in the variable. Example: #ftask mytaskname [SteamID]. This should open up new creative tasks triggered by purchasing a pack.
  • The export command can now be done by bots without the Yes confirmation message. This means you can use the Schedule tasks to routinely post the command. This is a great way to periodically back up your data.
  • A scheduled task processes each line by line and either executes discord commands right away or pools the IGC portion all into 1 single order to be executed when the IGC has chance (exception for a few of the newer commands like playerlocation which gets info right away-ish). So by the time the IGC starts it's part, the console has pretty much done it's part (including taskpauses).

Basic Commands

Command Finder

Search by command name, description, or category. Use the dropdown to filter the list without scrolling through every command.

Command Description
Bank & Economy
#ftask TASK_NAMEForces a task to run. NOTE: This can be put into a pack for purchase with an argument that can be passed to the task, e.g. #ftask taskname [SteamID]. This will pass the steam ID of the person who ordered the pack into the task you're running.
#pack PACK_NAMESets a pack to be spawned
Player Management
#channel {Channel ID}Sets a Discord channel that may be used later on in tasks
#map X Y Z "My awesome map!"This will create a matching map to the event you are creating in a task and post it in discord. NOTE: You need to use the #channel command before this one to tell it which channel to post your map in.
#onlineplayercountYou can use the #OnlinePlayerCount tag in a task to be replaced by the player count. Similarly the {OnlinePlayerCount} in the server messages.
#PlayerLocation("STEAMID")Returns the X Y Z of the player - 10 Second timeout. Task will wait for a response.
#PlayerName("STEAMID")Returns the in-game name of the player
#PlayerOnline("STEAMID")Returns "true" or "false" can be used in the if/else condition
#PostOnlinePlayers [channel ID]Posts a list of online players in discord
#randomonlineplayer#RandomOnlinePlayer can be used inline with variables or game commands. The whole #RandomOnlinePlayer is replaced by the SteamID of a random online player (this does not include the IGC bot accounts). Example #spawnitem rag 1 location #RandomOnlinePlayer
#RandomPlayerNameYou can use #RaNdOmPlAyErNaMe command in line with what ever other command after you would use the #RandomOnlinePlayer function. Example would be to do a #global #RaNdOmPlAyErNaMe has been chosen!
#taskpause {seconds}Pauses the task at the console level, this is for times that sending a messages in discord requires a precise order.
#teleport {location}Teleports the bot to a location
Server Messages
#announce [text]Announce in game
#channelmessage {Channel ID} {Message}Posts a message in the channel you specify in the command
#consolePrints a message to the console, can be used to check variables you defined earlier, e.g. #console( )
#global [text]Post in global chat in game
World Events
#currentworldeventReturns the name of the current World Event - useful for debugging or as a condition in the IF/ELSE
#eventsThis will toggle the admin settings for the in-game events. It will toggle blindly and NOT set particular on/off)
#lootThis will set the loot spawn rates. The Line is from the top (choices of 4 line) and Value is the desired value to be set and can be whole number or one decimal place and MUST be used with a period as separator (4 and 7.6 are acceptable values). You do not have to include all lines.
Vehicles & Taxi
#DisableTaxi "TAXINAME"Will automatically Disable a taxi and reload the Taxi channel
#EnableTaxi "TAXINAME"Will automatically Enable a taxi and reload the Taxi channel
Admin Tools
#consoleonlyAllows you to see the actions of the task in the console so you don't have to worry about it being executed on the server live. Note: This does not print the settings changes like #sentries or #raids (they would actually be sent to IGC if they were in the task)
#LastRanHours("TASKNAME")You need to specify the task name and it will return an amount in Hours since that task was last ran
#LastRanMinutes("TASKNAME")You need to specify the task name and it will return an amount in Minutes since that task was last ran
#location {Coordinates}Sets a location to be used later on in tasks. Format = #location "X Y Z"
#sentriesThis will toggle the admin setting for the Sentries. It will toggle blindly and NOT set particular on/off)
#var_VARNAMECreates a variable to be used later in the task, replace VARNAME with whatever you want
General
#clearchannelClears the channel you set earlier, can also be written with a specific channel, e.g. #clearchannel {Channel ID}
#maptpto3pmNot recommended to use but creates a map in a channel at random coordinates
#publishserversettingsThis will publish the server settings to your server. Server Restart will be required for changes to take. Used along with ServerSetting command.
#Random(MIN, MAX)This will return a random number between the min and the max values and only usable in a variable right now.
#random3pmcoordinatesGrabs a random coordinate for a location, with a Z valid on the ground. Can be used to create a location variable, e.g #Var_location (#random3pmcoordinates)
#randomcoordinatesGrabs a random coordinate with a pure random X and Y portion and a z=0
#restartremainingtimeWill allow you to post in game when a server restart is expected.
#ServerSetting("SettingName")Use this to get a server setting value - NOTE: BACK UP YOUR SERVER SETTINGS BEFORE PLAYING WITH THIS ONE
#ServerSetting("SettingName", "New value")Use this to set a server setting value, e.g. #ServerSetting("ServerName", "MY AWESOME SERVER!") (ServerName has a max of 64 characters, if you go over this you get the SCUM Server default name)
#waitPauses the IGC before processing anything else

Feature Toggle Commands

These commands function the same as the settings command in Discord:

Command Description
Server Messages
#raids [on/off] [0/1/2]NOTE: 0 is both settings, 1 is lockpicks and 2 is base damage - if no options selected, 0 is selected by default. Changes in-game server settings (Global zone only, bot does not know your custom zones). Restart of the server is NOT required for this change.
World Events
#world_event [on/off]Enable or disable the world event feature
Vehicles & Taxi
#taxi [on/off]Enable or disable the taxi feature
Admin Tools
#factions [on/off]Turn the factions feature on/off using schedule
#purge [on/off]You can set a task to disable/enable PVE (separate task to enable and disable). The state to set can be on/1/enable or off/0/disable. Purge changes the BOT PVE settings.

Conditional Commands

These commands allow you to create conditional logic in your tasks. At minimum, you need an #if and #endif:

Command Description
Admin Tools
#if (CONDITIONS)Start of the conditions - can use basic operators == < > =< => and Any Task command that returns an output or variable
General
#else ifAdditional condition to check if the first condition fails
#elseElse allows for 1 condition or another if the first has failed. Useful for a fallback
#endifRequired to end the IF statement

Example Tasks

Here are some example tasks to help you get started:

Random Player Reward

# This task gives a random online player a reward
#console Starting random player reward task
#if (#onlineplayercount > 0)
  #var_randomPlayer (#randomonlineplayer)
  #var_playerName (#PlayerName())
  #global Congratulations to  for winning a random reward!
  #spawnitem BP_MRE_01 1 location 
  #console Reward given to 
#else
  #console No players online, skipping reward
#endif

Scheduled Server Message

# This task posts a server message based on time of day
#var_hour (#CurrentHour)
#if ( >= 20)
  #global Good evening survivors! The night is dangerous, be careful out there!
#else if ( >= 12)
  #global Good afternoon survivors! Don't forget to check out our events!
#else
  #global Good morning survivors! Have a great day in the wasteland!
#endif

Important: These are WhalleyBot Discord commands posted and used inside Discord. The examples below use the default ! command prefix. If your server uses a different prefix, replace ! with the prefix configured in your bot settings. Items inside [brackets] are required arguments and should be replaced with your own values.

Example: !player [SteamID/DiscordID] becomes !player 726417539638493196. If your configured prefix is ?, the same command would be ?player 726417539638493196.

Video Setup Guide

Since this is from the 1.0 Version of the website, some information may be outdated, always refere to the WhalleyBot Discord.

Watch this comprehensive video guide that walks you through the Whalley Bot setup process:

Whalley Bot Setup Guide

This video tutorial demonstrates the complete setup process for Whalley Bot on your SCUM server. Follow along to configure your bot correctly and learn about all the available features.

Video Chapters:

  • 0:00 - Introduction
  • 1:23 - Initial Setup
  • 4:56 - Discord Configuration
  • 8:32 - Panel Settings
  • 12:45 - IGC Setup
  • 17:18 - Creating Packs
  • 22:04 - Testing Your Bot

Troubleshooting

Encountering issues with your Whalley Bot? Here are solutions to common problems:

Discord bot not showing online?

Check if the bot is running on Whalley panel. (Turned on)

Whalley Bot (IGC) showing not connected?

Restart Discord bot and Whalley Bot (IGC)

Drone is not teleporting to player?

Check if the game and windows have ENG language selected

Drone is not spawning all the items?

Make sure you write down all the correct "ItemID" inside pack.

Drone is still not spawning all the items?

Watch the chat while the bot is spawning items. If it is too fast, adjust the "TYPE SPEED" on the IGC to 2 or 3

Bot cannot login back after restart?

Check the windows resolution: have to be 100% scaling! If continue: Adjust MS Speed to higher value

Whalley Bot (IGC) Shows game running, but its closed!

Close the SCUM in Task Manager!

IGC Says Logged out, but Drone is logged IN?

Check if you are getting login log in the Discord. It can be a log issue. IGC Rely on logs to know if Drone is logged in!

My Tasks are being activated at times other than the set hours (30min after the set time or every minute)

You have to go back into the task and select the "every hour" then remove the unwanted minutes. For the case of your task happening "every minute" you should select at least one choice (most likely the 00). Then select "every day" again and click save.

How do I get the daily and welcome pack buttons?

Always check your !help command in your discord to see a list of all available commands.

Use !selfserve (by itself for the default buttons or input the buttons you want, the options are listed in your !help command)

The Welcome Pack buttons are separate (no they can't be combined). Use !welcomebutton

NOTHING IS WORKING RIGHT!

  1. Always, ALWAYS restart the console as your first troubleshooting step, and especially after you change anything in the panel/website. Use the stop/start buttons, or type !restartpanel in your admin commands channel in your discord.
  2. (For Premium only) If that doesn't work, shut everything down (IGC/SCUM/Console). Then start the console first, let it load in. Then start the IGC and only the IGC. Let it open SCUM. DON'T TOUCH THE IGC COMPUTER AFTER THAT.
  3. Check the console (on the website) for any errors that might give you a clue to your issue. Either fix the issue or take a screenshot and post in the support channels or make a ticket.
  4. Check the IGC for any errors. Check the log tab for any errors. Either fix the issue or take a screenshot and post in the support channels or make a ticket.
  5. If that doesn't work, make sure none of your admins changed anything on you.
  6. If that doesn't work, post in the Whalley Bot Discord support channels with relevant screenshots or make a ticket.

Important Note

WhalleyBot is actively maintained and continues to receive new features, fixes, and improvements. As a result, certain commands, interface elements, and setup procedures may change over time.

If you encounter an issue, need assistance with configuration, or have questions about the latest version, the official WhalleyBot Discord is the best place to receive support directly from the developers and community.

Disclaimer

Jade Vanity Gaming does not own, develop, maintain, or officially represent WhalleyBot, nor do we claim ownership of any WhalleyBot software, assets, branding, documentation, or intellectual property. This guide is an independent community resource created to help SCUM server owners install, configure, and use WhalleyBot more effectively.

All rights to WhalleyBot, its software, branding, and associated assets remain the property of their respective owner(s) and developer(s). This guide is provided for educational and informational purposes only.

Official WhalleyBot Discord

Join Official WhalleyBot Discord