元ドキュメント: Server Basic Interfaces

サーバー基本インターフェース

概要

ACE PCアンチチートのサーバーSDKは、ゲームサーバーに統合してクライアントから送信されるアンチチートデータを検証するためのインターフェースを提供します。

初期化

サーバーSDKの初期化

// サーバーSDKの初期化
int ret = AceServerInit(game_id, server_key);
if (ret != 0) {
    // 初期化失敗
    printf("ACE Server SDK init failed: %d\n", ret);
}

パラメータ

パラメータ	型	説明
game_id	int	ゲームID
server_key	const char*	サーバー認証キー

主要インターフェース

プレイヤーデータ検証

クライアントから受信したアンチチートデータを検証します：

int result = AceVerifyPlayerData(player_id, data, data_len);

返却値	説明
0	検証成功（正常）
1	チート検出
-1	データ不正
-2	内部エラー

チート結果の照会

特定プレイヤーのチート検出結果を照会します：

AceCheatResult result;
int ret = AceQueryCheatResult(player_id, &result);

コールバック設定

チート検出時のコールバック関数を設定します：

void OnCheatDetected(int player_id, int cheat_type, const char* detail) {
    printf("Cheat detected: player=%d, type=%d, detail=%s\n",
           player_id, cheat_type, detail);
    // ゲームロジックに応じた処理（キック、BAN等）
}

AceSetCheatCallback(OnCheatDetected);

チートタイプ定義

値	チートタイプ	説明
1	SPEED_HACK	速度変更
2	MEMORY_HACK	メモリ改ざん
3	INJECTION	コードインジェクション
4	DEBUGGER	デバッガ接続
5	KNOWN_CHEAT	既知チートツール

終了処理

AceServerUninit();

注意事項

1. サーバーSDKはスレッドセーフです
2. 初期化は1回のみ実行してください
3. ネットワークエラー時は自動的にリトライされます