Beatrun | Community Edition

Join our Discord Community!

Русский | Russian

🚨 Important Notice

Please read this README thoroughly before asking questions

The only official source for this fork is this GitHub repository. Workshop versions are outdated and unsupported

Whoever else that claims to have an "official" repository and does not have a license other than WTFPL is NOT to be trusted. This project is not something legal, so licenses DO NOT apply under any circumstances. This repository is the original one and is maintained by the original people that cracked beatrun.

About

Beatrun is an infamous parkour addon for Garry's Mod, now fully open-sourced and maintained by the community. It includes various improvements, new features, and enhanced functionality.

Warning

This repository contains no malicious modules. However, optional modules such as Discord Rich Presence and Steam Presence are available for additional features. These are completely optional and can be removed at any time.

Modules are located here.

Refer to the Credits section for their source code.

Installation

🔧 Automatic Installation (Recommended for Windows 10/11)

Note

Windows 7 and old versions of Windows 10 are not supported. Please update your OS.

Run the following command in PowerShell (Run as Administrator if Steam and/or the game is installed on the system (C:) drive):

irm https://beatrun.jonnybro.ru/install | iex

Start the game.
Select the Beatrun gamemode in the bottom-right corner.

🛠️ Manual Installation

Download this repository.
Delete the beatrun folder in your_game_folder/garrysmod/addons, if it exists.
Extract beatrun-main/beatrun into your_game_folder/garrysmod/addons.
(Optional) For Discord and Steam Presence, extract beatrun-main/lua to your_game_folder/garrysmod.
Start the game.
Select the Beatrun gamemode in the bottom-right corner.

Features and Updates

New Features

Custom Courses Database hosted by Jonny_Bro: Access Here (free and open source).
New Gamemode: Deathmatch.
"Proper" Kick Glitch similar to the original game.
In-game configuration menu in the Tools menu under Beatrun. All settings can be modified here.
Localization support in 7 languages.
Enhanced Build Mode: spawn props from the Spawn Menu, and they will save in your course.
Various new abilities:
- Roll after ziplines: Press +duck (CTRL by default).
- Dismount ladders: Press +duck (CTRL by default).
- Remove ziplines created with Zipline Gun: Press +attack2 (RMB by default).
- Next checkpoint arrow for easier navigation.
New server and client configuration variables:
- Server:
  - Beatrun_AllowOverdriveInMultiplayer: Allows Overdrive in multiplayer.
  - Beatrun_AllowPropSpawn: Lets players spawn props and weapons without admin rights.
  - Beatrun_HealthRegen: Toggles health regeneration.
- Client:
  - Beatrun_HUDTextColor, Beatrun_HUDCornerColor, Beatrun_HUDFloatingXPColor: Customize HUD colors.
  - Beatrun_DisableGrapple: Toggle the grapple ability.
  - Beatrun_OldKickGlitch: Switch between old and new Kick Glitch.
  - Beatrun_QuickturnHandsOnly: Restrict QuickTurn to the Runner Hands weapon.
Other improvements:
- Small camera punch effect when diving.
- SteamID no longer displayed on screen.

Fixes

Fixed playermodels showing as ERROR in first person.
Improved leaderboard sorting in gamemodes.
Fixed crashes and issues with Data Theft gamemode.
Enabled jumping while walking.
Grapples now follow moving entities and are visible to other players.

Animations

The animations installer has been removed. You can now switch animations directly in the Tools menu under the Beatrun category.

Known Issues

See the full list of issues here.

Beatrun Reanimated Project

Credits

All contributors ❤️
EarthyKiller127/datae - Original creator of Beatrun.
relaxtakenotes - Made this project possible.
MTB - Beatrun Reanimated Project.
Fluffy Servers - Discord Rich Presence.
YuRaNnNzZZ - Steam Presence (TFA Base creator).

5.2 KiB Raw Blame History