Skip to content

Using the create‐project.py Script

Alex Neargarder edited this page Jun 29, 2025 · 2 revisions

Setup

First you'll want to make sure you've either cloned the Broforce-Templates repo, or alternatively you can use it as a template to create your own repo, by clicking the "Use this template" button:

image

which is what I would recommend.


Next, you'll want to set these environment variables:

  • BROFORCEPATH - Path to your Broforce installation (e.g., C:\Program Files (x86)\Steam\steamapps\common\Broforce)
  • REPOSPATH - Path to your repositories folder (the folder which contains your repo folder)

On Windows, you can do this like so:

image

And then add new user variables.

Using the Script

If you've created a repository using the Broforce-Template repo as a template, you can simply call it like so:

python .\Scripts\create-project.py -t bro -n "Your Bro's Name" -a "Your Name"

Otherwise, if you've created a separate repository to store only your bros. You'll want to make sure you've cloned the Broforce-Template repo and you have it and your new repo in the same folder. Then you can call it like so:

python .\Scripts\create-project.py -t bro -n "Your Bro's Name" -a "Your Name" -o "Name of your repository"

Note that the name you specify for -o shouldn't be a path, it should just be the name of your repo, and then the script will automatically find it, as long as it's located in the folder you specified in your REPOSPATH variable.

Loading your Bro In-Game

In order to see your bro in-game, you'll want to run the CREATE LINKS.bat script in the Releases folder as an administrator. Or if you created your own repo, you can just copy this script over to your repo's Releases folder and then run it.

This script simply creates a symbolic link in the BroMaker_Storage folder that points to your bro's folder in the Releases, so you can also do this manually if you want instead, the command would look something like this:

mklink /D "%BROFORCEPATH%\BroMaker_Storage\Captain Ameribro" "%REPOSPATH%\BroforceMods\Releases\Captain Ameribro\Captain Ameribro"


Then you need to open up the .sln file that was created by the script, which should be here: path to your repo\your bro's name\your bro's name.sln

And then you can build the solution, and your .dll will automatically be copied to your bro's folder in Releases (which is symlinked to BroMaker_Storage so it'll show up in-game).

If you've created your own repo rather than using the template, you'll need to also copy the libs folder, and the bro-pre-build.bat and bro-post-build.bat from the Scripts folder to your new repo, or else the build will fail. You should place the scripts in a folder called Scripts in your new repo as well.



Now you should be able to start up Broforce and see your bro in the BroMaker menu.

Clone this wiki locally