boonGUI

User interface mod for the RTS game 0 A.D.

Website | GitHub | Project Overview | FAQ

---

Featured v2.1

Featured v2.0.2

---

Features

• Main menu
  • Cheat codes accessible through the game manual.
  • New background image
• Camera
  • Enter the view of a unit via a hotkey.
  • Change the camera settings in the options.
• In-Game
  • All fruits are more vivid and easier to see due to the increased saturation and brightness, some have also had their hue changed.
  • Chicken are 50% larger and fish were colored red.
  • Increased the size of weapon projectiles and the garrison flag on buildings.
  • All player colors are more vivid and easier to see on the minimap.
  • Larger buttons in the selection panel.
  • Larger and redesigned round minimap. The idle button displays the total number of idle workers.
  • Additional ingame stats about the players.
  • Rally points are displayed for observers.
  • Timestamp notifications for players moving up a phase or completing one.
  • The HUD in the centre shows the values of the individual units. Relics show their auras and treasures their contents.
  • Option to skip the summary screen after a game ends.
  • All civilian houses/apartments have a garrison flag.
  • All heroes have a large visible object flowing over their head, making them easier to see on the battlefield.
  • Sound notification for the death of a hero.
• Lobby
  • Quick access buttons below the chat input.
  • Rating dependent icon & title for the profile.
  • Layout rearrangements to improve the overall experience.
• Replay screen
  • Adding a button next to the replay file path to quickly open the directory.
• Summary screen
  • Increased the size, recommend to use a 1920x1080 display.

---

Installation

git clone https://github.com/LangLangBart/boonGUI.git

• Place it in your /0ad/mods/ folder:
  • Linux: ~/.local/share/0ad/mods/
  • macOS: ~/Library/Application\ Support/0ad/mods/
  • Windows: ~\Documents\My Games\0ad\mods\
• Launch 0 A.D., click Settings and Mod Selection.
• Double-click boonGUI, click Save Configuration and Start Mods.

Convenient installation

Arch and Manjaro Linux users

You can skip the above steps and install the boonGUI package from the AUR.

macOS Installer

Paste it into your macOS terminal and press enter. The mod will be downloaded and placed in the correct 0ad mods folder.

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/LangLangBart/boonGUI/main/.github/build_scripts/macOS_installer.sh)"

---

Contributing

1. Fork it.
2. Create a new feature branch: git checkout -b my-new-feature
3. Commit your changes: git add . and git commit -m 'Add some feature'
4. Push it to the branch: git push origin my-new-feature
5. Submit a pull request.

Linting

It is not necessary to set up a linter when you make a pull request. A GitHub action has been set up to automatically adjust your code to the rules. You can also lint your code locally, see instructions below.

Set up for VS Code

Linting is done with ESLint: https://eslint.org

• (1/3) install node.js e.g. via Homebrew

brew install node

• (2/3) Install the following dependencies

npm install eslint eslint-plugin-brace-rules @typescript-eslint/parser @typescript-eslint/eslint-plugin typescript

• (3/3) Add node_modules to your .gitignore_global

• The .vscode settings have been set up to automatically adjust your code to the rules when you save the document.

• You can also lint and correct your entire repository with the following commands.

npx eslint .
npx eslint . --fix

Contributors

Motivation for this mod was the desire to learn javascript and create a tool for @mysticjim to help him create his YouTube videos. Since then many people have contributed to this mod, to all of those I wanted to say thank you.

• A complete makeover of the stats overlay was done thanks to @Islan.

• Thanks to @mysticjim, @Palaiologos and @seeh for constantly testing and giving feedback.

• Providing code and helping with problems: @andy5995, @kaaduu, @maroder, @Nescio, @Pretuer and @Schweini.

• Thanks to @badosu, @ffffff, @ffm2, @nani, @The Undying Nephalim and @wowgetoffyourcellphone for creating the following mods: Prodmod, fGod, ffm_visibility, Autociv, Hyrule Conquest and Delenda Est.

• Being good lads @elexis, @bb, @Imarok, @wraitii, @Freagarach, @vladislavbelov, @Silier and @Stan` pointed me in the right direction on the IRC #0ad channel when I got stuck.

If you want to contribute, give feedback or make suggestions, go ahead.

❤️