Project Proposal: KZ Global API
Hey everyone,
For the past few months, we've been working on an experiment called KZ Global API, and we're building it because we want to help modernize the scene, bring communities closer together, and give players and server owners features we’ve been missing. If you’re familiar with CS2KZ or CS:GO KZ, this follows the same core idea: runs completed on participating online servers feed into one shared global top.
There are many reasons for this, but I believe the current way of recording demos is not up to today’s standard, and people are not so interested in recording LAN demos on empty servers. Nowadays, people spend time playing with friends on online servers, and I believe that is the core of what unites us today. We want to unite the different communities and servers under one global leaderboard, and in the long term, potentially replace the current world-record system with records done on online servers.
Before we push this any further, we want to hear what you think, and find out whether server owners would actually want to join. I want to emphasize that this is not a project meant to give control to kreedz.com. It is purely open source: no one owns it, and it is driven by everyone here. The goal is not to replace every server with a generic one. The goal is to keep each server’s uniqueness, while providing a global, shared top so that anyone can record on any participating server and contribute to a shared purpose.
How it would work

For players:
-
Play anywhere. Set a time on any approved server and it counts on the global top. Pro and nub stay separate.
-
Live updates and bans. Servers can show the current best time on that top, and update when someone beats it on another server. A ban in the global system carries to the other participating servers. Switching community shouldn't be a way to keep setting times.
- See your stats and jump data: You'll be able to pull detailed stats about your runs, longjumps, and overall progress across all connected servers.
For server owners:
-
Keep your server as it is. We aren't asking you to switch to a new KZ mode. You keep your timer, your local top, your maps, your ranks, and your community.
-
Plug in and pull live data: Install a lightweight module to connect your server, and have your plugin reports finished, valid runs while keeping your local records intact. From there, your server can fetch the global top, current map records, global bans, and potentially even optional features like cross-server chat sync.
Open source and public data
I want to be straightforward about this because it's bound to come up: kreedz.com isn't trying to take over the scene. The entire codebase is open source, so anyone can read it, self-host it, or argue with how it works out in the open. We're happy to cover the servers and storage - since we already maintain a lot of the historical data - but paying for the hosting doesn't mean we own the data or dictate the rules.
The API will be public. Anyone can pull records, leaderboards, stats, replay files, and build a site, a Discord bot, or their own top, without asking us. We'll have our own page for the same data, with stats and replays you can watch in the browser. You can build your own as well.
The hard part
Getting different servers to agree is the real difficulty, and I won't pretend we have it solved.
Communities need to stay themselves. If every connected server turns into the same generic KZ server, we've failed. Two runs can only share a board if they mean roughly the same thing, though. Comparable physics, comparable settings, and the same idea of a legit run.
It gets messy in the places you already argue about:
-
Pause, movable objects, and breakables. Normal on one server, invalid on another.
-
mpbhop, entity reset, and the other mechanical differences.
-
A LAN demo and a time set on a live server are not the same thing.
- Anti-cheat verification
Those differences are real. They won't disappear because someone put them in a config file. So the goal is a shared global top, not a replacement for the world records we have today. Replacing those would be a separate, later step, and honestly the less likely one.
None of the rules are decided, and they shouldn't be decided behind closed doors at kreedz.com. A rulebook handed down from here will kill this before it starts. We need server owners, plugin authors, people who care about demos, and people who play, to find a baseline everyone can live with.
I also won't claim this is cheat-proof. No online KZ is. It's built around how people actually play, and it can get stricter later, in the open, with people watching.
The code is already public:
https://github.com/kreedzcom/cs16kz
https://github.com/kreedzcom/kz-global-api
A lot of the foundation is already built, but a global top with only two or three servers is just a test. It only holds weight if the 1.6 community actually wants it.
What we need from you
We aren't asking anyone to install anything, or to change how records work today. We first need you to share your opinion.
The form takes about a minute. It's there so we can gather your opinion on this topic. It asks what you think of a global top, what has to match before two times share a board, whether the tops already on servers should be merged, and which features you'd want.
Use the comments for anything that doesn't fit a choice. If you think the idea is good or bad, say why!
What happens next
We'll go through the form and the comments, discuss with you, then potentially talk to the communities that want to join the project. If a few server owners are up for it, we'll start small, on a baseline they can accept, and see how a live global top feels in practice.
If the replies say this won't work, or nobody wants in, we'll shelve it. We aren't going to force this on the scene by ourselves. Either way, we're just hoping to help make the scene a better place for everyone!
Thanks to fxr and GameChaos who participated to the early development of this project.