Common problems
Fixes for what server owners hit most: claims that protect nothing, players who cannot use a command, a clan stuck raidable and chat shortcuts that swallow messages.
Find your symptom, then follow the fix.
The plugin does not start#
The console names what is missing. ExyliaLib is required. See Install ExyliaClans.
A player cannot use a command#
Every /clan node is allowed by default, so first check whether a permission group negates it. More often the cause is the clan: most subcommands also need a rank permission, and the shipped Member rank holds only FOCUS. See Permissions and Ranks and permissions.
Claims do not protect anything#
claims.protection-mode ships as WORLDGUARD. Without WorldGuard no region is created and the built-in protection stands down, so the claim is drawn and paid for and protects nothing. Set it to BUILTIN or install WorldGuard.
Then check that the owning clan is not raidable: a raidable clan's claim is open on purpose.
A member cannot build in our own claim#
With BUILTIN protection this is the BUILD rank permission, which the shipped Member rank does not have. Tick it in /clan, Settings, Roles, or add it to default-roles for clans created from now on.
/clan sethome says I must be inside the claim#
That is required while the claims module is on. Claim first, then set the home inside it. With modules.claims: false the home can be set anywhere.
We unclaimed and lost our home#
This is on purpose: the home lives inside the claim, so removing the claim removes it. Both are written to the clan log.
/clan deposit says the economy is unavailable#
The currency named by bank-currency cannot be read. Install an economy plugin that ExyliaLib can read, or point bank-currency at another currency from ExyliaLib's economy.yml, items and experience included. Without the bank no claim can be bought.
A clan cannot disband or unclaim#
Both need the clan to be in the NORMAL DTR state. A clan whose member just died is frozen for ten minutes. Leaving and being kicked cost nothing and freeze nothing, and neither does a death in a world listed in no-loss-worlds. /clanadmin disband skips the check. See DTR.
The clan is stuck raidable#
DTR regenerates regen-amount (0.1) every regen-interval-seconds (45) only while the clan is not frozen, and every death restarts the freeze. A clan being farmed never leaves it. Lower frozen-duration-seconds, raise regen-amount, or add the world to no-loss-worlds.
Deaths in the lobby cost DTR#
Add the world to dtr.no-loss-worlds. The lobby, event worlds and practice worlds belong there.
Typing a dot in chat sends to my clan#
settings.chat.quick-clan-prefixes is ["."] and quick-ally-prefixes is ["@"]. Change them to something nobody starts a sentence with, such as c: and a:, or empty the lists to turn the shortcuts off. See Chat and mail.
The menus and messages are in the wrong language#
The language key in config.yml decides. default follows ExyliaLib's own language, and en, es, fr, pt, ru or tr set this plugin alone. A server that ran 1.1.0 is on custom, its own files from before. Set another value to switch. See Configuration.
An invitation or alliance request vanished#
Both expire after settings.invite-expire-seconds (60), and the player or the requesting clan is told. Raise it, or set 0 to keep them until answered. They are stored, so a restart does not drop them.
"You invited that player recently"#
A clan can invite the same player once every settings.invite-cooldown-seconds (60). Creating a clan and sending mail have waits of their own, see Commands.
Allies are still hitting each other#
Both clans need friendly fire on for allies to be protected. Also check that the world is not in settings.forced-ff-worlds, which overrides every clan's setting.
Members can no longer focus, camp or rally#
Those are the rank permissions FOCUS, CAMP and RALLY. Ranks that existed before 1.2.0 were given all three once, and a new clan's Member rank holds only FOCUS. Tick the others in /clan, Settings, Roles.
The webhook button is missing from the settings menu#
webhooks.enabled is false. With it on, every member sees the button, and one without MANAGE_WEBHOOK is refused on click. See Discord webhooks.
Our clan lost a level#
Deaths cost 5 EXP and going raidable costs 50, and the level is recomputed from the total. Members are never kicked for it, but the clan cannot recruit past the smaller cap until it climbs back. See Clan levels.
The kills leaderboard is higher than the members' kills#
rivals.kill-stat-multiplier inflates the clan's recorded kill for a rival kill, while the player's own row records one. Set it to 1.0 to keep the two in step.
A scoreboard slot is blank#
An online-roster slot with nobody in it shows nothing. Use the fallback form, for example %exyliaclans_clan_online_member_5|%, and see Placeholders.
/clan map shows nothing#
Nothing is claimed within claims.map-radius (200 blocks). The command says so. The map also switches itself off after two minutes.
Menu edits do not show up#
Check that you edit the folder of the language in use, lang/<language>/menus/, then run /clanadmin reload. If a file is still not read, the console names the part it could not understand, and the rest of the screen opens without it.
I changed default-roles and existing clans did not change#
They will not. default-roles describes a clan on the day it is created. After that its ranks belong to the clan, which edits them itself.
Something missing on this page? Tell us on Discord