https://github.com/marutypes/foundryvtt-maru-combat-themes

A better way to do combat start, start-round, end of combat sounds for FoundryVTT
https://github.com/marutypes/foundryvtt-maru-combat-themes

foundryvtt tabletop

Last synced: about 2 months ago
JSON representation

A better way to do combat start, start-round, end of combat sounds for FoundryVTT

• Host: GitHub
• URL: https://github.com/marutypes/foundryvtt-maru-combat-themes
• Owner: marutypes
• License: other
• Created: 2023-03-18T21:07:05.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-21T00:33:01.000Z (about 1 year ago)
• Last Synced: 2025-01-29T21:49:50.041Z (4 months ago)
• Topics: foundryvtt, tabletop
• Language: JavaScript
• Homepage:
• Size: 2.74 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![](https://img.shields.io/badge/Foundry-v10-informational)

![](https://img.shields.io/badge/Foundry-v11-informational)

[![Download Count](https://img.shields.io/github/downloads/marutypes/FoundryVTT-Maru-Combat-Themes/total.svg)]()

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Q5Q32OGH1)

# Maru's Combat Themes

FoundyVTT's combat theme system is kinda cool as an idea (especially for more fighting-tournament themed campaigns/adventures) but pretty impractical to actually use. It has no way to customize what sounds play or add new sounds other than going and messing in the core filesystem, and the theme choice isn't even synced to all players. I found this very frustrating and limiting, so what started as a module to add some explicit new themes turned into this.

**This module Creates an entirely separate synced combat theme system that supports setting playlists for different combat events, and syncs playing sounds for all players. This allows the GM to set a consistent audio theme and control the experience.**

I made this for my Fists of The Ruby Phoenix campaign, so for me this system has allowed me to make a fun little synced combat announcer experience using fighting game references for my players to enjoy.

## Usage

To change your theme, select it from the dropdown menu in `Settings -> Maru's Combat Themes`. You can also find settings for whether to use the extra sound effect hooks there as well.

![Settings window for Maru's Combat Themes](./pics/Settings-Panel.png)

### Themes

This module should be compatible with any other module that adds to the list of combat themes. For example [Toon32's theme pack](https://foundryvtt.com/packages/combat-tracker-theme-pack) should work just fine.

### Using Custom Playlists

I recommend setting up a playlist for each sound-cue.

- go to Settings -> Maru's Combat Themes

- set the theme to "custom"

- assign playlists for each audio queue

**Example playlist setup**

![Playlists setup for each combat sound cue](./pics/Playlist-Setup.png)

**Example playlist config**

![Custom playlist setup for Maru's Combat Themes](./pics/Settings-Panel-Custom.png)

## Audio sourcing

You can find tonnes of fighting game and announcer sounds to play with on https://www.sounds-resource.com. I make no claim to anything regarding their safety to use from an IP perspective though! Probably don't use them if you run a podcast for your game or something.

## Development

To work on a local version I'd reccomend this workflow:

- Install the module using the module.json the usual way

- Clone this repo locally

- Go to the repo dir and run `npm install` to get some dev dependencies

- Run `npm run watch {path-to-your-local-foundry-install}/Data/modules/maru-combat-themes`

    - The path to foundry is usually something like `C://Users/{YOUR NAME}/AppData/Local/FoundryVTT`

    - This will run a watcher that copies in changed files to your local install, very useful for local testing!