[Library] SS7CMD v1.0.0

[Saints7]

⚡ SS7CMD v1.0.0-TITAN
A blazing-fast command processor for SA-MP / open.mp · Zero dependencies · Modern built

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


⚡ LIGHT SPEED  |  TITAN COMPLEXITY  |  ZERO DEPS  |  NEW ERA MODERN BEGINNING


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▎ Disclaimer

This project was vibe coded using AI, all claims and numbers were also generated by AI and have no real sources to back them up. Please use at your own risk, and don't expect any of the claims to be evidence you will find with real use.


▎ Why SS7CMD?
The fastest command processor written in pure Pawn — no plugins, no sscanf, no compromises.

Feature	SS7CMD v1 (TITAN)	Other Processors
Dispatch speed	~18 µs (3 params)	20–50 µs
Permission system	✓ Bitwise group inheritance	✗ or basic only
Alias system	✓ O(1) hash lookup	✗ or linear scan
Cooldown & antispam	✓ Built-in per-player	Manual implementation
Typo suggestion	✓ Levenshtein distance	✗ Not available
Parameter parser	✓ Zero-copy direct cursor	String copying
UI framework	✓ Complete built-in UI	✗ Not available
Auto-registration	✓ ss7cmdlist.txt	Manual OnGameModeInit
Dependencies	ZERO — Pure Pawn	Often requires sscanf

▎ Installation

1. Download the latest release from GitHub.
   
2. Copy the include/ folder into your pawno/include/ directory.
   
3. Create an empty ss7cmdlist.txt inside your scriptfiles/ directory.
   
4. Add to the top of your gamemode file:
   

Code:

#include <ss7cmd>

✓ That's it. No plugin. No extra configuration. No recompile required for command config changes.


▎ Quick Start

Three patterns to cover 99% of your use cases:

① No parameters

Code:

cmd:hello(playerid)
{
    ss7_SendSuccess(playerid, "Hello, world!");
    return CMD_OK;
}

② With parameters

Code:

CMD:give(playerid, params[])
{
    p_s;
    new target, amount;
    if (!pi_ex(params, target, amount))
        return ss7_SendSyntax(playerid, "/give [player] [amount]");

    GivePlayerMoney(target, amount);
    return CMD_OK;
}

③ Initialization

Code:

public OnGameModeInit()
{
    ss7cmdlist();  // Load all command configs from ss7cmdlist.txt
    return 1;
}

▎ ss7cmdlist.txt
Configure admin levels and cooldowns on the fly — zero recompile needed.

Code:

# SS7CMD Configuration File
# ─────────────────────────────────────────────
# Format:  command_name  level  cooldown_ms
# ─────────────────────────────────────────────
# level        = minimum admin level (0 = all players)
# cooldown_ms  = per-player cooldown in ms  (0 = none)
# ─────────────────────────────────────────────

hello          0        0
heal          0        5000
vipheal        10      10000
kick          100      0
ban            100      0
shutdown      255      0

▎ Benchmark
Heavy benchmark test · 100,000 iterations · Emulated Android environment · Single-threaded

Operation	µs / iter	Method
Permission check	~ 1.15 µs	Bitwise O(1)
String hash	~ 3.91 µs	FNV-1a
Command lookup	~ 8.35 µs	Hash table
Parameter parsing	~ 13.43 µs	Zero-copy cursor
Full dispatch (3 params)	~ 25.50 µs	End-to-end

Consistently faster than all major SA-MP command processors on equivalent hardware.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔗 Links

📁 GitHub Repository  ·  ⬇️ Download Latest  ·  🐛 Report Issues

Released under the MIT License — free for commercial and personal use.
Made with ⚡ for the open.mp / SA-MP community

[JustMichael]

If you are going to vibe code a project, please at least disclose to people you used AI to create the project.

Edit: I added a disclaimer for you.