messages:
start:
enabled: <true/false>
player: <String>
broadcast: <String>
radius: <String>
world: <String>
log: <String>
end:
enabled: <true/false>
player: <String>
broadcast: <String>
radius: <String>
world: <String>
log: <String>
messages:
start:
enabled: true
player: "§cYou started crafting the mace! Time left: %total_time_formatted%"
broadcast: "§cThe mace is being crafted! Total time: %total_time_formatted%"
radius: "§cThe mace is being crafted nearby! Total time: %total_time_formatted%"
world: "§cSomeone in this world started crafting the mace! Total time: %total_time_formatted%"
log: "%player% at %location% in %world% started crafting %item% (%total_time_formatted% total)."
end:
enabled: true
player: "§cYou have crafted the mace!"
broadcast: "§cThe mace has been crafted!"
radius: "§cThe mace has been crafted nearby!"
world: "§cSomeone in this world finished crafting the mace!"
log: "%player% at %location% in %world% finished crafting %item%."
Boss Bar
Displays progress to players in radius.
color – pink, blue, red, green, yellow, purple, white.
# Placeholder for all messages/bossbars/actionbars/commands
# %player% - returns player name
# %location% - the location of the crafting block (format: x y z)
# %world% - the world
# %x% - x coordinate (int)
# %y% - y coordinate (int)
# %z% - z coordinate (int)
# %total_time% - the total time to craft the item in seconds (example: 60)
# %total_time_formated% - the total time to craft the item formated (example: 1m)
# %time% - the current time it still needs to craft the item (example: 120)
# %time_formated% - the current time it still needs to craft the item formated (example: 1m 20s)
# %item% - the item name
# %item_material% - the item material
########################################################################
# ------------------------ Recipe Activation --------------------------#
# This section defines which recipe triggers the crafting ritual. #
# You can use a Minecraft recipe key or define a custom shaped recipe. #
########################################################################
# true to enable the recipe on the server - false to disable
# make sure to reload the plugin after changing this!
enabled: false
recipe_activation:
# -----------------------------
# Option 1: Use an existing Minecraft recipe key
# -----------------------------
# Players will see this in their recipe book if key is set.
# Use "/recipe give @p" in-game to see available keys and copy one here.
key: "minecraft:mace"
# -----------------------------
# Option 2: Define a custom shaped recipe grid
# -----------------------------
# Slots 1–9 correspond to crafting table layout:
# 1 2 3
# 4 5 6
# 7 8 9
# Remove the # in front of the recipe line to enable.
#recipe:
# 1: DIRT
# 2: DIRT
# 3: DIRT
# 4: DIRT
# 5: DIRT
# 6: DIRT
# 7: DIRT
# 8: DIRT
# 9: DIRT
# -----------------------------
# If true, adds the recipe and the item_result to the server.
# Players will see it in their recipe book.
# Only relevant if you use key or a custom recipe.
#add_recipe_to_server: false
# -----------------------------
# The resulting item when crafting this recipe
# -----------------------------
# Required if a recipe grid is defined.
# Optional if using only item creation without a recipe.
# Use the command /mr create with the item in your main hand to generate.
# item_result: null
# ===============================
# Ritual Settings
# ===============================
settings:
time: 30s # Total crafting time
radius: 10 # Message/particle/boss bar radius (blocks)
cancel_on_logout: false # Cancel if crafting player logs out
cancel_on_leave_radius: false # Cancel if player leaves the radius
cancel_on_death: false # Cancel if player dies
kill_on_logout: true # Instantly kill player on logout
cancel_leave_radius: false # Prevent player from leaving radius (movement blocked)
cancel_break: false # Make crafting block unbreakable
cancel_on_break: false # Cancel ritual if block is broken
send_message_to_join: true # Send active ritual messages to players joining mid-craft
delete_recipe: false # Remove recipe after crafting (craftable once only)
running_rituals: 1 # Max simultaneous rituals of this recipe (-1 = unlimited)
# ===============================
# Requirements
# ===============================
requirements:
enabled: true
xp: -1 # Minimum XP level required (-1 = disabled)
day_time: -1 # Earliest in-game time allowed (-1 = disabled, in ticks 0–23999)
world: null # World name (case-sensitive, null = any)
# ===============================
# Messages
# Order: Crafting Player → Players in radius → Players in world → Server-wide
# No one receives the same message twice.
# ===============================
messages:
start:
enabled: true
player: "§cYou started crafting the mace! Time left: %total_time_formatted%"
broadcast: "§cThe mace is being crafted! Total time: %total_time_formatted%"
radius: "§cThe mace is being crafted nearby! Total time: %total_time_formatted%"
world: "§cSomeone in this world started crafting the mace! Total time: %total_time_formatted%"
log: "%player% at %location% in %world% started crafting %item% (%total_time_formatted% total)."
end:
enabled: true
player: "§cYou have crafted the mace!"
broadcast: "§cThe mace has been crafted!"
radius: "§cThe mace has been crafted nearby!"
world: "§cSomeone in this world finished crafting the mace!"
log: "%player% at %location% in %world% finished crafting %item%."
# ===============================
# Boss Bar
# ===============================
boss_bar:
enabled: true
title: "§cMace crafting in progress! Time left: %time_formatted%"
color: red # pink, blue, red, green, yellow, purple, white
overlay: progress # progress, notched_6, notched_10, notched_12, notched_20
# ===============================
# Action Bar
# ===============================
action_bar:
enabled: true
text: "§cMace crafting in progress! Time left: %time_formatted%"
# ===============================
# Titles
# ===============================
titles:
enabled: false
title: ""
sub_title: "§cTime left: %time_formatted%"
# ===============================
# Sounds
# ===============================
sounds:
enabled: true
# One sound is randomly selected from the list each time sounds play
list:
- BLOCK_BLASTFURNACE_FIRE_CRACKLE
- BLOCK_CRAFTER_CRAFT
# ===============================
# Commands
# ===============================
commands:
enabled: false
start:
- "say Crafting started!"
end:
- "say Crafting finished!"
# ===============================
# Particle Effects
# ===============================
particle:
enabled: true
do_particle_beam: true # Vertical beam from crafting block
do_lightning: true # Lightning before crafting finishes
circle_particle: # Circle effect after crafting finishes
enabled: true
particle: dust
dust_option:
size: 1
color: # RGB 0–255
red: 0,
green: 0,
blue: 0
player_particles: # Particles around player while crafting
enabled: true
particle: dust
dust_option:
size: 1
color:
red: 0,
green: 0,
blue: 0
particles: # Particles drawn toward crafting block
enabled: true
particle: dust
dust_option:
size: 1
color:
red: 0,
green: 0,
blue: 0
# ===============================
# Loops
# Loops allow repeating tasks automatically while a crafting ritual is active.
# Each loop has a unique ID, settings, and tasks:
# - Loop ID: any number (e.g., 1, 2, 3)
# - Settings:
# enabled: true/false → should this loop run
# activate_time: time between each activation (e.g., 1s)
# - Tasks: actions executed each time the loop triggers
# Can include: particle, sounds, titles, action_bar, messages
# Behavior:
# 1. Loop triggers after activate_time once crafting starts.
# 2. Tasks run each interval until crafting ends.
# 3. Multiple loops can run in parallel with independent intervals.
# Example use cases:
# - Show particles around player or block repeatedly
# - Play sounds periodically
# - Update action bars or titles dynamically
# ===============================
loops:
1:
settings:
enabled: true
activate_time: 1s # Delay before repeating
tasks:
particle:
enabled: true
player_particles:
enabled: true
particle: ENCHANT
