Add a \'Quick Action Bar\' to your dungeon to give your players an optional quick bar that they can use to switch their weapons with the first two items in their inventory, drink a health potion or drink an energy potion.
Permissions and credits
Credits and distribution permission
Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou are not allowed to convert this file to work on other games under any circumstances
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou must get permission to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Donation Points system
Please log in to find out whether this mod is receiving Donation Points
Changelogs
Version 1.1.2
The QuickBar now provides a couple of functions to make it easy to 'block' the hot keys temporarily. You can now call 'addHotKeyBlock("name")' to block hot keys and removeHotKeyBlock("name") to unblock them.
Version 1.1.1
Bug Fix: It is now possible to "Reset to Default" key config an unlimited number of times.
The QuickBar will now work in your mod even if you have set potions/flasks to be "stackable".
Version 1.1.0
It is now possible to right click on the buttons on the QuickBar and the buttons will work as expected.
Added the ability for the user to customise the HotKeys for their own game with a hot key config dialog.
Version 1.0.1
Refined right click hiding mechanism so that it doesn't hide if you click on a UI button.
Version 1.0.0
QuickBar snugs screen edges better.
Added a skinning system and 3 different skins for different screen sizes. Skins auto switch on screen resize.
Added function qb_script.setQuickBarForcedOff() to force quick bar off during cutscenes for example.
Tapping 1,2,3,4 now also changes the current quick bar selection.
QuickBar is hidden during right clicking and when all 4 champions are disabled.
Potions now default to correct value of 75pts.
Version 0.9.1
IMPROVEMENT: Disabled characters are now grayed out and cannot be selected.
IMPROVEMENT: QuickBar only scans the inventory 3 times a second instead of 60, to update potion counts.
IMPROVEMENT: Redefined shallowSearchInventory method to accept a variable number of parameters.
BUG FIX: doesn't destroy items that cannot be placed into the character's hand (for instance, trying to swap an orb into a warrior's hand).
Version 0.9.0
Initial Release.
** NOTE: This file is for modders to add to their own mods. You cannot just load this up with the standard Grimrock dungeon due to the modding structure of Grimrock. **
The Quick Action Bar is easy to add to your custom dungeon and it creates a panel that the player can toggle on/off and drag around the screen to a custom position. The quick action bar functions as follows;
The user can press ',' at any time to toggle the quickbar and '.' at any point to reset the position of the quick bar (incase it gets lost under the portraits).
The user can select an active champion from the 4 champion buttons on the left of the quick bar.
With a champion selected the three buttons do the following: 1. Pressing the sword/shield button will swap the items in the champion's hands with whatever is in the first and second slot in the character's inventory. 2. Pressing the healing potion button will consume a potion in ANY character's inventory (but not in sacks/chests) and applies it to the selected character. 3. Pressing the energy potion button will consume a potion in ANY character's inventory (but not in sacks/chests) and applies it to the selected character.
The user can click on the right hand side of the panel and move it anywhere on the screen.
The user can perform any of the above functions using the following hotkeys: i,o,k,l to select characters and 8,9,0 to activate any of the three buttons.
INSTALLATION & CUSTOMISATION
The README file contains instructions on installing this in your own mod. It only takes 3 steps and has been streamlined to be easy. There are a few things you can customise in the script, such as the hot key bindings and how much health a health potion should give you (in case you are not using standard health potion values - note that the quick bar cannot actually 'use' the potions in the game, it emulates it by turning it into a flask, making a drink sound and altering the player stats).