ScoreDrop
Home Documentation FAQ Features About

Questions

Everything you need to know about ScoreDrop

What is ScoreDrop?

ScoreDrop is a simple, modern leaderboard API designed for indie game developers. It allows you to add leaderboards to your games with just a few lines of code, supporting Unity, Godot, Unreal, HTML5, and many other platforms.

What do I get with my donation?

ScoreDrop offers a free plan and donor plans for additional features:

Free

$0
  • 20 max scores
  • Edit name
  • No delete
  • 30 requests/min

Basic

$5
  • 50 max scores
  • Edit name
  • 1 delete/day
  • 60 requests/min

Pro

$20
  • 100 max scores
  • Edit name
  • 5 deletes/day
  • 120 requests/min
  • Bulk delete (1/month)

Unlimited

$50+
  • 500 max scores
  • Edit name
  • Unlimited deletes
  • 300 requests/min
  • Bulk delete unlimited

All plans include rate limiting, player_id support, and full API access.

Will my players hit rate limits if my game becomes popular?

No! This is a common misunderstanding. The rate limit (e.g., 30 requests per minute) is per player (per IP), not per leaderboard.

This means:

  • Each player has their own limit – Player A can send 30 scores/min, Player B can send 30 scores/min, and so on.
  • It scales with your success – If you have 10,000 players, your game can handle up to 300,000 requests per minute (Free plan) without any issues.
  • It only prevents abuse – Stops a single player from spamming thousands of fake scores.

Example: With the Free plan (30/min per player), 1,000 active players can send 30,000 scores per minute total. That's more than enough for any indie game!

Higher plans (Basic, Pro, Unlimited) simply give each player more requests per minute – useful if your game sends scores very frequently (e.g., every few seconds).

What platforms do you support?

ScoreDrop works with any platform that can make HTTP requests. We have examples for:

  • Unity - UnityWebRequest
  • Godot - HTTPRequest
  • Unreal Engine - FHttpModule
  • HTML/JavaScript - fetch
  • Construct - AJAX
  • GameMaker - http_get
  • C++ - Any HTTP library
  • Python - requests
  • C# (.NET) - HttpClient

See our documentation for code examples.

How do I delete scores?

Deleting scores is available only in paid plans:

  • Basic: Delete 1 score per day
  • Pro: Delete 5 scores per day + bulk delete once per month
  • Unlimited: Unlimited deletes

Use the endpoint: /api/delete?key=YOUR_KEY&player_id=PLAYER_ID

For bulk delete: /api/delete?key=YOUR_KEY&all=true

What is player_id and why do I need it?

player_id is a unique identifier for each player in your game. It allows us to track the same player across multiple sessions and update their score only when it's higher.

You should generate this ID in your game (e.g., using UUID, player's Steam ID, or any unique string) and send it with every score.

Example: /api/add?key=XXX&player_id=player_123&player=Ana&score=500

What happens when I reach the score limit?

If your leaderboard reaches the maximum number of scores (e.g., 20 for free plan), new scores will only be accepted if they beat the lowest score in the current top. The lowest score is automatically replaced.

This ensures your leaderboard always shows the best scores.

How do I upgrade my plan?

After creating a leaderboard, you'll see a "Support ScoreDrop" section with PayPal buttons. Click on the plan you want, complete the payment, and your plan will be updated automatically.

Your leaderboard URL stays the same – you'll immediately get access to the new features.

Is my data safe?

Yes. Your API key is private and should never be shared. Only people with your unique leaderboard URL can view or submit scores. We also implement rate limiting to prevent abuse.

All data is stored securely in Supabase with regular backups.

Can I export my data?

Currently, you can view all scores via the API or the public leaderboard page. CSV export is planned for future releases (likely as a Pro feature).

Do you offer support?

Yes! For questions, issues, or feedback, you can reach us at Guardabarrancoestudioapp@gmail.com. We typically respond within 24-48 hours.

Can I create tutorials for ScoreDrop?

ABSOLUTELY! We'd love that!

ScoreDrop is designed to be simple enough for anyone to integrate, regardless of their game engine or programming language. If you create a tutorial (video, blog post, or code example) in any platform, we'll:

  • Feature it in our official documentation
  • Share it on our social media
  • Give you credit and link to your channel/blog

Currently we have official examples for Unity. We're looking for creators to make tutorials for:

  • Godot (GDScript or C#)
  • Unreal Engine (Blueprint or C++)
  • HTML5 / JavaScript
  • Python (PyGame, etc.)
  • Construct
  • GameMaker
  • C++ (any framework)
  • C# (.NET)

Contact us at Guardabarrancoestudioapp@gmail.com with your tutorial!