Awesome
BYAR-Chobby
BYAR mutator for Chobby
Download links
- [Windows] and [Linux] https://github.com/beyond-all-reason/BYAR-Chobby/releases
Developing the Lobby
-
Download using one of the links above and start the application.
-
Start the application once and launch the lobby. This will download the engine and other dependencies.
-
Open the install directory (there's a button for that in the launcher), and create a
games
directory, then clone this repository inside thegames
directory:
NOTE: The games
directory is data/games
under windows, and just games
under Linux.
git clone https://github.com/beyond-all-reason/BYAR-Chobby.git BYAR-Chobby.sdd
This should result in the following directory being present: /path/to/install/dir/data/games/BYAR-Chobby.sdd/
under . (Beyond-All-Reason\data\games\BYAR-Chobby.sdd\LuaMenu\configs\gameConfig
should be a correct path)
- Choose the
Dev Lobby
config from the launcher's top right dropdown menu which will run the lobby version on your PC. You can now develop and test any BYAR specific lobby functionality.
To enable debugmode, make an empty devmode.txt
in the already used game install directory (/data/
), and then the Settings/Developer
tab will appear in the lobby. All debug messages are visible in th Debug chat panel.
Developing the Game
-
Make sure you've first finished setting up the lobby development environment (previous section)
-
Open the install directory, and inside the
games
directory clone the BAR game repository:
git clone https://github.com/beyond-all-reason/Beyond-All-Reason.git BAR.sdd
-
Start Chobby with
Dev Lobby
config, open theSettings/Developer
tab and in theSingleplayer
option chooseBeyond All Reason Dev
. The application title should change toBeyond All Reason Dev
. -
Choose Skirmish as you normally would - this will put you in a match against one Null AI by default - and start it. This should start Beyond All Reason with your local development version. You should see
Beyond All Reason $VERSION
in your window title.
Tips for BYAR-Chobby development:
- Use Zerobrane Studio dev env, open up any chobby Beyond-All-Reason\data*.lua file with Zerobrane studio, then set Project->Project Directory->From current file
- This allows you to ctrl+shift+f to find any text in all of chobby, useful
- Open infolog.txt in notepad++ or anything to grep for errors.
How to make new launcher releases:
Note: Windows executables are signed, this procedure can be done only by one of the developers that have code signing cerificate.
-
Modify a file in the
dist_cfg
folder (https://github.com/beyond-all-reason/BYAR-Chobby/tree/master/dist_cfg) on themaster
branch to trigger a launcher build. It should start a new action here: https://github.com/beyond-all-reason/BYAR-Chobby/actions -
Wait until the build completely finishes (the action should be green and have a check), otherwise you might create an incomplete release.
-
Make a pre-release by finding the latest Draft here https://github.com/beyond-all-reason/BYAR-Chobby/releases, open it:
- click
Edit draft
- Mark it as "pre-release"
- then
Publish Release
- click
-
Use
build/sign_release.py
to sign the new launcher binary, e.g.python ./build/sign_release.py --signtool 'C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\signtool.exe' v1.1832.0
-
Edit release:
- replace the Windows executable and
latest.yml
file with the singed version and new generatedlatest.yml
- untick pre-release and mark it as latest release
- replace the Windows executable and
-
Send new download links to .exe and .AppImage to BAR discord #website so download links on website can be updated.
-
Note that pr-downloader is fetched from https://github.com/beyond-all-reason/spring-launcher