EcoHarmony Plugin Documentation
Table of Contents

1. Introduction
2. Installation
3. Configuration
4. Features
   • Biodiversity System
   • Pollution Management
   • Advanced Farming
   • Weather and Climate
   • Mob Migration
   • Purification Crystals
   • Player Rewards
5. Commands
6. Permissions
7. API for Developers
8. Troubleshooting
9. FAQ

Introduction
EcoHarmony is a comprehensive ecosystem management plugin for Minecraft servers. It introduces dynamic environmental mechanics that respond to player actions, creating a more immersive and challenging gameplay experience.

Installation

1. Download the EcoHarmony.jar file from the Spigot resource page.
2. Place the JAR file in your server's plugins folder.
3. Restart your server.
4. The plugin will generate a default configuration file on first run.

Configuration
The main configuration file is located at plugins/EcoHarmony/config.yml. Here are the key settings:
Adjust these values to fine-tune the plugin's behavior on your server.

Features
Biodiversity System

• Tracks the ecological health of each chunk.
• Increases with tree growth, animal breeding, and crop harvesting.
• Decreases with pollution and over-exploitation.

Pollution Management

• Smelting and certain industrial activities generate pollution.
• High pollution levels cause negative effects on crops and mobs.
• Use Purification Crystals to clean polluted areas.

Advanced Farming

• Implements crop rotation bonuses and monoculture penalties.
• Pollution affects crop growth rates.
• Encourages diverse and sustainable farming practices.

Weather and Climate

• Long-term weather patterns affected by server activities.
• Acid rain occurs in highly polluted areas, damaging players and crops.

Mob Migration

• Animals relocate when their population in an area becomes too low.
• Encourages wildlife conservation and sustainable hunting.

Purification Crystals

• Craftable items used to reduce pollution in an area.
• Recipe: Diamond (D), Glowstone Dust (G), Emerald (E)
  
  Code (Text):

  DGD
  GEG
  DGD

Player Rewards

• Players receive buffs for maintaining high biodiversity in their area.
• Encourages eco-friendly gameplay.

Commands

• /ecoharmony info: Displays ecological information about your current location.
• /ecoharmony restore: Uses a Purification Crystal to restore the area (must be holding the crystal).
• /ecoadmin setbiodiversity <value>: Sets the biodiversity score for the current chunk (Admin only).
• /ecoadmin setpollution <value>: Sets the pollution level for the current chunk (Admin only).

Permissions

• ecoharmony.info: Allows use of the /ecoharmony info command.
• ecoharmony.restore: Allows use of the /ecoharmony restore command.
• ecoharmony.admin: Allows use of all admin commands.

API for Developers
EcoHarmony provides an API for other plugins to interact with its systems. Here's a basic example:

Troubleshooting

• If the plugin is not loading, ensure you're using a compatible server version (Spigot/Paper 1.21+).
• For any issues, check the server console for error messages.
• If crops are not growing, check the pollution levels in the area.
• Ensure that the config.yml file is properly formatted after making changes.

FAQ
Q: How often does the plugin save data? A: Data is saved periodically and when the server shuts down.

Q: Can I disable certain features? A: Most features can be effectively disabled by setting their values very low in the config.yml.

Q: How do I reset the ecological data for my world? A: Delete the data.yml file in the plugin's folder and restart the server.

For any additional questions or support, please post in the plugin's discussion thread on Spigot.