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 in x y z format.

• %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 recipes folder.

• 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 recipes folder.

• 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 recipes folder.

• 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 recipes folder.

• You can then edit this file to adjust time, effects, requirements, and messages.