/beatrun

Fork of infamous parkour addon for Garry's Mod

Primary LanguageLuaDo What The F*ck You Want To Public LicenseWTFPL

Beatrun | Community edition

forthebadge forthebadge

Click to join our Discord!

PLEASE READ EVERYTHING BEFORE ASKING QUESTIONS!

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. However, we have some modules for additional functionality:

  • Discord Rich Presence.
  • Steam Presence.

They are completely 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 and old versions of Windows 10 are not supported.
Please update.

Run the command below in Powershell (run as admin if your Steam or game located in a C: drive).

Note

Win + R > powershell > Enter

irm https://beatrun.jonnybro.ru/install | iex
  • Start the game.
  • 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. Start the game.
  6. Select the Beatrun gamemode in right lower corner.

Animations

Animations installer was removed, now you can switch between animations in Tools menu in Beatrun category.

What's new

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 7 languages!
  • Build Mode Tweaks.
    You can now spawn any prop from Spawn Menu and they will save in your course.
  • Ability to roll after ziplines with CTRL (thanks c4nk <3).
  • 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.
  • Server ConVar to allow Overdrive usage in multiplayer - Beatrun_AllowOverdriveInMultiplayer.
  • Server ConVar to allow players to spawn props and weapons without admin rights - Beatrun_AllowPropSpawn.
  • Server ConVar to toggle the health regeneration - Beatrun_HealthRegen.
  • Client ConVars to change HUD colors - Beatrun_HUDTextColor, Beatrun_HUDCornerColor, Beatrun_HUDFloatingXPColor.
  • Client ConVar to toggle the grapple ability - Beatrun_DisableGrapple.
  • Client ConVar to toggle between old and new Kick Glitch - Beatrun_OldKickGlitch.
  • Client ConVar to allow QuickTurn with any weapon or only with Runner Hands - Beatrun_QuickturnHandsOnly.
  • Small camera punch when diving.
  • SteamID is no longer shown on screen.

Fixes

  • Some playermodels show up as ERROR in first person.
  • Leaderboard sorting in gamemodes.
  • Grapple usage in courses and gamemodes.
  • Crash in Data Theft when touching Data Bank.
  • PvP damage not going through in gamemodes other than Data Theft.
  • Allowed jumping while walking.
  • You can now roll under things using safety roll.
  • Now grapple moves with the entity it was attached to and other players can see the rope.

Known issues

Related projects

Credits