Documentation › Mushrooms › Features › Picking & Quality

Picking & Quality

Hand-picking and knife minigames and the 1–3 star quality.

Players target a mushroom and choose Collect. With Config.WalkToMushroom the character first walks up to it (moving cancels), kneels, and the camera moves next to the mushroom. The minigame depends on what the player holds.

By hand (no knife)

Loosen

Hold the left mouse button and rock the mouse left and right. Soil puffs out as the stem loosens. Rocking too fast strains the stem.

Pull

Once it is loose, move the mouse up slowly to pull the mushroom out. Pulling too fast strains it; at full strain the stem snaps.

With a knife

Hold a knife, machete, switchblade or dagger (Config.KnifeWeapons) and cut along the line over the stem. Precision decides the result. The knife is the faster way.

Quality

Every mushroom gets 1★–3★. The base roll depends on rarity, then the minigame changes it by at most one star:

  • Clean result: cleanBonusChance (50 %) for +1★
  • Damaged mushroom: −1★
lua
-- config_economy.lua
Config.Quality = {
    enabled = true,
    maxStars = 3,
    collectWeights = {          -- % chance of 1★ / 2★ / 3★
        default   = { 70, 25, 5 },
        uncommon  = { 60, 30, 10 },
        rare      = { 50, 35, 15 },
        legendary = { 40, 40, 20 },
    },
    priceMultiplier = { 1.0, 1.35, 1.8 },
}

After a pick a small notice shows what was collected, e.g. +2 Boletus ★★☆ (Config.UI.collectHud).

Quality is stored as item metadata: ox_inventory, qb-inventory and qs-inventory. On other inventories every mushroom counts as 1★.

Minigame tuning

lua
Config.Minigames = {
    affectQuality = true,      -- false = minigames don't change stars
    cleanBonusChance = 0.5,
    lift = {
        loosenPerTwist = 0.35, maxTwistSpeed = 3.2, looseToPull = 1.0,
        pullPerMove = 0.6,     maxPullSpeed = 1.1, strainRelax = 0.35,
        cleanStrain = 0.35,    -- peak strain below this = clean
        damageStrain = 0.8,    -- above this = damaged; 1.0 snaps it
        timeoutMs = 25000,
    },
    camera = { side = 'right', distance = 0.85, height = 0.42, fov = 40.0 },
    knife = {
        tolerance = 0.018,     -- allowed distance from the line (screen fraction)
        cleanPrecision = 0.82, damagePrecision = 0.5,
        stemHeight = 0.05,     timeoutMs = 20000,
    },
}

Raise the *Per* values to make hand-picking quicker, raise the max speeds to make it more forgiving.

Amount

Config.CollectAmount = { min = 1, max = 2 } multiplied by the forest's countMultiplier. The double_drop perk can double it.