VirtualChest - Provide virtual chest GUIs for menus like ChestCommands

A new version has been released for VirtualChest, it is available for download here.


  • Support both PlaceholderAPI 3.x and 4.x
  • Fix a bug that player cannot take any item out of his own inventory
  • Add support for restrictions of high frequency clicks, which can be configured in two ways:
    • Set the acceptable-action-interval-tick option (the minimal interval between two clicks in the same menu) in config/virtualchest/virtualchest.conf, default is 0 (no restrictions)
    • Add the AcceptableActionIntervalTick option in the menu config files (please see the example config file stored in the pluginā€™s jar), and it will override the rule set by the option in config/virtualchest/virtualchest.conf
  • There will not be any new features add to VirtualChest v0.3.x, instead the author will focus on VirtualChest v0.4.0 which contains many new features (such as JavaScript) while it will not be compatible with the configuration files based on v0.3.x

A new version has been released for VirtualChest, it is available for download here.


  • Add auto completion for selection menus by commands
  • Add Requirements option which uses JavaScript to check the players
  • Change the structure of two options, PrimaryAction and SecondaryAction

VirtualChest v0.4.0 is not compatible with the configuration files based on v0.3.x, and if you are able to upgrade your configurations to v0.4.0, there are some changes which should be mentioned:

  • Position-X-X becomes SlotX now, and Position-1-1 corresponds with Slot0, Position-9-6 corresponds with Slot53, etc.
  • RequiredBalances, RequiredPermissions, and RejectedPermissions are not available now, which should be replaced by Requirements
  • PrimaryRequiredItem, PrimaryAction, and KeepOpen are combined (altogether with SecondaryRequiredItem and SecondaryAction), and they are all available in the PrimaryAction section. For example:
// in v0.3.9
KeepOpen = true
PrimaryAction = "cost-item: 9; cost: -8"
    PrimaryRequiredItem {
    ItemType = "minecraft:wheat"
    Count = 9
    UnsafeDamage = 0
}
// in v0.4.0
PrimaryAction {
    Command = "cost-item: 9; cost: -8"
    HandheldItem {
        ItemType = "minecraft:wheat"
        Count = 9
        UnsafeDamage = 0
    }
    KeepInventoryOpen = true
}

For more information, please refer to the wiki.

1 Like

Hello,
Nice to see the new version, but unfortunatelly, I cantt get it work. I tried to delete the whole config folder and its generated a new one. On the server I canā€™t open any of the default examples. It just says "The specified chest GUI (example) is not found.

Do you know, why is this happening?
Sponge 1.10.2, API 5.2.0. Everything load correctly.

A new version has been released for VirtualChest, it is available for download here.


  • Fix a mistake in the codes that players cannot open menus by commands because of the wrong permission judgement

VirtualChest v0.4.1 is not compatible with the configuration files based on v0.3.x, and if you are able to upgrade your configurations to v0.4.1, there are some changes which should be mentioned:

  • Position-X-X becomes SlotX now, and Position-1-1 corresponds with Slot0, Position-9-6 corresponds with Slot53, etc.
  • RequiredBalances, RequiredPermissions, and RejectedPermissions are not available now, which should be replaced by Requirements
  • PrimaryRequiredItem, PrimaryAction, and KeepOpen are combined (altogether with SecondaryRequiredItem and SecondaryAction), and they are all available in the PrimaryAction section. For example:
// in v0.3.9
KeepOpen = true
PrimaryAction = "cost-item: 9; cost: -8"
PrimaryRequiredItem {
    ItemType = "minecraft:wheat"
    Count = 9
    UnsafeDamage = 0
}
// in v0.4.0
PrimaryAction {
    Command = "cost-item: 9; cost: -8"
    HandheldItem {
        ItemType = "minecraft:wheat"
        Count = 9
        UnsafeDamage = 0
    }
    KeepInventoryOpen = true
}

For more information, please refer to the wiki.

A new version has been released for VirtualChest, it is available for download here.


  • Fix the incorrect implementation of cost: 0
  • Fix some minor bugs occurred when loading configurations
  • Reduce the count of schedulers in the source codes for performance improvement

A new version has been released for VirtualChest, it is available for download here.


  • Fix the incorrect implementation of cost: 0
  • Fix some minor bugs occurred when loading configurations
  • Remove some redundant debug logs about script executing
  • Reduce the count of schedulers in the source codes for performance improvement

A new version has been released for VirtualChest, it is available for download here.


Fix a bug that actions cannot be executed by players who join the server for the second time

1 Like

A new version has been released for VirtualChest, it is available for download here.


  • Fix a bug that actions cannot be executed by players who join the server for the second time
1 Like

Im having issues with the %economy_balance% for requirementsā€¦

It used to work correctly in older versions but now it doesnt work for me at all. Iā€™m a bit confused as to why this isā€¦

Does not work on the latest version of SpongeForge 1.12.2.
All the menus worked normally before.
https://pastebin.com/ZggTYfpV

@Semenkovsky_Ivan Please refer to this pull request: https://github.com/SpongePowered/SpongeAPI/pull/1687
ItemEnchantment has changed to Enchantment and I should do some extra works to be compatiable with the latest version of Sponge 1.12.2 (SpongeAPI v7.0.0)

A new version has been released for VirtualChest, it is available for download here.


  • Fix an incompatibility issue with the latest version of Sponge 1.12.2 (#38)
  • Add OptionActionCommand and CloseActionCommand for executing commands when opening or closing menus, and examples can be found in example2.conf
1 Like

@Semenkovsky_Ivan Try v0.4.4 and test again if the new version has fixed this issue

Thanks for the update. The menus are working again. There are no errors.

A new version has been released for VirtualChest, it is available for download here.


  • Fix a bug that the previous action will be interrupted when a subsequent action is submitted

A new version has been released for VirtualChest, it is available for download here.


  • Add sound and sound-with-pitch actions (please refer to the wiki)
  • Fix a bug that the previous action will be interrupted when a subsequent action is submitted

loaded your mod onto a 1.12.2 spongeforge server and the default menus loaded donā€™t work when i try and open them. heres the error i get.
[00:00:47] [Server thread/INFO] [nucleus]: Delsolsi ran the command: /m-e2 [00 - Pastebin.com on a fresh install using luckperms latest release and nucleus.

A new version has been released for VirtualChest, it is available for download here.


  • Fix a bug occurred when sponge keys have duplicate data queries (#42)
  • Fix a bug that permission system based on CompletableFutures in api 7 is not supported (#43)
1 Like

A new version has been released for VirtualChest, it is available for download here.


  • Fix a bug that a slot sometimes will be non-empty even though there is not any matched item

A new version has been released for VirtualChest, it is available for download here.


  • Fix a bug that a slot sometimes will be non-empty even though there is not any matched item
  • Optimized JavaScript execution strategy for performance improvements (maybe it could fix #37)
  • Add PrimaryShiftAction and SecondaryShiftAction for shift-clicking (please refer to the wiki)
  • Add RepresentedPlayer attribute for setting skull heads instead of using UnsafeData (please refer to the wiki)
1 Like