CopperPlus - Advanced Copper Oxidation Plugin

🎮 Overview

CopperPlus is a quality-of-life plugin for Minecraft 1.21+ that revolutionizes copper oxidation mechanics. Transform the slow, natural oxidation process into a rapid, controlled system using campfires and water - perfect for builders and redstone engineers who need oxidized copper quickly!

✨ Key Features

⚡ Accelerated Oxidation System

• Rapid Oxidation: Place copper blocks above lit campfires with water nearby to speed up oxidation dramatically
• Smart Detection: Automatically detects valid setups and begins the oxidation process
• Water Speed Multiplier: More water blocks = faster oxidation (configurable bonus per water block)
• Visual Feedback: Particle effects and sound notifications during oxidation
• Progress Tracking: Real-time oxidation progress messages

🌍 Multi-Language Support (11 Languages!)

• English (en_US) - Default
• Chinese Simplified (zh_CN) - 简体中文
• Spanish (es_ES) - Español
• Hindi (hi_IN) - हिन्दी
• Arabic (ar_SA) - العربية
• Portuguese (pt_BR) - Português
• Russian (ru_RU) - Русский
• Japanese (ja_JP) - 日本語
• German (de_DE) - Deutsch
• French (fr_FR) - Français
• Korean (ko_KR) - 한국어

🛠️ Additional Features

• Starter Kit: Quick-start kit with campfire, copper blocks, water bucket, and flint & steel
• Dispenser Support: Dispensers can place copper blocks that automatically start oxidizing
• Message Toggle: Players can enable/disable oxidation notifications
• Smart Chunk Management: Efficient processing with configurable limits per chunk
• Fully Configurable: Extensive configuration options for all features

📋 Commands

All commands use the main /copperplus command (aliases: /cp, /copper+):

Command	Description	Permission
/copperplus help	Show all available commands	copperplus.use
/copperplus kit	Get the copper oxidation starter kit	copperplus.kit
/copperplus language	View your current language	copperplus.use
/copperplus language set <code>	Change your language	copperplus.use
/copperplus language list	List all available languages	copperplus.use
/copperplus language admin <code>	Set server default language	copperplus.admin
/copperplus togglemsg	Toggle oxidation messages on/off	copperplus.use
/copperplus reload	Reload plugin configuration	copperplus.admin

🔧 How It Works

Basic Setup

1. Place a Campfire (regular or soul campfire)
2. Place a Copper Block directly above the campfire
3. Place Water blocks nearby (within 1 block radius)
4. The campfire must be lit for oxidation to occur
5. Watch as your copper oxidizes in seconds instead of hours!

Oxidation Speed Formula

• Base Speed: Configurable duration (default: 60 seconds for full oxidation)
• Water Bonus: Each water block adds a speed multiplier
• Maximum: Up to 26 water blocks can affect oxidation speed
• Formula: Speed = 1.0 + (water_blocks × water_speed_bonus)

Oxidation Stages

The plugin supports all vanilla copper oxidation stages:

• Copper Block → Exposed Copper
• Exposed Copper → Weathered Copper
• Weathered Copper → Oxidized Copper

Works with all copper variants: blocks, stairs, slabs, and cut copper!

⚙️ Configuration

Key Configuration Options

general:
  enabled: true                    # Enable/disable the plugin
  debug: false                      # Debug mode for troubleshooting

oxidation:
  duration-seconds: 60              # Base time for one oxidation stage
  water-speed-bonus: 0.25           # Speed multiplier per water block
  max-water-blocks: 26              # Maximum water blocks counted
  require-lit-campfire: true        # Campfire must be lit
  water-check-radius: 1             # Radius to check for water

effects:
  particles: true                   # Enable particle effects
  particle-type: "WAX_ON"          # Particle type to use
  sounds: true                      # Enable sound effects

performance:
  check-interval: 20                # Ticks between oxidation checks
  max-per-chunk: 50                 # Max oxidizing blocks per chunk

kit:
  items:
    campfire: 4                     # Number of campfires in kit
    copper-block: 64                # Number of copper blocks
    water-bucket: 2                 # Number of water buckets
    flint-and-steel: 1              # Flint and steel for lighting

🔑 Permissions

Permission	Description	Default
copperplus.use	Access to basic commands	All players
copperplus.kit	Use the /copperplus kit command	All players
copperplus.admin	Admin commands (reload, set default language)	Operators

📦 Installation

1. Requirements:

   • Paper server 1.21 or higher
   • Java 21 or higher

2. Installation Steps:

   • Download the latest copper-plus-1.0.jar from releases
   • Place the JAR file in your server's plugins folder
   • Restart your server
   • Configure settings in plugins/CopperPlus/config.yml
   • (Optional) Customize language files in plugins/CopperPlus/languages/

🎯 Use Cases

For Builders

• Quickly obtain oxidized copper for builds without waiting hours
• Create gradient effects with different oxidation stages
• Mass-produce weathered copper for roofing and decoration

For Redstone Engineers

• Rapidly test copper bulb oxidation states
• Create controlled oxidation farms
• Experiment with different oxidation patterns

For Server Admins

• Provide quality-of-life improvement for players
• Reduce server load compared to tick acceleration methods
• Full control over oxidation speed and mechanics

🌟 Unique Features

Why CopperPlus?

1. Realistic Mechanism: Uses campfire heat and water (like real oxidation chemistry!)
2. Performance Optimized: Efficient chunk-based processing
3. Fully Integrated: Works with dispensers, all copper types, and vanilla mechanics
4. Player Choice: Optional notifications, per-player language preferences
5. Admin Friendly: Extensive configuration and reload without restart

🔄 Update Roadmap

Planned Features

• Custom oxidation patterns and templates
• Waxing automation system
• Oxidation reversal with lightning integration
• GUI for language and settings management
• PlaceholderAPI support
• Economy integration for kit purchases
• Custom crafting recipes for oxidized variants

📊 Performance

• Lightweight: Minimal server impact with smart check intervals
• Scalable: Configurable limits prevent performance issues
• Efficient: Only processes active oxidation setups
• Clean: Automatic cleanup when chunks unload

🐛 Troubleshooting

Common Issues

Oxidation not starting:

• Ensure campfire is lit (not just placed)
• Check water is within 1 block radius
• Verify copper block is directly above campfire
• Make sure the plugin is enabled in config

Messages not showing:

• Check if you've toggled messages off with /copperplus togglemsg
• Verify your language file exists and is valid
• Ensure you're within 16 blocks of oxidizing copper

Performance issues:

• Reduce max-per-chunk in config
• Increase check-interval for less frequent updates
• Enable clear-on-unload for better memory management

💬 Support

• Bug Reports: Create an issue on our GitHub repository
• Feature Requests: Suggest features through GitHub discussions
• Discord: Join our community server for live support
• Wiki: Detailed documentation available on GitHub Wiki

📜 License

This plugin is provided as-is for use on Minecraft servers. Redistribution or modification requires permission from the author.

👨‍💻 Author

Timiliris_420 - Lead Developer

🙏 Credits

• Paper team for the excellent API
• Minecraft community for inspiration
• All contributors and testers

---

CopperPlus - Making copper oxidation fun and fast! 🎮⚡