Skip to content
/ foundry-custom-hotbar Public template

Foundry VTT module to add an extra functional macro hotbar above the first.

License

Notifications You must be signed in to change notification settings

Norc/foundry-custom-hotbar

Repository files navigation

UPDATE: Initial v10 compatiblility release. There is a known issue where the shift keybindings for the custom hotbar are non-functional for now, but this should otherwise be functionally equivalent to the v10 version.

Custom Hotbar

Foundry VTT module to add an extra, fully functional macro hotbar above the core Foundry macro hotbar:

Image of custom hotbar

Module and system compatibility is a primary goal of Custom Hotbar. If Custom Hotbar isn't compatible with a module or system that you think it should be, please let me know as a GitHub issue or ping me on Discord (Norc#5108).

The Custom Hotbar now matches the core Foundry hotbar styling by default, but it can now be repositioned and recolored as needed, and the same control is also granted over the core Foundry hotbar:

Image of customized hotbar

Additionally, players (or GMs I guess!) can disable either hotbar entirely if they don't want it for themselves.

Lastly, additional keybinds are also available: Shift-Number to run a macro on the custom hotbar, and Ctrl-Shift-1 through 5 to change the core Foundry Hotbar page

Installation

Features

  1. Adds easy access to 10 additional macros in a separate visual grouping

  2. Provides advamced color and position control over both the existing core hotbar and new custom hotbars

  3. Fully system agnostic

    1. Tested with 5E, PF2E, and WFRP
    2. Requests for features that would help support specfic systems are welcomed
  4. Keybinding for changing Core Foundry Hotbar page (Ctrl-Shift-1 through 5) and new macro slots (Shift + digit)

  5. Full Token Hotbar module support This module was originally created to enhance Stan's Token Hotbar module. We encourage you to try the two modules together! Custom Hotbar and Token Hotbar in action:

    )

  6. Broad compatibility:

    1. Closely mimics built-in methods to allow modules like Midi QoL and Better Rolls to use the Custom Hotbar without specific support
    2. Does not interfere with the operation of the original Macro Hotbar

Changelog

See the changelog.

Roadmap:

Next releases (minor cleanup):

  1. Ongoing bug/stability/module compat cleanup for v9 as needed.

Next major version:

  1. Add ability to create multiple Custom Hotbars, not just one

Potential Future Features (Undecided)

  1. Add option to popout hotbars for positioning by dragging and dropping
  2. Add pages 2-4 or more for each Custom Hotbar.

Special Thanks

Special thanks to Ardistristan for his excellent Lib - Color Settings Module and extraordinary support as I implemented it! Thanks to DF (flamewave000) for the Library: DF Hotkeys library. Both of these libraries do a better job than I ever could.

Further thanks to Stan of Token Hotbar fame for everything he's done and to the awesome Foundry modding community as a whole.