Myriad Clans -----
Clan plugin designed to work alone or integrate with Domain - 1.13-1.20Change Log
1.21 Support Added
API Changes:
1.21 Support Added
API Changes:
- ALL deprecated API functions have been removed
- Myriad Clans is now in the com.ibexmc.myriad package instead of work.torp.myriad
Change Log 1.2.0
This update addresses the Myriad API. The custom return classes have been deprecated in favor of simple objects
All existing API calls will function, but are showing as deprecated and may be removed in an upcoming version.
New API calls as follows:
This update addresses the Myriad API. The custom return classes have been deprecated in favor of simple objects
All existing API calls will function, but are showing as deprecated and may be removed in an upcoming version.
New API calls as follows:
Code (Java):
/**
* Gets the plugin version
* @return Plugin Version
*/
String version ( )
/**
* Gets the players clan tag
* @param uuid Player Unique Identifier
* @return Players clan tag if they have one, otherwise, returns a blank string
*/
String getPlayerClanTag (UUID uuid )
/**
* Returns true if the clan tag specified exists
* @param tag Clan Tag
* @return If true, clan exists
*/
boolean clanExists ( String tag )
/**
* Updates the specified clan with this clan object
* Use getClanFromTag to get the clan, make changes, pass that value to modifyClan
* @param clan Clan object
* @return If true, clan was updated
*/
boolean modifyClan (Clan clan )
/**
* Removes the clan specified
* @param tag Clan tag
* @return If true, clan was removed
*/
boolean removeClan ( String tag )
/**
* Gets a Clan from the clan tag
* @param tag Clan tag
* @return Clan object, null if not found
*/
Clan getClanFromTag ( String tag )
/**
* Gets a set of Clan objects that exist
* @return All clans
*/
Set <Clan > getAllClans ( )
/**
* Creates a new clan. Will fail if the owner is in a clan, or if the tag or name already exists
* Can also fail if the owner does not have the required funds to create the clan
* @param owner Clan owner
* @param tag Clan tag
* @param name Clan name
* @return If true, clan was created successfully
*/
boolean createNewClan (UUID owner, String tag, String name )
/**
* Returns true if the player is a pending member of a clan
* @param uuid Player unique identifier
* @return If true, player is a pending member already
*/
boolean playerIsPending (UUID uuid )
/**
* Adds a player to the pending list of the clan
* If the player is already pending elsewhere, they will be removed from that pending list
* @param uuid Player unique identifier
* @param tag Clan tag to add to
*/
void addPlayerToPending (UUID uuid, String tag )
/**
* Removes a player from any pending list
* @param uuid Player unique identifier
*/
void removePlayerFromPending (UUID uuid )
/**
* Adds a player as a clan member
* @param uuid Player unique identifier
* @param tag Clan tag to add to
*/
void addPlayerAsClanMember (UUID uuid, String tag )
/**
* Removes a player from any clan they are in
* @param uuid Player unique identifier
*/
void removePlayerFromClans (UUID uuid )
/**
* Adds a Message for a player
* @param message Player message
*/
void addPlayerMessage (Message message )
/**
* Gets all messages assigned to a player
* @param message_to Player unique identifier
* @return
*/
Set <Message > getPlayerMessages (UUID message_to )
/**
* Transfers funds from a player to a clan
* Requires Vault
* @param offlinePlayer Player to transfer from
* @param tag Clan tag to transfer to
* @param amount Amount to transfer
*/
void transferFundsPlayerToClan (OfflinePlayer offlinePlayer, String tag, Double amount )
/**
* Transfers funds from a clan to a player
* Requires Vault
* @param offlinePlayer Player to transfer to
* @param tag Clan tag to transfer from
* @param amount Amount to transfer
*/
void transferFundsClanToPlayer (OfflinePlayer offlinePlayer, String tag, Double amount )
/**
* Removes funds from a clan
* Requires Vault
* @param tag Clan tag to remove funds from
* @param amount Amount to remove
*/
void removeClanFunds ( String tag, Double amount )
* Gets the plugin version
* @return Plugin Version
*/
String version ( )
/**
* Gets the players clan tag
* @param uuid Player Unique Identifier
* @return Players clan tag if they have one, otherwise, returns a blank string
*/
String getPlayerClanTag (UUID uuid )
/**
* Returns true if the clan tag specified exists
* @param tag Clan Tag
* @return If true, clan exists
*/
boolean clanExists ( String tag )
/**
* Updates the specified clan with this clan object
* Use getClanFromTag to get the clan, make changes, pass that value to modifyClan
* @param clan Clan object
* @return If true, clan was updated
*/
boolean modifyClan (Clan clan )
/**
* Removes the clan specified
* @param tag Clan tag
* @return If true, clan was removed
*/
boolean removeClan ( String tag )
/**
* Gets a Clan from the clan tag
* @param tag Clan tag
* @return Clan object, null if not found
*/
Clan getClanFromTag ( String tag )
/**
* Gets a set of Clan objects that exist
* @return All clans
*/
Set <Clan > getAllClans ( )
/**
* Creates a new clan. Will fail if the owner is in a clan, or if the tag or name already exists
* Can also fail if the owner does not have the required funds to create the clan
* @param owner Clan owner
* @param tag Clan tag
* @param name Clan name
* @return If true, clan was created successfully
*/
boolean createNewClan (UUID owner, String tag, String name )
/**
* Returns true if the player is a pending member of a clan
* @param uuid Player unique identifier
* @return If true, player is a pending member already
*/
boolean playerIsPending (UUID uuid )
/**
* Adds a player to the pending list of the clan
* If the player is already pending elsewhere, they will be removed from that pending list
* @param uuid Player unique identifier
* @param tag Clan tag to add to
*/
void addPlayerToPending (UUID uuid, String tag )
/**
* Removes a player from any pending list
* @param uuid Player unique identifier
*/
void removePlayerFromPending (UUID uuid )
/**
* Adds a player as a clan member
* @param uuid Player unique identifier
* @param tag Clan tag to add to
*/
void addPlayerAsClanMember (UUID uuid, String tag )
/**
* Removes a player from any clan they are in
* @param uuid Player unique identifier
*/
void removePlayerFromClans (UUID uuid )
/**
* Adds a Message for a player
* @param message Player message
*/
void addPlayerMessage (Message message )
/**
* Gets all messages assigned to a player
* @param message_to Player unique identifier
* @return
*/
Set <Message > getPlayerMessages (UUID message_to )
/**
* Transfers funds from a player to a clan
* Requires Vault
* @param offlinePlayer Player to transfer from
* @param tag Clan tag to transfer to
* @param amount Amount to transfer
*/
void transferFundsPlayerToClan (OfflinePlayer offlinePlayer, String tag, Double amount )
/**
* Transfers funds from a clan to a player
* Requires Vault
* @param offlinePlayer Player to transfer to
* @param tag Clan tag to transfer from
* @param amount Amount to transfer
*/
void transferFundsClanToPlayer (OfflinePlayer offlinePlayer, String tag, Double amount )
/**
* Removes funds from a clan
* Requires Vault
* @param tag Clan tag to remove funds from
* @param amount Amount to remove
*/
void removeClanFunds ( String tag, Double amount )
Change Log 1.1.0
This update marks Myriad Clans as being officially supported for 1.17
Added config option to set a maximum length for clan tag for new clans.
To add the limit, add the following to your config.yml file
If anyone has any issues with this update, please reach out on Discord!
This update marks Myriad Clans as being officially supported for 1.17
Added config option to set a maximum length for clan tag for new clans.
To add the limit, add the following to your config.yml file
Code (YAML):
# clan_tag_max_length is the maximum number of characters allowed in the clan tag, can be between 1-10
clan_tag_max_length : 5
clan_tag_max_length : 5
Change log 1.0.9.3
Minor bug fixes
Minor bug fixes
Change Log
This update addresses a bug fix that impacts new users only. Existing users can skip this release unless they are having the issue outlined below.
When loading, if the Myriad\Clans folder does not exist, the user could be stuck with a 'Data not loaded' error that prevents them from saving new clans.
This update addresses a bug fix that impacts new users only. Existing users can skip this release unless they are having the issue outlined below.
When loading, if the Myriad\Clans folder does not exist, the user could be stuck with a 'Data not loaded' error that prevents them from saving new clans.
Change Log 1.0.9.1
This update addresses a small problem in 1.0.9 where if you confirm disbanding the clan more than once without forming a new clan will throw a null reference error in console.
Now trying more than once will just tell you that you're not in a clan.
No other changes - bug fixes only in the 1.* set of code now - new version is most the way written, but no ETA on finishing it up (LOTS added!)
This update addresses a small problem in 1.0.9 where if you confirm disbanding the clan more than once without forming a new clan will throw a null reference error in console.
Now trying more than once will just tell you that you're not in a clan.
No other changes - bug fixes only in the 1.* set of code now - new version is most the way written, but no ETA on finishing it up (LOTS added!)
Change Log 1.0.9
This update addresses an issue with PlaceholderAPI not registering %myriad_clan% correctly.
%myriad_clan% will return the clan or a blank string if the player is not currently in a clan.
This update addresses an issue with PlaceholderAPI not registering %myriad_clan% correctly.
%myriad_clan% will return the clan or a blank string if the player is not currently in a clan.
Change Log 1.0.7
Support has been added for Spigot/Paper 1.16
Support has been added for Spigot/Paper 1.16
Change Log 1.0.6
This update doesn't add a lot to the plugin for the user, but makes huge changes in the back-end. Please be sure to back up your Myriad folder before installing this update.
Replaces the sqlite database file storage with yml file storage with a file for each clan. The first time the update runs, it will read from the database and write the files out during startup. Any reboot after this will read directly from the files and ignore the database file so long as the Clans folder exists.
Removes a number of debug log messages showing throughout the console
Corrects the locked file issue when closing the server which could cause either the clan data to not update, or, cause the server to lock up until the file lock gave up.
Changes to the clan are saved in real-time rather than on server shutdown, which should lead to less chance of data loss in the event of a server crash
Foe/Functionality code modified to allow for further updates
Ranks code modified to allow for further updates
Banned word file error when no words entered has been corrected
Clan kill log no longer stored in memory and can be turned off completely with config option
record_clan_kills: false
This update doesn't add a lot to the plugin for the user, but makes huge changes in the back-end. Please be sure to back up your Myriad folder before installing this update.
Replaces the sqlite database file storage with yml file storage with a file for each clan. The first time the update runs, it will read from the database and write the files out during startup. Any reboot after this will read directly from the files and ignore the database file so long as the Clans folder exists.
Removes a number of debug log messages showing throughout the console
Corrects the locked file issue when closing the server which could cause either the clan data to not update, or, cause the server to lock up until the file lock gave up.
Changes to the clan are saved in real-time rather than on server shutdown, which should lead to less chance of data loss in the event of a server crash
Foe/Functionality code modified to allow for further updates
Ranks code modified to allow for further updates
Banned word file error when no words entered has been corrected
Clan kill log no longer stored in memory and can be turned off completely with config option
record_clan_kills: false
Change Log 1.0.5
New command added for admins
/clan admin disband <clan tag>
This allows you to disband other players clans if needed. The myriad.admin permission is required to run this command.
Also included are some minor bug fixes around the SQLite database file.
New command added for admins
/clan admin disband <clan tag>
This allows you to disband other players clans if needed. The myriad.admin permission is required to run this command.
Also included are some minor bug fixes around the SQLite database file.
Change Log 1.0.3
Added PlaceholderAPI support (optional)
You can use %myriad_clan% to get the players clan name
Add the following to your lang.yml to override default language:
Added PlaceholderAPI support (optional)
You can use %myriad_clan% to get the players clan name
Add the following to your lang.yml to override default language:
Code (YAML):
placeholder_no_clan
:
"&cNo Clan"
Change Log 1.0.2
This update addresses a null exception error when someone uses /clan join without specifying a clan tag.
This update addresses a null exception error when someone uses /clan join without specifying a clan tag.
Change Log 1.0.1
Myriad Clans can now store your clan banner, and you can purchase copies for an amount set in the configuration file.
To save a banner, hold the banner in your hand and type in:
/clan set banner
To retrieve the banner, type in:
/clan get banner
The cost will come from the clan wallet, not from the player
The following configuration options are required:
allow_clan_banner will default to true if no entry is there, and cost will default to 0. Be sure to set both appropriately before going live with this update.
Bug fixes:
Player applications will no longer prompt for accept/reject after each restart after already being rejected
Myriad Clans can now store your clan banner, and you can purchase copies for an amount set in the configuration file.
To save a banner, hold the banner in your hand and type in:
/clan set banner
To retrieve the banner, type in:
/clan get banner
The cost will come from the clan wallet, not from the player
The following configuration options are required:
Code (YAML):
# allow_get_banner is a true/false flag for if the clan banner can be retrieved via the "/clan get banner" command
allow_get_banner : true
# clan_banner_cost is the cost to get a copy of the clan banner
clan_banner_cost : 50
allow_get_banner : true
# clan_banner_cost is the cost to get a copy of the clan banner
clan_banner_cost : 50
Bug fixes:
Player applications will no longer prompt for accept/reject after each restart after already being rejected
Resource Information
Author:
----------
Total Downloads:
85
First Release:
Jul 13, 2019
Last Update:
Aug 23, 2024
Category:
---------------
All-Time Rating:
8 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings