DnDUtil

A mod for On-Together that adds Dungeons & Dragons utilities to enhance your tabletop gaming experience.

Features

• Dice Rolling: Roll any combination of dice (d4, d6, d8, d10, d12, d20, d100, etc.)
• Flexible Broadcasting: Send results to yourself, local chat, or global chat
• Customizable Announcer: Configure the name displayed when broadcasting rolls
• In-Game Commands: Easy-to-use slash commands for all features
• Toggleable Features: Enable/disable mod features as needed

Commands

Core Commands

• /help dnd - Display a list of all available DnD mod commands in-game

• /roll XdY [MdN ...] - Roll dice with specified sides

  • X = number of dice to roll
  • Y = number of sides on each die
  • You can roll multiple dice types in one command
  • Examples:
    • /roll 1d20 - Roll one 20-sided die
    • /roll 2d6 - Roll two 6-sided dice
    • /roll 2d20 1d6 1d4 - Roll two d20s, one d6, and one d4
    • /roll d20 - Roll a single d20 (X defaults to 1)

Configuration Commands

• /setannouncerarea [self|local|global] - Set where roll results are displayed

  • self - Only you see the results (default)
  • local - Nearby players see the results
  • global - All players see the results
  • Example: /setannouncerarea global

• /setannouncername [name] - Set the display name for roll announcements

  • Default: "DnDSystem"
  • Example: /setannouncername DungeonMaster

• /showusercommand - Toggle visibility of your commands in chat

  • When enabled, other players see your command (e.g., "/roll 2d20")
  • When disabled, only the results are shown
  • Default: hidden

• /usedndfeature - Enable or disable all DnD utility features

Installation

Automatic Installation (Recommended)

1. Install r2modman or Thunderstore Mod Manager
2. Look for On-Together game
3. Search for "DnDUtil" in the mod manager
4. Click "Install"
5. Launch the game through the mod manager

Manual Installation

1. Install BepInEx for On-Together:

   • Download the appropriate BepInEx version for your platform
   • Extract BepInEx to your game's installation directory
   • Run the game once to generate BepInEx configuration files

2. Download DnDUtil:

   • Get the latest release from GitHub or Thunderstore

3. Install DnDUtil:

   • Extract the DnDUtil archive
   • Copy the contents to your game's installation directory
   • Merge folders when prompted

Configuration

Configuration files are automatically created in BepInEx/config/ after first launch.

com.andrewlin.ontogether.dndmod.cfg:

• EnableFeature - Enable/disable the mod (default: true)
• ShowCommand - Show commands in chat (default: false)
• AnnouncerChatName - Display name for announcements (default: "DnDSystem")
• AnnouncerArea - Where to broadcast rolls: self|local|global (default: "self")

Usage Examples

Basic Rolling

/roll 1d20          → Roll for initiative!
/roll 2d6           → Roll damage for a greatsword
/roll 4d6           → Roll stats for character creation

Multiple Dice

/roll 1d20 8d6      → Roll attack with spell damage
/roll 1d20 1d4      → Roll with bardic inspiration

Broadcasting to Others

/setannouncerarea global    → Set to global chat
/roll 1d20                  → Everyone sees your roll
/setannouncerarea self      → Back to private rolling

Custom Announcer Name

/setannouncername DM        → Set name to "DM"
/roll 1d20                  → "DM rolled 1d20: 15"

Support

For bug reports, feature requests, or questions:

• Open an issue on GitHub
• Contact the mod author on the On-Together community Discord

License

See LICENSE file for details.

Changelog

All notable changes to DnDUtil will be documented in this file.

[0.0.7] - 2026-02-22

Changed

• Default AnnouncerArea (/dsaa) is now local

Removed

• Help command /help is removed. Please use /dndhelp

[0.0.6] - 2026-02-20

Changed

• Renamed /usedndfeature (/udf) to /dndtoggle (/dt)
• Renamed /setannouncerarea (/saa) to /dndsetannouncerarea (/dsaa)
• Renamed /setannouncername (/san) to /dndsetannouncername (/dsan)
• Announcer Area defaults to local
• Internal refactor: extracted DndRollCommand base class; command files renamed with Dnd prefix

[0.0.5] - 2026-02-16

Fixed

• Help text for OfficerBalls mods are no longer 'eaten'

[0.0.4] - 2026-02-15

Added

• Short command aliases for all commands (e.g., /r for /roll, /h for /help)
• Short names displayed in help command output

Changed

• Improved help command text and formatting
• Commands no longer interfere with or clean other game commands

Fixed

• Help text display issues

[0.0.3] - 2026-02-15

Changed

• Improved documentation with comprehensive usage examples
• Documentation cleanup and restructuring

[0.0.2] - 2026-02-15

Added

• Announcer area configuration (self/local/global broadcast)
• Commands to set announcer area and name
• Message scoping by selected area

Changed

• Announcements now properly identified by area scope

[0.0.1] - 2026-02-15

Added

• Initial release
• Basic dice rolling functionality (/roll XdY)
• Multiple dice rolling in single command
• BepInEx plugin integration
• Chat notification system