Difference between revisions of "Extensions:Crafting System"
Draginraptor (talk | contribs) m Tag: 2017 source edit |
Draginraptor (talk | contribs) (Added information on the Recipe Item Tag feature) Tag: 2017 source edit |
||
| Line 19: | Line 19: | ||
By default, recipes are immediately available to users, but can also be set to require unlocking. If unlocking is required, a user will need to acquire the Recipe before being able to craft it. | By default, recipes are immediately available to users, but can also be set to require unlocking. If unlocking is required, a user will need to acquire the Recipe before being able to craft it. | ||
| + | |||
| + | This extension also comes with the 'Recipe' Item Tag. This tag allows you to create items that will unlock a random locked recipe on use. You can either set it to roll from a specific set of unlockable recipes, or to roll from ALL unlockable recipes. | ||
== Installation == | == Installation == | ||
| Line 26: | Line 28: | ||
== Configuration == | == Configuration == | ||
| − | + | The config cache may need to be cleared with <code>php artisan config:cache</code> before the Recipe tag will show up. | |
== Usage == | == Usage == | ||
When users open the crafting modal, if they have sufficient items, the required ingredients will be preselected for them for convenience. However, they can still change the selection around as they desire, though selecting insufficient items means that the craft will fail. If there are insufficient items to begin with, an alert will be displayed to let them know. | When users open the crafting modal, if they have sufficient items, the required ingredients will be preselected for them for convenience. However, they can still change the selection around as they desire, though selecting insufficient items means that the craft will fail. If there are insufficient items to begin with, an alert will be displayed to let them know. | ||
Revision as of 06:31, 19 April 2021
| Description | Allows admins to construct recipes that users can then craft |
|---|---|
| Author(s) | Draginraptor, Ne-wt, Preimpression |
| Status | Testing |
| Github | feature/crafting_system |
| LK Version | Unspecified |
| Contains a Migration | |
This extension is built on the develop branch.
Huge thanks to Newt and Uri for really getting this extension past the finishing line!
This extension allows users to create recipes that can then be crafted by users without admin interaction. They are made up of 3 main sections: limits, ingredients, and rewards.
Limits are prerequisites that a user will need to have before they can craft the recipe. However, these are not consumed on craft. This was made with the idea of tools in mind, such as a cooking pot or sewing kit. Items, Currency, or other Recipes can be set as limits, and a quantity can be set. It is optional for recipes to use limits.
Each recipe can specify multiple ingredients, which can set as the following types:
- Single Item (Item): The ingredient requirement can only be fulfilled by the selected item
- Multiple Items (Multi Item): The ingredient requirement can be fulfilled with any mix of the items specified
- Single Category (Category): The ingredient requirement can be fulfilled by any mix of items item within a category
- Multiple Category (Multi Category): The ingredient requirement can be fulfilled with any mix of the items from any of the specified categories
Recipe rewards can be set as any rewardable item available in Lorekeeper (such as Item, Currency, Raffle). Additionally, the extension adds Recipe as a new type of rewardable.
By default, recipes are immediately available to users, but can also be set to require unlocking. If unlocking is required, a user will need to acquire the Recipe before being able to craft it.
This extension also comes with the 'Recipe' Item Tag. This tag allows you to create items that will unlock a random locked recipe on use. You can either set it to roll from a specific set of unlockable recipes, or to roll from ALL unlockable recipes.
Installation
You only need to run php artisan migrate.
Then run php artisan update-extension-tracker.
Configuration
The config cache may need to be cleared with php artisan config:cache before the Recipe tag will show up.
Usage
When users open the crafting modal, if they have sufficient items, the required ingredients will be preselected for them for convenience. However, they can still change the selection around as they desire, though selecting insufficient items means that the craft will fail. If there are insufficient items to begin with, an alert will be displayed to let them know.
Ingredients are always consumed from the most specific group to the least specific, namely Item -> Multi Item -> Category -> Multi Category. Currencies sit outside of this order.
Troubleshooting
You can look for Draginraptor, newt, or Uri on the Lorekeeper Discord specifically for bugs related to the crafting system.
