Custom Recipes Items

Tutorial: Custom Recipes & Items

Learn how to create unique crafting recipes for your custom beacons and customize how they look in a player's inventory.

1. Customizing the Beacon Item

In beacon.yml, you can define how the BeaconPlus item appears when it's in an inventory or dropped.

Beacon Item:
  Display:
    type: BEACON
    meta:
      display-name: "&aCustom Beacon"
      lore:
        - "&7A powerful artifact."
        - "{effect_list}" # This placeholder shows active effects

2. Defining a Crafting Recipe

You can add multiple recipes under the Recipes key.

Example: A "Super Beacon" Recipe

Beacon Item:
  Recipes:
    super_beacon:
      Shape:
        - "GGG"
        - "GNG"
        - "OOO"
      Ingredient:
        G:
          type: GOLD_BLOCK
        N:
          type: NETHER_STAR
        O:
          type: OBSIDIAN

Explanation

• Shape: A 3x3 grid using characters. Spaces can be used for empty slots.
• Ingredient: Map each character to a material.
  • You can use standard Bukkit material names.
  • You can also add more metadata to ingredients (like display-name) if you want to require specific custom items for crafting.

3. Giving Items via Command

If you don't want crafting, you can give players custom beacons directly: # /beaconplus give <player> [amount]

Note

By default, any beacon placed will be treated as a BeaconPlus beacon if Disable Vanilla is set to true in beacon.yml.