Godfather-API roadmap
The C# API every Alt:SA gamemode is written against: server lifecycle, players, storage, messages, and the black-glass UI kit drawn on players' screens. Small, stable and versioned, so gamemodes keep working as the engine changes.
- Done
Design
4/4The v0.1 surface and the UI kit look are agreed before any code is written.
- UI kit look chosen: black glass, centered panelAlt-SAMP/Brand#3Done
- v0.1 API surface drafted (lifecycle, players, storage, UI)Draft on the API page of godfather.altmp.app.docs/wiki/api/*.md, published at altmp.app/wiki/godfatherDone
- Docs site live at godfather.altmp.appRetired 2026-11-20: godfather.altmp.app now redirects to altmp.app/wiki/godfather.godfather.altmp.appDone
- Docs move into the Alt:SA wiki (docs/wiki/*.md, rendered at altmp.app/wiki/godfather)altmp.app/wiki/godfathergodfather.altmp.app redirectsDone
- Done
v0.1: first gamemodes
6/6A gamemode DLL loads on the dedicated server, reacts to players joining, shows UI and stores data.
- Gamemode lifecycle: OnServerStart, OnPlayerJoined, OnPlayerLeftAlt-SAMP/Engine#10tests/Godfather.Tests 9/9Done
- Players: name, position, spawn, freeze, toast, chat, kickAlt-SAMP/Engine#10engine autotest godfather: spawn, freeze, toastDone
- Storage: player, server and named buckets as JSON filesAlt-SAMP/Engine#10visits persisted across two server runs (Visit 1, then Visit 2)Done
- UI kit: panel, text and password fields, buttons, toast (server-driven)Alt-SAMP/Engine#10engine Build/Alt-SA/autotest/godfather_01_panel.pngDone
- Hello-Godfather example gamemodeexamples/HelloGodfatherDone
- Self-test: the example loads on a dedicated server and its UI shows on a clientAlt-SAMP/Engine#10Tools/run-autotest.sh godfather 17/17 on a dedicated serverDone
- Done
v0.2: sign-in support
3/3Everything the NG-RP sign-in needs.
- Camera: fly-over, fly-to and followAlt-SAMP/Engine#11engine autotest ngrp: fly-over 210 m up and moving; fly-to the saved positionDone
- Accounts: salted slow hashes, rate-limited attemptsAlt-SAMP/Engine#11PBKDF2 test vectors, lock after 5 tries (Godfather tests 15/15); ngrp wrong password rejected with tries leftDone
- SQLite storage backendAlt-SAMP/Engine#11SQLite file test (no plain-text password); ngrp database holds the account and saved positionDone
- Planned
Growing the API
2/6Reference list of what comes after v0.1.
- Vehicles: spawn, owners, locks, enginePlanned
- HUD hooks: money, strips, timers, GPS waypoint, hiding pieces, wanted levelAlt-SAMP/Engine#13engine huddemo 19/19: stars clear 6.0 s after leaving the search area; Godfather tests 19/19Done
- Menus, HUD stat lines and custom sights per weapon (v0.4)Alt-SAMP/Engine#14engine huddemo 30/30: menu keys, Enter, Backspace, stats, sight; Godfather tests 23/23Done
- Chat commands and permissionsPlanned
- Lua scripting layer on top of the C# APIPlanned
- Gamemode packages and a registryPlanned