# Installation

> Setup guide for ML Planting

Category: PLANTING · Source: https://miciomods.it/docs/ml-planting-installation · Last updated: 2026-07-28

## Overview

ML Planting is a cultivation system. Players plant seeds, water and fertilize them, and harvest the results. Supports multiple plant types, growth zones with multipliers, ground material restrictions, and a full admin panel.

## Quick Start

1. Download from [CFX Portal](https://portal.cfx.re)
2. Extract to your `resources` folder as `ml_planting`
3. Add to `server.cfg`:

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_planting
```

> **WARNING:** Load Order
>
> `ml_planting` must start AFTER `ml_bridge`. Incorrect order causes startup errors.

## Database

Tables are created automatically on first start:

`ml_planting_plants` - Active plants (position, water, fertilizer, health, growth)

`ml_planting_types` - Plant type definitions (stages, harvest, water/fertilizer config)

`ml_planting_categories` - Plant categories with defaults

`ml_planting_zones` - Growth zones (multipliers, allow/block lists, blips)

Plant types, categories, and growth zones are managed through the admin panel.

## Admin Panel

Access the admin panel with:

```lua
/plantadmin
```

Requires admin permission from your framework, resolved through `ml_bridge` (the `admin`/`god` group on QBCore, Qbox and ESX, or ACE admin on standalone).

## Verify

Start the server and check the console for:

```lua
[ml_planting] Resource started
[ml_planting] Ready! Loaded 0 plants in 0 chunks, 1 zones
```

Open the admin panel to create your first plant type and seed items.

**Troubleshooting**

- Plants not spawning - Check that the prop model exists in GTA and ground material restrictions are not blocking placement.
- Admin panel not opening - Verify you have admin permission on your framework (`ml_bridge` resolves the check).
- Growth stuck - Plants stop growing completely when water reaches 0. Water the plant and growth resumes; progress is computed from elapsed time.