ADVANCED CLANS REVAMPED 1.2.0 PATCH LOG:
Please, before updating the .jar normally, read the full changelog and understand that several changes were made. This version has to be tested a time to pass to a STABLE version.
guis.yml is now replacing the guis in config.yml, so you have to pass your guis styles to the new file.
- Added missing paths in messages.yml and config.yml (like color, etc that cause color features not work correctly).
- Added new messages.
- Added a check so new clans can't have an existing prefix in their names.
- Added an option in config.yml to requiere a clan prefix on creation of a clan, false by default. (/clan create <name> <prefix>)
- Added BETA version for the API
- Added a new Notification system, so you members get notifications when a clan event happens (this is toggleable per player).
- Added a /clan notifications <on/off> to toggle the notifications
- Added DIRECT support with MVDWPlaceholderAPI to aviod PlaceholderAPI issues on scoreboard like FeatherBoard.
- Added new placeholders
- %clans_balance% (Display the bank balance of the clan)
- %clans_level% (Display the clan level)
- %clans_required_experience% (Display the clan needed experience to level up)
- %clans_experience% (Display the current experience of a clan)
- Added a new file (guis.yml) so you can customize the menus easily (it was part of config.yml before).
- Added new admin commands:
- /clan admin bank balance <clan> (Show the balance of a clan).
- /clan admin bank set <clan> <amount> (Set the balance of a clan bank).
- Created an internal Rank system for clans, so you can create as many ranks as you want and give them different clan permissions.
- Added a new file (ranks.yml) so you can customize the ranks as you wish.
- Updated the members section of /clan info, so it aligns with the new Rank system.
- The back page now works in members menu.
- Fixed a lot of NullPointerExceptions due a database issue.
- Updated /clan promote and /clan demote so now it aligns with the new Rank system.
- The config option "max-mods-per-clan" is not available any more.
- The variable %mods% in members GUI doesnt work anymore.
- A lot of code cleanup.
API TUTORIAL:
Getting the API:
Code (Java):
RegisteredServiceProvider
<AdvancedClansApi
> provider
= Bukkit.
getServicesManager
(
).
getRegistration
(AdvancedClansApi.
class
)
;
if
(provider
!=
null
)
{
AdvancedClansApi advancedClansApi
= provider.
getProvider
(
)
;
}
API Methods:
Code (Java):
AdvancedClansApi.
getClan
(
String clanName
).
Returns a simple Clan object.
AdvancedClansApi.
getClan
(
int id
).
Returns a simple Clan object.
AdvancedClansApi.
getClanPlayer
(
String playerName
).
Returns a simple ClanPlayer object.
AdvancedClansApi.
getClan
(Player player
).
Returns a simple ClanPlayer object.
API Events:
Code (YAML):
- NotificationEvent
(Called when a notification is sent to a Notificable player
).
- ClanPlayerKillEvent
(Called when a ClanPlayer makes a kill
).
- ClanLevelUpEvent
(Called when a Clan level up
).
- ClanCreateEvent
(Callen when a new Clan is finally created
).
- AsyncPlayerDataLoadEvent
(Called when a ClanPlayer data is loaded succesfully
).
- AsyncClanDataLoadEvent
(Called when a Clan data is loaded succesfully
).
RANK SYSTEM EXPLANATION:
Code (YAML):
ranks:
leader
:
#This string can not be repeated. This is not an important value, it can bee whatever you want
id
: 2
#IMPORTANT: setted by default to match with the old rank system, to make database compatible. If you change that ids, you will bug the database, so only change this values if you are using the plugin for first time.
display-name
:
"&aLeader"
#Display name of the rank
prefix
:
"&8[%color%**%clan%&8] &r"
#Prefix that players with this rank will have
ladderPosition
: 2
#The position of this rank in ladder (to /clan promote and /clan demote)
permissions
:
#List of permissions that the rank have. NOTE: if a lower rank has a X permission, all the ranks above this will heredate this permissions.
- '
ALL'
To indicate the default rank, add the path "default: true" to the rank.
Also to indicate that a rank is the "leader" clan, set the ladderPosition to the highest value of the ladder.
The ladder order have to follow a simple rule: +1. Example:
You MUST do:
Code (YAML):
ranks:
leader:
ladderPosition
: 3
coleader:
ladderPosition
: 2
veteran:
ladderPosition
: 1
member:
ladderPosition
: 0
You CAN NOT do:
Code (YAML):
ranks:
leader:
ladderPosition
: 50
coleader:
ladderPosition
: 10
veteran:
ladderPosition
: 2
member:
ladderPosition
: 0