PLUGIN OVERVIEW

Cronus is a powerful, production-ready Minecraft plugin that automatically loads custom texture packs when players enter specific areas from various city build plugins. It's designed to work seamlessly with any combination of major city build plugins, providing a dynamic and immersive texture pack experience for your server.

CORE FUNCTIONALITY

• AUTOMATIC TEXTURE PACK LOADING: When a player enters an area (town, plot, faction land, etc.), Cronus automatically loads the texture pack configured for that area
• UNIVERSAL PLUGIN COMPATIBILITY: Works with 22+ major city build plugins including Towny, WorldGuard, GriefPrevention, Lands, PlotSquared, Factions, and many more
• INTELLIGENT AREA DETECTION: Monitors player movement and detects area changes in real-time
• CONFIGURABLE LOAD DELAYS: Set custom delays for texture pack loading to ensure smooth transitions
• HASH VERIFICATION: Uses SHA-1 hashes for security and performance optimization

SUPPORTED CITY BUILD PLUGINS

MAJOR PLUGINS:
• Towny & TownyLands - Town and nation management
• WorldGuard - Region protection and management
• GriefPrevention - Land claim protection
• Lands - Land management and protection
• PlotSquared - Plot management system
• Factions - Faction-based gameplay
• RedProtect - Region protection

ADDITIONAL PLUGINS:
• Residence - Residence management
• CoreProtect - Block logging and rollback
• LocketteX - Chest and door protection
• LWC - LocketteX alternative
• Citadel - Reinforcement system
• JukeAlert - Snitch monitoring
• NameLayer - Group management
• ExilePearl - Player exile system
• PrisonPearl - Player imprisonment
• CombatTagPlus - Combat logging
• Essentials - Essential server commands
• Vault - Economy and permission bridge

COMMANDS

/cronus set [delay] [owner]
Sets a texture pack for a specific area
• area: Name of the area (e.g., "spawn", "town_center")
• hash: SHA-1 hash of the texture pack file
• url: Direct download URL for the texture pack
• delay: Load delay in milliseconds (default: 1000)
• owner: Owner of the area (default: command sender)

/cronus list
Lists all configured areas and their texture pack information

/cronus reload
Reloads the areas configuration from file

/cronus remove
Removes a texture pack configuration for an area

/cronus info
Shows detailed information about a specific area

/cronus stats
Displays comprehensive plugin statistics

/cronus validate
Validates all configured areas for errors

/cronus reloadall
Reloads texture packs for all online players

/cronus status
Shows plugin compatibility status

/cronus help
Displays the help message

PERMISSIONS

• cronus.admin - Full access to all Cronus commands (default: op)
• cronus.user - Basic user permissions (default: true)

FEATURES

ADVANCED CONSOLE LOGGING:
• Color-coded console output with prefixes
• Progress indicators for all operations
• Success/failure status messages
• Debug mode for detailed logging
• Load time tracking and performance metrics

ENHANCED TEXTURE PACK MANAGEMENT:
• Automatic texture pack loading with configurable delays
• Hash verification for security
• Player notification system
• Texture pack status tracking
• Force reload capabilities
• Area-based player counting

IMPROVED AREA MANAGEMENT:
• Input validation and error handling
• Area statistics and metrics
• Automatic area validation
• Better file handling and error recovery
• Owner tracking and management

PERFORMANCE & MONITORING:
• Load time tracking
• Plugin compatibility summary
• Area validation system
• Player distribution tracking
• Debug logging system

TECHNICAL SPECIFICATIONS

• Minecraft Version: 1.21.8+
• Java Version: 21+
• Server Software: Paper (recommended) or Spigot
• API Version: 1.21
• Dependencies: None (soft dependencies on city build plugins)

HOW IT WORKS

1. PLUGIN DETECTION: On startup, Cronus automatically detects which city build plugins are installed and enabled
2. AREA MONITORING: The plugin monitors player movement and detects when they enter/exit areas from city build plugins
3. TEXTURE PACK LOADING: When a player enters an area, Cronus automatically loads the texture pack configured for that area
4. AUTOMATIC MANAGEMENT: Texture packs are applied with configurable delays and can be easily managed through commands

SETUP INSTRUCTIONS

1. PREPARE YOUR TEXTURE PACK:
   • Create a .zip file containing your texture pack
   • Upload it to a web server with direct download access
   • Get the SHA-1 hash of the file

2. INSTALL THE PLUGIN:
   • Download the Cronus.jar file
   • Place it in your server's plugins folder
   • Restart your server

3. CONFIGURE AREAS:
   • Use /cronus set to configure each area
   • The plugin will automatically detect when players enter these areas

4. TEST:
   • Walk into the configured area
   • The texture pack should automatically load

GETTING TEXTURE PACK HASHES

WINDOWS:
certutil -hashfile texturepack.zip SHA1

MACOS/LINUX:
shasum -a 1 texturepack.zip

ONLINE TOOLS:
• Use online SHA-1 calculators (upload your file)

CONFIGURATION FILES

config.yml - Main plugin configuration including:
• General settings
• Texture pack options
• Area detection settings
• Plugin compatibility settings
• Customizable messages

areas.yml - Stores area texture pack configurations (automatically managed)

CONSOLE OUTPUT EXAMPLE

When you start the server, you'll see:

§6=== Cronus Plugin Starting ===
§7Version: 1.0.0
§7Minecraft Version: 1.21.8
§7Initializing managers...
§7Registering commands...
§7Registering listeners...
§7Hooking into city build plugins...
§7Detecting city build plugins...
§a✓ Hooked into Towny v0.100.1.0
§a✓ Hooked into WorldGuard v7.0.9
§7Loading area configurations...
§a✓ Cronus plugin has been enabled successfully!
§7Load time: 245ms
§7Loaded areas: 3
§6=== Plugin Compatibility Summary ===
§7Total plugins checked: 22
§aCompatible plugins: 8
§cIncompatible plugins: 14
§aSuccessfully hooked into 8 city build plugin(s)!

TROUBLESHOOTING

TEXTURE PACK NOT LOADING:
• Check that the URL is accessible
• Verify the hash is correct
• Ensure the area name matches exactly
• Check server console for error messages

PLUGIN NOT WORKING:
• Verify you're using Paper 1.21.8+
• Check that your city build plugin is enabled
• Ensure you have the correct permissions
• Check server console for startup messages

PERFORMANCE ISSUES:
• Increase the check_interval in config.yml
• Reduce the number of areas being monitored
• Use appropriate load delays

ADVANTAGES

• UNIVERSAL COMPATIBILITY: Works with virtually any city build plugin
• PROFESSIONAL QUALITY: Comprehensive error handling and logging
• USER FRIENDLY: Clear feedback and progress indicators
• EXTENSIBLE: Easy to add new plugin compatibility
• PERFORMANCE: Efficient area detection and texture pack management
• PRODUCTION READY: Built with enterprise-level quality standards

USE CASES

• CITY BUILD SERVERS: Automatically load themed texture packs for different districts
• ROLEPLAY SERVERS: Change textures based on player location and faction
• ADVENTURE MAPS: Load different texture packs for different zones
• MINIGAME SERVERS: Switch textures between game modes
• ANY SERVER: Create immersive, location-based texture pack experiences

LICENSE

This project is licensed under the MIT License.

SUPPORT

For support, please:

1. Check the README and configuration files
2. Review server console logs for error messages
3. Ensure all requirements are met
4. Test with a minimal setup

CONTRIBUTING

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

VERSION HISTORY

1.0.0 - Initial release with basic functionality:
• Area detection for major city build plugins
• Automatic texture pack loading
• Configurable delays and settings
• Easy management commands
• Extended plugin compatibility (22+ plugins)
• Professional logging system
• Enhanced user experience
• Production-ready quality

CONCLUSION

Cronus is the ultimate solution for Minecraft servers that want to provide dynamic, location-based texture pack experiences. With its universal compatibility, professional quality, and comprehensive feature set, it transforms your server into an immersive world where every area can have its own unique visual identity.

Whether you're running a city build server, roleplay server, or any other type of Minecraft server, Cronus provides the tools you need to create engaging, location-based texture pack experiences that enhance player immersion and server atmosphere.