Your game, online in about three minutes. CheddaBoards Template is a complete, runnable Godot 4 project with leaderboards, achievements, sign-in and anti-cheat already built and wired. You bring a game scene; the template brings everything around it. No server, no database, no per-player fees — and it's MIT, so nothing about your project is locked in.
Quick start
- Open the project in Godot 4.6+ and run the Setup Wizard
(
addons/cheddaboards/SetupWizard.gd, File → Run) — paste your free API key and it configures everything, autoloads included - Build your game as its own scene (any root node type) and emit one signal when a run ends:
signal game_over(final_score: int, stats: Dictionary)
func _end_run():
game_over.emit(score, {"max_combo": max_combo})
- Point the wrapper at your scene (Game Scene Path in the Inspector) and export
The wrapper does the rest: game-over screen, score submission, achievement sync, anti-cheat session. A complete example game (CheddaClick) ships in the project as a working reference, and it runs out of the box so you can see everything live before writing a line.
What you get
- Game wrapper — loads your scene as a child, drives the HUD, game-over screen and submission from your signals
- Four-panel MainMenu — anonymous play with zero setup, Google / Apple sign-in via Device Code (QR on screen, no OAuth SDKs to bundle), and account linking that keeps all progress
- Players stay signed in — sessions persist across restarts; device code auth is a one-time flow, not a per-visit ritual
- Finished Leaderboard screen — All Time / Weekly / Daily tabs, automatic reset and archiving, sort by score or streak, the player's own rank highlighted
- Achievements engine — auto-unlock on score / combo / level / games-played, offline caching for anonymous players, popup notifications
- Anti-cheat — server-side play sessions and score validation; you set the caps from a dashboard, no code
- Mobile-ready — scrollable menus, display-cutout (notch) handling, compact leaderboard layout on phones
- Web-ready — HTML5 export tested, including itch.io iframe embeds
- Docs in the box — the full documentation set ships in the project
under
docs/, from a zero-experience getting-started guide to a raw REST API reference
This template is the full shell — your game just emits signals. The
only required one is game_over; three optional signals feed the live HUD
if you want it. The step-by-step
Build Your Own Game guide
walks the whole swap, including removing the example game.
Already have your own menus?
If your game already has its UI, you don't need the shell — grab the addon-only listing instead: CheddaBoards - Online Leaderboards is just the SDK, for wiring into your own screens. A REST API is also available for non-Godot engines.
Requirements
- Godot 4.6 or newer
- A free CheddaBoards account + API key from the dashboard at cheddaboards.com — the Setup Wizard handles the rest
Docs & support
- Documentation index
(also included in the project under
docs/) - Getting Started — zero Godot experience assumed
- Build Your Own Game
- Troubleshooting
- Website
MIT licensed. The template and SDK are fully open source; the hosted backend has a free tier with no per-player fees. Battle-tested — this exact stack runs our own live arcade games in production.
Changelog for version v2.2.4
No changelog provided for this version.