LordAshes-CustomDicePlugin icon

CustomDicePlugin

Allows accessing up to ten custom dice sets.

Last updated 2 years ago
Total downloads 1628
Total rating 0 
Categories Integration Assets
Dependency string LordAshes-CustomDicePlugin-1.1.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

bbepisTaleSpire-BepInExPack-5.4.10 icon
bbepisTaleSpire-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.10
brcoding-SetInjectionFlagPlugin-2.3.0 icon
brcoding-SetInjectionFlagPlugin

Allows players to flag mods are installed

Preferred version: 2.3.0
LordAshes-FileAccessPlugin-1.3.1 icon
LordAshes-FileAccessPlugin

Provides standardized methods for accessing both local file and url resources. Automatically handles searching local folders for assets.

Preferred version: 1.3.1

README

Custom Dice Plugin

This unofficial TaleSpire plugin for providing access to up to ten different dice sets. The current dice set is applied when dice are taken out of the tray and thus different custom dice sets can be used at the same time.

Preview

Change Log

1.1.0: Renamed dice files to have a die extension to avoid conflict with EAR 1.0.0: Initial release

Install

Install using R2ModMan or similar.

Warning: Updating this plugin (like all other plugins) will remove/overwrite all custom content in the plugin folder. If you have placed custom dice there, ensure that you save them elsewhere before updating.

Usage

When Tale Spire is started the default dice tray (01) is selected. When any dice are pulled out of the dice tray they will automatically be customized to match the appearance of the dice tray 01 dice (the dice in TaleSpire_CustomData/Misc/dice01).

The current dice tray can be swapped by holding left control and pressing a number on the numeric keypad (1 thru 9 and 0 for 10). Ensure that Num Lock is turned on for this swap to work. If done correctly a display message will appear indicating the dice try style swap. Switching the current dice tray does not change any dice already on the board but it changes any future dice that are drawn from the dice tray.

Player Dice

At the moment dice trays cannot be associated with players. However, if players draw their dice at the beginning of the game and do not generally draw additional dice during the game, you can "asssociated" different dice sets with different players by doing the following:

  1. Select Dice Tray 01 and draw all the dice that you will need.
  2. Select Dice Tray 02 and have the next player draw their dice.
  3. Select Dice Tray 03 and have the next player draw their dice.

Repeat as needed. The important key to the process is that players draw their dice in order (and not at the same time) so that the dice tray can be swapped in between each player's draw.

Making Custom Dice

Each custom dice tray is an assetBunlde in the TaleSpire_CustomData/Misc/ folder with the name "dice01.die" thru "dice10.die". The assetBundle must contain prefabs called d4, d6, d8, d10, d100, d12 and d20.

Easiest Method

The plugin comes with a ZIP file that has the default meshes for each die type and sample texture files which indicated which part of the texture map corresponds to which side of the dice. The easiest way to make custom dice is to use the provided meshes and just apply your own custom textures.

Customizing Meshes

If you want to customize the dice meshes, try to ensure that the center of each dice type matches the center of the provided meshes. This will ensure that the custom meshes will line up with the core TS dice underneath. However, the R2ModMan configuration for the plugin does allow each type of die to be adjusted manually by specifying exact rotations, position offsets and scaling. Just be aware that the settings are common to all dice trays, so ensure that all dice trays are based on the same meshes or at least meshes that use the same settings.

Limitations

The current custom dice do not use the TS numbers for the sides. In the future, this plugin may make use of that to provide features like glowing rolled side.

Since the plugin adds an exterior shell to the core TS dice, they can appear to be a little "heavy" (especially the D10) and sink somewhat into the table. This cannot be avoided with this implementation of Custom Dice but it has no effect on the rolling of the die.