Submitted on 21 Dec 2021 from Dev Build #36, Approved on 21 Dec 2021
General
A complete suite of Economy plugins by onebone:
- User oriented plugin
- EconomyAPI Individual language support
- Economy API support
- Direct accessible API
- Lots of configurations
- Lots of events to handle
- Fast processing with massive features
IMPORTANT: You MUST install EconomyAPI to use ANY of the EconomyS plugins
EconomyS
-
EconomyAPI - Main of the €conom¥$ - All plugins below requires this plugin
-
EconomyShop - Buy items
-
EconomySell - Sell items
-
EconomyAirport - Teleport by money
-
EconomyJob - Provide job system into your server
-
EconomyTax - Helps your server balancing money
-
EconomyLand - Helps your server manage lands
-
EconomyPShop - Shops for non-op players - requires ItemCloud plugin
-
EconomyAuction - Open your auction!
-
EconomyCasino - Do casino in your server!
-
EconomyProperty - Buy your land with signs - requires EconomyLand
-
EconomyUsury - Create your usury host and take a loan from host
EconomyAPI
Commands
| Default command | Parameter | Description | Default Permission |
|---|---|---|---|
| /mymoney | Shows your money | All | |
| /mydebt | Shows your debt | All | |
| /takedebt | <money> |
Borrows $<money> from plugin |
All |
| /returndebt | <money> |
Returns $<money> to plugin |
All |
| /topmoney | <page> |
Shows server's top money | All |
| /moneysave | Saves data to your hardware | Console |
|
| /moneyload | Loads data from your hardware | Console |
|
| /setmoney |
<player> <money>
|
Sets <player>'s money to $<money>
|
OP Console
|
| /economys | Shows plugin which are using EconomyAPI | All |
|
| /givemoney |
<player> <money>
|
Gives $<money> <player>
|
OP Console
|
| /takemoney |
<player> <money>
|
Takes $<money> from <player>
|
OP Console
|
| /seemoney | <player> |
Shows <player>'s money |
All |
| /bank deposit | <money> |
Deposit $<money> to your account |
All |
| /bank withdraw | <money> |
Withdraw $<money> from your account |
All |
| /bank mymoney | Shows your money from your account | All |
|
| /mystatus | Shows your money status | All |
|
| /bankadmin takemoney |
<player> <money>
|
Takes $<money> from <player>'s account |
OP Console
|
| /bankadmin givemoney |
<player> <money>
|
Gives $<money> for <player>'s account |
OP Console
|
Configuration
File :
plugins/EconomyAPI/economy.properties
| Key | Description | Available Value | Default Value |
|---|---|---|---|
| show-using-economy | Changes server name to [EconomyS] SERVER NAME on : Change off : Don't change
|
on off
|
on |
| once-debt-limit | Limits borrowing debt at once | All integers |
100 |
| debt-limit | Limits available debt | All integers |
500 |
| add-op-at-rank | Shows OP at top money rank on : Shows OP off : Don't shows OP
|
on off
|
off |
| default-money | Sets default money | All integers |
1000 |
| default-debt | Sets default debt | All integers |
0 |
| time-for-increase-debt | Sets how long will take for debt increase | All integers |
10 |
| percent-of-increase-debt | Sets percentage of increasing debt | All integers |
5 |
| default-bank-money | Sets default bank money | All integers |
0 |
| time-for-increase-money | Sets how long will take for credit increase | All integers |
10 |
| bank-increase=money-rate | Sets percentage of increasing credit | All integers |
5 |
| debug | Money debugging preferences on : yes off : no
|
on off
|
on |
EconomyLand
EconomyLand provides your players a land protection system. If the player buys land, the land will protected for the bought player.
Commands
List of commands :
/land <list | here | move | invite | invitee | give | buy | whose>
/landsell <here | land number>
Instructions for /land command :
/startp : Sets the start position.
/endp : Sets the end position.
/land list [page] : Shows the list of land.
/land here : Shows the land where you are standing on.
/land move <land id> : Move to land.
/land invite <land id> <invitee> : Invites player to your land.
/land invitee <land id> : Shows the list of invitee in land.
/land give <land id> <player> : Give the land to other player.
/land buy : Buys land.
/land whose <keyword> : Queries the list of land-bought players.
/landsell here : Sells land where you're standing on.
/landsell <land id> : Sells land by land ID.
If you use /startp and /endp commands you'll set the position where you'll buy. Then, you can use /land buy command to buy the land.
The land id is the land ID that shows in /land list command.
EconomyLand will ignore Y axis. It will protect all of Y axis which is in area.
Permissions
economyland.*
economyland.land.*
economyland.land.modify.others
economyland.land.modify.whiteland
economyland.land.modify.others
economyland.landsell.*
economyland.landsell.others
economyland.command.*
economyland.command.startp
economyland.command.endp
economyland.command.land.buy
economyland.command.land.move
economyland.command.land.list
economyland.command.land.whose
economyland.command.land.give
economyland.command.land.here
economyland.command.landsell
economyland.command.landsell.here
economyland.command.landsell.number
EconomyShop
Commands
/shop create <create|remove|list> [item[:damage]] [amount] [price] [side] - Tap to activate SHOP signs | OP |
Shop are created with /shop then tapping any block to activate it.
For example to make a shop selling a Diamond Sword for 500$:
/shop create 276 1 500 then tap a block/sign.
Sell Center in EconomySell can be created in same way with /sell create 276 1 500. And also Player's Shop in EconomyPShop
Configuration
File :
plugins/EconomyShop/shop.properties
| Key | Description | Available Value | Default Value |
|---|---|---|---|
| handler-priority | The priority of handling shop touches | Integer | 5 |
EconomyPShop
EconomyPShop is the system that lets non-OP players to open their own shop.
Important: EconomyPShop requires ItemCloud
First, you have to register and upload your item. Then, you'll create the PShop (Player shop). Second, other players will tap your pshop sign/block twice to buy your item. Then, your item in ItemCloud will be removed.
Commands
/pshop create <create|remove|list> [item[:damage]] [amount] [price] [side] - Tap to activate SHOP signs | OP |
EconomyJob
Instructions for jobs.yml configuration
tree-cutter:
"17:0:break": 10
This is one of the config items in jobs.yml.
'tree-cutter' is name of the job,
In "17:0:break" - 17 is item code, 0 is damage of item, break is the method and the 10 on the far right side is the money earned.
So
"18:0:place": 10
Means : If I place a block with ID 18 and damage 0 I will earn $10.
Instructions for config.yml configuration
refresh-time: The time of changing price of item, Integer
broadcast-refresh: Whether to broadcast the item has refreshed the price, true/false
max-change-rate: The maximum rate of changing money, Integer
Permissions
economyjob.command.*
economyjob.command.job.join
economyjob.command.job.reture
economyjob.command.job.list
economyjob.command.job.me
EconomyAirport
File :
%CONFIG_PATH%/DepartureSign.ymlFile :%CONFIG_PATH%/ArrivalSign.ymlFile :%CONFIG_PATH%/Identifier.yml
This documentation is focused on default configuration.
| Line1 | Line2 | Line3 | Line4 |
|---|---|---|---|
| `<international | airport>` | `<arrival | departure>` |
Example:
Line1: airport Line2: departure Line3: 10 Line4: onebone
Takes $10 to go to onebone airport
Line1: airport Line2: arrival Line3: onebone Line4:
Arrival sign : onebone airport
If there's no target airport to fly, it aborts riding a flight.
For Developers
You can access to EconomyAPI by using EconomyAPI::getInstance()
Example:
EconomyAPI::getInstance()->addMoney($player, $amount);- Untested updates for Scheduler nuke #2213 (9644766df3c69)
- Update Task
- Updated for PMMP PocketMine 3.0.0
- update
- API version bump, untested
- Bumped version
- Updated for 3.0.0-ALPHA11, version bump
- API version Bump
- Bumped version
- Version bump for 3.0.0-ALPHA9
- Add Ukrainian translation
- Add Ukrainian translation #2 (my bad...)
- Bugfix (#7)
-
- Update MySQLPingTask.php
-
- Update SaveTask.php
-
- Fixes for ALPHA7
- Forgot this
- Merge onebone master
- Merge pull request #2 from samalero/patch-1
- Added Ukrainian translation
- Merge pull request #3 from samalero/patch-2
- Added Ukrainian translation #2 (my bad...)
- PLEASE STOP CHANGING API
- https://stackoverflow.com/questions/3580628/is-type-hinting-helping-the-performance-of-php-scripts
- Please stop making changes that I have to make these unnecessary changes...
- It is better to create PHP Doc
- Updated entity code, bugfix
- Updated for API version 3.0.0-ALPHA7. Breaks BC
- tested with 3.0.0-ALPHA8
- 부분적인 하위 호환 패치 ^^
- https://stackoverflow.com/questions/3580628/is-type-hinting-helping-the-performance-of-php-scripts
- More code, no advantage.
- And bonuses are more execution time and backwards incompatibility.
- Too great improvement @dktapps !!! Keep up your nice work!!!
Working with API 3.0.0-ALPHA6
Fixed /topmoney, API 3.0.0-ALPHA5
Fixed /topmoney
Fixed Icon, Bumped API to ALPHA4
Reply to review by :
Producers §
-
Collaborators:
-
@onebone
-
-
Contributors:
-
@Ad5001
-
@Awzaw
-
@Bamuel
-
@Cathesda-Server-Studios
-
@Conankun17
-
@Creeperface01
-
@HmHmmHm
-
@MasterOfTheRealm
-
@PJK12
-
@PJZ9n
-
@Pub4Game
-
@SOF3
-
@SleepSpace9
-
@Thunder33345
-
@chalkpe
-
@dktapps
-
@dog194
-
@edwinyoo44
-
@kairusds
-
@kvetinac97
-
@laurobeleche
-
@llronaldoll
-
@luthfianto
-
@nnnlog
-
@shoghicp
-
@supercrafter333
-
@zKoz210
-