Chunklock 2.0 - Premium Strategic Survival Plugin
Transform your Minecraft server into a strategic progression-based survival experience! Players start with a single chunk and must strategically expand their territory through resource investment and teamwork.
What Makes Chunklock Special?
- Strategic Gameplay - Players must plan their expansion carefully, as only adjacent chunks can be unlocked
- Dual Economy System - Choose between materials-based or Vault currency economy
- Team Collaboration - Teams share territory and get cost reductions
- Biome-Based Difficulty - Different biomes have unique unlock costs and challenges
- Dynamic Scaling - Costs increase based on distance, biome type, and player progress
- Visual Feedback - Hologram displays, particle borders, and interactive GUIs
Key Features
Core Mechanics
- Start with one 16x16 chunk - your safe zone and base
- Adjacent-only unlocking - strategic expansion required
- Cost scaling system - prices increase with distance and progress
- Team benefits - 15% cost reduction for team members
Economy Systems
- Materials Economy - Pay with blocks, ores, and items
- Vault Integration - Full support for money-based servers
- Biome Multipliers - Rare biomes cost more to unlock
- Progressive Pricing - Costs scale with player advancement
Visual & UI
- Real-time cost displays via holograms
- Chunk borders with particle effects
- Interactive GUIs for easy chunk management
- Multiple hologram providers (FancyHolograms, internal fallback)
Team System
- Collaborative territory - share unlocked chunks
- Cost sharing - pool resources for expensive unlocks
- Team management - roles, invitations, and permissions
- Shared progression - work together towards common goals
Commands
Player Commands
- /chunklock start - Begin your progression journey
- /chunklock status - View your progress and stats
- /chunklock unlock - Unlock the chunk you're in
- /chunklock spawn - Return to your starting chunk
- /chunklock team - Full team management system
Admin Commands
- /chunklock setup <world> <size> - Create a dedicated Chunklock world
- /chunklock reset <player> - Reset player progress
- /chunklock bypass - Toggle movement restrictions
- /chunklock debug - Performance diagnostics
- /chunklock reload - Hot-reload configuration
⚙️ Server Requirements
Minimum Requirements
- Minecraft: 1.20.4+ (tested up to 1.21.4)
- Server: Paper/Spigot/Pufferfish
- Java: 17+
- Players: 1-200+ (performance optimized)
Optional Dependencies
- Vault - For currency-based economy
- FancyHolograms - Enhanced hologram displays
Easy Setup
- Download and place Chunklock.jar in your plugins folder
- Start server - config files auto-generate
- Configure economy type in config.yml (materials or vault)
- Create world: /chunklock setup myworld 30000
- Players start: /chunklock start to begin progression
Gameplay Example
Code (Text):
Player starts with 1 chunk (16x16 blocks)
Wants to unlock adjacent Forest chunk
Cost: 16 Oak Logs + 4 Apples (materials economy)
✅ Pays cost → chunk unlocked → can access new territory
Repeat to expand empire strategically
What's New in 2.0?
- ️ Service Architecture - Professional-grade dependency injection system
- ⚡ Performance Optimizations - Async processing and advanced caching
- Complete Documentation - Comprehensive guides and API docs
- Enhanced Configuration - Unified config system with migration
- Production Ready - Enterprise-level stability and features
Performance & Scalability
- 100+ concurrent players supported
- Minimal TPS impact (<0.3 TPS loss on large servers)
- Async chunk operations - non-blocking gameplay
- Smart caching - optimized memory usage
- Rate limiting - prevents lag spikes
️ Configuration Highlights
Code (Text):
# Choose your economy type
economy:
type: "materials" # or "vault"
# Customize biome difficulties
chunk-values:
biomes:
PLAINS: 5 # Easy starting area
JUNGLE: 20 # Expensive rare biome
NETHER: 50 # Very expensive
# Team settings
team-settings:
max-team-size: 6
team-cost-multiplier: 0.15 # 15% cost reduction
Documentation & Support
- Complete Wiki - Installation, commands, configuration guides
- API Documentation - For developers building integrations
- Troubleshooting Guide - Common issues and solutions
- ⚡ Performance Tuning - Optimization guides for different server sizes
Why Choose Chunklock?
For Server Owners
- Unique gameplay that keeps players engaged longer
- Highly configurable - adapt to your server's style
- Performance optimized - won't slow down your server
- Professional support - comprehensive documentation and help
For Players
- Strategic thinking required - not just mindless grinding
- Team cooperation encouraged through shared benefits
- Clear progression - visual feedback and goal setting
- Balanced difficulty - challenging but fair advancement
Perfect For
- Survival servers wanting unique progression mechanics
- Team-based communities with collaborative gameplay
- Strategic gameplay enthusiasts
- Long-term engagement - content that lasts months
- Streamers/Content Creators - visually appealing mechanics
Support
- GitHub: Issues & Documentation
- Discord: Join our community server
- Direct: Contact LunaryCraft Dev Team
Transform your server with strategic chunk-based progression. Your players will never look at Minecraft survival the same way again!
Get Chunklock 2.0 today and revolutionize your server's gameplay!
Bug Fixes
Installation: Simply replace your old ChunkLock.jar and restart. No config changes needed!
- Fixed hologram timing issues - No more missing holograms when joining per-player worlds
- Fixed border update crashes - Resolved memory leaks and world validation errors
- Fixed team data persistence - Team information now saves properly across server restarts
- Fixed world creation conflicts - Eliminated race conditions during world generation
- Per-player private worlds - Each player gets their own isolated world for Chunklock
- Better performance - Optimized hologram updates and border processing with queue system
- Enhanced stability - More reliable world management and automatic cleanup
- Smart world organization - Symbolic links keep server folder clean while maintaining compatibility
- Improved team system - Better team management with join requests and officer permissions
- Complete world manager overhaul - New architecture for per-player world support
- Enhanced hologram service - Modular design with better debouncing and distance culling
- Improved border system - Queue-based processing prevents lag on large servers
- Better error handling - Comprehensive logging and graceful failure recovery
Installation: Simply replace your old ChunkLock.jar and restart. No config changes needed!
Bug Fixes
Installation: Simply replace your old ChunkLock.jar and restart. No config changes needed!
- Fixed hologram text overlap - No more duplicate text appearing when item counts change
- Fixed server compatibility issues - Now works properly on Pufferfish, Purpur, and other Paper forks
- Fixed crash on older servers - Resolved startup errors on different server types
- Better performance - Faster plugin startup and smoother hologram updates
- Enhanced stability - More reliable chunk borders and GUI interactions
- Cross-server support - Automatically detects and adapts to your server type
- Complete code restructure for easier maintenance and future updates
- Better error handling and logging for troubleshooting
Installation: Simply replace your old ChunkLock.jar and restart. No config changes needed!
✨ New Features
Compatibility: Requires Java 17+ and Paper/Spigot 1.21.4+
- Multi-World Support
- ChunkLock now works seamlessly across multiple worlds (configured in config.yml)
- Configure which worlds have chunk progression in the config
- Automatic starting chunk assignment when entering new worlds
- Smart teleportation between different world types
- Enhanced World Navigation
- Holograms and borders automatically adjust when switching worlds
- Portal travel now properly handles chunk unlocking in destination worlds
- Better experience when moving between Overworld, Nether, and End
- Automatic Upgrade System
- Seamlessly upgrades from older ChunkLock versions
- All your existing progress and teams are preserved
- No manual configuration changes needed
- Faster plugin startup and better performance
- More reliable chunk borders that only appear where they should
- Improved team functionality across multiple worlds
- Better error handling for a smoother gameplay experience
- New world management settings in config.yml
- Easily enable/disable ChunkLock in specific worlds
- All existing settings automatically preserved during upgrade
Compatibility: Requires Java 17+ and Paper/Spigot 1.21.4+
✨ New Features
Compatibility: Requires Java 17+ and Paper/Spigot 1.21.4+
- Multi-World Support
- ChunkLock now works seamlessly across multiple worlds (configured in config.yml)
- Configure which worlds have chunk progression in the config
- Automatic starting chunk assignment when entering new worlds
- Smart teleportation between different world types
- Enhanced World Navigation
- Holograms and borders automatically adjust when switching worlds
- Portal travel now properly handles chunk unlocking in destination worlds
- Better experience when moving between Overworld, Nether, and End
- Automatic Upgrade System
- Seamlessly upgrades from older ChunkLock versions
- All your existing progress and teams are preserved
- No manual configuration changes needed
- Faster plugin startup and better performance
- More reliable chunk borders that only appear where they should
- Improved team functionality across multiple worlds
- Better error handling for a smoother gameplay experience
- New world management settings in config.yml
- Easily enable/disable ChunkLock in specific worlds
- All existing settings automatically preserved during upgrade
Compatibility: Requires Java 17+ and Paper/Spigot 1.21.4+
✨ New Features
- Contested Chunk Claiming
- Unlocking a chunk owned by another team multiplies the item cost and checks a daily limit.
- Cost multiplier and daily cap are configurable:
- Unlock GUI adjusts requirements if the chunk is contested and notifies the player
- Team‑Based Chunk Ownership
- Each unlocked chunk now records the owning team (or player) for later checks.
- Daily Contested Claim Tracking
- PlayerProgressTracker keeps a per‑team counter that resets every 24 hours.
- Team‑Colored Glass Borders
- Borders around locked chunks display in lime for your own team and red for enemy teams:
- Border Protection
- Players can no longer break or place border glass. The listener identifies border blocks using new helper methods.
- Unlock GUI now refuses contested claims if a team has hit the daily cap.
- Starting chunks and force-unlocked chunks are recorded with the player's team leader as owner.
- Border interaction warns when your team has no remaining contested claims for the day.
- Various constructors updated to pass TeamManager and PlayerProgressTracker for ownership and claim‑tracking.
- Plugin version updated to 1.2.4 in plugin.yml:
- Two new configuration options under team-settings manage contested-claim behavior.
- Data file data.yml now stores chunk ownership details for each chunk.
Chunklock v1.2.3 - Team System Update
✨ New Features
✨ New Features
- Enhanced Team System - Create and manage teams with up to 6 members
- Team Roles - Owner, Officer, and Member roles with different permissions
- Join Requests - Players can request to join teams, officers can approve/deny
- Team Chat - Private team communication with /chunklock team chat <message>
- Team Cost Scaling - Chunk unlock costs increase slightly with team size for balance
- /chunklock team create <name> - Create a new team
- /chunklock team join <name> - Request to join a team
- /chunklock team info - View team details and members
- /chunklock team list - Browse all teams
- /chunklock team accept/deny <player> - Manage join requests
- /chunklock team leave - Leave your current team
- /chunklock team help - See all team commands
- Enhanced status command shows team information
- Improved debug output includes team statistics
- Better error handling and logging
- Teams share unlocked chunks automatically
- New configuration file: team_config.yml
- Team data stored in teams_enhanced.yml
- Backward compatible with existing progress
- Requires Java 17+ and Paper/Spigot 1.21.4+
What's Fixed
✅ Holograms Now Disappear When You Unlock Chunks
Enhanced Spawn Command
✅ Holograms Now Disappear When You Unlock Chunks
- Fixed annoying bug where floating text would stay visible after unlocking
- Holograms now instantly update to show current chunk status
- Much cleaner visual experience!
- Removed the confusing double particle lines where chunks meet
- Chunk borders now look clean and professional
- Easier to see exactly where each chunk begins and ends
- You'll no longer be forced back to your starting chunk every time you log in
- If you log out in an unlocked area, you'll spawn right where you left off
- Only new players or those in locked chunks get moved to their starting area
Enhanced Spawn Command
- /chunklock spawn - Go back to your starting chunk
- /chunklock spawn center - Go to the exact center of your starting chunk
- Clear messages tell you exactly where you're being teleported
- Visual effects are more optimized and run smoother
- Better memory usage means less lag
- Holograms update faster and more reliably
- Better error logging helps track down any remaining issues
- /chunklock reload works more reliably
- Improved debug tools for troubleshooting
✨ Major New Features
- Dynamic Holograms: Floating text displays above unlockable chunks showing requirements and biome info
- Epic Unlock Effects: Spectacular particle effects, sounds, and animations when unlocking chunks
- Firework bursts and golden sparkles
- Expanding spiral effects
- Achievement sounds for milestones
- Cinematic title screens with unlock progress
- Smart Chunk Borders: Intelligent particle borders that only show around relevant chunks
- Color-coded by difficulty (Green=Easy, Yellow=Normal, Red=Hard, Purple=Impossible)
- Animated borders for unlockable chunks
- Optimized performance with distance-based rendering
- Advanced Chunk Evaluation: More sophisticated scoring system with improved biome and distance calculations
- ️ Bulletproof Error Handling: Extensive exception handling prevents crashes and provides detailed logging
- ⚡ Performance Optimizations:
- Cached chunk evaluations reduce server load
- Optimized particle rendering with smart distance checks
- Reduced visual effect frequency for better performance
- Improved GUI: More intuitive unlock interface with better visual feedback
- Perfect Spawn Positioning: Players now spawn at exact chunk centers for consistent experience
- Hot Reload System: Admins can reload the plugin without server restart
- Broadcast System: Nearby players see notifications when someone unlocks a chunk
- New /chunklock reload - Hot reload plugin configuration and systems
- Enhanced /chunklock reset - Complete player progress and chunk reset with detailed feedback
- New /chunklock debug - Advanced debugging tools for server administrators
- Improved /chunklock status - More detailed progress information
- Fixed spawn location safety checks to prevent players spawning in dangerous locations
- Resolved chunk loading edge cases that could cause evaluation errors
- Improved biome detection accuracy across different world types
- Fixed team system synchronization issues
- Enhanced data persistence reliability
Critical Performance Fixes
TickTask.java - Major Overhaul
ChunkEvaluator.java - Robust Error Recovery
Enhanced Security Measures
ChunklockPlugin.java - Enhanced Lifecycle Management
New Debug Capabilities
Code Quality Enhancements
Multi-Player Performance
TickTask.java - Major Overhaul
- Fixed Memory Leaks: Added proper cleanup of player data when players disconnect
- Thread Safety: Replaced HashMap with ConcurrentHashMap for all shared collections
- Performance Optimization:
- Reduced particle update frequency from 0.5s to 1s
- Reduced particle density from 4 to 3 particles per side
- Implemented view frustum culling (120° FOV) - particles only show in player's view
- Reduced view distance from 48 to 40 blocks
- Improved Caching:
- Removed player-specific cache keys to eliminate duplication
- Extended cache duration from 30s to 45s
- Better cache cleanup with size limits (150 entries)
- Performance Metrics: Added comprehensive monitoring with particle count, cache hits, and evaluation tracking
- Memory Leak Prevention: Added onPlayerQuit event handler to clean up player data
- Rate Limiting: Added 1-second cooldown for unlock attempts to prevent spam
- Thread Safety: Used ConcurrentHashMap for lastWarned and lastUnlockAttempt maps
- Optimization: Only check chunk changes when player moves to different block coordinates
- Enhanced Cleanup: Properly notifies TickTask and HologramManager when players leave
ChunkEvaluator.java - Robust Error Recovery
- Specific Exception Handling: Replaced generic Exception catches with specific types:
- IllegalArgumentException for invalid coordinates/parameters
- IllegalStateException for world state issues
- Generic Exception only for truly unexpected errors
- Input Validation: Added validateChunkEvaluation() method with coordinate bounds checking
- Optimized Caching: New evaluateChunkForCache() method without player-specific distance calculations
- Better Fallbacks: Improved biome and block scanning fallback mechanisms
- Reduced Block Scanning: Optimized surface scan to sample every 4 blocks instead of dense sampling
- Startup Validation: Added comprehensive configuration validation before loading
- Threshold Validation: Ensures thresholds are positive and in ascending order (easy < normal < hard)
- Default Fallbacks: Automatically loads defaults when configuration is invalid
- Better Error Messages: Specific error reporting for different failure types
- Reload Support: Added reloadConfiguration() method for runtime config updates
- Statistics: Added getConfigStats() for debugging configuration issues
Enhanced Security Measures
- Coordinate Validation: Chunk coordinates limited to reasonable range (±30,000)
- Rate Limiting:
- Unlock attempts: 1 second cooldown per player
- Warning messages: 2 second cooldown per player
- Input Sanitization: All configuration keys trimmed and validated
- Null Safety: Comprehensive null checks throughout codebase
ChunklockPlugin.java - Enhanced Lifecycle Management
- Configuration Validation: Added startup validation for:
- Plugin data folder creation
- Server version compatibility (warns if not 1.21+)
- Available memory (warns if <1GB)
- Better Component Initialization: Improved dependency order and error handling
- Enhanced Reload: 6-step reload process with validation and rollback
- Memory Monitoring: Runtime memory usage tracking
- Comprehensive Statistics: Added getPluginStats() method for debugging
- Proper Cleanup: Enhanced shutdown process with data saving verification
New Debug Capabilities
- Performance Metrics: Real-time tracking of:
- Particles spawned per interval
- Chunk evaluations performed
- Cache hit ratios
- Memory usage
- Player Statistics: Tracking of:
- Players with active cooldowns
- Border chunk calculations
- Unlock attempt rates
- Cache Statistics: Monitoring of:
- Cache size and efficiency
- Entry age and cleanup frequency
- Player-specific data cleanup
- Structured Logging: Different log levels for different severity
- Performance Logging: Automatic logging of performance metrics every 30 seconds
- Error Context: Better error messages with specific context
- Debug Support: Fine-grained logging for troubleshooting
Code Quality Enhancements
- Thread Safety: All shared data structures now use concurrent collections
- Resource Management: Proper cleanup of scheduled tasks and entity references
- API Design: Added builder patterns and immutable data structures
- Documentation: Comprehensive JavaDoc comments and inline documentation
- Type Safety: Better use of generics and null annotations
- Reduced Object Creation: Reuse of expensive objects where possible
- Efficient Algorithms: Optimized chunk scanning and evaluation algorithms
- Memory Pool: Better management of temporary objects
- Lazy Loading: Deferred initialization of expensive components
Multi-Player Performance
- Concurrent Processing: Better handling of multiple players
- Load Distribution: Spread expensive operations across multiple ticks
- Memory Efficiency: Reduced per-player memory footprint
- Network Optimization: Reduced packet spam from particles and holograms
- CPU Optimization: Reduced background task frequency
- Memory Management: Aggressive cleanup of unused data
- I/O Efficiency: Batched file operations for better disk performance
- Thread Management: Proper thread pool usage for async operations
- Minecraft: 1.21.4+ (Paper)
- Java: 17+
- Backward Compatibility: All existing configuration files and player data remain compatible
- No database migration required
- Existing configuration files will be validated on startup
- Invalid configurations will automatically fall back to defaults
- Enhanced logging will help identify any migration issues
- Memory Usage: Reduced by ~30% through leak fixes and better cleanup
- CPU Usage: Reduced by ~25% through optimized algorithms and reduced frequencies
- Network Traffic: Reduced particle spam through view culling and rate limiting
- Disk I/O: Improved through batched operations and better caching
Chunklock v1.1.0 - Release Notes
Major Features
Precision Player Spawning
Major Features
Precision Player Spawning
- Players now spawn at exact chunk centers (X = chunkX * 16 + 8, Z = chunkZ * 16 + 8)
- Smart Y-coordinate placement on highest solid block
- Applied to all spawning: initial, reset, and /chunklock spawn
- Starting chunks limited to score ≤ 25 for fair progression
- Improved search algorithm finds better suitable chunks
- Prioritizes lowest-score chunks for optimal difficulty
- MAJOR FIX: /chunklock reset now properly re-locks ALL previously unlocked chunks
- Players can no longer access old unlocked areas after reset
- True progress reset with intelligent new chunk assignment
- Modern API: Fixed deprecated biome.name() warnings, added Java 22 support
- Error Handling: Comprehensive exception handling prevents crashes
- Performance: Optimized chunk evaluation and spawning logic
- Data Integrity: Enhanced save/load with immediate persistence
- /chunklock debug - Shows total unlocked chunks
- /chunklock debug list - Lists all unlocked chunk coordinates
- /chunklock resetall confirm - Emergency lock-all command
- Enhanced /chunklock status - Now shows current chunk info (score, difficulty, lock status)
- Critical: Reset command now actually re-locks chunks (was major bug)
- Fixed biome display deprecation warnings
- Resolved progress counter vs world state desync
- Enhanced chunk access validation
- Better Feedback: Detailed spawn messages with coordinates and scores
- Admin Tools: Debug commands for monitoring and troubleshooting
- Transparency: Players see chunk difficulty and scoring information
- Improved Logging: Better error reporting and system monitoring
- Minecraft: Paper 1.21.4+
- Java: 21 or 22 required
- Backup: Always backup your data before updating
Resource Information
Author:
----------
Total Downloads:
1,180
First Release:
Jun 11, 2025
Last Update:
Yesterday at 11:17 AM
Category:
---------------
All-Time Rating:
3 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings