OneblockWaves - Advanced OneBlock Minecraft Plugin

OneblockWaves is a comprehensive Minecraft plugin that transforms your server into an engaging OneBlock survival experience. Players mine a single magical block that continuously changes, spawning mobs, items, and treasures while providing a deep progression system with customizable upgrades, gem socketed equipment, and strategic combat mechanics.

🌟 Key Features

🏗️ Core OneBlock System

• Dynamic Block Respawning: Each player has a single block that randomly changes into different materials (stone, ores, wood, etc.)
• Level-Based Progression: Players level up by mining blocks, unlocking higher-tier materials and stronger enemies
• Automatic Block Maintenance: Blocks respawn automatically if destroyed or missing, ensuring continuous gameplay

⚔️ Advanced Combat & Mobs

• Scaling Mob System: Enemies spawn with health and damage that scales with player level
• Rarity-Based Mobs: Common, Uncommon, Rare, Epic, and Legendary mobs with different stats and drop rates
• MythicMobs Integration: Optional support for custom MythicMobs with full compatibility
• Smart Mob Targeting: Monsters automatically target players and have custom health bars
• Daytime Protection: Mobs get leather helmets during the day to prevent burning

🎒 Item & Equipment System

• Custom Weapons & Armor: Over 50+ unique items with scaling stats (damage, armor, health, crit chance/damage)
• Gem Socket System: Socket gems into weapons and armor for bonus stats (damage, crit, health, defense, etc.)
• Upgrade Stones: Upgrade equipment at anvils with success/failure mechanics
• Item Database: Persistent item storage with full metadata preservation

💎 Gem System

• Weapon Gems: Damage, Crit Chance, Crit Damage, Attack Speed
• Armor Gems: Health, Defense, Block Rate, Move Speed
• Gem Combining: Combine gems at workbenches with tier progression (I → IV)
• Socket Management: Up to 8 sockets per item with visual socket indicators

🛡️ Player Progression

• Class Points System: Earn points per level for permanent stat upgrades:
  • Health Regeneration: Passive healing with configurable rates
  • Block Rate: Chance to block monster attacks
  • Move Speed: Permanent movement speed bonuses
  • Attack Speed: Faster weapon swing rates
  • Poison System: Chance to poison enemies on hit with damage over time

⚙️ Upgrade Systems

• Forge Upgrades: Increase item upgrade success rates
• Alchemist Upgrades: Boost gem combination success rates
• Adventurer Upgrades: Higher chest spawn chances
• Money Upgrades: Earn more money per block mined
• Drop Rate Upgrades: Increase item drop frequencies
• EXP Rate Upgrades: Gain more experience per block

🤖 Auto-Tool Feature

• Smart Tool Switching: Automatically switches to the best tool for mining blocks
• Combat Detection: Switches to weapons when targeting enemies
• Universal Support: Works with all tool tiers (wood, stone, iron, diamond, netherite)
• Block-Specific Tools:
  • Pickaxe for stone/ores
  • Axe for wood/chests/melons/pumpkins
  • Shovel for dirt/gravel/clay
  • Hoe for leaves/hay blocks

📦 Chest & Loot System

• Level-Locked Chests: Chests spawn based on player level with appropriate loot
• Randomized Contents: 1-3 items per chest with configurable drop tables
• Persistent Storage: Chest contents save and drop when broken

💰 Economy Integration

• Vault Support: Full integration with Vault economy plugins
• Money Rewards: Earn money for mining blocks (scales with upgrades)
• Upgrade Costs: Purchase upgrades with in-game currency

📊 User Interface

• Interactive GUIs: User-friendly menus for upgrades, gem socketing, and stats
• Real-Time Boss Bars: Health bars for mobs and EXP progress for players
• Damage Indicators: Visual damage numbers with color coding (yellow for normal, purple for crit, green for poison)
• Action Bar Messages: Contextual feedback for actions and events

🛠️ Commands

Player Commands

• /oneblock - Main command menu
• /oneblock help - Show help menu
• /oneblock spawn - Spawn your OneBlock
• /oneblock tp - Teleport to your OneBlock
• /oneblock move - Move your OneBlock location
• /oneblock auto - Toggle auto-tool feature
• /oneblock top - Show leaderboard

Admin Commands

• /oneblock reload - Reload all configurations
• /oneblock give <player> <item> [rarity] - Give items to players
• /oneblock stats give|remove <player> <amount> - Manage player class points

⚙️ Configuration Files

config.yml

# Core Settings
base_xp: 100.0                    # Base XP per level
level_xp_multiplier: 1.5          # XP scaling per level
oneblock_check_interval: 100      # Block maintenance interval (ticks)

# Mob Settings
mob_spawn_chance: 0.1             # Chance for normal mob spawns
wave_base_chance: 0.05            # Base chance for mob waves
wave_base_count: 1                # Base mob count per wave

# Upgrade Costs
upgrade_costs:
  1: 50.0                         # Cost for +1 upgrade
  2: 100.0                        # Cost for +2 upgrade
  3: 150.0                        # Cost for +3 upgrade

# Class Points Settings
class_points_per_level: 1         # Points earned per level
max_health_regen_level: 10        # Max health regen upgrades
health_regen_increase_per_level: 0.1  # Hearts per tick per level

# Auto-Tool Settings
auto_tool_cost: 5000.0            # Cost to unlock auto-tool

drop.yml

rarities:
  Common:
    multiplier: 1.0
    color: WHITE
    drop_weight: 10.0
    socket_count: 0

drops:
  WOODEN_SWORD:
    type: weapon
    min_level: 1
    max_level: 15
    drop_chance: 0.15
    base_damage: 4.0
    damage_multiplier: 1.05
    attack_speed: 1.6
    base_crit_chance: 0.05
    crit_chance_multiplier: 1.02
    base_crit_damage: 1.5
    crit_damage_multiplier: 1.03

gems:
  DAMAGE_GEM_I:
    type: weapon_gem
    gem_type: damage
    gem_level: 1
    value: 5.0
    base_value: 5.0
    value_multiplier: 1.2
    min_level: 5
    drop_chance: 0.1

chests.yml

chests:
  small_chest:
    level_required: 5
    items:
      - WOODEN_SWORD
      - LEATHER_HELMET
      - APPLE

mobs.yml

mobs:
  ZOMBIE:
    min_level: 1
    base_health: 20.0
    base_damage: 3.0
    health_multiplier: 1.1
    damage_multiplier: 1.05

rarities:
  Common:
    multiplier: 1.0
    color: WHITE
    drop_weight: 10.0

translations.yml

# Custom item and mob names
items:
  WOODEN_SWORD: "Wooden Training Sword"
  DIAMOND_SWORD: "Diamond Blade of Power"

mobs:
  ZOMBIE: "Rotting Undead"
  SKELETON: "Bone Archer"

📦 Installation

1. Download the plugin JAR file
2. Place it in your server's plugins/ folder
3. Restart your server or use /reload
4. Configure the generated config files in plugins/OneblockWaves/
5. Set permissions for admin commands if needed

🔗 Dependencies

Required

• PaperMC 1.21+ - Recommended Minecraft server software
• Vault - Economy integration

Optional

• MythicMobs - Custom mob support
• Any Vault-compatible economy plugin (Essentials, etc.)

🎮 Gameplay Guide

Getting Started

1. Use /oneblock spawn to create your OneBlock
2. Mine the block to gain EXP and level up
3. Higher levels unlock better materials and stronger enemies
4. Collect drops and upgrade your equipment

Progression Path

1. Early Game: Focus on basic tools and armor
2. Mid Game: Unlock auto-tool and start gem socketing
3. Late Game: Max out upgrades and class points for optimal stats

Combat Tips

• Use auto-tool to automatically switch weapons when targeting enemies
• Poison enemies for damage over time effects
• Block rate helps survive tough encounters
• Upgrade your forge for better item upgrade success rates