Beatrun | Community edition

• Русский
  (If you can read English: This isn't maintained, I don't speak Russian)

PLEASE READ EVERYTHING BEFORE ASKING QUESTIONS ON OUR SERVER!

Infamous parkour gamemode for Garry's Mod.
Fully open sourced and maintained by the community (like 4 people I think).

Important

This repository does not contain any malicious modules whatsoever. These modules are present for more functionality however:

• Discord Rich Presence
• Steam Presence

They are optional and can be removed at any time.
You can find all compiled modules here in the repository.
Check Credits section for module source code.

Automatic Installation?

Not supported. I (LostTrackpad) am not going to set this up.¹

Manual Installation

Method 1: Repository download and extract (easy)

Note: <Garry's Mod game folder> is a placeholder for your Garry's Mod game folder.

1. Download this repository.
2. Delete the beatrun folder in <Garry's Mod game folder>/garrysmod/addons if you have one.
3. Extract the beatrun-main/beatrun folder to <Garry's Mod game folder>/garrysmod/addons.
   • If you want to have Discord and Steam Presence:
     • Extract the beatrun-main/lua folder to <Garry's Mod game folder>/garrysmod.
4. That's it, Beatrun is installed.

Method 2: Using Git and Directory Junctions (Windows 10+ Only!)

Warning

This method requires:

• A working and up to date installation of Windows 10 or above.
• A working and usable installation of Git for Windows on the system
• The drive volume you have Garry's Mod on must use a file system that supports Windows Directory Junctions (this will likely be NTFS)
  

Important

May work on Windows 7/8, but those versions of Windows are no longer supported! You really should upgrade if you're running either of those, and I will not provide support!

If you're ready and willing to use this method, read this guide to continue.

Animations

Please refer to this file.

New Features

Important

This version has lots of undocumented features and fixes. Look into the commit history if you wanna see all of them.

• Jonny_Bro (original fork creator) is hosting a custom course database, which is free² to use and also open source!
• New Deathmatch gamemode (it's definitely more fun than Data Theft trust us)
• "Proper" kick glitch just like in original game
  • Kick glitch behavior type toggle (yep, original kick glitch is still usable!) - Beatrun_OldKickGlitch to toggle
• In-game configuration menu - you can find it in the spawn menu, in the Beatrun category
  Most Beatrun settings can now be configured there! Use cvarlist beatrun_ to list all Beatrun options (and some commands), including some I didn't list
• Discord and Steam Presence (only Discord presence is new actually)
• Localization support.
  Now in 7 languages (mostly, some stuff is locked in English)!
• Dismounting from ladders with your duck key (default is CTRL)
• Removing ziplines created with Zipline Gun using your alternate fire bind (default is Right Mouse Button)
• Arrow that points to the next checkpoint
• Serverside option to enable Overdrive mode in multiplayer: Beatrun_AllowOverdriveInMultiplayer
• Serverside option to allow prop spawning without being an admin: Beatrun_AllowPropSpawn.
• Serverside toggle for health regeneration: Beatrun_HealthRegen
• You can change HUD colors (client only)! Use Beatrun_HUDTextColor, Beatrun_HUDCornerColor, and Beatrun_HUDFloatingXPColor
• Clientside to allow disabling the grapple: Beatrun_DisableGrapple.
• ConVar to allow QuickTurn with any weapon or only with Runner Hands (client) - Beatrun_QuickturnHandsOnly.
• Small camera punch when diving.
• Your Steam account ID/SteamID is no longer shown on screen

Some Older (?) Fixes

• Some playermodels showing up as ERROR
• Leaderboard sorting in gamemodes
• Allow using the grapple in Time Trial and gamemodes
• Crash in Data Theft when touching Data Bank
• Collision issues - PvP damage not going through in gamemodes other than Data Theft
• Allowed jumping while walking (don't ask me, Jonny did this...).
• Tweaked safety roll to allow rolling under stuff
• Some grapple tweaks (moves with attached entity, other players can see rope)

TODO

• Loadouts creation menu for Data Theft and Deathmatch. (I don't do UI stuff, I can't do this).

Known issues

• Issues on Jonny's original fork
  I'm not kidding, check there first for problems. Do not report issues with this fork there.

• Issues on this fork
  Report any issues with this fork here, and any feature requests you may want.

Related projects

• Beatrun Reanimated Project.

Credits

• All contributors for making Beatrun better
• EarthyKiller127 / datæ for making the original Beatrun gamemode (and obfuscating it and putting it into DLL files...really?)
• relaxtakenotes for even making all this possible
• MTB for Beatrun Reanimated Project
• Fluffy Servers for Discord Rich Presence module
• YuRaNnNzZZ for Steam Presence module

---

1. I already tried to set up a webserver on my PC. It failed. I don't want people spamming requests for the install script to my PC either, and I know Cloudflare is a thing. Maybe I'll try GitHub Pages? ↩︎

2. A Steam account with a copy of Garry's Mod is required. Ask them why if you're curious. ↩︎