Infernus Monorepo and Packages

Infernus Monorepo and Packages An architecture diagram generated by Archify. create-app · scaffolding CLI · Architecture component create-app scaffolding CLI Gamemode script · gamemode entry · Architecture component Gamemode script gamemode entry @infernus/core · core library · Architecture component @infernus/core core library samp-node · Node runtime · Architecture component samp-node Node runtime @infernus/fs · bundled scripts · Architecture component @infernus/fs bundled scripts @infernus/types · ambient types · Architecture component @infernus/types ambient types open.mp Server · server host · Architecture component open.mp Server server host Node.js 22 · JS runtime · Architecture component Node.js 22 JS runtime @infernus/shared · build-time code · Architecture component @infernus/shared build-time code raknet · network packets · Network and anti-cheat raknet network packets nex-ac · anti-cheat · Network and anti-cheat nex-ac anti-cheat weapon-config · weapon damage · Network and anti-cheat weapon-config weapon damage query · server queries · Network and anti-cheat query server queries streamer · entity streaming · World and navigation streamer entity streaming colandreas · collision query · World and navigation colandreas collision query mapandreas · terrain heights · World and navigation mapandreas terrain heights map-loader · map file loading · World and navigation map-loader map file loading mapfix · map hole fixes · World and navigation mapfix map hole fixes gps · navigation · World and navigation gps navigation cef · in-game browser · Interface cef in-game browser ompp · open.mp extras · Interface ompp open.mp extras progress · progress bars · Interface progress progress bars qrcode · QR codes · Interface qrcode QR codes s-art · image rendering · Interface s-art image rendering e-selection · model menu · Interface e-selection model menu fcnpc · NPCs and bots · Players and gameplay fcnpc NPCs and bots samp-voice · voice chat · Players and gameplay samp-voice voice chat veh-para · vehicle parachute · Players and gameplay veh-para vehicle parachute distance · distance maths · Players and gameplay distance distance maths drift-detection · drift detection · Players and gameplay drift-detection drift detection rec · .rec conversion · Players and gameplay rec .rec conversion scaffold import core callNative Network and anti-cheat World and navigation Interface Players and gameplay Legend Frontend Backend Cloud Security External

Three implementation styles

  • • Wrapping a native plugin: raknet, streamer, colandreas, cef, ompp and fcnpc expose plugin natives as typed functions
  • • Enhancing core behaviour: nex-ac, weapon-config, veh-para and distance replace core's native calls to rewrite damage and position logic
  • • Pure TypeScript: mapandreas, rec, query and e-selection need no native plugin at all

Extension points in core

  • • defineEvent declares an event; listeners form a middleware chain advanced by next()
  • • defineHooks(Class) returns the original method snapshot plus setHook, for replacing class methods
  • • GameMode.use() only queues; loading happens in onInit

Build and runtime boundary

  • • scripts/build-all.ts builds serially: streamer, core, raknet, then the rest
  • • Each package type-checks then bundles to bundle.mjs / bundle.js / bundle.d.ts
  • • samp-node is loaded by open.mp and injects global samp; streamer and types are unpublished