OreTree

OreTree is a Minecraft Forge mod that allows you to automatically chop entire trees with one axe swing and mine entire ore veins with one pickaxe swing.

## Features
- **Automatic Tree Chopping**: Chopping any tree block with an axe automatically chops all connected tree blocks
- **Automatic Ore Mining**: Mining any ore block with a pickaxe automatically mines the entire ore vein
- **Automatic Sapling Planting**: After chopping a tree, a sapling of the same type is automatically planted
- **Loot Combining**: Mined ore and wood are combined into single stacks for convenience
- **Anti-Abuse Protection**: Manually placed blocks are not automatically destroyed
- **Configurable Limits**: You can set maximum number of blocks for chopping/mining
- **Mod Tool Support**: Works with axes and pickaxes from popular mods
- **Mod Tree Support**: Automatically detects and plants saplings from mod trees

### Supported Trees and Saplings
- **Vanilla Trees**: Oak, Spruce, Birch, Jungle, Acacia, Dark Oak
- **Biomes O' Plenty**: Cherry, Dead, Fir, Hellbark, Jacaranda, Magic, Mahogany, Palm, Redwood, Umbran, Willow
- **Quark**: Azalea, Blossom

### Adding Other Mods
You can add support for other mod tools in the configuration file

## Installation
1. Make sure you have Minecraft Forge installed for version 1.19.2
2. Download the JAR file of the mod
3. Place the file in the `mods` folder
4. Start the game

## Performance Configuration

### Configuration File
Settings are located in the `server.toml` file in the `config` folder after the first game launch.

### Main Parameters

#### `enable_tree_chopping` (boolean, default: true)
Enable or disable automatic tree chopping.

#### `enable_ore_mining` (boolean, default: true)
Enable or disable automatic ore mining.

#### `max_tree_blocks` (integer, default: 300, range: 50-1000)
Maximum number of tree blocks that can be chopped at once.
- **50-100**: Fast chopping, suitable for small trees
- **200-300**: Balanced setting (recommended)
- **500-1000**: For very large trees, may be slower

#### `max_ore_blocks` (integer, default: 1000, range: 100-5000)
Maximum number of ore blocks that can be mined at once.
- **100-500**: Fast mining, suitable for small veins
- **1000-2000**: Balanced setting (recommended)
- **3000-5000**: For very large ore veins

#### `respect_tool_speed` (boolean, default: true)
Respect tool speed. If disabled, all tools will work at the same speed.

#### `respect_enchantments` (boolean, default: true)
Respect tool enchantments (e.g., Efficiency). If disabled, enchantments won't affect speed.

#### `auto_plant_saplings` (boolean, default: true)
Automatically plant saplings after chopping trees.

#### `require_saplings` (boolean, default: false)
Require saplings in inventory for planting. If disabled, saplings are created automatically.

#### `combine_ore_loot` (boolean, default: true)
Combine mined ore into single loot stacks. This reduces inventory clutter.

#### `respect_fortune` (boolean, default: true)
Respect Fortune enchantment when combining loot. If enabled, Fortune increases ore yield.

#### `combine_tree_loot` (boolean, default: true)
Combine chopped wood into single loot stacks. This reduces inventory clutter.

#### `compatibility_mode` (boolean, default: false)
Compatibility mode - less aggressive event handling to avoid conflicts with other mods.

#### `check_other_mods` (boolean, default: true)
Check for conflicting mods and automatically disable functions.

#### `custom_axes` (list, default: predefined mod axes)
List of additional axes from mods for support.

#### `custom_pickaxes` (list, default: predefined mod pickaxes)
List of additional pickaxes from mods for support.

#### `excluded_mods` (list, default: treecapitator, veinminer, oreexcavation)
Mods that TreeChop should not work with (to avoid conflicts).

#### `enable_logging` (boolean, default: false)
Enable logging for debugging. Useful for diagnosing performance issues.

### Performance Configuration Recommendations

#### For Fast Gameplay:
```toml
max_tree_blocks = 150
max_ore_blocks = 500
respect_tool_speed = true
respect_enchantments = true
auto_plant_saplings = true
require_saplings = false
combine_ore_loot = true
combine_tree_loot = true
respect_fortune = true
enable_logging = false
```

#### For Large Trees and Ore Veins:
```toml
max_tree_blocks = 500
max_ore_blocks = 2000
respect_tool_speed = true
respect_enchantments = true
auto_plant_saplings = true
require_saplings = false
combine_ore_loot = true
combine_tree_loot = true
respect_fortune = true
enable_logging = false
```

#### For Realistic Gameplay (Requires Saplings):
```toml
max_tree_blocks = 300
max_ore_blocks = 1000
respect_tool_speed = true
respect_enchantments = true
auto_plant_saplings = true
require_saplings = true
combine_ore_loot = true
combine_tree_loot = true
respect_fortune = true
enable_logging = false
```

#### For Debugging:
```toml
max_tree_blocks = 300
max_ore_blocks = 1000
respect_tool_speed = true
respect_enchantments = true
auto_plant_saplings = true
require_saplings = false
combine_ore_loot = true
combine_tree_loot = true
respect_fortune = true
enable_logging = true
```

## Mod Compatibility

### Potential Issues:
1. **Conflicts with other tree chopping mods**: TreeCapitator, VeinMiner, Tinkers Construct (if they have their own chopping system)
2. **Issues with mod trees**: Some mods may use non-standard blocks for trees
3. **Conflicts with mod tools**: Mods may override axe behavior

### Solutions:
- The mod checks if blocks were placed manually, reducing conflicts
- Universal tree detection system by name and tags
- Uses `event.setCanceled(true)` for complete control

### Compatibility Settings:
- **`compatibility_mode = false`**: Normal operation
- **`compatibility_mode = true`**: Less aggressive event handling
- **`check_other_mods = true`**: Automatic conflict detection
- **`excluded_mods`**: List of mods to avoid

## Support
If you encounter any issues or have suggestions for improvements, please report them on the mod's issue tracker or contact the development team.

---

**Enjoy your enhanced Minecraft experience with OreTree!** 🌳⛏️