dapigguy/libpiggyeconomy

There is no license information available for the latest version (3.0.2) of this package.

3.0.2 2023-08-30 01:09 UTC

This package is not auto-updated.

Last update: 2024-04-26 02:01:35 UTC


README

libPiggyEconomy is a virion for easy support of multiple economy providers.

Supported Providers

Usage

Setup

libPiggyEconomy::init()

Using Economy Providers

libPiggyEconomy::getProvider($providerInformation)

$providerInformation is an array with the key provider.

Economy Provider Methods

Method Description Callback Signature Callback Description
EconomyProvider::getMonetaryUnit(): string Returns symbol of currency none none
EconomyProvider::getMoney(Player $player, callable $callback): void Get balance of a player function(float|int $amount) void{} Returns default balance if player wasn't found, float|int otherwise.
EconomyProvider::giveMoney(Player $player, float $amount, ?callable $callback = null): void Give money to a player function(bool $success): void{} Returns true if money was given successfully, otherwise false.
EconomyProvider::takeMoney(Player $player, float $amount, ?callable $callback = null): void Take money from a player function(bool $success): void{} Returns true if money was taken successfully, otherwise false.
EconomyProvider::setMoney(Player $player, float $amount, ?callable $callback = null): void Set balance of a player function(bool $success): void{} Returns true if money was set successfully, otherwise false.

Error Handling

There are several exceptions that can be thrown that you may want to handle in your plugin:

  • MissingProviderDependencyException
  • UnknownProviderException

Examples

config.yml

economy:
  provider: bedrockeconomy

AmazingPlugin.php

class AmazingPlugin extends PluginBase{
    public $economyProvider;
    
    public function onEnable(): void{
        $this->saveDefaultConfig();
        libPiggyEconomy::init();
        $this->economyProvider = libPiggyEconomy::getProvider($this->getConfig()->get("economy"));
    }
}