BetterClans+ | Economy & Claims & Clans v1.3

☘ BetterClans+ ☘

The Ultimate Clan, Territory, War & Economy System for Hytale

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FEATURES

COMPLETE CLAN SYSTEM

• Create & Manage Clans - Create your own clan and build your community
• Invite System - Auto-expiring invitations (60 seconds)
• Rank Hierarchy - Leader, Co-Leader, Veteran and Member
• Promote & Demote - Manage your members with clear clan roles
• Kick Members - Remove unwanted players from your clan
• Clan Points System - Compete with other clans
• Clan Top Leaderboard - View the top clans on the server
• Admin Management Tools - Set leader, set points, delete clans and forcejoin players

CLAN WARS SYSTEM

• Full Clan Wars - Challenge other clans for money and pride
• Configurable Team Size - Start wars with custom team sizes
• Clan War Queue - Members can join or leave their war team
• Accept / Deny Flow - Clan leaders and co-leaders can accept or deny wars
• War Stake System - Fight for configurable money amounts
• Arena Spawn Support - Configure team spawns and spectator spawn
• Live War Info - Check active war status and remaining players
• Spectator Mode - Spectate active wars in ghost mode
• Spectator Ghost Features:
→ Invisible spectator mode
→ Can fly
→ Cannot break, place, interact, attack, drop items or pick up loot
→ Inventory is hidden while spectating
→ Original inventory and location are restored after leaving or when the war ends

TERRITORY & CLAIMS

• Chunk-Based Claims - Claim territory for your clan
• Interactive Claim GUI - Visual chunk map to claim and manage land
• World Map Claim Overlay - Claimed chunks also appear on the main world map
• Claim Border Viewer - Use particles to visualize claim borders
• Admin Claim Mode - Manage claims for other clans
• Configurable Max Claims - Set claim limits per clan
• Extra Claims Per Member - Clan territory grows with clan size
• Configurable Max Members - Full control over clan size limits
• Claim Ownership Integration - Claims are tied directly to clans

ADVANCED CLAIM PROTECTION

• Block Break Protection - Outsiders cannot break blocks inside claims
• Block Place Protection - Outsiders cannot place blocks inside claims
• Block Interaction Protection - Protect chests, doors, buttons and interactables
• Entity Protection - Outsiders cannot damage entities inside protected claims
• No PvP In Claims - PvP is disabled inside claimed territory
• Effect Damage Protection - Fire, ice and indirect weapon effects are blocked in protected claims
• Explosion Protection - Explosions cannot destroy claimed land
• Mob Grief Protection - Mobs cannot destroy blocks in claims
• Territory Enter/Leave Messages - Players are notified when entering or leaving claimed areas
• Anti-Spam Protection Messages - Cooldown system prevents chat spam while hitting protected land

SIMPLECLAIMS IMPORT SYSTEM

• Import From SimpleClaims - Migrate old claims into BetterClans
• Dry Run Mode - Preview the import before applying changes
• Run Import Mode - Execute the migration safely
• Pending Claims Manager - View unassigned imported claims
• Assign Imported Claims - Assign pending claims to clans manually
• Backup Support - Import process creates backup data
• Multiple Source Support - Supports old formats and newer SimpleClaims storage formats

CLAN CHAT

• Private Clan Chat - Toggle a private chat mode for clan members only
• Chat History - View recent clan messages inside GUI
• GUI Chat Input - Send clan messages directly through the clan menu
• Integrated Clan Prefix Format - Clan chat works cleanly with the clan system

HOME SYSTEM

• Clan Home - Set your clan base location
• Full Position Saving - Saves world, coordinates, yaw and pitch
• Configurable Teleport Delay - Control teleport wait time
• Home Status In GUI - See whether a home is set or not

PVP CONTROL

• Friendly Fire Toggle - Enable or disable PvP between clan members
• Leader Control - Only clan leaders can manage clan PvP
• Configurable Default State - Choose the default PvP mode for new clans

CLAN BANK

• Deposit Money - Players can deposit money into the clan bank
• Withdraw Money - Leaders and co-leaders can withdraw
• Clan Economy Integration - Works alongside the built-in economy support
• Bank Value In GUI - View clan bank value in menu and placeholders

FULL ECONOMY SYSTEM

• /money - Check player balance
• /pay <player> <amount> - Send money to another player
• /eco - Admin economy commands (give, take, set)
• Starting Balance - Configurable for new players
• Auto Reward System - Earn money from:
→ Breaking blocks
→ Killing mobs
→ Fishing
→ Harvesting crops
• Configurable Reward Values - Customize every reward source
• Reward Multiplier - Global reward scaling
• Multi-Economy Support - Works with external economy systems
• Richest Players Support - Economy top integration ready

MODERN GUI

• Full Clan GUI - Visual menu for management, social, clan and admin actions
• Category Navigation - Clean sectioned interface
• One-Click Actions - Easy clan management
• Text Input Support - Integrated HyUI input support
• Clan Chat Panel - Clan messages directly inside GUI
• HUD Category - Dedicated HUD controls inside the clan menu
• Custom Logo Support - Add your own server logo into the clan GUI

CLAN HUD

• Clan Member HUD - Visual HUD for clan presence information
• Toggle HUD On/Off - Players can enable or disable it
• Left / Right Positioning - Choose screen side
• Status Command - Check current HUD settings
• Reload Safe - HUD refreshes correctly after plugin reloads

WIFLOW PLACEHOLDERAPI SUPPORT

Expansion JAR included! Use these placeholders anywhere:

• {clan_name} - Player clan name
• {clan_tag} - Clan tag / prefix
• {clan_members} - Total clan members
• {clan_members_online} - Online clan members
• {clan_points} - Clan points
• {clan_leader} - Clan leader name
• {clan_id} - Clan unique ID
• {clan_has} - true/false if player has a clan
• {clan_is_leader} - true/false if player is the leader
• {clan_bank} - Clan bank balance
• {clan_home} - Clan home status

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COMMANDS

Player Commands:

/clan - Open clan GUI
/clan create <name> - Create a new clan
/clan invite <player> - Invite a player
/clan accept - Accept clan invite
/clan leave - Leave your clan
/clan disband confirm - Disband your clan
/clan info [clan] - View clan info
/clan kick <player> - Kick a member
/clan promote <player> - Promote a member
/clan demote <player> - Demote a member
/clan sethome - Set clan home
/clan home - Teleport to clan home
/clan chat - Toggle clan chat
/clan pvp - Toggle clan PvP
/clan top - Show top clans
/clan deposit <amount> - Deposit to clan bank
/clan withdraw <amount> - Withdraw from clan bank
/clan claim - Open claim GUI / claim land
/clan view - Show current claim border
/clan hud [on|off|left|right|status] - Control clan HUD

Clan War Commands:

/clan war <clan> <amount> <size> - Challenge another clan
/clan war join - Join your clan war team
/clan war leave - Leave war queue
/clan war accept - Accept incoming war
/clan war deny - Deny incoming war
/clan war info - Show current war info
/clan war spectate [clan|player|leave]
/clan war spec [clan|player|test|leave]

Economy Commands:

/money - Check your balance
/pay <player> <amount> - Send money
/eco give <player> <amount>
/eco take <player> <amount>
/eco set <player> <amount>

Admin Commands:

/clan setleader <clan> <player>
/clan setpoints <clan> <points>
/clan delete <clan>
/clan forcejoin <clan> <player>
/clan reload
/clan setwar <apos|bpos|specpos|info>
/clan import simpleclaims <dry-run|run>
/clan importclaims pending [page]
/clan importclaims info <id>
/clan importclaims assign <player|uuid> <clan>
/clan importclaims assignone <id> <clan>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERMISSIONS

stealedh.clan.users - Access to all player clan commands
stealedh.clan.admins - Access to admin commands

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CONFIGURATION

• Fully Customizable Messages - language.yml with color support
• Clan Settings:
→ max-name-length / min-name-length
→ max-tag-length
→ default-max-members
→ default-max-claims
→ max-claims-per-extra-member
→ allow-pvp-toggle
→ default-pvp-enabled
→ disband-confirm-required
→ home teleport-delay

• Claim Settings:
→ claim limits
→ unclaim settings
→ map opacity
→ claim map radius
→ protection settings
→ claim notifications

• War Settings:
→ enable/disable wars
→ minimum / maximum team size
→ duration
→ countdown
→ arena spawns
→ spectator spawn

• Economy Settings:
→ starting balance
→ block / mob / fish / crop rewards
→ reward multiplier
→ enable / disable reward types

• YAML Data Storage - Easy to edit, backup and migrate

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WHAT'S INCLUDED

• BetterClans-1.2.jar (Main plugin)
• BetterClans-ClanExpansion-1.2.jar (WiFlow PlaceholderAPI expansion)
• Bundled dependencies (SnakeYAML, HyUI, SQLite support for imports)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

REQUIREMENTS

• Optional: WiFlowPlaceholderAPI (for placeholders)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SUPPORT

Need help? Join our Discord!

DISCORD: https://discord.gg/FbdFH86yVV

Fast support • Updates • Community

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Made with by Stealedh