Skip to content

Latest commit

 

History

History
125 lines (87 loc) · 4.9 KB

README.md

File metadata and controls

125 lines (87 loc) · 4.9 KB
Raw

Beatrun | Community Edition

Powered by Electricity Powered by Black Magic

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

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
  1. Start the game.
  2. Select the Beatrun gamemode in the bottom-right corner.

🛠️ Manual Installation

  1. Download this repository.
  2. Delete the beatrun folder in your_game_folder/garrysmod/addons, if it exists.
  3. Extract beatrun-main/beatrun into your_game_folder/garrysmod/addons.
  4. (Optional) For Discord and Steam Presence, extract beatrun-main/lua to your_game_folder/garrysmod.
  5. Start the game.
  6. 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.

Related Projects

Credits