Boomer Shell

Boomer Shell is a shell application written in C# (.NET 9). The main purpose of the application is to extend the functionality of games created with the Easy FPS Editor.

Requirements

OS: 64 bit Windows 10/11
Editor: Easy FPS Editor CE - All versions that use the current save system (to utilize the db variables, 1.11 alpha 4 or later is required)

NOTE: Boomer Shell is a self contained .NET 9 application. This means that .NET 9 Runtime is not required on the system as it is included in the Boomer Shell files.

---

Conditions for use

Boomer Shell is a one-time purchase per developer/team. That means that once you have bought it you can use it freely in all your projects. You are entitled to any public update to Boomer Shell. Please refrain from sharing the files with other developers who are not directly working on your own projects. Developers who are working with you on your own project are not allowed to copy the Boomer Shell files and use it in their own projects. 

Boomer Shell must be purchased by the owner of the project. That means that a publisher who has previously purchased Boomer Shell may not share the files with projects they are not developing themselves.

---

Features

Steam Achievements

Boomer Shell allows you to add Steam Achievements to your game. You can add, remove, and update achievements using the achievements.json file. Because of limitations in the Steamworks API, achievements will have to be updated manually on Steamworks to match the JSON. Read more about how to add achievements in Steamworks in the official Steamworks documentation.

Achievements can be triggered each time the game is autosaved, or each time a db variable is updated. The auto save file and the db file is read by Boomer Shell and any game variables are extracted. The variables are then compared to the achievements.json file and any achievements where the conditions are fulfilled will be unlocked.

All save files (including db.txt) are automatically encoded and backed up each time a change occurs. If a save file or the db.txt file are edited manually they are automatically replaced by the backup. This is to prevent cheating by editing the variable values in the save file

---

Changelog

v.1.1.1 - Patch - 2025-10-07

This is a small patch containing fixes for the bundling function in the Admin Console and some more robust exception handling when reading the Config file.

• Changes
  • The Bundle function in the Admin Console will now always include the encoded Achievements file, regardless of the values in the config file
• Fixes
  • The terms "mode" and "gameMode" was used interchangably in the documentation, but "gameMode" would cause a crash.

v.1.1.0 - 2025-09-28

• Added
  • DB variable monitoring
  • Configuration to toggle  saves and db monitoring on and off
  • Admin console
    • Rename BoomerShellService file when bundling
• Fixed
  • Bug where the db.txt file is deleted and not restored between sessions
  • Bug where the game will not start if the Logs folder is not present in the directory
  • Bug where the configuration would not work when using backslash in paths (windows style)
  • Crash when the maxLogs configuration is 0 or omitted in the Config file

---

Planned Features

The following features may be added in future versions:

• Resolution manager
  • Auto detect system resolution and apply to game before launch
  • Limit max resolution
• Steam stats and Leaderboards
• Import Achievements from Steamworks
• Achievements status reflect in the achievements json file and will only try to unlock once
• UI for Achievements and Configuration management