Skip to content

Conversation

@DavidCQ80
Copy link

Storage Management A way to list items the players have collected during their adventures in a magical bag, sack or hole that calculates weight and amount. It stores this in a handout created when !dimensionbag add "Bag Name" "quantity item weight" is run.

!storageconfig — Opens the configuration menu. *Configuration Commands

!storageconfig — Opens the configuration menu.
*Configuration Commands

!setbagmax [number] — Sets the max weight for the Dimension Bag.
!setsackmax [number] — Sets the max weight for the Sack.
!setholemax — Resets the Moveable Hole to unlimited weight.
!setcoins [comma-separated values] — Updates the order of coin types (e.g., !setcoins PP, GP, SP, CP).
!setcolor [color name or hex] — Changes the text color for item quantity.
*Storage Commands

!dimensionbag add "Bag Name" [quantity] [item] [weight] — Adds an item to a Dimension Bag.
!dimensionbag remove "Bag Name" [quantity] [item] — Removes an item from a Dimension Bag.
!sack add "Sack Name" [quantity] [item] [weight] — Adds an item to a Sack.
!sack remove "Sack Name" [quantity] [item] — Removes an item from a Sack.
!hole add "Hole Name" [quantity] [item] [weight] — Adds an item to a Moveable Hole.
!hole remove "Hole Name" [quantity] [item] — Removes an item from a Moveable Hole. *Each storage type has its own max weight (except the hole, which is unlimited). */

This script creates a bag, sack, or hole handout that will track Items, amount, weight and overall weight.
To add items to the bag, sack or hole you will need to use one of these macros:
!dimensionbag add ["Bag Name"] [Amount] ["Item"] [Weight]
!sack add ["Sack Name"] [Amount] ["Item"] [Weight]
!hole add ["Hole Name"] [Amount] ["Item"] [Weight]
To remove items from the bag, sack or hole use these macros:
!dimensionbag remove ["Bag Name"] [Amount] ["Item"]
!sack remove ["Sack Name"] [Amount] ["Item"]
!hole remove ["Hole Name"] [Amount] ["Item"]
If the weight threshold is reached a message is posted in chat to alert the players that the bag or sack is overloaded and its contents are lost. The hole has unlimited weight but its up to the GM to determine if too much space is taken up to be able to fit anymore in.
@Alicekb
Copy link
Contributor

Alicekb commented Jul 16, 2025

@DavidCQ80 Please take a look at the contributing guide: https://github.com/Roll20/roll20-api-scripts?tab=readme-ov-file#creating-a-scriptjson-file

Your api script PR should match the folder structure of the example api script found in the guide. The guide also has an explanation and example of the correct script.json file.

@kfroll20
Copy link
Contributor

@DavidCQ80, just wanting to follow up with you about this PR to make sure you're aware of the requested changes!

@DavidCQ80
Copy link
Author

DavidCQ80 commented Jul 29, 2025 via email

@kfroll20
Copy link
Contributor

@DavidCQ80, no problem at all! Thank you for updating :)

@Alicekb Alicekb marked this pull request as draft August 7, 2025 16:00
@kfroll20
Copy link
Contributor

Hello, @DavidCQ80! We are going to close this for now and when you're ready, feel free to open a new PR!

Thanks!

@kfroll20 kfroll20 closed this Aug 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants