ChallengePlugin

A comprehensive Minecraft challenge plugin that adds multiple gameplay challenges with a sophisticated timer system and intuitive GUI management.

Overview

ChallengePlugin transforms your Minecraft experience by introducing various gameplay restrictions and modifications. Whether you want to prevent jumping, randomize block drops, or turn the floor into lava, this plugin provides a complete challenge framework with persistent data storage and easy-to-use interfaces.

Key Features

Challenge System

• No Jump: Prevents players from jumping
• Random Drops: Every broken block drops random items instead of normal drops
• No Natural Regeneration: Disables hunger-based health regeneration
• No Regeneration: Completely disables all forms of health regeneration
• Die When Challenge Failed: Instantly kills players when they fail any active challenge
• Floor Is Lava: Transforms blocks under players into magma and lava over time

Advanced Timer System

• Flexible Timer: Count up or countdown with customizable colors
• Action Bar Display: Real-time timer visibility for all players
• Challenge Integration: Challenges only activate when timer is running
• Persistent Storage: Timer state saves across server restarts

User Interface

• Intuitive GUI Menus: Easy challenge management through inventory interfaces
• Settings Customization: Detailed configuration options for each challenge
• Real-time Updates: Immediate visual feedback for all changes
• Admin Controls: Permission-based access to all features

Data Management

• YAML Persistence: All settings and progress automatically saved
• World Reset System: Complete world regeneration with data preservation options
• Backup-friendly: Settings can be preserved during resets

Installation

1. Download the latest release
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Grant challenge.admin permission to administrators

Commands

Main Commands

• /menu - Opens the main challenge selection interface
• /menu reset confirm - Resets all challenges and settings
• /timer start|stop|pause|resume - Control timer functions
• /timer set <hours> <minutes> <seconds> - Set specific timer value
• /timer settings - Open timer customization menu
• /resetworld confirm - Complete world reset with server restart

Utility Commands

• /timer save - Manually save current state
• /timer drops check - Check what item a block will drop (hold block in hand)

Permissions

• challenge.admin - Access to all plugin commands and menus (default: op)

Technical Details

Performance Optimizations

• Efficient block transformation system using concurrent maps
• Optimized event handling with challenge state checks
• Memory-safe cleanup of active transformations

Compatibility

• Tested Version: Minecraft 1.21.4
• API: Spigot/Paper 1.21.4
• Java: Requires Java 21 or higher

Floor Is Lava Mechanics

The Floor Is Lava challenge features a sophisticated three-stage transformation system:

1. Stage 1: Block transforms to Magma Block after configurable delay
2. Stage 2: Magma Block becomes Lava after additional delay
3. Stage 3: Block resets to original state after final delay

Each stage deals different damage amounts and provides visual feedback to players.

Configuration

The plugin automatically creates a data.yml file to store:

• Active challenge states
• Timer configurations and current time
• Floor Is Lava timing settings
• Random drop seed for consistency

Settings persist across server restarts and can be selectively preserved during world resets.

Development Status

Early Beta - This plugin is currently in early beta development. While core functionality is stable and tested, some features may be subject to change. Please report any issues or suggestions.

Known Limitations

• Challenge combinations may have unexpected interactions
• Some edge cases in block transformation timing
• Limited testing in large multiplayer environments

Planned Features

• Additional challenge types
• Team-based challenge modes
• Achievement system
• Enhanced GUI animations
• Multiplayer-specific optimizations

Support

For bug reports, feature requests, or general support, please join the Discord. Include your server version, plugin version, and detailed reproduction steps for any issues.