ClansFix

revised translation

Clans Fix 1.2.4 for Minecraft versions 1.21 – 1.21.6

1. Changed the output of the %clans player level% placeholder 2. Translated clan leveling tasks

Fixed a bug with deleting clans and a bug with clan name length limitations.

notification of replenishment of the clan treasury

Admin panel /clan admin (beta) Support for placeholders in language files Support for "\r" line breaks

Menu changes, more flexible settings, automatic substitution of the user's language


Fixed a bug with armor

Added clickable clan invitations, fixed armor/coat-of-arms duplication bugs, fixed holograms surviving crashes/timeouts, added /clan chat, changed chat format to <tag-colored-clan-name> nick: message, removed on/off tab hints, bumped to 1.1.4, added all hostile mobs to all 7 language files (prevents broken names when changing mobs in config), and fixed the code fallback for unknown mob types.

Fixed: Clan tag now stays in its correct position. Fixed: Removed repeated clan armor update messages. Fixed: Players can now pick up clan armor again. Fixed: Clan shield can now be changed without issues.

Bug #1 (Armor)

The save path was changed from "armor" to "armorEnabled" (line 222). A backup fix was added on line 412 to keep old saves working.

Bug #2 (Name duplication)

The color tag is set without including the clan name (line 2174). On line 2160, special color codes are normalized from § to &.

Language Files - Fixes & Completion Status

Fixes Applied

- Fixed truncated Brazilian Portuguese (pt.yml) translation - Completed missing entity and item translations in pt_BR.yml - Corrected YAML syntax errors across multiple language files - Standardized color code formatting (both & and <#RRGGBB> formats) - Completed all incomplete raid system messages and menus - Ensured all placeholder variables ({player}, {clan}, {amount}, etc.) remain intact - Fixed missing closing brackets and indentation issues ---

Completed Language Files

| Code | Language | Status | |:----:|----------|:------:| | ru | Russian (Русский) | Complete | | de | German (Deutsch) | Complete | | fr | French (Français) | Complete | | es | Spanish (Español) | Complete | | pl | Polish (Polski) | Complete | | pt | Brazilian Portuguese (Português Brasileiro) | Complete | ---

All 6 language files are now 100% complete and ready for production use.

- You will no longer see your clan name in third-person view. - You can create a clan for 30,000 without asking the admins. - /clan help now works better. - Other technical changes.

New Features

#### Clan Chat - Added clan chat via % prefix at the beginning of message - Command `/clan chat` — enable/disable clan chat mode - ManagerFix integration — using API for message sending - Automatic channel creation for each clan - 6 languages supported: Russian, English, German, French, Spanish, Polish #### Beautiful Message Formatting - Clan name — gold gradient, bold - Player rank — purple, bold (Leader, Elder, Member, Novice) - Player nickname — yellow - Message — white - 4 alternative styles to choose from (symbols, minimalism, rich)

Bug Fixes

#### Holograms - Fixed bug — clan tag hologram now always removed when player quits - Additional cleanup of references in onPlayerQuit() to prevent leaks #### Data Saving - Fixed bug — player no longer stays in clan after logout and server restart - Synchronous saving when leaving clan (saveClanSyncPublic()) - Fixed bug — deleted clan no longer restores after restart - Cleanup of stale records in playerClans on server load #### Clan House Teleport - Fixed teleportation — now works correctly - Safe location search — automatic search for teleport point - Force teleportation via Passenger API to bypass blocks - Detailed logging — all teleport stages logged to console - Teleport animation — 5 seconds wait with particles and countdown - Movement protection — teleport cancels if player moves - Title countdown — beautiful countdown in center screen

Changes

#### Permissions - OP players can now create clans by default - *Wildcard ``** now grants clan creation permission - `clansfix.create` — works via clansfix.* wildcard #### Clan House - Synchronous saving when setting/removing house - World name saved separately from location for recovery - Auto-load world if not loaded on startup ---

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.

+ optimization + admin panel

/clan admin

/clan tphere

+ hologram not visible in spectator mode

Clan holograms have been fixed

The clan creation button works

-New menu -New translation -Fixed a duplication bug -Ability to disable clan armor

translation corrected

translation corrected