Plugin Description §

PiggyFactions

PiggyFactions is an open-sourced factions plugin for PocketMine-MP.

Documentation

Documentation is currently not up to date as of version 2.0.0

PiggyFaction's documentation is available at piggydocs-rtd.
- Prerequisites
- Quick Start Guide
- Commands & Permissions
- Functionality
  - How do I overclaim other factions? How does power work? --> Functionality

Addons

Plugin	Description	Installation
PiggyCustomEnchants	AllyChecks Integration	Automatically enabled.
HRKChat	Chat Integration	Requires Hierarchy. Additional setup required.
PureChat-PiggyFactions	Chat Integration	Requires PurePerms. Additional setup required.
ScoreHud v5	Scoreboard Integration	Requires Addon Script. See installation steps and tags.
ScoreHud v6	Scoreboard Integration (recommended)	Automatically enabled. See tags.
EconomyAPI	Economy Integration	Additional setup required.
MultiEconomy	Economy Integration	Additional setup required.

Features

Feature	PiggyFactions	SimpleFactions	FactionsPro
PiggyCE Integration	✔	❌	❌
Hierarchy/HRKChat Integration	✔	❌	❌
Economy Integration	✔	✔	❌
ScoreHud Integration (v5 & v6)	✔	❌	❌
Saves Players by UUID	✔	❌	❌
Per Faction Permissions	✔	❌	❌
SQLite3 Support	✔	✔	✔
MySQL Support	✔	✔	❌
Asynchronous Database I/O	✔	✔	❌
SQL Injection Protection	✔	❌	❌
Command Autocomplete	✔	❌	❌
Form UI	✔	❌	❌
Multi-Language Support	✔	✔	❌
Developer Friendly	✔	❌	❌

Issue Reporting

If you experience an unexpected non-crash behavior with PiggyFactions, click here.
If you experience a crash in PiggyFactions, click here.
If you would like to suggest a feature to be added to PiggyFactions, click here.
If you require support, please join our discord server here.
Do not file any issues related to outdated API version; we will resolve such issues as soon as possible.
We do not support any spoons of PocketMine-MP. Anything to do with spoons (Issues or PRs) will be ignored.
- This includes plugins that modify PocketMine-MP's behavior directly, such as TeaSpoon.

Additional Information

We do not support any spoons. Anything to do with spoons (Issues or PRs) will be ignored.
We are using the following virions: Commando, libasynql, libPiggyEconomy and libFormAPI.
- Unless you know what you are doing, use the pre-compiled phar from Poggit-CI and not GitHub.
- If you wish to run it via source, check out DEVirion.

Translators

Chinese (Simplified) - @Taylarity, @Aericio, TGPNG, prprprprprprpr
Chinese (Traditional) - @Taylarity, @Aericio, TGPNG, prprprprprprpr

French - Thouv (@adeynes), @ItsMax123, steelfri_031, @superbobby2000
German - @SalmonDE
Indonesian - @MrAshshiddiq, @SillierShark195

Serbian - yuriiscute53925
Spanish - @UnEnanoMas

License

   Copyright 2020 DaPigGuy

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

"Castle" vector graphic used in the banner and icon is licensed under the Pixabay License.

What's new §

🆕 New Features

Added support for API 5 (#132)

🐛 Bug Fixes

Fix /f help with negative integers crashing server (#133)

Misc

Virion changes
- Updated Commando to 3.1.0
- Updated libasynql to 4.2.0
- Updated libPiggyEconomy to 3.0.2
- Migrated from libformapi to FormsUI
Bumped minimum PMMP version to 5.3.0.
Bumped version to 2.1.0

Full Changelog: 2.0.4...2.1.0

🐛 Bug Fixes

Fixed /f home not working until a server restart. (#123)
Fixed /f top with large negative/positive numbers crashing server. (#128)
Fixed /f claim with large radiuses for circle/square toggles crashing server. (#128)
Fixed /f promote on an offline user crashing server. (#128)
Fixed /f kick unable to fetch role data crashing server. (#116)
Sanitized color codes from faction name, description, and MOTD (#119).
- This applies only to newly created factions, or those who attempt to update these fields.

🆕 New Features

NEW: Added ability to disable any commands. (#128)
NEW: Added ability to disable autoclaim, unclaimall, square, and circle claims. (#128)
NEW: Added ability to configure max radiuses for circle/square claims. (#128)

Misc

Support for PHP 8.1.
Bumped minimum PMMP version to 4.21.0.
Bumped version to 2.0.4
*** NOTE: PLEASE REGENERATE YOUR CONFIGS AND LANGUAGE FILES! NEW SETTINGS WERE ADDED.**

Implemented support for new BedrockEconomy API
Bumped version to 2.0.3

Full Changelog: 2.0.2...2.0.3

Migrated to DaPigGuy/[email protected] for improved auto-update checks. (#112)
Updated DaPigGuy/FormAPI-4.0.0 to 2.1.0
Updated Paroxity/Commando to 3.0.0
Bumped version to 2.0.2

Full Changelog: 2.0.1...2.0.2

Updated libPiggyEconomy to 3.0.0 (#111)
- Added BedrockEconomy support.
- Dropped MultiEconomy support.
Bumped version to 2.0.1

Fixed world crashing when using /f home in an unloaded world (#72)
Fixed /f who being completely obfuscated if §k is used in the description. May need to re-generate your language files. (#104)
Support PMMP API 4.2.0
Bumped version to 2.0.0

PiggyFaction's PureChat for 4.0.0 can be downloaded here: https://github.com/Heisenburger69/PureChat/releases/download/2.0.0/PureChat-PiggyFactions_v2.0.0.phar

Add support for ScoreHud v6 (#94)
Updated Serbian translations
Bumped libasynql to v3.3.1
Bumped version to v1.2.0

Fixed Internal Server Error caused by submitting empty forms (#91)
Added /f debug command (#69)
Bumped version to v1.1.3

Fixed Internal Server Error caused by banning factionless players
Register $instance in onLoad() instead of onEnable() (#76)
Renamed FlagFactory::registerPermission to FlagFactory::registerFlag
Fixed FactionPermission keys not being removed before serializing
Fixed right click interactions being cancelled (#11)
Bumped version to v1.1.2

BC-BREAK: Stop using Chunk objects for claim lookups and use Position instead.
BC-BREAK: Renamed ClaimsManager::getClaim() to ClaimsManager::getClaimByPosition()
BC-BREAK: Separate PlayerManager::getPlayer() to getPlayer() and getPlayerByUUID()
- Due to this change, you are required to update your PureChat version from PR-15 to PR-17.
- PureChat PR-17: https://poggit.pmmp.io/r/95436/PureChat_pr-17.phar
Reduced usage of class::getInstance() calls
Added command: /f unsethome
Added feedback to /f claim auto and /f unclaim auto
- Note: To begin autoclaiming, you will need to first create a claim with /f claim, then use /f claim auto after that.
- This is not intended behavior and is planned to be fixed in later versions.
Fixed error when promoting a player to leader in admin mode
Updated Translators list in /f version
New Languages:
- id_ID: Indonesian
- fr_FR: French
Updated existing language file strings
Bumped version to v1.1.1

Implemented new commands:
- /f addpower (#40)
- /f powerboost
- /f player
  - {PLAYER} - Name
  - {FACTION} - Faction
  - {RANKSYMBOL} - Symbol of faction rank
  - {POWER} - Amount of power
  - {TOTALPOWER} - Max amount of power
  - {TIMETOMAXPOWER} - Time to max on power in hours
  - {POWERPERHOUR} - Amount of power obtained within an hour
  - {POWERPERDEATH} - Amount of power obtained per death
  - {CREATIONDATE} - Date of first login (format: January 1, 1970 @ 12:00 AM PST)
  - {AGE} - Detailed duration string since first login
  - {SIMPLEAGE} - Simplified {AGE}
- /f unclaim <auto|circle|square>
- /f version
New Languages: Serbian, Simplified Chinese
Updated Languages: German, Traditional Chinese, Spanish
Added config option to enforce alphanumeric faction names (#65)
Added the following tags for /f info
- {CLAIMS} - # of claims
- {CREATIONDATE} - Date of creation of faction (format: January 1, 1970 @ 12:00 AM PST)
- {AGE} - Detailed duration string since faction creation
- {SIMPLEAGE} - Simplified {AGE}
- {RELATIONS} - Color coded list of factions in relationship with
Overclaiming now requires having outter claims to first be overclaimed
FactionEvent & FactionMemberEvent classes are now marked as abstract
Changed FactionRelationEvent constructor signature to accept two factions rather than an array of two factions
Fixed members with ban & kick permissions to ban or kick faction leaders
Fixed crash when using non-implemented language as the default language
Fixed exploit which allowed players to fly indefinately
Bumped minimum PMMP version to 3.13.0
Bumped version to 1.1.0

Updated ParoxityTeam/Commando to v2.1.0 (#59)
Fixed /f fly not disabling on teleport
Fixed crash when leaving while /f fly is toggling off
Fixed several potential crashes caused by faction member not yet existing
Bumped version to 1.0.8

New Language: Chinese (Traditional) by @Taylarity
New Language: Spanish by @UnEnanoMas
Added obtaining power through kills
Improved the update notifier
Fixed several missing permission nodes
Fixed /f permission not accepting neutral or truced
Fixed missing space in the logs.actions.kick message
Bumped version to 1.0.7

Fixed forms causing Internal Server Errors for float/int arguments
Bumped version to 1.0.6

Implemented faction bank
- /f money
- /f deposit
- /f withdraw
- /f top money
Localization improvements
- Added /f language for players to change their language
- Allow default server language to be changed within config.yml
- Moved language files to its own folder
New Language: German (#51) by @SalmonDE
Database changes
- Added patch system
- Main thread is now stopped until tables are created
- Main thread is now stopped on disable until all PiggyFactions queries are finished
DEVELOPERS: FactionsPlayer instance now available for most events
FactionCommand now implements PluginIdentifiableCommand (#49)
Add EconomyAPI, MultiEconomy, HRKChat as a soft dependency
Fixed autoclaiming not working when moving between unclaimed chunks
Bump version to 1.0.5

Added faction logs (#34)
Added virion checks
Added /f fly
Change displayed power to be rounded to the hundredth (#44)
Bump version to 1.0.4

Switched to ParoxityTeam/Commando fork
Added better auto completion for /f permission & /f flag
Added /f claim subcommands auto, circle, square
Fixed usernames not correctly updating when changed
Fixed /f setpower not displaying final player power
Fixed missing command permissions for disband, enemy, flag, top, & truce
Bump version to 1.0.3

Fixed container permissions having no effect
Fixed int column type remaining from development
Bumped version to 1.0.2

Added RANK_SYMBOL & RANK_NAME tags to faction/ally chats (#2)
Allow blocking of commands in claims by relation (#6)
Added faction player count limit feature (#7)
Added ability to customize /f form title
Added Poggit update checks
Cleaned up /f map
Fixed potential crash with slow chunk generation
Fixed potential crash caused by auto power gain

iKxPz3Mc

Outdated

using v2.0.3

08 Aug 22

f claim circle/square crash if you but too many numbers the f home is not detected fix it

Aericio

01 Jun 23

Fixed in 2.0.4

QazamYTB

Outdated

using v2.0.2

21 Apr 22

Commande /f home not work because the world is dont get

Aericio

01 Jun 23

Fixed in 2.0.4

Tanmayboy

Outdated

using v2.0.2

20 Apr 22

FraisexBeure

Outdated

using v2.0.2

13 Apr 22

How to set max claim ?

Aericio

01 Jun 23

Added in 2.0.4

fernanACM

Outdated

using v2.0.0

17 Feb 22

excellent plugin

reyyan987

Outdated

using v1.2.0

01 Nov 21

The best documentation and many features love it

Gezou

Outdated

using v1.2.0

31 Aug 21

"https://poggit.pmmp.io/r/95436/PureChat_pr-17.phar" This don't works

TienDat2k

Outdated

using v1.2.0

06 Aug 21

addon scorehub no working .Please help

SkullyGamingDM

Outdated

using v1.2.0

14 Jun 21

Update it

xmrfr

Outdated

using v1.1.2

30 Oct 20

ItsMax123

Outdated

using v1.1.2

11 Oct 20

Dapro718

Outdated

using v1.1.2

02 Oct 20

FactionsPro :)

ItzFabb-uwu

Outdated

using v1.1.2

06 Sep 20

jsonfromstatefarm

Outdated

using v1.1.1

26 Jul 20

MrEcstsy

Outdated

using v1.1.1

21 Jul 20

Very nice plugin but the commands, /f money /f deposit /f withdraw /f top money Do NOT work, any idea why? their's no error in console

Aericio

24 Jul 20

Enable economy features in the configuration. It's disabled by default.

VecroGamingYT

Outdated

using v1.1.1

15 Jul 20

I gave it a 4 because I dont know if it has PureChat Support I Tried The Link That was sent to another client but it still didn't work please reply :)

Aericio

15 Jul 20

Create an issue on the GitHub repository and be more specific.

ThePlayer372-FR

Outdated

using v1.1.0

29 Jun 20

"Undefined offset: 4" (EXCEPTION) in "plugins/PiggyFactions.phar/src/DaPigGuy/PiggyFactions/commands/subcommands/roles/PromoteSubCommand" at line 33

Aericio

13 Jul 20

This issue was resolved in v1.1.1.

NormalOcean6686

Outdated

using v1.0.7

31 May 20

U can`t open chest while raiding

FabiTrvsh

Outdated

using v1.0.6

01 Jun 20

/ f fly bug, when doing / warp, / hub, / home or any command to go to a place you continue with the active fly

DaPigGuy

01 Jun 20

This issue has been resolved in v1.0.8 currently pending approval on Poggit

Gabitzuu

Outdated

using v1.0.4

19 May 20

The best factions plugin for PMMP that i've ever seen!

BlockingCrazy

Outdated

using v1.0.4

18 May 20

Hi I am making an faction server the I realised u cant destroy obsiden with tnt so I might have a whole code that u can use to make that happen.

EarthCraftOfficial

Outdated

using v1.0.3

14 May 20

1. be Able to Increase Claim size so like 128x128, 2. How to get Strength, 3. Something like Purechat, 4. Something is broken with the Power so its like .6666666666 and stuff its quite annoying

DaPigGuy

15 May 20

All of the above were addressed in your GitHub issue.