| Concept | What it is |
|---|---|
| Achievement | A milestone or reward that players unlock while playing, like "First Win" or "Score 1,000 Points." You define them in the dashboard and unlock them from your game. |
| API key | A secret token that lets the CLI and other tools act on your behalf. Create one in Developer Portal → API Keys. |
| Build | A versioned snapshot of your game's files. Every time you run wavedash build push, a new build is created. You can always roll back to an earlier one. |
| Leaderboard | A scoreboard for your game. You pick the name, sort order, and format — your game submits scores through the SDK, and Wavedash handles ranking. |
| Lobby | A room where players can gather before or during a game. Supports chat, invites, a member list, and connects to peer-to-peer networking automatically. |
| Player | Someone with a Wavedash account. They have a username, avatar, friends list, and game library. Your game can read their info with WavedashJS.getUser(). |
| Publish | Choosing which build players see when they open your game. Publish a new build to update, or publish an older one to roll back. |
| Sandbox | A local version of Wavedash that runs on your machine when you use wavedash dev. Great for testing SDK features like leaderboards and achievements before going live. |
| Session | The time between a player opening your game and leaving. Wavedash tracks sessions automatically so you can see how people play. |
| Stat | A number your game tracks per player — things like total kills, distance traveled, or games played. Stats persist between sessions and can automatically unlock achievements. |
| Store page | What players see when they find your game — the title, description, screenshots, trailers, tags, and price. You can update it anytime without pushing a new build. |
| Team | A group of developers who work on games together. Team members share access to builds, analytics, and settings. |
| UGC | User-generated content. Things players create and share — custom levels, replays, screenshots, mods. Your game decides what players can upload, and other players can browse and download it. |
| upload_dir | The folder on your computer that contains your game's built files. Set it in wavedash.toml — the CLI uses it for local testing and uploads. |
| WavedashJS | The SDK your game uses to talk to Wavedash. It's automatically available in the browser — no npm install needed. Godot and Unity have their own wrappers around it. |
| wavedash.toml | A small config file in your project that tells the CLI your game ID, where your build files are, and any engine-specific settings. |
Glossary
Key terms used across the docs, the Developer Portal, and the CLI.