Legendary Crafting
Description
This plugin adds a ritual-based crafting system to Minecraft, replacing instant crafting with immersive, timed rituals. Fully configurable effects, limits, requirements, and messages let you create unique, event-like crafting experiences for RPG or themed servers.
Configuration
Main Config
The main configuration controls global plugin behavior, including ritual limits, global messages, and deleted recipes.
Configuration Format
settings:
ritual_per_radius: <Integer>
rituals_per_player: <Integer>
messages:
leave_radius: <String>
cancel_cuz_leave_radius: <String>
cancel_block_break: <String>
max_rituals: <String>
max_player_rituals: <String>
max_radius_rituals: <String>
deleted_recipes: <List>Settings
ritual_per_radius– Maximum number of rituals allowed in the same radius.rituals_per_player– Maximum number of rituals a single player can start at once.
Messages
All strings here are sent to players under specific conditions:
leave_radius– Sent when a player attempts to leave the ritual radius while crafting.cancel_cuz_leave_radius– Sent when a ritual is canceled because the player left the radius.cancel_block_break– Sent when the player tries to break a block used in an active ritual.max_rituals– Sent when the maximum allowed rituals for an item is reached.max_player_rituals– Sent when the player has reached their personal ritual limit.max_radius_rituals– Sent when too many rituals are active in the same radius.
Deleted Recipes
deleted_recipes– A list of recipe keys that are disabled/removed from the server. Example:
Placeholders
These can be used in any message to dynamically insert information:
%player%– Player name.%location%– Crafting block coordinates inx y zformat.%world%– World name.%x%/%y%/%z%– X, Y, Z coordinates individually (integer).%total_time%– Total crafting time in seconds (e.g.,60).%total_time_formatted%– Total crafting time in readable format (e.g.,1m).%time%– Remaining crafting time in seconds (e.g.,120).%time_formatted%– Remaining crafting time in readable format (e.g.,1m 20s).%item%– Item display/custom name.%item_material%– Item's raw Minecraft material name.
Creating a Ritual
There are two ways to create a ritual:
1. Using an existing recipe
If another plugin has already registered a recipe on your server, you can create a ritual for it by adding a config file to the
recipesfolder.Copy and paste the example recipe file into that folder.
The file name is also the ritual ID, which must be unique. This ID is used for commands later.
If you have an item but no recipe for it, hold the item in your offhand.
Use the provided ritual creation command.
The plugin will generate a config file for the new ritual in the
recipesfolder.You can then edit this file to adjust time, effects, requirements, and messages.
2. Creating a recipe from an item
If another plugin has already registered a recipe on your server, you can create a ritual for it by adding a config file to the
recipesfolder.Copy and paste the example recipe file into that folder.
The file name is also the ritual ID, which must be unique. This ID is used for commands later.
1. Using an existing recipe
There are two ways to create a ritual:
Creating a Ritual
2. Creating a recipe from an item
If you have an item but no recipe for it, hold the item in your offhand.
Use the provided ritual creation command.
The plugin will generate a config file for the new ritual in the
recipesfolder.You can then edit this file to adjust time, effects, requirements, and messages.
Last updated