[SimplePetsAddon] ItemEconomy Addon

This addon for the SimplePets plugin provides server administrators with the ability to set prices for pets that players can purchase using in-game items. You no longer need additional plugins to create an economic system for buying pets.

Compatibility and Requirements

The main SimplePets plugin is required for the addon to work. Additionally, plugins that add custom item models such as Custom Items or ItemsAdder are supported but not mandatory. If you use custom models, you will need to specify the CustomModelData number and the base material of the item.

Installation Methods

Installation via Command (Easiest Method)

Simply execute the command /pet addon install ItemEconomy in the server console or in-game. The system will automatically load and activate the addon.

Installation via Graphical Interface

1. Execute the command /pet addon
2. In the opened menu, select the "Install Addons" item in the bottom row
3. Find the ItemEconomy addon in the list
4. Click on it to install

If the installation process gets stuck with the message "Installing...", check the server console for any errors. If there are none, try another installation method.

Manual Installation

1. Open the SimplePets plugin folder
2. Navigate to the "Addons" folder (create it if it doesn't exist)
3. Download the addon file and place it in the Addons folder
4. Restart the server to load the addon

Configuration Settings

# Hide price if player has bypass permissions
Hide-Price-If-Bypassed: true

# Require payment each time a pet is spawned
Pay-Per-Use-Enabled: false

Price:
  # Text for free pets
  Free: FREE
  # Text when bypass permissions are present
  Bypassed: BYPASSED

Cost:
  # Color when items are insufficient
  Short: '&#fa7d7d'
  # Color when items are sufficient
  Over: '&#99ffac'

Boolean:
  'true': '&#92fc98true'
  'false': '&#fa7d7dfalse'

Messages:
  PurchaseSuccessful:
    # Message for successful purchase
    One-Time-Purchase: '&eSimplePets &6>> &7You have successfully purchased the {type} pet.'
    # Message for successful payment
    Pay-Per-Use: '&eSimplePets &6>> &7You have successfully paid for the {type} pet.'

  # Message when items are insufficient
  InsufficientFunds: '&eSimplePets &6>> &cYou do not have the item(s) to buy this pet, you need to have {cost-display}'

  Lore-Lines:
    # Description lines for one-time purchase
    One-Time-Purchase:
      - '&#ffbf5ePrice: &#99ffac{cost-display}'
      - '&#ffbf5ePurchased: {purchased}'

    # Description lines for pay-per-use
    Pay-Per-Use:
      - '&#ffbf5ePrice: &#99ffac{cost-display}'

# Cost settings for each pet type
# - 'enabled': enable/disable payment
# - 'display': displayed price
# - 'material': payment material
# - 'count': item quantity
# - 'custom-model-data': custom model data (-1 if not used)

type:
  allay:
    enabled: true
    display: 10 Diamonds
    cost:
      material: DIAMOND
      count: 10
      custom-model-data: -1
  # ... similar settings for all other pets

# Payment bypass permissions
bypass_permissions:
  # Main bypass permission
  parent: pet.itemeconomy.bypass
  type:
    # Bypass permissions for specific pets
    allay: pet.itemeconomy.bypass.allay
    # ... similar permissions for all other pets

Configuration Features

The system allows flexible configuration of costs for each pet individually. You can use both standard Minecraft items and custom models through supported plugins. Settings include the ability to make pets free, set up one-time purchases or pay-per-use, and configure bypass permissions for administrators and privileged players.