Extensions:Cultivation

Cultivation
Description	Allows users to cultivate items of any kind within cultivation areas by tending to them each day.
Author(s)	Cylunny
Status	Stable
Github	extension/cultivation
LK Version	2.1.2
Contains a Migration
	v; t; e;

Cultivation adds the functionality of allowing users to unlock areas and create plots within them. Plots can be planted with a seed item, allowing it to grow via daily user interaction before granting the user a reward. Number of days required for growth, amount of plots able to be tended by a user in a day, amount of areas that can be unlocked by a user, and so on are all customizable.

Installation

Pull & merge conflicts. Afterwards, run the following commands:

php artisan migrate
php artisan add-site-settings
php artisan update-extension-tracker
php artisan optimize x2 (only if on live; if you are on local, run php artisan optimize:clear once instead)

Configuration

This extension adds three additional site settings in the admin panel:

cultivation_plot_usability (default 0), do plots become unusable once an item was cultivated? Whether or not a user needs to prepare them again or not. (0 = No, 1 = Yes)
cultivation_care_cooldown (default 0), how many plots can a user tend to in a day? (0 = Unlimited)
cultivation_area_unlock (default 0), how many areas can a user unlock at the same time? (0 = Unlimited)

Usage

As an admin you will have to set up the following things first via admin panel:

Create cultivation areas with basic fields + what plots can be prepared here via tool item
Plots themselves, with basic info + images for each stage + what seed items can be planted there
Item tag for exploration items (unlocks an area)
Item tag for tool items (creates a specific type of plot)
Item tag for seed items (actually plants something and starts cultivation) with how long each stage takes in days, what item(s) are harvested once ready + optional specific "ready for harvest" image

Users will have:

A page with different locations they can cultivate in
Each area has an amount of plots to cultivate seeds
Plots go through different stages: unprepared, ready for cultivation, cultivating and ready for harvest
Users need items to progress between the stages, exploration items to gain access to a cultivation area, tools to prepare a plot, seeds to start cultivating something
They need to tend to the plots once a day to progress them until they are ready for harvest
When harvesting, user will be awarded the corresponding fully grown item/set reward
A guide that automatically lists what plot can cultivate which item etc

Previews

The display when a cultivation area has yet to be unlocked by a user.
The display when a cultivation area has been unlocked by a user.
A single plot made inside an unlocked cultivation area.
Prepare plot modal.png

The modal when clicking on a newly made plot in order to prepare it for a seed.
The modal of a prepared plot without a seed planted in it yet, showing options to begin cultivating a seed item or to re-prepare the plot.
The modal of a plot with a seed planted in it, allowing a user to tend to it once per day.