WishingWell Plugin

A Minecraft plugin for Paper servers (Versions 1.21.4+) that allows players to earn AFK Coins by staying in a designated WorldGuard region and throw them into water for rewards.

Features

Players earn an AFK Coin after staying in a configured WorldGuard region for a set time (default: 10 minutes).
Throw the AFK Coin into water to receive a random reward (items or commands).
Customizable boss bar to show time until the next coin, with fill-in or fill-out options.
Permission-based timers for faster coin earning (e.g., VIP players).
Configurable rewards, messages, and coin appearance (e.g., enchanted effect).
Coins can be picked up by other players, transferring ownership for reward eligibility.
/wishingwell: Opens a menu to view all items that you can get from the AFK coins
/wishingwell help: Displays plugin version and lists commands.
/wishingwell givecoin <player> <amount>: Reloads the plugin configuration (requires permission).
/wishingwell configreload: Reloads the plugin configuration (requires permission).

Showcase

Requirements

Software: Paper
Versions: 1.21.4+
WorldGuard and WorldEdit: Required, plugin will not start without them
Permissions Plugin: Optional, for custom timers

Downloads

Name	Game Version	Platform	Plugin Version	Actions

Configuration

Default config.yml

The plugin includes a config.yml file to customize the region, timers, rewards, and messages. Below is the default configuration:

# Wishing Well Plugin Configuration
# NOTE VERSION 1.1 CHANGES THE WAY REWARDS ARE SAVED, REFER TO THIS FILE TO UPDATE YOUR OLD VERSIONS

# Name of the WorldGuard region where the wishing well is located
region-name: wishing-well

# Time (in ticks) players must stay in the region to receive an AFK Coin (default: 600s = 12000 ticks)
coin-interval: 12000

# Whether the AFK Coin has an Unbreaking enchantment (hidden)
is-enchanted: true

# Permission-based timers (in ticks)
times:
  vip: 6000  # Example: Players with wishingwell.time.vip get a coin every 300s
  premium: 9000  # Example: Players with wishingwell.time.premium get a coin every 450s

# Boss bar settings
bossbar:
  color: YELLOW # Valid colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
  text: '&eTime until next %coin_name%: %seconds%'
  fill-direction: FILL_IN # Options: FILL_IN (bar fills from 0 to 1), FILL_OUT (bar empties from 1 to 0)

coin-material: 'SUNFLOWER' # Set item type of the coin

# Messages
messages:
  coin-name: '&aᴀꜰᴋ ᴄᴏɪɴ'
  coin-lore: '&7Throw into water to make a wish!'
  receive-coin: '&aYou received an %coin_name% for staying in the wishing well!'
  one-coin-at-a-time: '&cYou can only throw one %coin_name% at a time!'

rewards:
  - id: 'diamond' # Uniqe id of the reward
    type: 'ITEM' # Either give a item to the player or run a command when granted
    amount: 64 # Amount of item to give
    chance: 0.1 # Chance to get this reward
    message: '&aYou received a shiny diamond!' # Message when a player receives this reward
    icon:
        material: 'DIAMOND' # Item type of the item granted
        display-name: '&bWishing Diamond' # Name when the player receives the item and in the menu
    lore: # Optional
        - '&7A rare gem from the well!'
        - '&7Highly valuable'

  - id: '$100'
    type: 'COMMAND'
    command: 'eco give %player% 1'
    as-console: true
    chance: 0.2
    icon:
        material: 'EMERALD'
        display-name: '&a1 Dollar'
    message: '&aYou received 1 Dollar'

Commands and Permissions

Commands

/wishingwell: Opens a menu to view all items that you can get from the AFK coins
/wishingwell help: Displays plugin version and lists commands.
/wishingwell givecoin <player> <amount>: Reloads the plugin configuration (requires permission).
/wishingwell configreload: Reloads the plugin configuration (requires permission).

Permissions

wishingwell.commands.reloadconfig: Allows use of the reloadconfig command.
wishingwell.commands.givecoin: Allows use of the reloadconfig command.
wishingwell.time.: Sets custom coin-earning intervals (e.g., wishingwell.time.vip for 300s).

Bugs

How to report bugs:

Email bugs you find to [email protected]