📘Configuration
Last updated
Last updated
The main configuration file for SimpleClans can be found here.
default-color - color used when the clan leader didn't set any colors
max-length - maximum length for tags
bracket - brackets are the characters around the tag, ex.: [ ]
color - the bracket color
leader-color - this color is used when the player is a leader
left - the left character
right - the right character
min-length - minimum length for tags
separator - the separator is a character that separates the tag and the player name
color - the separator color
leader-color - this color is used when the player is a leader
char - the separator character
In this section you can edit the base commands of the plugin. Enable force-priority if other plugins are interfering with the commands.
enable-max-kills - by enabling this, you can set a limit on kills per victim.
max-kills-per-victim - this is the limit of kills per victim. If it's set to 10, for example, killing the same player for the 11th time won't affect the KDR
enable-kill-delay - enables a delay between kills
delay-between-kills - this is the delay in minutes between kills
creation-price - the price to create a clan
purchase-clan-create - players must pay to create a clan
verification-price - the price to verify a clan
purchase-clan-verify - players must pay to verify their clans
invite-price - the price to invite a player to your clan
purchase-clan-invite - players must pay to invite
home-teleport-price - the price to teleport to the clan's home
purchase-home-teleport - players must pay to teleport
home-teleport-set-price - the price to set the clan's home
purchase-home-teleport-set - players must pay to set the clan's home
home-regroup-price - the price for regrouping the clan members
purchase-home-regroup - players (or the clan) must pay to regroup
unique-tax-on-regroup - if false, the price is multiplied by the amount of online members of the clan
issuer-pays-regroup - if enabled, the player issuing the command pays for the regroup, otherwise the clan pays it
money-per-kill - enables a prize in money for the killer clan
money-per-kill-kdr-multipier - this is multiplied by the attacker's KDR, the result is the money prize for the clan
purchase-reset-kdr - If true, players will be able to reset their KDR
reset-kdr-price - the price to reset one's KDR
purchase-member-fee-set - players must pay to set the member fee
member-fee-set-price - the price to set the member fee
member-fee-enabled - if clans can charge a daily fee from their members
max-member-fee - the maximum amount clans can set for their member fee
upkeep - the daily price for maintaining a clan (if not paid, the clan is disbanded)
upkeep-enabled - if clans must pay the upkeep
multiply-upkeep-by-clan-size - if the upkeep price should be multiplied by the amount of members
charge-upkeep-only-if-member-fee-enabled - if the upkeep should be charged only for clans that choose to enable the member fee
bank-log.enable - If true, all economy actions will be recorded in .CSV file (SimpleClans/logs/bank/)
Here you can set the weight of every kill type. The weight can be negative too. It's used to calculate the KDR like so: (Kill Count * Kill Wight) / Death Count = KDR
homebase-teleport-wait-secs - the amount of seconds players must wait before teleporting to their clan' home
homebase-can-be-set-only-once - if the clan's home can be set only once
min-size-to-set-rival - the minimum amount of members a clan needs to add rivals
max-length - the max length of the clan's name
max-description-length - the maximum length of the clan's description
min-description-length - the minimum length of the clan's description
max-members - the maximum amount of members a clan can have
unverified-max-members – the limit of members in unverified clans
confirmation-for-promote - if other leaders must confirm the promotion of members
trust-members-by-default - if members are set as trusted by default
confirmation-for-demote - if other leaders (except the one being demoted, of course) must confirm the demotion
percentage-online-to-demote - the percentage of online leaders to demote
ff-on-by-default - if the clan's friendly-fire is enabled by default
min-length - the minimum length of the clan's name
min-size-to-set-ally - the minimum amount of members a clan needs to add allies
min-to-verify - The clan must have this amount of members to get verified (moderators can bypass this)
starter-ranks – The list of ranks created in the new clan
default-rank – The rank assigned to a new clan member
This section allows you to set the time of collection for the two types of fee. The fees are described on the economy section.
The collect-upkeep-warning is sent when the clan doesn't have enough money to pay for its upkeep.
The time is in the 24-hour clock.
untrusted-color -
clan-name-color -
subtitle-color -
headings-color -
trusted-color -
leader-color -
separator -
size -
You can checkout the configuration here.
enable - enables the clan chat
tag-based-clan-chat - if true, the command to talk on the clan chat is the clan tag
announcement-color - color used for announcements
format - the chat format
spy-format - the spy chat format
rank - the member's rank format (used on the format)
leader-color - the color for leaders (%nick-color%)
trusted-color - the color for trusted players (%nick-color%)
member-color - the color for non-leaders and non-trusted players (%nick-color%)
Requests are messages sent to players to decide (accept or deny) on something (joining a clan, promoting someone, etc).
message-color - the message color
ask-frequency-secs - the interval in seconds between each message
max-asks-per-request - maximum amount of messages before the request expires
prefix – A prefix of messages in bulletin board
show-on-login - if enabled, the BB is sent to clan members when they login
size - the BB size (when using its command)
login-size - the BB size on login
The Ally Chat config works just like the Clan Chat one.
Just a few words how it works.
Imagine, we are in different clans.
You're in Fenix and I'm in Dragon, but you're an OP
(or player with simpleclans.admin.all-seeing-eye permission).
When I write a message in Dragon's clan chat: /. Good morning, dragons!
You as an admin (OP) will receive that message as well and it would be formatted by spy-format.
So, you will get something like: [Spy] [C] RoinujNosde: Good morning, dragons!
This feature allows you to purge data of inactive players or clans.
The plugin supports SQLite and MySQL. By disabling MySQL, SQLite will be used automatically.
Set your credentials below to use MySQL on SimpleClans.
In this section, you can give clans specific permissions. In the example below, members of the clan "YourClanNameHere" will receive the permission "test.permission".
auto-group-groupname - if enabled, members of clans will receive the permission "group.TAG" (tag, of course, gets replaced). Be careful with this setting, if you are using LuckPerms, players could create a clan called "admin" and be automatically added to the corresponding group. If you are using it, disable the creation of such clans (mod, admin, etc).
save-periodically - The plugin will save its data periodically as opposed to right away, RECOMMENDED to set it true.
save-interval - The interval in minutes in which changes are written to the database.
use-threads - The plugin will not use the main thread to connect with the database if this is true, RECOMMENDED to set it true.
use-bungeecord - Enable it in both spigot plugins, also make sure you have one MySQL connection.
safe-civilians - Civilians are safe from PvP, even civilian vs civilian combat is disabled