Authentication
The plugin checks whether your Roblox account is allowed in when Studio loads. New accounts get a free 7-day trial automatically; after that, the plugin nags you to whitelist permanently.
Four ways to whitelist. Pick the one that suits how you want to pay.
The 7-day trial
Section titled “The 7-day trial”A 7-day trial starts automatically the first time the plugin loads on your account. Full functionality during the trial — no purchase needed to try.
When the trial ends, a centered dialog appears on plugin load: Trial Expired, with three buttons — Purchase ($20) (opens the Gumroad page), I Already Purchased (re-checks if you whitelisted on a different route since), and Close. Closing leaves the plugin disabled until you whitelist via one of the routes below.
Whitelist routes
Section titled “Whitelist routes”Route 1 — Gumroad ($20 USD)
Section titled “Route 1 — Gumroad ($20 USD)”- Go to qwinkletee.gumroad.com/l/qwinklesparticles2
- Enter your Roblox User ID in the custom field during checkout
The Gumroad webhook auto-whitelists the moment the purchase completes — no manual step on your end. You’ll see the banner clear on the next plugin load.
If you typo the User ID, message me on Discord with proof of purchase.
Route 2 — Ko-fi
Section titled “Route 2 — Ko-fi”Donate any amount on the ko-fi.com/qwinkletee page. Include your Roblox User ID in the donation message field. Same webhook flow as Gumroad — auto-whitelists when the donation lands.
Route 3 — Roblox (8000 Robux)
Section titled “Route 3 — Roblox (8000 Robux)”Two equivalent options:
- Gamepass — buy at roblox.com/game-pass/1779373735/Qwinkles-PartIcles-2
- Shirt (alternate route at the same price) — roblox.com/catalog/94767567168940/QP2
Then run /whitelist in the Discord server’s bot channel. The bot links to your Roblox account via Bloxlink (you’ll be asked to connect it the first time), checks your purchase, and adds you to the allowlist. You also get the Customer Discord role.
The Discord route has a 60-second cooldown per user to prevent spam.
Route 4 — Already whitelisted
Section titled “Route 4 — Already whitelisted”If you bought the plugin before this auth system existed, your User ID is on the legacy whitelist. The plugin works without further action.
Verifying
Section titled “Verifying”The plugin shows a small banner on the HUD only while you’re in the trial period — Trial: N day(s) left. Whitelisted users see no banner; the plugin loads normally. Expired users see the centered dialog described above.
For more detail, check Studio’s Output console after the plugin loads. The auth result is printed there: [Part-Icles] Trial active: N day(s) remaining. or [Part-Icles] <status>: <reason> (where <status> is expired, blacklist, or greylist). Whitelisted accounts print nothing.
If you just bought via Gumroad / Ko-fi / Roblox and Studio still shows the expired dialog, click I Already Purchased to force a re-check rather than restarting Studio.
If it still shows expired after that: the purchase may not have linked correctly to your User ID. Re-check what you submitted at checkout, or message me on Discord.
What’s next
Section titled “What’s next”If you’ve followed Install and the plugin’s running, Hello, Particles is the next stop.