ClaimBlocks (ProtectionStones mod)

🛡️ ClaimBlocks Premium: Professional Protection System

ClaimBlocks is a high-performance, aesthetically refined protection system for Minecraft (Fabric 1.21.1). Designed for professional servers that value both security and visual excellence, this mod replaces traditional “protection stones” with a modular, highly customizable system.

💎 Core Concept: The Security Module

At its heart, ClaimBlocks utilizes a Module-based architecture. Protection is not just a region; it is tied to a physical “Security Module” (which can be a standard block or a custom 3D head texture).

• Deployment: Placing a module instantly establishes a customizable security perimeter (e.g., 20×20 blocks).
• Automation: The mod automatically calculates boundaries, prevents overlaps with other players’ zones, and handles all coordinate math in the background.

🛠️ User Experience & Interaction

1. Unified Management Interface (/cb menu)

The mod features a premium, state-of-the-art GUI built with GooeyLibs. Users don’t need to memorize complex commands; everything is accessible via an interactive menu:

• Flag Configuration: Toggle server-side rules (PVP, Mob Spawning, TNT, etc.) with a single click.
• Member Management: Add or remove trusted players through a head-based interface.
• Entry Notifications: Configure custom Titles and Subtitles that greet players when they cross into your territory.
• Visual Feedback: Use /cb view to see the exact edges of your claim rendered with particle effects.

2. The “Hide” Module Feature

Unique to ClaimBlocks is the ability to Hide the Module. If a player wants their base to look completely natural, they can use the “Ender Eye” tool in the menu to remove the physical module from the world while keeping the entire protection active.

👮 Administrative Power

ClaimBlocks provides a suite of tools for server administrators:

• God Mode Management: Admins with the cb.admin permission can bypass any protection and open any player’s menu to resolve disputes or griefing.
• Teleportation: Instantly jump to any active claim via the management list.
• Manual Overrides: Technical info (/cb info) and manual pemberian modules (/cb give).

⚙️ Advanced Customization for Owners

The mod is designed for 100% white-labeling and customization:

• Full Cosmetic Control: In settings.json, owners can define infinite tiers of modules, each with unique radii and textures (using Base64 values from Minecraft-Heads).
• Internationalization: texts.json allows for 100% translation of all messages, GUI titles, and lore. Supports JSON-style color codes (&5, &l, etc.).
• Dynamic Data Indexing: The mod maintains a split-database system. Core claim data is stored in the config folder (claims.json), while player-specific location indices are saved directly within each world folder (player_data.json) for maximum performance.

(Important: Review the readme.md file in the config/claimblocks folder)

🔒 Security & Performance

• Zero-Tick Conflict Resolution: The mod’s internal manager performs spatial overlap checks instantly, ensuring two players can never claim the same block.
• Lighweight Logic: Designed with ConcurrentHashMaps and asynchronous saving/loading to ensure that even with thousands of claims, server TPS remains stable.
• Permission-Driven: Granular control via cb.user and cb.admin permission nodes.

This mod represents a fusion of robust security logic and modern UI design, aimed at providing the most professional protection experience for Fabric servers.

formerly known as protectionstones mod