Skip to content

HarvestController.md

Latest commit

 

History

History
65 lines (45 loc) · 2.17 KB

HarvestController.md

File metadata and controls

65 lines (45 loc) · 2.17 KB
Raw

HarvestController

Code: include/controllers/world/HarvestController.hpp, src/controllers/world/HarvestController.cpp

Overview

HarvestController is the progress-based harvesting controller for resource collection. It operates on harvestable entities already registered with WorldResourceManager and backed by EntityDataManager.

Supported flows include:

  • chopping wood
  • mining stone and ore deposits
  • harvesting gem deposits
  • gathering any other configured HarvestType

Core API

bool startHarvest();
void cancelHarvest();
void update(float deltaTime);

bool isHarvesting() const;
float getProgress() const;
VoidLight::HarvestType getCurrentType() const;
std::string_view getActionVerb() const;
Vector2D getTargetPosition() const;

Constants:

HARVEST_RANGE = 48.0f
MOVEMENT_CANCEL_THRESHOLD = 8.0f

Runtime Flow

  1. startHarvest() queries nearby harvestables through WorldResourceManager::queryHarvestablesInRadius(...).
  2. It selects the closest valid, non-depleted EDM harvestable.
  3. Harvest duration comes from HarvestConfig for the resolved HarvestType.
  4. update() advances progress until complete or cancels if the player moves too far.
  5. completeHarvest() awards resources or spawns a dropped item fallback.

Integration Details

  • WRM provides the spatial query.
  • EDM provides the harvestable payload, depletion state, and dropped-item creation.
  • Successful inventory inserts emit ResourceChangeEvent for UI and inventory synchronization.
  • Harvest completion emits HarvestResourceEvent so world/tile systems can react visually.

Inventory Fallback

If the player inventory is full, harvest output is spawned as a dropped item in the active world instead of being discarded.

That means harvesting now depends on:

  • a valid player inventory index when available
  • WorldResourceManager::getActiveWorld() for dropped-item registration

Usage Notes

  • Treat this as a controller, not a data store. Persistent harvestable state remains in EDM.
  • The controller keeps a reusable harvestable index buffer to avoid repeated allocation.
  • Player movement is part of the interaction contract; harvesting is intentionally interruptible.