**Gameplay Elements for Crop Growing - Mechanic Compilation**

---

**Core Mechanics Overview**

1. **Sunlight**

   * Intensity (full sun, partial shade, shade)
   * Duration (hours per day)
   * Seasonal shift in sunlight patterns
   * Artificial lighting (developed via tech upgrades)

2. **Hydration**

   * Water frequency (daily, weekly)
   * Water quantity (light, moderate, heavy)
   * Source of water (rain, irrigation, recycled)
   * Evaporation rate (affected by temperature, humidity)

3. **Soil**

   * pH level (acidic, neutral, alkaline)
   * Texture (sandy, loamy, clay)
   * Compaction (loose to packed)
   * Organic matter content

4. **Virus**

   * Spread mechanics (windborne, waterborne, insect vector)
   * Host specificity (plant species susceptible)
   * Symptoms (wilting, discoloration, stunted growth)
   * Containment (quarantine, crop burning, resistant strains)

5. **Nutrient**

   * Macronutrients (N-P-K)
   * Micronutrients (Zn, Fe, Mg, etc.)
   * Depletion over time
   * Nutrient-specific needs by crop type

6. **Bacteria**

   * Beneficial (e.g., nitrogen-fixing)
   * Harmful (e.g., rot-causing)
   * Environmental dependencies (moisture, pH)
   * Interaction with soil and roots

7. **Water Quality**

   * pH level
   * Salinity
   * Presence of heavy metals or contaminants
   * Microbial load

8. **Crop Rotation**

   * Nutrient recovery benefits
   * Pest and disease control
   * Soil structure maintenance
   * Crop synergy planning

9. **Fertilisation**

   * Organic vs Synthetic
   * Application method (topsoil, root injection)
   * Timing and intervals
   * Over-fertilisation penalties

10. **Symbiotic Relations**

    * Companion planting (e.g., nitrogen fixers)
    * Pollinator attraction (bees, butterflies)
    * Mycorrhizal fungi networks
    * Wildlife integration (e.g., frogs eating pests)

Other aspects such as crop splitting due to the abrupt change in moisture from dry spell to wet weather.

---

**Interdependency Table for Unique Scenario Generation**

| Mechanic A    | Mechanic B    | Possible Interaction / Scenario                                    .                         |
| ------------- | ------------- | -------------------------------------------------------------------------------------------- |
| Sunlight      | Soil          | Certain soil types heat up faster under full sun, affecting seed germination speed           |
| Hydration     | Bacteria      | Overwatering promotes harmful bacterial growth unless balanced with beneficial strains       |
| Soil          | Nutrient      | Sandy soils drain nutrients faster, requiring more frequent fertilization                    |
| Virus         | Crop Rotation | Repeated planting of the same crop increases virus spread; rotating crops breaks the cycle   |
| Nutrient      | Fertilisation | Excessive synthetic fertilizer can cause nutrient lockout or runoff, affecting water quality |
| Water Quality | Hydration     | Poor-quality water leads to toxin accumulation in soil and crops                             |
| Soil          | Symbiosis     | Clay-rich soil supports stronger fungal networks for symbiotic benefits                      |
| Crop Rotation | Nutrient      | Rotating legumes improves nitrogen levels for following crops                                |
| Symbiosis     | Virus         | Symbiotic fungi may protect plant roots from viral infection vectors                         |
| Sunlight      | Symbiosis     | High light levels support better photosynthesis in symbiotic companion plants                |
| Water Quality | Bacteria      | Contaminated water introduces harmful bacteria, reducing crop yield                          |
| Fertilisation | Bacteria      | Organic fertilisers encourage beneficial microbial communities                               |
| Virus         | Water Quality | Poor water quality increases vulnerability to virus outbreaks                                |
| Sunlight      | Hydration     | Intense sun increases evaporation, requiring more frequent watering                          |
| Crop Rotation | Bacteria      | Rotating with antibacterial crops (e.g., garlic) suppresses harmful bacteria in soil         |

---

**Enhancing Tactile & Immersive Feedback**

To make each farming action feel more immediate, responsive, and satisfying, consider adding:

• **Tool‐Specific Animations & Sounds**
– Unique swing, pour, or soil‐shovel animations for each tool (watering cans, trowels, shears).
– Layered audio: water trickle, soil crunch, leaf rustle, and fertilizer sprinkle.

• **Haptic Feedback (if supported)**
– Light vibration when the watering can empties or the hoe strikes soil.
– Stronger feedback on critical interactions (harvesting, diseased plant removal).

• **Dynamic Soil & Crop Physics**
– Soil that deforms under footsteps or tool pressure, with small dust clouds.
– Plants that bend and sway when touched, or shake slightly when wind passes through.

• **Contextual UI Prompts & Radial Menus**
– Pop‐up radial tool selection at high‐precision areas (e.g., choosing between fertilizer types).
– On‐screen prompts that fade in when a plant is ready for a specific action (pruning, sampling).

• **Environmental & Weather Immersion**
– Morning dew glistening on leaves; sunbeams piercing through canopy during planting.
– Real‐time weather effects: raindrop replay when harvesting wet crops, wind‐driven pollen clouds.

• **Interactive Sampling Mini‐Games**
– Quick‐time events for leaf or soil sampling that reward precision with more accurate readouts.

• **Time‐Lapse & Growth Visualization**
– Brief accelerated animations when advancing days, showing subtle growth or decay in seconds.

• **NPC & Companion Feedback**
– Farmhand or mentor character comments (“Your soil sample is rich in phosphorus today!”).
– Critters (bees, butterflies) visibly respond to plant health—flitting around healthy blossoms.

• **Harvest Ritual & Presentation**
– Cinematic close‐up of each fruit or vegetable being cut or picked, with satisfying snap or pop.
– Animated sorting table where crops are graded, triggering visual flourishes for top‐grade produce.

• **Sensory Layering**
– Ambient soundscape: distant crow caw, flowing irrigation canal, soft breezes carrying floral scents.
– Subtle colour grading—vibrant hues on healthy plants vs. desaturated tones on stressed crops.

• **Progressive Skill Mastery**
– Unlock new animations, faster tool use, or more precise effects as the player’s farming skill improves.
– Taste refinement: richer screen filters or enhanced audio cues (crisp bite sounds) when consuming high‐grade produce.

By weaving these sensory, technical, and interactive layers into your farming loop, each task—no matter how routine—becomes an engaging, memorable experience that reinforces player investment and mastery over time.

Soil data:

Soil depth. 5 levels: surface, shallow, medium, deep, and superdeep. Past the soil depth, roots will enter into rocks and hardened clay territory, where further growth is greatly obstructed.

Water saturation at 5 depth levels as a percentage. The first level is surface water not yet infiltrated into the soil. 2 levels per block, levels 3 and 4 reserved for deep root systems. Water quality with ph (drops due to salinity) and salinity (salts that decrease water uptake)

Mulch on the surface level. 

Fertiliser on 5 levels. Multiple types of nutrients are available. Nitrogen and phosphorus content. High nutrient content increases toxicity and may disrupt mycorrhizal fungi networks, reducing root efficiency.

Toxins and chemicals. Lead, arsenic, pesticides, etc.

Fungal Growth. Mycelium on 5 levels impacting the crop's root system and nutrient intake. Surface mycelium in the form of mushroom growth is the only observable one.

Bacterial and viral presence on 4 levels.

Soil quality at five levels: rock content, the level of compaction affecting porosity, water retention and drainage (influencing pathogenic accumulation), and a high preexisting weed root system. For example, a hydrophobic surface residue decreases drainage and increases runoff at the soil's top. Types include sandy, clay, silty, loam, peaty, and lime /chalky. Weeds and compacted soil at the surface can be displaced using better-quality hoes. 

Soil temperature. Affects nitrification, hydration, and induces hydrophobic surfaces.

Multicellular organisms. Earthworms, caterpillars, and propensity to attract critters, insects, and pollinators.

Crop data:

Max hydration in blocks of a single depth of fully saturated soil blocks. Entirely based on the current foliage density scaled by the growth phase.

Hydration in blocks. Increases as water is absorbed by roots.

The ratio between hydration and max hydration gives you the relative hydration of the crop (%). 100% indicates all leaves are hydrated and photosynthesis efficiency is maximised.

Oxygen (%) decreases proportionally to the foliage density, where the rate of increase is determined by the soil saturation level. CO2 as a Boolean availability.

Sunlight as a percentage of exposed sky. Affected by weather /overcast.

Root health at 5 levels, root density as a percentage of optimum soil volume (with competition from other crops so that total percentage < 100%, percentage of fluid extracted from soil is thus a fraction of the root density), impacted by rot caused by soil water content, bacterial content. Root health determines the plant's water  and nutrient intake rate, which is clamped to maximum. Shape and tangled boolean impacts the efficiency factor (%).

The branches attribute will be a number representing the number of branches on the crop. This statistic will determine the number of leaves that will sprout after a growth phase. Instead, leaf density will be calculated based on the height of the tree, the number of branches and the number of leaves. The height of the tree should be determined by the growth phase. External crop parameters will guide the number of leaves that can grow from each stem, the initial and continuous glucose expenditure for leaf growth, crop height per phase and other foliage-specific behaviour. Photosynthesis efficiency will be a fraction of the total leaves decreased due to higher leaf densities. Foliage count only decreases due to pathogens, pests, environmental factors and pruning of leaves or the stem itself. Foliage still uses up glucose even without additional growth, so that during the night, foliage produces a net negative amount of glucose.

Max nutrient level in the same unit as max hydration.

Nutrient content: nitrogen, phosphorus, potassium, and calcium in the same unit as hydration.

Hence, nutrient ratio (%).

Pests, aphids, and viruses at either the root level or foliage level as a percentage indicating severity out of 100%. Certain crop conditions can alleviate pest infestations and the accelerated growth of viruses/fungi. These can include leaf density, presence of younger leaves,  glucose accumulation from the slow production of leaves, etc.

Growth phase, including harvest, death and rotting phases.

Harvest phase progress. Fertilisation percentage, fruit growth progress until maturation.

Glucose level: It is the plant's energy, which updates multiple times per day based on the average of plant growth conditions (root quality, nutrient content, virus concentration, etc.). Once energy reaches above a threshold determined by the plant growth stage, it will enter the next growth stage. If it falls to 0, the plant will die.

Main growth stages: germination, root, stem, leaves, maturation, pollination, crop yield, and death. Environmental conditions determine the rate of root and leaf /stem growth. Some nutrients may increase root growth, while others boost foliage growth. Rock strata at a certain depth may inhibit root growth, and viruses may impede foliage growth. Thus, the amount of growth will be a fraction of the total glucose reserved for this growth stage. During the crop yield stage, the rate of growth updates should increase. Glucose and nutrients may be allocated to foliage and root growth, hindered by pathogens and other ailments. During intergrowth updates, energy will be partitioned to different areas depending on the crop's nutrient availability. All fruit growth must occur over a strict growth period (time-limited) after which, the fruit's quality will decrease (harden, become fibrous, toxic, etc.). The overall yield quality will be based on the amount of nutrients that went into the fruit when it was harvested (ripe or not) and other factors that stunted growth. There may be multiple yield periods throughout the plant's lifespan, so one must determine whether the plant is annual, biannual (like carrots) or perennial (potatoes). The yield stage may begin immediately after planting (these include root plants or crops where the leaves are eaten). Hence, some plants won't have a fruit-growth progress stat; instead, maturity would be determined by the foliage density or root density.

Reaching the next growth stage normalised the foliage density by the formula: density \* (stage-1) / (stage) + x% (additional leaf growth proportional to leaf density from the previous stage and growth factors) {useful as density indicates what proportion of the leaves are contributing to photosynthesis and also simplifies mildew calculations}. Limited by rock strata, roots may also grow to deeper depths.

Inter-stage growth. Each growth update provides an additional opportunity for leaves and roots to grow in density and regenerate foliage mass after damage sustained by viruses, pests and other environmental factors. Similarly, this stage may allow for further infections, pests to infest, and natural conditions to further degrade crop health. Crop growth during this update is slow but may be accelerated by growth factors. 

Observable defects:

Accumulated defects from previous viral load, pest infestation, and fungal spore invasion. This will constantly impact glucose generation efficiency, but defects will subside as new leaves grow. 

Percentage burnt, 100% is dead.

Percentage trampled.

Plant-specific parameters:

• Bottom and top thresholds for imbalanced hydration, nutrients, sunlight, oxygen, temperature, pH tolerance (nutrient uptake efficiency is impacted by pH level), salinity tolerance (impacts water uptake), etc. Different during the germination phase.

• Pre-germination-phase probability of germinating.

• Base chances of rotting in roots due to waterlogging. 

• Base chance of sunburn starting at the threshold temperature and sun exposure duration.

• Base glucose threshold for growth to tier 2.

• Proportional increase in glucose threshold required to enter the next growth stage.

• Base chances of adverse events such as infections, pest invasion, weed sprawl, etc., occurring on roots and foliage.

• Harvest window leniency (yield quality reduction factor multiplied by time from optimum harvest time).

• Base distribution of glucose levels for root growth and foliage growth.

• Senescence. Number of days until crop yield and quality begin to fall.

Globals:

Phases and what happens when entering the next phase. 

Whether the crop is a root, leaf or fruit crop. 

Global growth considerations:

Differences between day and night. Daytime watering is more favourable. During the night, respiration increases, resulting in a net loss of glucose and water.

Once the germinated seedling uses up most of its initial energy reserves, it will enter  the sprouting, normal growth, flowering, and death or regrowth phase. 

After the end of life (finished flowering for some plants), the plant's immune and metabolic system greatly wanes, and death quickly approaches.

**Carrot crop:**

7 normal growth stages until the flowering phase. 3 flowering stages until seeds are ripe.

Harvest interval = 5 inter-growth periods around the end of the yield period up until the first stage of flowering ends. 

A total of 40 inter-growth updates until the carrot is ripe.

100 inter-growth period senescence.

Germination phase:

Starting glucose 10.

Starting glucose allocation ratio: 70% root, 30% foliage.

Starting max hydration = 0.01 blocks. Starting hydration = 0.001 blocks.

Starting max nutrient = 0.001 blocks. Starting nutrients = 0 blocks for all.

Soil moisture range: 50-80. Soil can't be fully saturated or dry.

Soil temperature range: 10-30.

Germination chance per phase: 90%. Influenced by deviation from the above conditions.

Rot chance when soil moisture is above 80% = 20% per update.

Roots do not grow well in compacted, hardened clay soils. Prefers loamy and sandy soils.

Finish the initial germination phase with surface roots of low density. 

Increase hydration as glucose is expended in the growth of deeper root systems. Stockpile on nutrients and other important minerals for when leaves start to sprout. - End phase 2 as glucose levels reach below the threshold value of 2.

The first stem begins to sprout. Glucose levels gradually increase under photosynthesis. Roots absorb water from the soil, increasing crop hydration. Each update cycle checks hydration, sunlight, oxygen, foliage density and other factors to determine glucose increases, leaf growth and root growth.

Phosphorus and potassium are essential for robust root growth. Potassium also aids in disease control, while nitrogen is for leaf growth (it should be minimised to ensure adequate energy for roots). 

The proportion of phosphorus to nitrogen determines how energy is partitioned for root and leaf growth. More phosphorus than nitrogen results in a higher level of root growth, which is desirable for carrot cultivation.

Leaf development must be prioritised in the early stages of carrot growth. This ensures high energy supplies through photosynthesis (invest in NCA). However, energy expenditure for leaf growth becomes disadvantageous as the yield period comes to an end. Root development should then be prioritised.

Excessive leaf growth over root development can result in dehydration during dry spells or when root absorption capacity is inadequate to sustain the plant's leaf density. This will decrease growth efficiency. Water stress may also increase the chance of pest and viral infestation, further degrading plant health. Alternatively, significant root growth early on will result in inadequate energy production as the lack of leaves decreases glucose production. 

Stage bonuses must be harnessed appropriately  to facilitate the greatest foliage and root growth over the carrot's production lifespan. The bonuses acquired after reaching the next stage of development are far higher than the growth accumulated in interstage periods. After reaching the final developmental stage, the plant will wait until the yield period is concluded before starting the flowering phase. At this point, the root (carrot underneath) will harden and develop a fibrous texture unsuited for consumption.

The maturation of the flowers enables the player to harvest carrot seeds. If the seeds aren't harvested, they may be blown  to nearby tilled plots by the wind.
