SimpleClans 2.14.4.1

Simple yet robust clan system for PvP servers (Supports 1.8 to 1.16)

  1. RoinujNosde
    Native Minecraft Version:
    Legacy (< 1.13)
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Source Code:
    https://github.com/RoinujNosde/SimpleClans
    Contributors:
    Phaed (original author)
    Languages Supported:
    Brazilian Portuguese (100%), Russian (100%), Polish (100%), Spanish (100%), French (77%), Turkish (76%) and others: https://crowdin.com/project/simpleclans
    “The ability to simplify means to eliminate the unnecessary so that the necessary may speak.”
    —Hans Hofmann​


    GUI
    main.png
    main_clan_details.png main_player_details.png clan_menu.png clan_allies.png clan_coords.png clan_rivals.png clan_roster.png leaderboard_player.png

    Main Menu
    You can add the name of your server in the configuration and your server's name will replace "MinecraftServer" in the menu to give it a more personalized look. The main menu can be accessed by using the /clan command and will show the player only the commands he has access to at any given time.
    • Untrusted members of clans have basic commands
    • Trusted members of clans have advanced commands
    • Leaders of clans have clan administration commands
    • Mods have access to global commands
    • Unverified clans have a restricted command list
    • Verified clans have an unrestricted command list
    • Leaders of verified clans have all clan functionality
    • Leaders of verified clans that are also mods have the full set (seen below)

    Clan Types
    There are two types of clans, verified and unverified clans. When a player first creates a clan it will be of type unverified. These clans have a reduced feature set, no coords, vitals, stats, etc, they will not show up on any clan listings, and are automatically deleted if none of its members log in for 48 hours (configurable). Their purpose is to give your members quick and easy teaming up abilities without polluting your server with dozens of abandoned one off clans.

    Once one of your moderators can verify that the clan is legit, it can be upgraded by a mod it to verified status with /clan verify. At this point the clan and its members will be able to enjoy the full feature set of the SimpleClans plugin. Verified clans have an inactivity timer of 7 days (configurable), this means if noone logs in that belongs to the clan for a week it is automatically deleted.

    Optionally you can disable the clan verification feature in the config to make it so newly created clans are automatically verified.


    Creating your first Clan
    To create a clan you must give it a name and a tag. The tag will be used as the unique identifier for you clan, will be used in the clan commands, and will pretty much represent your clan in most messages. This tag can have color codes which can be later modified. For example, If i wanted to create a clan named "Knights of the Labyrinth" with a red and white tag named "kol", I would use the following create command:

    /clan create &4K&Fo&4l Knights of the Labyrinth

    Later on if I wanted to modify this tag, for example I wanted to make it all red instead of red and white and all uppercase I would use the modtag command. Note: with the modtag command you can only change colors and case, but not the letters that make up the tag

    /clan modtag &4KOL

    The colored tag will prefix all clan player's names on chat, don't worry it works alongside your existing prefixes and chat plugins.

    Inviting Members
    Creators of clans will become the first clan leader. They can invite other members into the clan with/clan invite. These members are first added with the untrusted status. These members will not be able to view clan vitals, coords, or stats. This is to prevent players form joining clans just to spy on other clans by writing down coordinates of bases or viewing vitals during battles. Once a player has gained the clan's trust he can be upgraded to trusted status with /clan trust.

    You can have multiple leaders on a clan. You can promote other leaders using the /clan promote command. To promote a leader all other leaders must be online and must accept the vote. A leader cannot be promoted unilaterally without the consent of all other leaders. Demotion using the /clan demote command works the same way.

    A moderator can completely ban a player form ever joining any clans with the /clan ban/unban command.

    Member fee and upkeep
    You can charge clans a upkeep (value set on the config) everyday, a clan that doesn't have enough balance will be disbanded automatically; to prepare the clan leaders, a notification is sent before the upkeep is collected. The upkeep can be a fixed amount or based on the clan size.
    And you can give (by enabling on the config) clan leaders the ability to charge their members a fee, also everyday; a member that doesn't have money to pay the fee and doesn't have the permission to bypass it, will be kicked automatically. To prevent abuses from leaders you can set a max value to the fee.

    Clan Chat
    To talk in clan chat use /. [your message]. It's super simple. (You can change the command to use the chat)

    Clan Alliances and Rivalries
    Any clan leader can send an request to start an alliance with any other clan with /clan ally add. If the request is accepted by a leader of the second clan, the alliance is formed. The alliance can be broken by any leader of either clan at any time with /clan ally remove, no one needs to accept the removal of an alliance.

    Clan rivalries can be started by any clan at any time, no request is needed, rivalries are automatically formed once a clan leader decides he wants one by using /clan rival add. If someone has pissed you off and you want them as rivals, their permission is not needed. To break a clan rivalry on the other hand, you need the acceptance of the other clan, you must use /clan rival remove to send the other clan a request, once one of their leaders accept the rivalry is broken.

    You can view a list of all clans and their allies with the /clan alliances command, or their rivals with the /clan rivalries command.

    Kill/Death Ratio
    Once a player is part of a verified clan, all his kills will start to be recorded. Deaths by other player's are also recorded. All kills are not equal. Killing a member of a rival clan, of a neutral clan, and a civilian not attached to any clan all carry different weights. Rival: 1.5, Neutral: 1, Civilian: 0.5 (configurable). The weights can also carry negative values, for example if you want to discourage killing civilians, you may want to set the civilian weight to -1 to lower the KDR with every civilian kill.

    Each player has a Kill/Death Ratio.score that is calculated and attributed to them. This is the ratio between your kills and your Deaths (your weighted kills divided by your deaths). This is the metric that shows a player's skill level.

    For example, If your weighted kills are 1000 points but you died twice as much, say 2000 times, then your KDR will be low (.5), far lower than a player who only killed 20 players but died only 1 time (KDR of 20). This is THE metric that determines how good of a PvPer you are. The higher the KDR the more worth you are to your clan. A noob that has been playing for a few months can amass a huge amount of kills and claim to be good at pvp, but his low ass Kill/Death ratio wont lie.

    Kills and Deaths will be recoded since you first step on a SimpleClans server, even if you're not on a clan. Once you join a clan you will start out with a KDR that will reflect all your kills (civilian only) and deaths since the first time you joined.

    Your server's players do not need to know the math in order to play. They can just go on their merry way doing what they were doing before, and their KDR will start being calculated which they can then see in their clan's stats page and your server's leaderboard. If they suck at pvp they will be low on the lists, if they are good they will show near the top. They will be able to compare their skill with someone elses based on their KDR.


    Friendly Fire
    Players in the same clan and players in allied clans have friendly fire protection from each other, they won't be able to hurt each other. Leaders of clans can turn this on and off with the /clan clanffcommand, you can either allow or block friendly fire. Each player can also turn off his own friendly fire protection at any time using the /clan ff command, he will be able to allow friendly fire or to set it to auto, which is whatever the clanff is. He will not be able to block friendly fire if his clan has allowed it, but he will be able to allow it if his clan has blocked it.

    Moderators have access to the /clan globalff command, this command allows you to set the global friendly-fire setting to either allowed or auto. Allowed will effectively allow everyone to harm everyone else, turning off friendly fire protection. This command is useful for when you are having a server-wide tournament and want to ensure that no one is cheating by using the clan protection. Setting globalff back to auto will give back the friendly fire control to each clan's or persons settings.

    Clan Home-Bases
    Clans can set a home-base locations for their clans with /clan home set and. The clan must be verified and only the leader is able to use this command.

    Once home is set any member is able to /clan home at any time to teleport back to their home base. Leaders have permissions for a powerful command /clan home regroup, which will teleport all clan members to the home base. This is useful for when your home base is being raided, or when you want to coordinate an event or raid.

    Before a player is teleported he must wait a pre-configured amount of seconds on the same block. This is to prevent them from running away from pvp fights. If they move before the warmup time is expired, then the teleport is canceled. Warmup timer for teleport can be configured with the clan.homebase-teleport-wait-secs config setting. If set to 0, the warmup is disabled.

    Alternatively if you do not allow teleporting in your server (many survival servers don't), you can disable the "simpleclans.member.home" and "simpleclans.member.home-regroup" permissions from your players and enable the "teleport-home-on-spawn" config setting. This will turn clan homes into clan spawn points. Your server's clans will still be able to set homes, and their members will be able spawn in their clan homes.


    Clan Bulletin Board
    All clan activity is logged on the server's log files. The last few events (configurable) are displayed to each clan member when they log in giving them an overview of the clan's activities. This list can also be pulled up at any time with the /bb view command. Trusted members can add messages to the bulletin board using the /bb add [msg] command. Messages added to the bulletin board are also announced to any members that are currently online. Each individual player can toggle the display of the bb on join with /clan toggle bb. If you have no more use for the bb you can clear it with /bb clear.

    Ranks
    Clan leaders can give their members ranks using the /clan setrank [player] [rank] command. The ranks can contain color codes and can pretty much be anything.

    Clan List

    You can view all the clans on your server using the /clan list [name/size/kdr/founded/active] [asc/desc] command. The clans are sorted by KDR (configurable) if no arg is used.

    Leaderboard
    With the /clan leaderboard you can compare all clan players. The leaderboard is sorted by KDR, this will tell you who to fear, or what free agent you may want to invite to your clan.


    Clan Roster
    The /clan roster command shows you the members of your clan. Here you can see your clan's members ranks, status, and when the last time they were seen online was.


    Clan Vitals
    The /clan vitals command shows you the vitals of all online members of your clan. Here you can see their health, what armor and weapons they are carrying and of what materials, and how many hearts all of their food contains. This comes in handy during battle to know who you need to help and who can bring help to you.


    Clan Coordinates
    The /clan coords command shows you the distance and coordinates of all online members of you clan, sorted by distance. With this you will be able to know who to call for help during a raid/battle.


    Clan Stats
    Your clan's stats screen, opened with the /clan stats command, shows you all of your clan members KDR, raw kills, and deaths stats. Leaders show on the top and members on the bottom. Leaders are sorted by KDR, and members are sorted by KDR. This screen tells you who are the strongest leaders, and who are the strongest members. It will also show you the current weights for the different types of kills.


    Player Lookup
    You can look up your own or another players info using /clan lookup command. This gives you all the data concerning the player, his KDR, his kills and deaths, what clan he belongs to, the date when he joined the clan, his status in the clan, when he was last seen, a list of all past clans hes been part of, and how many days he has been inactive for.


    Clan Profile
    With the /clan profile command you can view details about any clan. It shows you the clan leaders, how many members are currently online, the KDR, the sum of all kills and deaths of all members of the clan, allies, rivalries, the date founded, and how many days it has been inactive for. It also shows a description of the clan (if set) and the status of the member fee (if enabled and its value).


    Kills List
    With /clan kills [player] you can see which victims this player has killed the most and the counts. You can use /clan kills to see your own victim list. Note: Huge numbers of kills to the same victim point to two people willingly cheating kdr.

    Most Killed
    With the /clan mostkilled command (by default only available to mods) will show you the most killed players by a single attacker in the whole server, basically a list of possible kdr cheaters, starting with most obvious at the top.


    Protection
    If you use GriefPrevention, follow this guide:
    https://simpleclans.gitbook.io/simpleclans/other/land-claims

    Economy Support
    You will need Vault for economy plugin support. You can download it form here. Just drop it into your plugins folder. http://dev.bukkit.org/server-mods/vault/

    Clan Creation
    You can charge your players for unverified clan creation by using the economy.purchase-clan-create config setting along with the economy.creation-price setting. With only this setting on, you still have control of clan verification.

    Clan Verification
    You can also add pay for verification with the economy.purchase-clan-verify config setting and the economy.verification-price setting. This will give control of clan verification back to the players, it will give them the /clan verify menu item, which will charge them for clan verification. You can have either or both of these systems in place at the same time.

    User Translations:
    You can help translating SimpleClans to your language here.
    Status:
    [​IMG]

    Permissions
    Works with all common permissions managers.
    Nodes: https://simpleclans.gitbook.io/simpleclans/commands-and-permissions/permissions

    Persistence
    If possible you should activate MySQL in your config. If you do not have a MySQL server you can use SQLite. Preferred engine: MySQL
    Also enable use-threads in the config to prevent lag.

    API
    Every feature of SimpleClans is available though the API. You start by retrieving a player's data object called ClanPlayer. From this object you can pull his Clan and act on the player and the clan using the numerous methods.

    For more information: https://simpleclans.gitbook.io/simpleclans/other/simpleclans-api

    Found a bug or have a feature request?
    Add it to the bug tracker:
    https://github.com/RoinujNosde/SimpleClans/issues

    Dynmap-SimpleClans
    You can find the plugin here: https://www.spigotmc.org/resources/dynmap-simpleclans.70439/

Recent Updates

  1. v2.14.4.1
  2. v2.14.4
  3. 2.14.3

Recent Reviews

  1. Enotik_kiss
    Enotik_kiss
    5/5,
    Version: 2.14.4.1
    Самый, просто самый лучший плагин на кланы, спасибо вам за всё, ждём больше обнов! ;)
    1. RoinujNosde
      Author's Response
      Thank you!
  2. Hokz
    Hokz
    5/5,
    Version: 2.14.2
    Muy buen plugin lo uso en mi server pero quería saber si era compatible con protecciónstone
    1. RoinujNosde
      Author's Response
      Thanks! That depends on the other plugin (for now).
  3. Afk6
    Afk6
    5/5,
    Version: 2.13.1
    [19:12:33 WARN]: [SimpleClans] Plugin SimpleClans v2.13.1 generated an exception while executing task 973368
    java.util.zip.ZipError: zip END header not found
    at com.sun.nio.zipfs.ZipFileSystem.zerror(ZipFileSystem.java:1651) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystem.findEND(ZipFileSystem.java:1040) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystem.initCEN(ZipFileSystem.java:1049) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystem.<init>(ZipFileSystem.java:130) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystemProvider.newFileSystem(ZipFileSystemProvider.java:117) ~[zipfs.jar:1.8.0_262]
    at java.nio.file.FileSystems.newFileSystem(FileSystems.java:326) ~[?:1.8.0_262]
    at java.nio.file.FileSystems.newFileSystem(FileSystems.java:276) ~[?:1.8.0_262]
    at net.sacredlabyrinth.phaed.simpleclans.language.LanguageResource.loadAvailableLocales(LanguageResource.java:81) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.language.LanguageResource.getAvailableLocales(LanguageResource.java:73) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.frames.LanguageSelectorFrame.createComponents(LanguageSelectorFrame.java:47) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.InventoryDrawer.setComponents(InventoryDrawer.java:89) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.InventoryDrawer.prepareInventory(InventoryDrawer.java:62) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.InventoryDrawer.lambda$open$1(InventoryDrawer.java:40) ~[?:?]
    at org.bukkit.craftbukkit.v1_12_R1.scheduler.CraftTask.run(CraftTask.java:64) ~[patched_1.12.2.jar:git-Paper-1618]
    at org.bukkit.craftbukkit.v1_12_R1.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:52) ~[patched_1.12.2.jar:git-Paper-1618]
    at com.destroystokyo.paper.ServerSchedulerReportingWrapper.run(ServerSchedulerReportingWrapper.java:22) ~[patched_1.12.2.jar:git-Paper-1618]
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [?:1.8.0_262]
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [?:1.8.0_262]
    at java.lang.Thread.run(Thread.java:748) [?:1.8.0_262]
    [19:12:37 INFO]: _Diksen_112 issued server command: /donate
    [19:12:52 INFO]: Vadik345 issued server command: /menu
    [19:12:56 WARN]: [SimpleClans] Plugin SimpleClans v2.13.1 generated an exception while executing task 973820
    java.util.zip.ZipError: zip END header not found
    at com.sun.nio.zipfs.ZipFileSystem.zerror(ZipFileSystem.java:1651) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystem.findEND(ZipFileSystem.java:1040) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystem.initCEN(ZipFileSystem.java:1049) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystem.<init>(ZipFileSystem.java:130) ~[zipfs.jar:1.8.0_262]
    at com.sun.nio.zipfs.ZipFileSystemProvider.newFileSystem(ZipFileSystemProvider.java:117) ~[zipfs.jar:1.8.0_262]
    at java.nio.file.FileSystems.newFileSystem(FileSystems.java:326) ~[?:1.8.0_262]
    at java.nio.file.FileSystems.newFileSystem(FileSystems.java:276) ~[?:1.8.0_262]
    at net.sacredlabyrinth.phaed.simpleclans.language.LanguageResource.loadAvailableLocales(LanguageResource.java:81) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.language.LanguageResource.getAvailableLocales(LanguageResource.java:73) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.frames.LanguageSelectorFrame.createComponents(LanguageSelectorFrame.java:47) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.InventoryDrawer.setComponents(InventoryDrawer.java:89) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.InventoryDrawer.prepareInventory(InventoryDrawer.java:62) ~[?:?]
    at net.sacredlabyrinth.phaed.simpleclans.ui.InventoryDrawer.lambda$open$1(InventoryDrawer.java:40) ~[?:?]
    at org.bukkit.craftbukkit.v1_12_R1.scheduler.CraftTask.run(CraftTask.java:64) ~[patched_1.12.2.jar:git-Paper-1618]
    at org.bukkit.craftbukkit.v1_12_R1.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:52) ~[patched_1.12.2.jar:git-Paper-1618]
    at com.destroystokyo.paper.ServerSchedulerReportingWrapper.run(ServerSchedulerReportingWrapper.java:22) ~[patched_1.12.2.jar:git-Paper-1618]
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [?:1.8.0_262]
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [?:1.8.0_262]
    at java.lang.Thread.run(Thread.java:748) [?:1.8.0_262]
    1. RoinujNosde
      Author's Response
  4. weedorpy
    weedorpy
    5/5,
    Version: 2.13.1
    Muy buen plugin. Lo uso en mi servidor de clanes! Simple pero completo, lo recomiendo bastante. Lo unico que le faltaria es que sea compatible con ProtectionStones. :DD
    1. RoinujNosde
      Author's Response
      Thank you!
      If possible, open an issue on github to talk about this compatibility.
  5. Lutin
    Lutin
    4/5,
    Version: 2.13.1
    Плагин хороший, но у меня баг или я рукожоп, у меня кдр не засчитываются при убийстве игрока, также и со смертью, может в конфиге строка, которая отвечает за включение подсчета кдр?
    1. RoinujNosde
      Author's Response
      I can't give an appropriate support through the reviews section. Open an issue on Github or join SimpleClans' discord.
  6. ElDaptap
    ElDaptap
    5/5,
    Version: 2.13.0
    The friendly-fire issue is somewhat bugged, since I'm interested in my clan not being able to hit me but if I can hit myself for the punch, if I could fix it it would be wonderful, Everything else is great. And also if you can add that there is no friendly fire between allies or that it can be activated / deactivated. (1.8 version)
  7. PirateCraft
    PirateCraft
    5/5,
    Version: 2.13.0
    We have been using SimpleClans on PirateCraft for well over 5 years now, this is the only full Clan/Crew management plugin that really does have it all with fantastic updates!
    1. RoinujNosde
  8. Sage905
    Sage905
    5/5,
    Version: 2.12.2
    SimpleClans is an excellent addition for any SMP server that doesn't want to get too complicated. Our server at pwn9.com has been running SimpleClans on our main YASMP server as far back as 2011, because our players love it.

    We're very grateful to phaed for creating it, and all the effort that folks like RoinujNosde have put into reviving it, and making it even better.
    1. RoinujNosde
      Author's Response
      Thank you!
  9. Gustavo_Player
    Gustavo_Player
    5/5,
    Version: 2.12.2
    This is much better than the older versions, great job dude. =)
    1. RoinujNosde
      Author's Response
      Thanks :)
  10. FoxSpellCaster
    FoxSpellCaster
    5/5,
    Version: 2.12.2
    Amazing! You'd think it would be easier to find a plug-in that doesn't include a claim system, well here is the plug-in. The GUI, and hooks to other plug-ins really complete this package for me. Thanks for your hard work.
    1. RoinujNosde
      Author's Response
      Thank you!