
ClansFix
ClansFix — a powerful clan plugin for Minecraft servers that adds deep clan systems with progression, quests, ranks, and customization . It turns group gameplay into an engaging experience with leveling, treasury, houses, and competitive rankings .
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
support for the vanish function from CMI
Development of a new raid system has begun (beta test)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
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 ruRussian (Русский) ✅ Complete deGerman (Deutsch) ✅ Complete frFrench (Français) ✅ Complete esSpanish (Español) ✅ Complete plPolish (Polski) ✅ Complete ptBrazilian Portuguese (Português Brasileiro) ✅ Complete
All 6 language files are now 100% complete and ready for production use.
- Fixed truncated Brazilian Portuguese (
- 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
playerClanson 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
- Added clan chat via
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. Whenfalse, 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
hologramssection 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 createor chat input in the menu) or renaming, the name is validated. If it contains forbidden characters, a message is sent in chat (keyscommands.clan.create.invalid_nameandmenus.settings.rename.invalid_namein 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 inviteand 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 usescommands.clan.tphere.doneinstead ofcommands.tphere.done, so the “[Missing: ...]” message no longer appears. - Added keys
commands.clan.create.invalid_nameandmenus.settings.rename.invalid_nameto all language files (en, ru, pl, fr, de, es).
Config
config.ymlperformancesection:save-clan-async,travel-distance-enabled,travel-distance-interval-ms,quest-save-debounce-ticks,periodic-save-interval-ticks.hologramssection:height-tag,height-coat-of-arms.
- TRAVEL_DISTANCE quest: Progress is no longer updated on every player move. Distance is accumulated and flushed at most once per second (configurable via
- 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


