Skip to content

Custom Client to achieve a working 1.27 GTA V for everyone on PC

License

Notifications You must be signed in to change notification settings

TwosHusbandS/Project-127

Repository files navigation

Discord Twitter MIT License Maintained Installer Help Features


Logo

Project 1.27 aka. P127

Custom Client / Launcher for Speedrunning GTA.
View Demo . Contact me . Changelog

Table of Contents
  1. About Project 1.27
  2. Roadmap
  3. Contributing
  4. License
  5. Shoutouts and Credits
  6. Contact

About The Project

Hi! This is a custom Client which was originally created to give all Speedrunners the capability of launching the Downgraded GTA Version 1.27.

Over time it grew with Features and Launch - Capabilities

Note:

Project 1.27 now has the stability, user experience and core features we envisioned at the start of this project. While @dr490n and me (@thS / TwosHusbandS) both have ideas for potentially improvements and we may get around to working on them at some point, Project 1.27 is not under active development as of this very second (June 2024). Big bugfixes etc. will still happen if needed, but we are making no promises either way. We want to thank everyone who has been a part of this incredible journey.

Help, How to get started, Support & Contact

Main Features

Built With

Pretty much built with straight C# visualized with WPF

  • Installer built using InnoSetup
  • Some componments, mostly in regards to the Game Launch are closed source and written in C / C++
  • The logging into your Social Club account is achieved by:

Installation

User Instructions:

  • Get your GTA V Installation to an Up-To-Date State and launch the latest Version online to confirm that its working.
  • Grab the latest Installer from the Installer folder
  • This Program does automatically detect the current State of the Installation (Downgraded or Upgraded) and launches the Game accordingly.
  • Windows 10 Checks all Files for Viruses if they are run for the first time. If you open a file (the Installer or the Program) for the first time, please give it some time (up to 15 seconds) to do so, and just wait.
  • This Program only supports 64 Bit at this Point and probably will never support 32 Bit. Seeing as GTA V only supports 64 Bit (AFAIK), and I doubt you can have a good time playing GTA V on less than 4 GB of RAM, this will probably stay this way.
  • This Program also requires Admin-Rights for File Operations and Accessing the Registry for Settings. You do not need to start it as Admin, you will get the UserAccessControl Popup regardless of how this was started.
  • Please actually Read the Popups the Program gives you
  • In order to fully remove this Program and all of its files and settings click the Uninstall Button inside the Settings Window.
  • Changelogs can be found here
  • If something is not working and you are contact me, I would appreciate the LogFile and the DebugFile, which are both in the InstallationFolder of this Program
  • Read the Help Section if something is not working.

Advanced User Instructions:

  • Settings are in: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Project_127 in the Registry
  • The Files this Program needs (apart from the Client itself) are saved in a folder called "Project_127_Files" inside the Folder which you selected to use for ZIP File Extracting.
    • By default it recommends you to use your GTA Installation for that.
    • Again: Use your GTA Installation Folder for this.
  • Theres a lot of stuff you can rightclick. I mean. A lot.
  • A lot of "advanced user" stuff is explained here
  • There are also explanations for the Note Overlay as well as an Advanced Patcher Guide

Roadmap

Project 1.27 is not being actively developed at this stage.

It will continue to receive BugFixes and Hotfixes if needed.


Contributing

To get a local copy up and running follow these simple example steps.

  • Clone the Github Repo.
  • Pray Nuget does its magic.
  • Press F5.
  • In Order to check how stuff is connected id just recommend following User Actions and seeing what Methods are called.
  • The whole Project ...historically grew a lot, and it shows.
  • Some of the Code (especially XAML / GUI related) is not the best looking and far from best practice.
  • If you can think of Improvements or new Features feel free to make a Pull Request or contact me.
  • Can always use an extra pair of eyes to make sure I dont do anything stupid.

License

Distributed under the MIT License. See LICENSE for more information.


Shoutouts and Credits

  • Project 1.27 Launcher / Client Programming, Documentating: @thS
  • Reverse Engineering: @dr490n, @Special For, @zCri, @Gogsi
  • Launcher GUI Design & Artwork: @hossel
  • Special thanks to: @JakeMiester, @Antibones, @Aperture, @MOMO
  • GOGSI THE GOAT. Very special shoutouts to @Gogsi not only for being awesome and a pleasure to work with but also for continuing to reverse-engineer, help with information, provide fixes and PRs. Very much appreciated.
  • Special shoutouts to @dr490n, who was responsible for getting the downgraded game to launch, adding patches against in-game triggers, writing the Overlay Backend, writing the Download Manager Backend, Writing the Launch-Through-Socialclub launch process, Authentication backend, decryption and managed to get the preorder entitlement to work.
  • Special shoutouts to @special for, for being there during the whole development phase, providing valuable insight, being available to bounce ideas off of, being available for brainstorming, and providing valuable help in regards to reverse engineering the GTA V Launch Process. We could not have done this without you.
  • Also thanks to @special for, for implementing the ability to downgrade GTA to Version 1.24 via the DragonEmu into P127 by figuring out how P127 GUI and backend logic works and how my component manager and dr490ns download manager handles things.
  • Shoutout to FiveM and Goldberg, whose Source Code proved to be vital to understand and reverse engineer the GTA V Launch Process
  • Shoutout to @Fro for providing Hosting to the Files needed for Project 1.27. Youre an absolute legend
  • Shoutout to @yoshi for providing the Information which Build Version corresponds with which Game Version
  • Shoutout to @Gogsi for being awesome and a pleasure to work with
  • Shoutout to @Diamondo25 for finding a way to launch GTA without going through LaunchGTAV.exe or PlayGTAV.exe, which eased the development process to launch through Social Club
  • Shoutout to @AntherXx for making the incredible P127 Demo + Help Video, as well as going through the trouble of tracking down and renaming SaveFiles for every single Mission in Classic% and to @Hossel for providing the SaveFiles for the main Categories
  • Shoutout to @DaWolf85 for open sourcing his GTAVAutoPatcher Tool the Community used to Upgrade / Downgrade previously.It helped us a ton.
  • Shoutout to @Hoxi and @Special For for implementing and integrating the ReturningPlayerBonus toggle on dr490n emu.
  • Shoutout to @cuzbabytonight on community.pcgamingwiki.com (and hoxi I think) for figuring out which DLC Folders are safe to delete when on 1.27.
  • Shoutout to @Rayope for finding a Bug, fixing it himself, and providing us with the solution. Thanks mate. (P127 crashing on MTL Token Gen when losing internet after P127 Startup)
  • Shoutout to @burhac, @Crapideot, @GearsOfW, @rollschuh2282, @Ollie, @Alfie, and the aforementioned people for being awesome members of the GTA Speedrunning community, always being nice and respectful, and providing Help / Testing. You guys are much appreciated.

Contact

Twitter - @thsBizz

Project Link - github.com/TwosHusbandS/Project-127

Discord - @ths_was_taken

About

Custom Client to achieve a working 1.27 GTA V for everyone on PC

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages