Skip to content

Dimension Storage #2085

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 6 commits into
base: master
Choose a base branch
from
Draft

Dimension Storage #2085

wants to merge 6 commits into from

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
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