[SimplePetsAddon] Treasury Addon

Introduction

This is an enhancement for the SimplePets plugin that enables server owners and administrators to set prices for pets to be purchased using in-game currency. You'll no longer need external plugins to implement economic transactions for pets.

Required Components

For the addon to function properly, you'll need:

• SimplePets (REQUIRED)
• Treasury (REQUIRED) Minimum version v1.1.0 (or v1.1.0-937ec97-RELEASE on Spigot)

Installation

The addon can be installed through several methods:

Installation via Command (Simplest Method)

Simply enter the command /pet addon install Treasury, and the system will automatically install and activate the addon.

Installation via Graphical Interface

Execute the command /pet addon, in the opened menu select "Install Addons" in the bottom row, locate the "Treasury" element and click it for installation.

Note: If the installation process gets stuck with "Installing...", check the server console for errors. If there are no errors, try another installation method.

Manual Installation

Open the SimplePets plugin folder, create the "Addons" folder (if it doesn't exist), download the addon file and place it in this folder, then restart the server to load the addon.

Default Configuration

# When disabled, the price will always be shown, but players with bypass permissions won't have to pay
# Default value: true
Hide-Price-If-Bypassed: true

# Should players pay every time they summon a pet?
# Default value: false
Pay-Per-Use-Enabled: false

Price:
  # Text displayed for free pets instead of the price
  # Default value: 'Free'
  Free: Free
  # Text for bypass-exempt players instead of the price
  # Default value: 'BYPASSED'
  Bypassed: BYPASSED

# Translations for boolean values (true/false)
Boolean:
  'true': '&#92fc98true'
  'false': '&#fa7d7dfalse'

Messages:
  prefix: '&eSimplePets &6>>'
  PurchaseSuccessful:
    # Message for successful purchase
    # Placeholders:
    # - {prefix} (uses the configured prefix)
    # - {type} (pet type)
    # - {price} (pet price)
    One-Time-Purchase: '{prefix} &7You have successfully purchased the {type} pet.'
    # Message for successful payment with "pay per use" mode enabled
    # Placeholders:
    # - {prefix} (uses the configured prefix)
    # - {type} (pet type)
    # - {price} (pet price)
    Pay-Per-Use: '{prefix} &7You have successfully paid for the {type} pet.'
  # Message when player has insufficient funds
  # Placeholders:
  # - {prefix} (uses the configured prefix)
  # - {type} (pet type)
  # - {price} (pet price)
  InsufficientFunds: '{prefix} &cYou do not have enough money to purchase this pet, you need {price}'
  Lore-Lines:
    # These description lines are only used with "Pay-Per-Use" disabled
    # Placeholders:
    # - {price} (pet price)
    # - {purchased} (true/false - whether pet is purchased)
    One-Time-Purchase:
    - '&#ffbf5ePrice: &#99ffac{price}'
    - '&#ffbf5ePurchased: {purchased}'
    # These lines are added to pet items in the menu
    # Placeholders:
    # - {price} (pet price)
    # - {purchased} (true/false - whether pet is purchased)
    Pay-Per-Use:
    - '&#ffbf5ePrice: &#99ffac{price}'

# Permission settings for payment bypass
bypass_permissions:
  # Main permission, overrides all individual permissions below
  parent: pet.treasury.bypass
  type:
    # Bypass permission for armor_stand pet
    armor_stand: pet.treasury.bypass.armor_stand
    # Bypass permission for axolotl pet
    axolotl: pet.treasury.bypass.axolotl
    # Bypass permission for bat pet
    bat: pet.treasury.bypass.bat
    # Bypass permission for bee pet
    bee: pet.treasury.bypass.bee
    # ... permissions remain unchanged ...

# Prices for different pet types
type:
  # Price for armor_stand pet
  armor_stand: 2000
  # Price for axolotl pet
  axolotl: 2000
  # Price for bat pet
  bat: 2000
  # ... prices remain unchanged ...