RBR Universal Crash Guard [Development]

A plug-and-play safety layer for Arma Reforger servers that protects against bad mod behavior, runaway loops, and VM crashes — without relying on mod authors to fix their code.

---

Overview

The RBR Universal Crash Guard provides a universal safety net for Reforger servers running multiple mods. It catches bad behavior, prevents infinite loops, monitors global frame usage, and logs detailed information administrators can use to identify problem mods — all without requiring updates from mod authors.

THIS IS A WiP & Currently in Development!

This is meant for testing on live servers for framework and compatibility. Please report bugs here in Github thanks!

---

Why This Exists

Servers running many community mods often face instability from:

• Missing null checks
• Infinite loops
• Heavy EOnFrame execution
• Bad update pushes

Crash Guard functions like a seatbelt — catching failures before they take the entire server down.

---

Installation

If you wish to contribute I have the mod listed below. (its private atm for development)

I am not very good with C# so be gentel, this is still in its infancy lol!

Server Installation

Currently the mod is private while in development

1. Add the mod entry to the TOP of your server’s modlist JSON.

{ "modId": "66E3474D783F309A", "name": "Untugs Crash Guard WiP", "version": "" },

2. Start the server and confirm this appears in the console/logs:
   [CrashShield] Universal SafeGuard loaded.

Optional Setup

Not implimented yet - Still working on proper logging

• Create custom guards inside SafePatches.c if you encounter a misbehaving mod.
• Use the included templates to add loop caps, null-checks, and safety wrappers.

---

Core Components

Universal Bootstrap

Initializes the guard system and confirms loading.

Safe Utilities

Provides:

• Null safety checks
• Loop protection
• Structured logging
• Context/instance/owner tracing

Crash Guard Monitor

Assigns severity levels (LOW, MED, HIGH) to loop events and writes them to logs.

Crash Guard Logger

Outputs all structured events to:
$profile:CrashGuard.log

Global Loop Guard

A system-wide frame counter that detects runaway frame scripts.

Safe Patch System

Where admins can create per-mod safety guards.

Integration Templates

Reserved for future patch collections and mod-specific examples.

---

Admin Workflow

1. Install the addon and restart the server.
2. When instability occurs, read CrashGuard.log in your profile directory.
3. Look for HIGH/MED severity entries and repeated contexts.
4. Check [GLOBAL] entries for full server frame overloads.
5. Use AR Explorer to trace issues back to scripts.
6. Build guards in SafePatches.c to prevent repeat issues.

---

Contributing

Contributions are welcome!
Ways to contribute:

• Improve documentation
• Add templates
• Submit bug fixes
• Submit new mod integration patches

How to Contribute

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Submit a pull request

---

License

Arama Reforger and its associated assets are trademarks of Bohemia Interactive. APL-ND License applies to this project while in development.

Credits

Would like to thank the Rubber Band Rangers Dev Team along with:

• LoneStarActual [BTGG]
• Rouge [RES]
• Brooks [OG]

Thank you for helping with the development and testing for this project!