ClansFix

Performance (TPS)

• TRAVEL_DISTANCE quest: Progress is no longer updated on every player move. Distance is accumulated and flushed at most once per second (configurable via performance.travel-distance-interval-ms). This significantly reduces load with 150+ players online.
• Clan saves: File writes are done on a separate thread (performance.save-clan-async: true). Saves triggered by quest progress are debounced by a few seconds (performance.quest-save-debounce-ticks) so the disk is not written on every move.
• Periodic save: All clans are saved every 5 minutes (performance.periodic-save-interval-ticks: 6000) as a backup.
• Disable travel quest: New option performance.travel-distance-enabled. When false, no movement-based logic runs — zero load from walking.

Holograms above player

• Holograms (clan name and coat of arms) are not shown above players in Spectator mode or when invisible (potion, etc.).
• New holograms section in config to set height above the player’s head:
  • holograms.height-tag — height of the clan name text (default 2.4 blocks).
  • holograms.height-coat-of-arms — height of the coat of arms hologram (default 2.5 blocks).

Security (LFI / Path traversal)

• Fixed vulnerability: clan name is no longer used in file paths without validation. The characters .., /, and \ are disallowed in clan names.
• When creating a clan (via /clan create or chat input in the menu) or renaming, the name is validated. If it contains forbidden characters, a message is sent in chat (keys commands.clan.create.invalid_name and menus.settings.rename.invalid_name in all languages).
• Saving and deleting clans only use paths that stay inside the plugin folder.

Commands and UI

• Tab completion for /clan invite: Typing /clan invite and Tab suggests online player names (excluding the sender), filtered by the typed prefix.
• Forbidden symbols message: When trying to create a clan with .., /, or \, the chat shows a message like “These symbols are forbidden in clan name! Do not use .. / \” (or the equivalent in the selected language).

Localization

• Fixed the key for the message after teleporting clan members (/clan tphere): now uses commands.clan.tphere.done instead of commands.tphere.done, so the “[Missing: ...]” message no longer appears.
• Added keys commands.clan.create.invalid_name and menus.settings.rename.invalid_name to all language files (en, ru, pl, fr, de, es).

Config config.yml

• performance section: save-clan-async, travel-distance-enabled, travel-distance-interval-ms, quest-save-debounce-ticks, periodic-save-interval-ticks.
• holograms section: height-tag, height-coat-of-arms.