Skip to content

FAQ

A list of the most frequently asked questions about the FunnyGuilds plugin.

With prevent-uuid-conflicts enabled, UUID conflict for username means the stored data contains two different UUIDs for an identical username. Comparison is case sensitive: Steve and steve are distinct names. The console lists both UUIDs and their sources (file paths or the SQL table). FunnyGuilds aborts on the first conflict, before loading users and guilds or starting automatic saves. Account records are not automatically deleted or merged.

  1. Stop the server and back up FunnyGuilds data, including the SQL database if used.
  2. Check authentication and UUID forwarding settings in Velocity/Bungee. A proxy backend can legitimately use online-mode=false; check the whole network configuration before changing that setting.
  3. Identify the accounts belonging to the reported UUIDs. Possible causes include authentication changes, imported data and another account reusing a username.
  4. Resolve the conflict manually, accounting for player data and guild references, then restart the server. Do not delete all user data.

The check is disabled by default and runs only at startup. It does not reject logins by a new owner of an old username or restrict username changes. If username reuse is valid on your server, leave prevent-uuid-conflicts: false: enabling it can stop the next startup while two accounts remain stored under the same name. See the configuration.

Separate errors Invalid or missing UUID, Missing or blank username, Could not read … user file(s) indicate an invalid UUID, missing username or unreadable YAML file, respectively. Unreadable YAML files are counted in one summary per directory, including the first affected file’s path. These errors and identity conflicts are logged without stack traces. With checking enabled, the plugin aborts startup to avoid saving incomplete data; with checking disabled, it skips unreadable YAML files.

Fog when entering or leaving a guild’s territory

Section titled “Fog when entering or leaving a guild’s territory”

In config.yml, change

notification-boss-bar-flags:
- CREATE_FOG

to

notification-boss-bar-flags: []

What is a nightly build and where can I download one?

Section titled “What is a nightly build and where can I download one?”

Nightly builds are plugin builds containing all the latest changes to the source code. An official release is put together every few nightly builds. Individual builds are available here: FunnyGuilds Nightly.

After installing such a version, you’ll keep seeing a message about a newer version being available. This happens because the updater only takes official releases into account — nightlies aren’t included. The message can be ignored.

Where do I find the list of FunnyGuilds permissions?

Section titled “Where do I find the list of FunnyGuilds permissions?”

You can find the list of permissions here.

Tags, scoreboards and points under the nickname aren’t working

Section titled “Tags, scoreboards and points under the nickname aren’t working”

The most common cause of this kind of issue is another plugin using scoreboards and the elements tied to them, such as team tags above players’ heads or points under the nickname. Since Bukkit provides no sensible API for this, every plugin registers its own scoreboards, which is often a source of conflicts. One example is Scoreboard Stats, which offers a compatibility mode option that lets the two work together correctly. If a plugin has no similar option in its configuration, it’s incompatible with FunnyGuilds.

How do I set up holograms with the top guilds?

Section titled “How do I set up holograms with the top guilds?”

FunnyGuilds does not create these holograms itself. You need DecentHolograms and PlaceholderAPI — put the top-list placeholders from the funnyguilds expansion in the hologram’s lines:

%funnyguilds_gtop-points-1%
%funnyguilds_gtop-points-2%
%funnyguilds_gtop-points-3%

See Placeholders for the full list of available top lists.

How do I integrate the plugin with CombatLogX?

Section titled “How do I integrate the plugin with CombatLogX?”

CombatLogX does not kill players with administrator/op permissions, so the integration cannot be tested on such an account. CombatLogX may also override the death message set in FunnyGuilds.