thatzeogal / economys

The economy plugin for PocketMine-MP

EconomyS

The economy plugin for PocketMine-MP.

Download

Jenkins

Upcoming

The new version of EconomyS will include new features with better performance and extensibility. My goal is to complete the update before Feb 02, 2020 when GitHub Archive Program takes snapshot for all public repositories. So let's take a brief look at what I'm planning to do in this update.

General

• Multi currency. You can handle more than one currency with EconomyAPI. You can configure your players to use different currency as per the world where the player is in, or any other custom factors.
• Logging the transactions. If server administrators needs to check the transaction which happened in the past for some reason, abusing, for example, EconomyAPI will help arrest the abusers.
• /pay command will ask once again before executing transaction.
• /givemoney, /takemoney, /setmoney will support asterisk(*) player selection which selects all players online.
• EconomyShop and EconomySell will become one as it has almost same code base except for the direction where transaction is done. To improve code quality and fully use the new multi-currency system, the plugin will be fully rewritten. My goal is to meet the standard of Korean Minecraft: BE servers and make most of our server administrators use EconomyShop.
• EconomyLand will be fully rewritten to have better code quality.

Developers

• myMoney(), addMoney(), reduceMoney(), setMoney() will have its last parameter string|Currency $currency which selects the currency to transact with.
• It will be able to get ranking of the balance from EconomyAPI. Sorting the balance will be done from database provider as each database can have its own optimal method to sort values.
• $issuer parameter on API will receive Issuer class instead of string. The data is used on logging the transactions and event calling.
• Transaction will be implemented. API will allow executing multiple actions at once. For example, /pay command will give and take balance at once instead of giving after taking money from the payer.

EconomyAPI commands

Default command	Parameter	Description	Default Permission
/mymoney		Shows your money	All
/topmoney	<page>	Shows server's top money	All
/setmoney	<player> <money>	Sets <player>'s money to $<money>	OP Console
/givemoney	<player> <money>	Gives $<money> <player>	OP Console
/takemoney	<player> <money>	Takes $<money> from <player>	OP Console
/seemoney	<player>	Shows <player>'s money	All
/mystatus		Shows your money status	All

EconomyAPI configuration

File : plugins/EconomyAPI/economy.properties

Key	Description	Available Value	Default Value
add-op-at-rank	Shows OP at top money rank on : Shows OP off : Don't shows OP	true or false	false
default-money	Sets default money	All integers	1000
max-money	Limits maximum balance each player may possess	All integers	9999999999
allow-pay-offline	Whether to allow player to pay when target player is offline	true or false	false
default-lang	Sets default language for the plugin	Available languages	def
auto-save-interval	Set interval of auto-save by minutes	number	10
provider	Sets provider for database	yaml or mysql	yaml
check-update	Sets whether to check update from server	true or false	true
update-host	Sets host where to check update	Any available URIs	onebone.me/plugins/economys/api
provider-settings	Data which will be given to database provider	mixed	mixed

For Developers

You can access to EconomyAPI by using EconomyAPI::getInstance()

Example:

EconomyAPI::getInstance()->addMoney($player, $amount);

License

EconomyS, the massive economy plugin with many features for PocketMine-MP
Copyright (C) 2013-2020  onebone <[email protected]>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.