Skip to content

JonnyBro/beatrun

Repository files navigation

Beatrun | Community edition

PLEASE READ EVERYTHING BEFORE ASKING QUESTIONS ON OUR SERVER!
WE DOCUMENTED EVERYTHING ENOUGH SO YOU CAN INSTALL THIS YOURSELF PRETTY EASILY

Infamous parkour addon for Garry's Mod.
Fully open sourced and maintained by the community (me 😞).

Important

This repository doesn't contain any malicious modules. It does contain some modules for additional functionality like:

  • Discord Rich Presence.
  • Steam Presence.

They are optional and can be removed at any time.
You can find all modules here.
Check Credits section for their source code.

Automatic Installation (Recommended | Windows 10/11)

Warning

Windows 7 is not supported.
Update already...

Run the command below in Powershell.

Note

Win + R > powershell > Enter

iex (iwr "beatrun.ru/install" -UseBasicParsing)
  • Select the Beatrun gamemode in right lower corner.

Manual Installation

  1. Download this repository.
  2. Delete the beatrun folder in your_game_folder/garrysmod/addons if you have one.
  3. Extract the beatrun-main/beatrun folder to your_game_folder/garrysmod/addons.
  4. If you want to have Discord and Steam Presence:
    • Extract the beatrun-main/lua folder to your_game_folder/garrysmod.
  5. Select the Beatrun gamemode in right lower corner.

Animations

Please refer to this file.

Features

Important

There are many undocumented changes and fixes in this version, you better look at the commits for more specific changes.

  • Jonny_Bro is hosting custom courses database, which is also free to use and open sourced!
  • New gamemode - Deathmatch (it's way more fun than Data Theft I promise).
  • "Proper" Kick Glitch just like in original game.
  • In-game configuration menu - you can find it in the tools menu, in the Beatrun category.
    All of the Beatrun settings can be changed in the configuration menu!
  • Discord and Steam Presence.
  • Localization support.
    Available in 5 languages now!
  • Build Mode Tweaks.
    You can now spawn any prop from Spawn Menu and they will save in your course.
  • Ability to get off of ladders - Press CTRL.
  • Ability to remove ziplines that created with Zipline Gun - Press RMB.
  • Arrow that shows the next checkpoint.
  • ConVar to allow Overdrive usage (server) - Beatrun_AllowOverdriveInMultiplayer.
  • ConVar to allow players to spawn props and weapons without admin rights (server) - Beatrun_AllowPropSpawn.
  • ConVar to toggle the heatlh regeneration (server) - Beatrun_HealthRegen.
  • ConVars to change HUD colors (client) - Beatrun_HUDTextColor, Beatrun_HUDCornerColor, Beatrun_HUDFloatingXPColor.
  • ConVar to toggle the grapple ability (client) - Beatrun_DisableGrapple.
  • ConVar to toggle between old and new Kick Glitch (client) - Beatrun_OldKickGlitch.
  • ConVar to allow QuickTurn with any weapon or only with Runner Hands (client) - Beatrun_QuickturnHandsOnly.
  • Small camera punch when diving.
  • Your SteamID on the screen is no longer present.

Fixes

  • Some playermodels show up as ERROR.
  • Leaderboard sorting in gamemodes.
  • Grapple usage in courses and gamemodes.
  • Crash in Data Theft when touching Data Bank.
  • Collisions issues - PvP damage not going through in gamemodes other than Data Theft.
  • Allowed jumping while walking (🤷).
  • Tweaked safety roll - now you can roll under things.
  • Tweaked some grapple related stuff - now it moves with the entity it was attached to and other players can see the rope.

TODO

  • Loadouts creation menu for Data Theft and Deathmatch. (idk how to properly implement this for know).

Known issues

  • Issues.
  • Maybe more, i forgor 💀.

Related projects

Credits