Getting Started

The easiest way to think about CampAPI is this: pick the thing you want to react to, then attach your logic to it.

1) Pick the feature you actually need

A few common choices:

• BeforeRenderScreenEvent when you want to stop or replace a screen render
• AfterRenderScreenEvent when you want to run code after a screen has drawn
• OnKeyEvent and OnTouchEvent when you want to react to player input
• GetSplashTextEvent when you want to change the startup splash text
• RPMConstructor when you want to observe resource-pack manager setup
• getLibBase() and getVtableClass() when you need native addresses

2) Put listeners inside a scope

ModuleScope keeps things tidy. When the scope ends, its listeners are cleaned up automatically.

CampAPI::ModuleScope scope;

scope.AddListener<OnKeyEvent>([](OnKeyEvent& event) {
    if (event.isKeyDown && event.keyCode == 66) {
        event.Consume();
    }
});

3) Make a JavaScript mod

A normal JS mod usually looks like this:

{CampAPIRootFolder}/scripts/ExampleMod/
  manifest.json
  scripts/
    index.js
    utils.js

Example manifest.json:

{
  "name": "Example Mod",
  "author": "Alvin",
  "version": "1.0.0",
  "namespace": "example",
  "export": true,
  "entry": "index.js"
}

Example scripts/index.js:

import { getModInfoByName } from 'internal:mod'
import { sigscan } from 'internal:modding'
import { fetch } from 'internal:network'

console.log('Loaded:', getModInfoByName('Example Mod'))

const addr = sigscan('libminecraftpe.so', '48 8B ?? ??')
console.log('Signature result:', addr)

const res = fetch('https://example.com/version.json')
console.log(res.status, res.ok)

4) Reuse files from other exported mods

If a mod is marked "export": true, other mods can import from it using @namespace/path.

import { helper } from '@example/utils.js'

That is handy for shared utilities, constants, and small bootstraps you do not want to copy everywhere.

Practical tip

Start small. A mod that changes splash text or reacts to one key is much easier to debug than a huge mod with everything mixed together.