[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


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



▎ 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