Skip to content
NordBots.
Back to RollTheDice

RollTheDice configuration editor

Set everything with sliders and toggles, then export your config.json. Your progress saves in this browser as you go. See the docs for what each setting does.

Ready to edit

Templates

Save the current settings as a named template, then load it any time. Stored in this browser.

No templates yet.

General

Debug

Debug: set to true to write extra lines to ArkApi.log. Handy when something is not working and you want to see why. Leave false for normal play.

AutosaveSeconds

AutosaveSeconds: how often the game saves player stats and the jackpot to disk. 30 means every 30 seconds. A smaller number saves more often but touches the disk more. 30 is a good pick for most servers.

Commands

Commands: the words players type in chat to use the game. You can rename any of them. Set one to "" (empty) to turn that command off.

RollCMD

play the game. Type /roll <bet>. You can also add a target, like /roll 100 75.

FreeCMD

one free roll each day. No points needed.

StatsCMD

show your wins, losses, and win streak.

JackpotCMD

show how big the jackpot is right now.

VerifyCMD

show the fair play seed so players can check the rolls are honest.

Game

Game: the rules and numbers that shape how the game plays.

MinBet

MinBet and MaxBet: the smallest and biggest number of points a player can bet.

MaxBet

WinThreshold

WinThreshold: every roll is a number from 1 to 100. In the normal mode, a player wins if their roll is this number or higher. 50 gives about a coin flip. A higher number makes wins rarer.

ClassicMultiplier

ClassicMultiplier: how much a normal win pays. 1.9 means a 100 point bet pays back 190 points on a win. Keep it under 2.0 so the house keeps a small edge and the point economy stays healthy.

HouseEdge

HouseEdge: the small cut the server takes in target mode. 0.03 means 3 percent. Bigger numbers make target mode pay less and protect your economy more.

JackpotNumber

JackpotNumber: roll this exact number to win the whole jackpot pool. 100 is the rarest roll, so the jackpot is hard to hit. That keeps it exciting.

JackpotContributionPct

JackpotContributionPct: each time a player loses a bet, this share of that bet is added to the jackpot pool. 0.05 means 5 percent. This grows the jackpot over time.

JackpotSeed

JackpotSeed: the jackpot resets to this many points right after someone wins it. So the pool is never empty.

MaxPayout

MaxPayout: the most points a single win can ever pay. This is a safety cap so one lucky player can not drain your whole economy in one roll.

RollCooldownSeconds

RollCooldownSeconds: how long a player must wait between paid rolls. This stops spam and protects your economy. VIP players can get a shorter wait (see Tiers).

FreeRollReward

FreeRollReward: how many points a player wins if their daily free roll wins.

StreakMilestones

StreakMilestones and StreakBonusPct: reward win streaks. When a player wins this many times in a row, their next win pays a bonus. The two lists line up by spot. Below: 3 wins in a row gives 10 percent extra, 5 gives 25 percent, 10 gives 50 percent.

StreakBonusPct

Tiers

Tiers: special limits for players in a permission group (needs the Permissions plugin). A player who has the RollTheDice.Vip permission gets these numbers instead of the normal Game numbers. Here VIPs can bet more and wait less between rolls.

RollTheDice.Vip

MaxBet

RollCooldownSeconds

Database

Database: where the game saves player stats and the jackpot. Right now the game saves to a simple file (data.json) next to the plugin. These options are ready for the MySQL and SQLite backend, which is coming next.

UseMySQL

false uses a local file. true uses a MySQL server (fill in the rows below).

Host

the address of your MySQL server.

Port

the MySQL port. 3306 is the normal one.

User

your MySQL user name.

Password

your MySQL password.

Database

the name of the MySQL database to use.

TablePrefix

the start of each table name, like rtd_players.

SQLiteDatabasePath

leave blank to use the default file. Only used when UseMySQL is false.

Permissions

Permissions: lock the game to certain players or groups (needs the Permissions plugin). Groups and nodes: RollTheDice.Play (can play), RollTheDice.Vip (better limits), RollTheDice.NoCooldown (no wait), RollTheDice.Admin (can use admin commands). If the Permissions plugin is not installed, everyone can play.

Enabled

ArkShop

ArkShop: use ArkShop points as the bet and the prize (needs the ArkShop plugin). If ArkShop is not installed, the game gives each player their own points to play with.

Enabled

Discord

Discord: post game news to a Discord channel with a webhook.

Enabled

you MUST set this to true or nothing will send.

WebhookURL

paste the full webhook link from Discord here.

AlertWebhookURL

a second webhook for odd or unfair looking events. Leave blank to use the main one.

Username

the name the bot uses when it posts.

ServerName

your server name. It shows at the bottom of each post.

MinEventToLog

only post a paid win if it paid at least this many points. 0 posts them all.

LogFreeRolls

post free roll results too. These are low volume, one per player per day.