Plugin Description: Heart Manipulation Items

This plugin introduces 5 unique items designed to manipulate players' health in surprising and strategic ways. Perfect for adding excitement and chaos to your Minecraft server, it features new mechanics, tools, effects, and crafting recipes that enhance gameplay.

Key Features and Items

Wheel Item

Randomly re-rolls the user's health to a value between 1 and 20 hearts.

Drop Item

Automatically drops when a player dies. Custom Cooldown: 300 seconds.

Heart-Changer Item

Changes the health of the player it hits to a random value between 1 and 20 hearts.

Scythe of Randomness

Re-rolls the health of a player to a random value between 1 and 20 hearts.

Heart of Revival

Revives a player who has lost all their hearts and unbans them if banned due to heart loss. Unbreakable and fire-resistant.

Crafting Recipes

The plugin includes custom crafting recipes for these items using unique combinations of materials and existing game items

---

Configuration

############################################################
# +------------------------------------------------------+ #
# |                         ITEMS                        | #
# +------------------------------------------------------+ #
############################################################

# Items in this configuration provide unique functionalities and mechanics,
# each designed to enhance gameplay with special effects and interactions.
items:

  ############################################################
  # +------------------------------------------------------+ #
  # |                         Wheel Item	           | #
  # +------------------------------------------------------+ #
  ############################################################

  WheelItem:
    name: "&fWHEEL ITEM"
    type: "STICK"
    custom_model_data: 1
    random_change_amount: # In hearts
      min: 1
      max: 20
    lores:
      - "&7Re-rolls health from user"

  ############################################################
  # +------------------------------------------------------+ #
  # |                    Drop Item	                   | #
  # +------------------------------------------------------+ #
  ############################################################

  DropItem:
    name: "&fRe-roll Shard"
    type: "ECHO_SHARD"
    custom_model_data: 1
    lores:
      - "&7Cooldown: 300" # Seconds
      - "&7Gets dropped whenever player dies"


  ############################################################
  # +------------------------------------------------------+ #
  # |                  Heart-Changer Item                  | #
  # +------------------------------------------------------+ #
  ############################################################

  HeartChangerItem:
    name: "&f"
    type: "SUGAR"
    custom_model_data: 1
    random_change_amount: # In hearts
      min: 1
      max: 20
    lores:
      - "&7Re-rolls health of damaged player"

  ############################################################
  # +------------------------------------------------------+ #
  # |                     Scythe Item                      | #
  # +------------------------------------------------------+ #
  ############################################################

  ScytheItem:
    name: "&fScythe of Randomness"
    type: "WOODEN_HOE"
    dura: 1
    damage: 8
    custom_model_data: 1
    random_change_amount: # In hearts
      min: 1
      max: 20
    lores:
      - "&7Re-rolls health to a random amount"
      - "&7Between 1 and 20 hearts"
      - "&7One-time use"

  ############################################################
  # +------------------------------------------------------+ #
  # |                    Heart of Revival                  | #
  # +------------------------------------------------------+ #
  ############################################################

  # If you lose all your hearts, you’ll get banned. This Item will also unban you.
  HeartOfRevival:
    name: "&fHeart of Revival"
    type: "NETHER_STAR"
    custom_model_data: 1
    lores:
      - "&7Revives a player, who lost all of his hearts"
      - "&7This item is fire resistant and unbreakable"

############################################################
# +------------------------------------------------------+ #
# |                 SETTINGS OVERVIEW                    | #
# +------------------------------------------------------+ #
############################################################

settings:
  heart-changer-damage: 4
  # When you change the amount of crit damage, it will not affect old crafted items.
  heart-changer-crit-damage: 12
  drop-item-cooldown: 300 # Seconds
  wheel_spin_animation: true

############################################################
# +------------------------------------------------------+ #
# |                       RECIPES                        | #
# +------------------------------------------------------+ #
############################################################

recipes:
  # Placeholder %DropItem%, %WheelItem%, %ScytheItem%, %HeartChangerItem%
  WheelItem:
    shape:
      - "DD " # First line in the crafting recipe
      - "DD "
      - "SS "
    ingredients: # Has to be a material or a custom item
      D: "%DropItem%"
      S: "DIAMOND"
  ScytheItem:
    shape:
      - "DDN" # First line in the crafting recipe
      - " N "
      - " N "
    ingredients:
      N: "NETHER_INGOT"
      S: "%WheelItem%"
  HeartChangerItem:
    shape:
      - "DDN" # First line in the crafting recipe
      - " N "
      - " N "
    ingredients:
      N: "NETHER_INGOT"
      S: "%WheelItem%"
  HeartOfRevival:
    shape:
      - "R R" # First line in the crafting recipe
      - "RNR"
      - " R "
    ingredients:
      N: "NETHER_STAR"
      R: "DIAMOND"

############################################################
# +------------------------------------------------------+ #
# |                     MESSAGES                         | #
# +------------------------------------------------------+ #
############################################################

messages:
  player_unbanned: "§cPlayer %player% has been unbanned"
  player_not_banned: "§cPlayer %player% is not banned due to the loss of hearts!"
  player_error_reviving: "§cYou need to hold a Heart of Revival in your main hand to revive a player!"
  heartOfRevival_pending_message: "§aEnter Player Name: "
  player_rerolling_already: "§cYou are already rolling."

---

Installation

To successfully install the HeartWheel plugin, follow these steps:

Step 1: Download the Plugin

• Obtain the latest version of the HeartWheel plugin .zip file from the releases page.

Step 2: Extract the AdvancedCommands plugin:

• Extract the [AdvancedCommands-X.X.jar] from the downloaded zip file. For guidance on extraction, refer to the following links:
  • Click here for Windows
  • Click here for Linux
  • Click here for Mac

Step 3: Place the File

• Move the downloaded .jar file into your server's plugins folder.
  • The path typically looks like this: /container/plugins/

Step 4: Restart the Server

• Restart your Minecraft server to load the new plugin. This can usually be done by using the following command in your server console: restart Alternatively, you can stop the server and start it again manually.

Step 5: Verify Installation

• Check if your server loaded the plugin. Run in your server console: pl or plugins and check if AdvancedCommands is green.

Step 6: Configure the Plugin

• Open the config.yml in the HeartWheel folder within the plugins directory.
  • The path typically looks like this: /container/plugins/HeartWheel
• Configure the plugin as desired to tailor the plugin to your server's needs. Default file

---

FAQ

If you encounter any issues, join our discord and open a ticket here.