Making your own OpenBullet mod
I am writing this guide for people who never used git.
I will assume you:
- use Windows (64-bit)
- have Visual Studio 2017 or 2019 installed on your computer
- have an account on https://github.com
- know how to code in C#
You need to take the following steps:
Visit the openbullet repository here https://github.com/openbullet/openbullet
After that, press the
forkbutton on the top right corner. This will basically make a copy of the repository for yourself that you can modify at your own will.
Install git from here https://github.com/git-for-windows/git/releases/download/v2.21.0.windows.1/Git-2.21.0-64-bit.exe and, when asked, select the full install and leave all the default options except for the text editor. As far as I can remember the default text editor that the installer suggests is
vimbut it might not be suitable for newcomers so you should select something graphical like Notepad++ or Sublime (you need to have them installed of course).
Go to the folder
YOUR_USERNAMEis your actual user) and right click on an empty area, then select
Open Git Bash here. A terminal window will open.
git clone https://github.com/YOUR_GITHUB_USERNAME/openbulletand press enter (replace
YOUR_GITHUB_USERNAMEwith your actual username of course). This will start pulling all the files from your forked repository to your local computer so you can work with them.
OpenBullet.slnfile with Visual Studio. Once you are inside, make a small change just to start you off (for example you could simply change the program name from
OpenBullet [My Mod]). Then save all the files you edited.
Back to the git bash terminal, type:
git add --allwhich will add all the changed files to the commit we're going to make
git commit -m "Changed the program title"which will make a commit with the desired commit message
git push -u origin masterwhich will push all the new commits to your repository.
At the last command, git bash will most certainly ask for your github username and password, which you will need to provide in order to give it writing permissions to your repository.
At this point you can go search how to merge the changes I make on the master repository into your own fork, it's just a google search away and it will be a nice learning experience :]