Click Beyond Frames API

Standalone API headers for the Click Beyond Frames mod.

---

What's Inside?

This repository contains only header files that allow other mods to interact with Click Beyond Frames.

Header	Purpose
API.hpp	Dev presence – tells other mods this mod exists.
Checker.hpp	Anti‑cheat state – retrieve runtime data for verification.

---

Installation (for Developers)

Add this as a dependency in your mod.json:

{
    "dependencies": {
        "yourname.click-beyond-frames-api": {
            "version": ">=v1.0.0",
            "required": false
        }
    }
}

Then include the headers in your mod:

#include <ClickBeyondFrames/API.hpp>     // Dev presence
#include <ClickBeyondFrames/Checker.hpp> // Anti-cheat state

---

Usage Examples

1. Check if Click Beyond Frames is installed

if (clickbeyondframes::dev::isInstalled()) {
    log::info("Click Beyond Frames is present!");
    auto version = clickbeyondframes::dev::getVersion();
    log::info("Version: {}", version);
}

2. Get runtime state (for anti-cheat / verification)

auto state = clickbeyondframes::checker::getState();

if (state.isExceedingVanilla) {
    log::warn("Polling rate exceeds 480 TPS!");
}

if (!state.isInputThreadHealthy) {
    log::error("CBF input thread is not running!");
}

3. Verify integrity (flags debug builds)

if (! clickbeyondframes::checker::verifyIntegrity()) {
    log::error("Mod is running in debug mode!");
}

4. Get a cryptographic signature

auto state = clickbeyondframes::checker::getState();
auto signature = clickbeyondframes::checker::getStateSignature(state);
// Send signature to your server to validate

---

Building

This is an API‑only mod. Build it to ensure the headers are registered with Geode:

geode build

---

Notes for Mod Developers

• Do not require this API unless your mod absolutely needs Click Beyond Frames. Use "required": false.
• The API functions are guaranteed stable – they will not break across versions.

---

License

MIT – Use freely.

---

Credits

• Geode SDK team
• Geometry Dash community

---

Check. Beyond. Frames.