Vinscratch

---

Vinscratch Config (vinscratch.lua)

This configuration defines the vinscratch minigame settings for each vehicle class, including allowed attempts, sequence difficulty levels, time limits, and player-specific modifiers.

---

Example Config

Config.Vinscratch = {
    ["d"] = { attemptsAllowed = 4, levels = {...}, timeLimit = 120, difficulty = 1 },
    ["c"] = { attemptsAllowed = 3, levels = {...}, timeLimit = 110, difficulty = 2 },
    ["b"] = { attemptsAllowed = 3, levels = {...}, timeLimit = 100, difficulty = 3 },
    ["a"] = { attemptsAllowed = 2, levels = {...}, timeLimit = 90, difficulty = 4 },
    ["s"] = { attemptsAllowed = 2, levels = {...}, timeLimit = 80, difficulty = 5 }
}

Config.VinscratchPlayerModifiers = {
    ["d"] = { difficulty = -1, speedBonus = 50, extraAttempts = 1 },
    ["c"] = { difficulty = 0, speedBonus = 0, extraAttempts = 0 },
    ["b"] = { difficulty = 1, speedBonus = -25, extraAttempts = 0 },
    ["a"] = { difficulty = 2, speedBonus = -50, extraAttempts = -1 },
    ["s"] = { difficulty = 3, speedBonus = -75, extraAttempts = -1 }
}

---

Fields Explained

Vinscratch per Class

Field	Description
attemptsAllowed	Maximum number of attempts per player for the class.
levels	Array of level configurations. Each level has:- sequence: number of steps to complete- unlock: steps required to succeed- speed: speed (ms) per step
timeLimit	Maximum time (seconds) to complete the vinscratch challenge.
difficulty	Base difficulty of the vinscratch minigame for the class.

Player Modifiers

Field	Description
difficulty	Adjusts base difficulty based on player skill or experience.
speedBonus	Positive or negative modifier to level speed (ms).
extraAttempts	Additional attempts granted or deducted from base attempts.

---

Notes

• Class-based difficulty ensures lower-tier vehicles are easier to vinscratch than higher-tier ones.

• Player modifiers allow for adaptive difficulty, making the minigame easier for beginners and challenging for experienced players.

• Levels define progressive sequences for realistic and scalable minigame challenges.

• Can be integrated with Vehicle Options, Minigames, and Missions to enforce class-specific gameplay