Built for real servers

Everything under the hood

MultiSeason is a small platform with a serious core: tenant isolation, automated TLS, account-free sign-in and a reliable reward pipeline.

How a reward travels

From click to chest, without trusting the browser.

01

Player acts

The page calls the site's own API with a CSRF token and the remembered session.

02

Rules enforced

In one transaction: cooldown or bonus spin, calendar date, one claim per door, weighted draw.

03

Claim queued

The prize becomes a pending delivery. Messages, spins and webhooks finish instantly.

04

Server delivers

The plugin fetches the queue, runs allowed commands as console and acknowledges each one.

Multi-tenant core

  • Host-based tenancy. Every request is mapped to a site by its Host header: a verified custom domain first, then slug.platform. Unknown hosts get a 404.
  • One canonical address per site. Switch between subdomain and custom domain in Settings; the other address 301-redirects to it.
  • Hard data isolation. Every query is scoped by site and server; sessions and cookies are host-only; each server has its own API token.
  • Suspension at the edge. A suspended site gets a branded page, a 403 on every API call, and a read-only dashboard.

Networks and the portal

  • Many servers, one site. Add Survival, Skyblock, a lobby and more. Each server has its own token, rewards, wheel, calendar and claims.
  • Spins are never global. Cooldowns and bonus spins are stored per player, per server, so a spin on one server does not use up another.
  • The server is in the URL. Every server lives at /survival. With two or more servers the root URL becomes a portal showing status and what is waiting for the signed-in player.
  • One sign-in for the network. A player signs in once; /wheel on each server opens that server's own page.
  • Safe addressing. Reserved words are blocked, addresses are unique per site, and a disabled server disappears from the portal and is shut out of the API.

Domains and TLS automation

  • Ownership proof. Custom domains are verified through a DNS TXT record bound to the site and the app key.
  • Per-host nginx and certificates. A root helper writes the vhost and requests a Let's Encrypt certificate (HTTP-01, webroot) for each host.
  • Safe by construction. Strict hostname validation, nginx -t before every reload, automatic rollback, and hand-made vhosts are never overwritten.
  • Least privilege. The web user can run exactly three helper verbs through sudo. Nothing else touches /etc.
  • Live verification. DNS, wildcard DNS, HTTPS reachability, vhost and certificate expiry are checked from the owner panel.

Identity without accounts

  • No emails, no passwords. Players and owners are signed in by single-use links created by the Minecraft plugin (10 and 5 minute lifetime).
  • 30-day remembered login. Stored as a SHA-256 hash; the cookie is HttpOnly, SameSite=Lax and Secure.
  • Personal recovery token. Looked up by hash, shown from an encrypted copy, regenerable (which signs out every browser).
  • Separate platform owner. php artisan scy:owner issues a one-time link; --revoke ends every owner session on any session driver.
  • Rate limits and CSRF on sign-in, token entry, spinning, door opening and the API.

Rewards engine

  • Weighted wheel. Odds use a cryptographic RNG inside a transaction with a row lock on the player, so double clicks and parallel tabs cannot double-spin.
  • Advent calendar. Timezone-aware unlocking, optional catch-up for missed days, one claim per door.
  • Five reward types. Console commands (multi-line, %player% and %uuid%), chat message, bonus spins, webhook (JSON POST) and nothing.
  • At-least-once delivery queue. Claims stay pending until the server acknowledges them; offline players receive rewards when they join.
  • Bonus spins API for votes, store purchases and events.

Minecraft plugin

  • Asynchronous by design. All web calls run off the main thread; commands run on it, only for online players.
  • Command blocklist. Dangerous commands (op, stop, ban, lp …) are refused even if a reward defines them.
  • Token connection. One command connects a server; the dashboard shows server name, plugin version and last-seen time. Every server of a network has its own token.
  • Messages from the dashboard. Chat text is fetched from the website with a revision check and applied without a restart. Placeholders include <player> <reward> <url> <site> <server>.
  • Works with your stack. Built for Paper 26.x next to LuckPerms, EssentialsX, ProtocolLib, TAB, ViaVersion and ViaBackwards.

Customisation

  • Eleven presets. Winter, Candy Cane, Neon, Cabin, Minimal and six seasons: Halloween, Autumn, Spring, Summer, Valentine's and New Year. Save your own and share them with other sites.
  • Theme builder. A visual editor with live preview for colours, fonts, corner radius, effects, wheel and door styles and texts.
  • Export and import. Themes are portable JSON files. Imports are checked against a schema, so unknown or unsafe values are dropped.
  • Seasonal effects. Snow, falling leaves, Halloween bats and embers, petals, fireflies, hearts, fireworks, stars and rain, switched off for visitors who prefer reduced motion.
  • Theme engine. Every theme value becomes a CSS variable, so Tailwind CSS v4 utilities, your own CSS and your own JavaScript all follow the theme. HTML blocks and <head> are editable too.
  • Polished scrolling. Themed scrollbar, smooth anchor scrolling, a scroll progress bar and reveal animations.
  • Event API. MultiSeason.on('spin:result', …) and friends for custom effects.
  • Messages with HEX. MiniMessage, <#rrggbb>, &#rrggbb, legacy codes and gradients, with a live chat preview.
  • Languages. English, Română, Deutsch, Español and Français, a default per site, a switcher for players, and editable text.
  • Icons. 28 pixel-art Minecraft items plus your own PNG, JPEG, WebP or GIF uploads, shown on the wheel, on every calendar door and in the reward popup.

Hardening

  • Uploads are inspected, not trusted: real image sniffing, four allowed formats, size and dimension caps, served with nosniff and a sandbox CSP. No SVG.
  • Sanitised theming. Theme values that could break out of CSS are dropped; boot data is embedded with tag escaping.
  • Hashed secrets. Player remember tokens and owner links are stored as hashes; plugin tokens can be rotated instantly.
  • Suspension and rotation take effect on the next request, with no cache to flush.

Operations

  • Owner alerts. Publish a message to all sites or selected ones. It shows on every site dashboard and in Minecraft: in the console at startup, to players with the multiseason.alerts permission when they join, and live when published.
  • Audit log. Owner sign-ins, suspensions, token rotations, address changes, alerts, server changes, provisioning and deletions.
  • Owner panel. Fleet overview, search and filters, per-site detail, domains and TLS, announcements shown on every dashboard.
  • Command palette. Ctrl K jumps to any page or action.
  • REST API. Player state, login links, bonus spins, delivery queue and plugin configuration.
  • Test suite. Tenant routing, isolation, tokens, suspension, uploads, messages and the language system are covered by automated tests.
© 2026 MultiSeason