[DanZay]

CS:GO KZ Redefined
Initial Release: 2018/1/9

GOKZ a set of plugins exclusively for CS:GO servers. It implements the KZ (Kreedz) game mode, which involves speedrunning through custom maps.


Features

• Timer - Times runs by automatically detecting the use of start and end buttons in KZ maps.
• Movement Modes - Custom movement mechanics. Includes Vanilla, SimpleKZ, and KZTimer modes.
  • Mode plugins can be used alone (with only MovementAPI) to apply their mechanics at all times.
• Jumpstats - Detailed statistics of your jumps and each individual air strafe.
• Customisable Experience - Tonnes of options to provide the best possible experience for players.
• Database Support - Store run times, options and more using either a MySQL or SQLite database.
• GlobalAPI Support - Submit run times to the GlobalAPI so that players may compete across servers.
• Replays - Record replays of the server's fastest times and use bots to play them back.
• Anti-Macro - Detect and auto-ban blatant users of bhop macros and cheats (SourceBans++ supported).
• Map bonus support, HUD, teleport menu, noclip, !goto, !measure and much, much more.

Here's a short video showcase of some features: https://youtu.be/2gtDnNFkz0U

Visit the repository for up-to-date information including current features, installation instructions and download links.


Repository & Download

https://bitbucket.org/kztimerglobalteam/gokz


Support

The CS:GO KZ Discord is the best place to ask questions, get help, and discuss KZ.

I don't check this thread regularly. Please feel free to instead message me directly on Steam or find me in the Discord.


Bugs and Contributing

Creating issues on the BitBucket is the best way to report bugs. Requests for new features can also be reported as issues.

Any bug reports, feedback and, of course, contributions are greatly appreciated. Those who wish to contribute code should read the contributing guidelines at the BitBucket.

Anyone in the community who would be keen to work closely with the 'KZ Global Team' and I to develop exciting new plugin features, web apps and services should hit us up in the CS:GO KZ Discord.


Some Cool, Related Links

WebGL GOKZ Replay Player - https://github.com/Metapyziks/GOKZReplayViewer
Very, VERY cool prototype of parsing the GOKZ replay files and playing them back in a browser with high, in-game-like quality and framerate.

MovementAPI - https://github.com/danzayau/MovementAPI
The modes and some other features of GOKZ are heavily dependent on MovementAPI, which is a library+plugin I wrote primarily for GOKZ.
You may find this interesting or useful, or maybe not so much when compared to other libaries like smlib.

GlobalAPI - https://global-api.com/
Heavily in-development REST API with accompanying SourceMod plugin to provide global leaderboards, map lists and ban lists for timer plugins. This is used by GOKZ.

GOKZ Stats - https://gokzstats.com/
Simple website showing global times for the three GOKZ modes (data comes from GlobalAPI).


Acknowledgements

1NutWunDeR - KZTimer initial work
KZ Global Team - supporting the plugin alongside KZTimer
shavit - bhoptimer being open-source
george - providing advice, snippets
sneaK - getting involved with the CS:GO KZ community
ziks - WebGL Replay Player being awesome


Developer Ramblings

Spoiler

GOKZ actually started under the name of SimpleKZ (https://github.com/danzayau/SimpleKZ). Back then, I was only really getting into the swing of programming and it was also my first SourcePawn project. Unfortunately, but hopefully interestingly, I picked up some unconventional and maybe bad habits regarding the way I structured the files and code for the plugin. I like maintaining it so I think I'd call it good enough.

Anyway, so KZTimer was the dominant, 'only choice' of KZ plugin for CS:GO servers. And, at the time of writing, still is. I had issues with it gameplay wise - the inconsistent bhop mechanics of CS:GO were getting on my nerves when speedrunning. Eventually I set out to write my own proof of concept of some more preferable movement mechanics (https://github.com/danzayau/MovementTweaker). Unfortunately, KZTimer being written the way it is, I had no way of putting this in as a selectable option whilst maintaining my sanity. Another developer had also been hinting that they were going to release a new 'KZTimer 2.0' but unfortunately didn't end up having the time. So, I went ahead to take on the challenge of creating a new alternative to KZTimer with my movement mechanics as an option. Cue SimpleKZ and then later getting accepted by the heads of the KZTimer community to create GOKZ as the future of KZTimer.

Timer plugins seem to be a bit of a cliche in the SourceMod community, but it would seem that most target bhop and surf servers. KZ doesn't have a lot of the intricacies like directional styles (e.g. backwards, sideways), zones and stages, detailed strafing stats. KZ also has a few unique features like a checkpoint and teleport system, hooks to buttons in the map, and jumpstats (to an extent). I probably could have forked or extended an existing timer plugin to support KZ, but the truth is I didn't really consider it. I very quickly locked myself into writing a plugin from scratch. Regardless, I owe many thanks to several members of the community for technical inspiration and, in some cases, full code snippets.

So, thank you AlliedModders/SourceMod community. Please enjoy my contribution made possible by you.

[mug1wara]

cool

[rogeraabbccdd]

Nice release

[beastedout]

Nice!!

[sneaK]

Now THIS is a release! Glad to see GOKZ finally make it here

[Cruze]

[OfficialSikari]

Link to MovementAPI is broken.

[_GamerX]

Awesome

[DanZay]

Originally Posted by OfficialSikari Link to MovementAPI is broken.

Thanks.

[maningrey]

public void Zone_OnClientLeave(int client, const char[] zone)
{
	if(StrContains(zone, "[zone name_1]", false) == 0)
	{
		GOKZ_StartTimer(client, 0);
	}
}



public void Zone_OnClientEntry(int client, const char[] zone)
{
	if(StrContains(zone, "[zone name_2]", false) == 0)
	{
		GOKZ_EndTimer(client, 0);
	}

	if(StrContains(zone, "[zone name_1]", false) == 0)
	{
			
		TimerStop(client);
	}
}

Im very bad at this, sorry. With regards to https://forums.alliedmods.net/showthread.php?p=2023591, how could one start the timer by leaving the zone and have it successfully finish also?