FarmDashboard

FarmDashboard tracks your crops, sends chat alerts when they need attention, and can guide you back with a star trail.

Watch the intro: YouTube

---

Overview

Your farm keeps ticking even when you are not standing on it. FarmDashboard tracks your plantations (not the whole world), remembers where you planted, and can ping you in chat when harvest, water, or fertilizer actually matters. Same remote list as the dashboard, not limited to nearby chunks.

---

Installation

1. Download FarmDashboard-1.0.0.jar from the CurseForge Files tab
2. Place the JAR in mods/ (global UserData/Mods or per-save mods/)
3. Start the world. Config is created at mods/durkz_FarmDashboard/FarmDashboard.json
4. Plant crops, then run /farm d to open the dashboard
5. Walk away and wait for scheduler alerts (default every 30 seconds) if crops need attention

---

Quick start

1. Plant crops (water/fertilize on tilled soil for faster growth — optional for eternal seeds, but recommended as a boost).
2. /farm d — loading scan, then dashboard.
3. Check the summary bar (ready / need water / unfertilized).
4. Go explore. Chat alerts fire when something needs harvest, water, or fertilizer.
5. Open the dashboard again or use Follow Crop / /farmloc x y z to get a star trail back.

---

Commands

Main command: /farm

Command	Description
/farm d	Open Farm Dashboard (alias: /farm dashboard)
/farmloc x y z	Start follow star trail to coordinates
/stop follow	Stop the follow trail

Examples:

/farm d
/farmloc -551 118 -40
/stop follow

---

Dashboard

Area	What it shows
Summary	Total crops, ready to harvest, need water, need fertilizer (tilled soil only)
Groups	Crops grouped by type — expand for each plant row
Seed row	Coordinates x, y, z — click to select
Details	Name, growth %, stage, soil status, planter name
Location	Sends coords + distance to chat
Follow Crop	Star trail path guide to selected plant

The panel auto-refreshes while open (default every 5 seconds).

---

Scheduler alerts (chat)

Background checks run on an interval (alertCheckIntervalMs, default 30000 ms). Alerts are sent only for crops you planted, using the same remote tracking as the dashboard — not limited to chunks around you.

Alert	Color (typical)	When
Ready to harvest	Green	Crop is mature / 100% growth
Needs watering	Blue	Tilled soil crop is dry (includes eternal boost reminders)
Needs fertilizer	Orange	Tilled soil crop is unfertilized

Each alert fires once per state until the condition is fixed (then it can alert again later).

Toggle all alerts: schedulerAlertsEnabled in config.

---

Follow Crop

Select a crop in the dashboard → Follow Crop, or use /farmloc x y z.

A trail of glowing stars marks the path to the plant (visible day and night). Stop with /stop follow.

---

Supported crops

Explicit integration allowlists (no generic “any farming block” guessing):

Pack	Examples
Vanilla	Plant_Crop_*, Plant_Sapling_*
Life Crops	mod crop blocks (standard + eternal variants)
NoCube’s Orchard	NoCube_Plant_Sapling_* fruit trees

Saplings on natural soil show Natural soil — water/fertilizer counts apply to tilled crops only.

Eternal seeds grow without water/fertilizer but grow faster with both. Dashboard and alerts show boost status optionally.

Custom packs: drop JSON files in mods/durkz_FarmDashboard/integrations/ (see repo docs for format).

---

Config

File: mods/durkz_FarmDashboard/FarmDashboard.json

Field	Default	Description
schedulerAlertsEnabled	true	Enable/disable chat scheduler alerts
alertCheckIntervalMs	30000	Alert tick interval (milliseconds)
scanRadius	16	Horizontal scan radius for nearby discovery
verticalRange	4	Vertical scan range (blocks up/down)
alertScanRadius	16	Legacy radius field (alerts use remote scan in 1.0.0)
maxResults	40	Max crops returned per scan
pageRefreshMs	5000	Dashboard UI refresh while open
scanCacheMs	3000	Scan result cache TTL
scanLoadingMs	4000	Loading screen minimum duration
scanLoadingRepeatMs	2000	Faster loading if re-opened soon after last scan

Example for faster alerts during testing:

{
  "alertCheckIntervalMs": 10000,
  "schedulerAlertsEnabled": true
}

---

Data files

Path	Purpose
mods/durkz_FarmDashboard/FarmDashboard.json	Runtime config
mods/durkz_FarmDashboard/Planters.json	Tracked plantation positions per player

Planter positions are recorded when you place crop-related blocks. The dashboard probes those positions even when you are far away.

---

Troubleshooting

Issue	Check
No crops in dashboard	Did you plant after installing? Run /farm d near farm once. Only your crops show.
Alerts not firing	schedulerAlertsEnabled: true. Wait full alertCheckIntervalMs. Crop must be on tilled soil for water/fert alerts.
Sapling missing	Must be in allowlist (Plant_Sapling_* vanilla or Orchard). Mature prefab trees may use different block IDs.
UI ack errors in log	Known Hytale PageManager noise on loading screen — dashboard still works.
“Eternal Eternal” name	Display quirk from integration names + eternal flag — cosmetic only.

---

Recommended

• Water and fertilize tilled crops for faster growth; eternal seeds grow without both but benefit from boosts.
• Wait one full alertCheckIntervalMs (default 30s) after leaving the farm to see scheduler alerts.
• Use Follow Crop or /farmloc when an alert fires.

---

Verifying it works

1. Plant crops after install, then run /farm d near the farm.
2. Walk away; within one alert interval you should see chat alerts for dry or ready crops (tilled soil).
3. Select a crop and Follow Crop; star trail should lead back to the block.

---

License

MIT License