# Farming Zones

### **🌾 Farming Zones** (v2.1.2+)

Farming Zones let you create regions where players can farm crops that automatically regenerate after a set amount of time. Supports per-player farming so multiple players can farm in the same zone simultaneously without interfering with each other.

{% hint style="info" %}
**Version 2.1.2+** — If you are on a legacy version, see the Farming Zones (Legacy) down below.
{% endhint %}

***

### Requirements

* [WorldGuard](https://enginehub.org/worldguard/) for region management
* [PacketEvents ](https://modrinth.com/plugin/packetevents)*(optional — required for `player-only` mode)*

***

### 1. Setup

 Plant & Grow Your Crops Wheat must be **planted and fully grown** in the area before creating a farming zone.

### 2. Create the Farming Zone

Run the following command and click the new zone button in the menu to begin your selection: **/hoe farmingzones**

Follow the steps shown in chat using the selection wand to define your zone area.

#### 3. Enable in config.yml

Ensure the following options are set in `config.yml`:

```yaml
Farming-Zones:
  enabled: true
  packetcrops: true
```

#### 4. Set the Crop for the Zone

You can either use the Crop Selector GUI (configured in \`cropselector.yml\`) or set a crop manually with:

/hoe setcrop {player} {material}

{% hint style="info" %}
ItemsAdder, Nexo & Oraxen are supported for material types, instead of a material you can use itemsadder:yourmodel oraxen:yourmodel nexo:yourmodel
{% endhint %}

{% hint style="danger" %}
Any material set must also be added to \`Leaderboard-Materials:\` in \`leaderboards.yml\`. \*\*A server restart is required\*\* after adding the new materials.
{% endhint %}

####  Region Flags

You still need a WorldGuard region with the correct flags applied. Use \`/rg define {name}\` and then set:

/rg flag {region} build allow

\*\*or:\*\*

/rg flag {region} rivalharvesterhoes allow

& 

/rg flag {region} block-break deny

/rg flag {region} block-place deny

/rg flag {region} deny-message -e

***

### Configuration

The region config and structure remain the same as the legacy version:

```yaml
Farming-Zones:
  enabled: true          # Enable the Farming Zones module
  packetcrops: true      # Enable packet-based crops — requires PacketEvents
  player-only: false     # Only the farming player sees their own crops break
  global: false          # If true, every crop acts as a farming zone crop
                         # and regions are ignored
  regions:
    - 'regionname'       #Regions does nothing on this version
  regen-time: 20         # Default crop regen time in seconds
  custom-times:          # Override regen time per crop type
    WHEAT: 5
  particles:
    enabled: true        # Show particles when a crop regenerates
    particle: 'VILLAGER_HAPPY'
```

### **🌾 Farming Zones (Legacy)**

\
Farming Zones let you create regions where players can farm crops that automatically regenerate after a set amount of time. Supports per-player farming so multiple players can farm in the same zone simultaneously without interfering with each other.

{% hint style="danger" %}
 **Legacy Version** — If you are on version 2.1.2 or above, see the Farming Zones (v2.1.2+) above
{% endhint %}

***

### Requirements

* [WorldGuard](https://enginehub.org/worldguard/) for region management
* [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/) *(optional — required for `player-only` mode)*

***

### Setup

#### 1. Create a WorldGuard Region

Define a WorldGuard region over the area you want to use as a farming zone:

```
/rg define {name}
```

#### 2. Set Region Flags

Apply the following flags to your region:

```
/rg flag {region} build allow
```

**or** (if you prefer a more restrictive setup):

```
/rg flag {region} rivalharvesterhoes allow
```

```
/rg flag {region} block-break deny
/rg flag {region} block-place deny
/rg flag {region} deny-message -e
```

#### 3. Add the Region to config.yml

Add your region name to the `regions` list in `config.yml` and configure the module to your liking (see below).

***

### Configuration

```yaml
Farming-Zones:
  enabled: true          # Enable the Farming Zones module
  player-only: false     # Only the farming player sees their own crops break
                         # (other players' crops remain visible) — requires ProtocolLib
  global: false          # If true, every crop acts as a farming zone crop
                         # and regions are ignored
  regions:
    - 'regionname'
  regen-time: 20         # Default crop regen time in seconds
  custom-times:          # Override regen time per crop type
    WHEAT: 5
  particles:
    enabled: true        # Show particles when a crop regens
    particle: 'VILLAGER_HAPPY'
```