Sophie's Dice - Documentation

Customising Dice

Sophie's Dice allows a great deal of customisation of your dice, this page explains all the ways you can make dice your own.

Custom Dice Folder:

When you open Sophie's Dice for the first time, a Custom Dice folder is made. Sophie's Dice loads all dice, images, and sound effects from this folder.

If you have any dice .xml files, or images and sound effects that you wish to customise your dice with, place them in this folder and they will be loaded when you open Sophie's Dice.

The location for of this folder on PC is:

On Android, the location is:

On iOS, the location is in the Files app:
On My {Your Device Name}/Sophie's Dice/CustomDice/

Opening the die edit screen

To edit a die, locate it on your hotbar and right-click on it (long-press on Android). This will open a pop-up menu allowing you to delete (the trash can icon), clone (the copy icon), move (the arrow and bag icon), or edit (the wrench icon) the die.

Click/tap the wrench icon to open the die edit screen.

Die Edit screen overview

The die edit screen is made up of three core parts:
If your display is in landscape mode you will be able to see all of these at once, if you have a portrait display you will view them one at a time, with buttons to switch between them.

There are also controls along the bottom:

Die Properties Panel

The Die Properties panel is where you specify everything that applies to the die as a whole - it's shape, size, colour, and also things that will apply to all faces that have not been otherwise customised.

Die Label

This is essentially the "name" of the kind of die you are making, it will be displayed on the hotbar, and also be used when making roll expressions using dice notation.

For example, if you have a die with the label "magicWeapon", you will be able to use it in roll expressions:
Which will roll four of your magicWeapon dice and add 11 to the result.


The shape of your die. Click the "change" button to bring up a menu listing all of the dice shapes.
You will be able to see how many faces each shape has, a preview image of the shape, it's name, and also some information on it's tested deviation.
Every die shape included in Sophie's Dice has been tested thousands of times (sometimes millions) to ensure fairness. Some of the shapes in the "Novelty" category however cannot be considered fair dice shapes, and should not be used in cases where you need random selection where each possibility has an equal chance of selection.

If you are unsure if a die shape is fair, check its Tested Deviation, Anything less than 2% can be considered a very fair shape (Most physical dice are not even this fair).


Adjusts the scaling of your die. Most die shapes cannot be stretched and remain fair, so this option is hidden in those cases.

Appearance settings

Adjust the dice material, colors, and also face font and face colours here. These settings are entirely cosmetic and will not effect how your die rolls.
The two die colors will determine the marbled colour of the die surface, the face color will be applied to all faces except the face which is pointing up - that face will use the highlight color instead.

Face Properties Panel

The Face Properties panel is where you configure each individual face - what value it has, and its appearance. Faces are listed in order here, and how many faces there are is determined by the die shape.


A face's "value" is what the result of a roll of your die will be if the face points up. It will be added or listed to the roll results, and be used when evaluating roll expressions that include your die.

There are four kinds of value your die faces can have:
A note on String values:
String value faces can be random within the face also, just like a Range value. For example, a face with this string value:
will randomly select one of the strings between each vertical bar (|) character. And could randomly settle on "attack", "defend", or "escape".

It is also possible to have string face values that contain multiple values. For example:
will add "attack" to the results twice, and also "defend".

You can make a face roll a dice expression using standard notation by having a string value in square brackets:
will roll 4d6 and pass the result as the result for this die. To learn more about sub-expressions and dice notation, see the Notation page of the documentation.

If you want a face that has no value, you can have an empty string. (a zero number value will still be counted)


A face's "Display" is what is physically displayed on the die, and is not referred to when checking roll results or evaluating roll expressions. The face display is purely aesthetic.

A face can have one of three display types:
A note on face displays:
It is possible to make misleading face displays (i.e. a face value of "20" when the display shows "1"). How you use/abuse this power is up to you, but if you lose friends by being a jerk then that is on you. My advice is that you try to be a good and honest person.

Extra face options

Behind a "Show More" toggle button are some extra options for each face, here you can adjust the display size and color of the face (overwriting the face color settings on the Die Properties panel), and you can also select a sound effect or visual effect that will play when the die settles on this face.

Die Preview

Use the die preview to view what your die will look like. Rotate it by dragging, or if you want to see a specific face then just make a change to it in the Face Properties panel and the die preview will rotate to that face.
Documentation index

Sophie's Dice