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