مستندات رسمی پروژه 7.2.18

FIREAC؛ مستندات دقیق برای استقرار واقعی.

یک آنتی‌چیت رایگان و سبک برای FiveM ساخته امیررضا جابری؛ با تشخیص‌های سمت کلاینت و سرور، اعتبارسنجی آگاه از چرخه حیات بازیکن، پنل مدیریتی با تأیید سمت سرور و مدیریت بن و دسترسی مبتنی بر دیتابیس.

ESXQBCoreStandaloneoxmysqlAGPL-3.0

شروع نصب مشاهده سورس

fireac/status

$ resource FIREAC

› version 7.2.18

› fx_version cerulean

› game gta5

› framework auto-detect

› database oxmysql

آماده پیکربندی

7.2

نسخه 7.2.18 یک بروزرسانی کامل پایداری و سازگاری است

این نسخه سازگاری فریم‌ورک، چرخه اتصال/Spawn/Respawn، اعتبارسنجی source سمت سرور، cooldown تشخیص‌ها و کاهش False Positive را بهبود می‌دهد. برای نسخه‌های قدیمی، کل Resource را جایگزین کنید و فایل‌ها را تکی Merge نکنید.

راهنمای ارتقا

ساختار FIREAC

معماری Resource

Resource به تنظیمات و داده‌های مشترک، تشخیص‌های کلاینت و اتصال NUI، منطق اعتبارسنجی و مجازات سمت سرور، و رابط مدیریتی مرورگر تقسیم شده است.

configs/

پیکربندی

fire-config.lua حفاظت‌ها، زمان‌بندی lifecycle، ACE و رفتار UI را کنترل می‌کند. fire-webhook.lua تنظیمات Webhook را نگه می‌دارد.

src/

هسته اجرایی

fire-client.lua, fire-menu.lua, fire-server.lua تشخیص‌ها، تعاملات ادمین، اعتبارسنجی و اکشن‌های سرور را اجرا می‌کنند.

tables/

داده‌های بلک‌لیست

جدول‌های Lua جدا برای Weapon، Vehicle، Ped، Object، Word، Trigger، Explosion، Plate، Task و موارد دیگر.

ui/

رابط مدیریتی NUI

رابط مدیریتی F9 و Command. اکشن‌های حساس در سرور بررسی می‌شوند و صرفاً به NUI اعتماد نمی‌شود.

fxmanifest.luacerulean · gta5 · ui_page "ui/index.html" · dependency "oxmysql"

قبل از نصب

پیش‌نیازها

oxmysqlالزامی

FIREAC، oxmysql را به‌عنوان dependency اعلام می‌کند و در سمت سرور از کتابخانه MySQL آن استفاده می‌کند.

GitHub

discord-screenshotبرای اسکرین‌شات

هنگام فعال بودن ثبت مدرک تصویری استفاده می‌شود. Resource باید Start باشد و Webhook معتبر تنظیم شود.

GitHub

فریم‌ورکخودکار

FIREAC 7.2.18 از ESX، QBCore و Standalone پشتیبانی می‌کند و آماده‌شدن Framework/Lifecycle را خودکار مدیریت می‌کند.

ESXQBCoreStandalone

نصب تمیز

نصب FIREAC

نسخه 7.2.18 را روی فولدر قدیمی FIREAC Merge نکنید.

Resource قدیمی را حذف کنید، نسخه کامل را نصب کنید، Schema جدید دیتابیس را Import کنید و سرور را Restart کنید.

1
نسخه فعلی را دانلود کنید
آخرین نسخه پایدار را از GitHub Releases دانلود و Resource کامل FIREAC را Extract کنید.
باز کردن آخرین Release
2
Resource را اضافه کنید
فولدر FIREAC را داخل resources سرور FiveM کپی کنید. نام Resource را FIREAC نگه دارید تا Exportهای مستندشده به‌درستی Resolve شوند.
3
Dependencyها را آماده کنید
oxmysql را نصب کنید. اگر Screenshot فعال است، discord-screenshot را نیز نصب کنید.
4
دیتابیس را Import کنید
فایل database.sql داخل FIREAC را قبل از اولین اجرا Import کنید. Schema نسخه 7.2.18 پاک‌سازی شده و باید همراه همین نسخه استفاده شود.
5
FIREAC را تنظیم کنید
قبل از Production، فایل‌های configs/fire-config.lua و configs/fire-webhook.lua را مرور کنید و مشخصات سرور، Actionها و Webhookها را آگاهانه تنظیم کنید.
6
Resourceها را به ترتیب Start کنید
server.cfg
```
ensure oxmysql
ensure discord-screenshot
ensure FIREAC
```
اگر ثبت Screenshot را عمداً غیرفعال کرده‌اید، discord-screenshot فقط زمانی لازم است که از همان مسیر ثبت مدرک استفاده کنید.

configs/fire-config.lua

تنظیمات اصلی

این موارد، Defaultهای مهم FIREAC 7.2.18 هستند. مقادیر lifecycle، evidence و کنترل False Positive را فقط زمانی تغییر دهید که اثر آن‌ها را می‌دانید.

ServerConfig

Name: YOUR SERVER NAME
Port: 30120
Linux: false

ACE

Enable: false
Admin: FIREAC.Admin
Whitelist: FIREAC.Whitelist
Unban: FIREAC.Unban

ChatSettings

Enable: true
PrivateWarn: true

ScreenShot

Enable: true
Format: PNG
Quality: 1

Defaultهای اتصال و Deferral

گزینه	پیش‌فرض	کاربرد
`AntiBlackListName`	true	نام‌های مسدودشده را هنگام اتصال بررسی می‌کند.
`AntiVPN`	false	بررسی VPN به‌صورت پیش‌فرض خاموش است.
`HideIP`	true	در خروجی‌های پشتیبانی‌شده از نمایش IP بازیکن جلوگیری می‌کند.
`UseDeferrals`	true	از جریان Connection Deferral استفاده می‌کند.
`DeferralMode`	`card`	جریان کارت اتصال را استفاده می‌کند.
`DeferralDelayMs`	1200 ms	تأخیر ابتدایی Deferral.
`DeferralStepMs`	120 ms	زمان هر Step نمایشی/پیشرفت.
`ProblemOnlyMode`	false	UI اتصال عادی نمایش داده می‌شود و فقط محدود به خطاها نیست.

Defaultهای Lifecycle تشخیص

120sReadyMaxWaitحداکثر انتظار برای آماده‌شدن بازیکن/فریم‌ورک

12sMinimumClientReadyحداقل زمان آماده‌شدن کلاینت

20sSpawnGraceمهلت بعد از Spawn

18sPostSpawnSettleزمان پایدارشدن بعد از Spawn

20sPostReadyGraceمهلت پس از Ready

15sRespawnGraceمهلت بعد از Respawn

12sPedChangeGraceمهلت هنگام تغییر Ped

3.5sCameraGraceمهلت هنگام تغییر Camera

3EvidenceThresholdتعداد شواهد در بازه تعیین‌شده

15sEvidenceWindowبازه جمع‌آوری شواهد

6GodmodeSamplesنمونه‌های بررسی Godmode

6 / 10sServerReportLimitمحدودیت نرخ Report کلاینت

Lifecycle Check بخشی از کنترل False Positive است.

قبل از خاموش‌کردن یک حفاظت به‌خاطر تشخیص هنگام Spawn یا Load Character، ابتدا تنظیمات Framework Readiness و Grace Period را بررسی کنید.

ماتریس تشخیص

حفاظت‌ها و وضعیت پیش‌فرض

FIREAC هم تشخیص رفتاری سمت کلاینت و هم حفاظت Event/Entity سمت سرور دارد. وضعیت‌های زیر مطابق Default نسخه 7.2.18 هستند و به معنی توصیه برای روشن‌کردن بدون بررسی تمام گزینه‌های خاموش نیست.

سمت کلاینت

وضعیت بازیکن، حرکت، دوربین، سلاح و Vehicle.

Anti Health HackON · BANMaxHealth 200

Anti Armor HackON · BANMaxArmor 100

Anti Infinite AmmoON

Anti SpectateON · BAN

Anti Blacklist WeaponONWeapon action: BAN

Anti God ModeON · BAN

Anti InvisibleON · KICK

Anti Change SpeedON · KICK

Anti Rainbow VehicleON · BAN

Anti Plate Changer / Blacklist PlateON · BAN

Anti Night / Thermal VisionON · BAN

Anti Super JumpON · BAN

Anti TeleportON · BANFoot 200 · Vehicle 600

Anti Ped ChangerON · BAN

Anti Tiny PedON · BAN

Anti Blacklist AnimationsON · BAN

Anti Free CameraOFF · BAN

Anti NoclipOFF · KICK

Anti Infinite StaminaOFF · WARN

Anti SuicideOFF · WARN

Anti Pickup CollectOFF · BAN

Anti Blacklist TasksOFF · BAN

سمت سرور

Chat، Event، Entity، Permission، Damage و Rate Limit.

Anti Spam ChatON · BAN10 messages / 3 sec cooldown

Anti Blacklist CommandsON · BAN

Anti Weapon Damage ChangerON · BAN

Anti Blacklist WordON · KICK

Anti Spam TriggerON · BAN

Anti Taze PlayersON · KICKMax 3

Anti Explosion SpamON · BANMaxExplosion 10

Anti Blacklist Object / Ped / Building / VehicleON · BAN

Anti Spam VehicleON · KICKMaxVehicle 10

Anti Spam PedON · KICKMaxPed 4

Anti Spam ObjectON · KICKMaxObject 15

Anti Play SoundON · KICK

Anti Bring AllOFF · BAN

Anti Blacklist TriggerOFF

Anti Clear Ped TasksOFF · BANMax 5

Anti InjectOFF · BAN

Anti Change PermissionOFF · BAN

tables/*.lua

جدول‌های بلک‌لیست

داده‌های بلک‌لیست عمداً از تنظیمات Runtime جدا شده‌اند تا بازبینی و شخصی‌سازی بدون مخلوط‌کردن لیست‌های بزرگ با منطق تشخیص انجام شود.

fire-anim.luafire-cmd.luafire-damage.luafire-emoji.luafire-event.luafire-explosions.luafire-name.luafire-object.luafire-peds.luafire-plate.luafire-task.luafire-vehicle.luafire-weapon.luafire-words.lua

رابط مدیریتی با تأیید سمت سرور

پنل مدیریت

بازکردن پنل مدیریت FIREAC

وقتی AdminMenu.Enable برابر true باشد، ادمین مجاز می‌تواند با F9 یا دستورات /fireac و /fireacmenu پنل NUI را باز کند. وضعیت Admin و اکشن‌های حساس توسط کد سمت سرور اعتبارسنجی می‌شوند.

EnabletrueKeyF9MenuPunishmentBAN

▦

Dashboard

بازیکنان آنلاین، Props، Vehicleها، Pedها، Banها، Adminها، دسترسی Whitelist/Unban و آخرین رکوردهای مدیریت و بن.

◎

ابزارهای شخصی

Godmode، Invisible، Suicide، Heal، همه سلاح‌ها، حذف سلاح‌ها، Copy Coords، Night Vision و Thermal Vision.

♟

اکشن بازیکن

Goto، Bring، Kick، Spectate، Ban، Make Admin، Whitelist و اعطای Unban Access. اکشن‌های Kick/Ban دلیل دریافت می‌کنند.

◇

کنترل Entity

حذف Vehicle، Prop، Ped یا Entityهای پشتیبانی‌شده. Ped بازیکن در مسیر حذف Entity محافظت می‌شود.

جریان Teleport

اکشن‌های Teleport ادمین Grace مناسب دریافت می‌کنند تا جابه‌جایی مجاز بلافاصله با Anti-Teleport تداخل نداشته باشد.

▱

ابزار Vehicle

Spawn برای خود یا Target، رنگ RGB، Repair/Clean، Full Custom و Delete.

چه کسی چه دسترسی دارد

دسترسی Admin، Whitelist و Unban

Admin

دسترسی به پنل مدیریت FIREAC و اکشن‌های مدیریتی محافظت‌شده را می‌دهد.

Whitelist

بازیکنان مورد اعتماد/مجاز را برای مسیر Whitelist در FIREAC مشخص می‌کند.

Unban

دسترسی Unban را بدون الزام به اعطای تمام قابلیت‌های Admin فراهم می‌کند.

ACE

اتصال ACE وجود دارد اما به‌صورت پیش‌فرض خاموش است.

FIREAC.Admin · FIREAC.Whitelist · FIREAC.Unban. فقط زمانی FIREAC.ACE.Enable = true قرار دهید که Ruleهای ACE در server.cfg عمداً پیکربندی شده باشند.

عملیات Console و داخل بازی

دستورات

دستور	کاربرد
`/funban [Ban ID]`	حذف بن FIREAC با Ban ID.
`/unban [Ban ID]`	مسیر/نام جایگزین دستور Unban در پروژه.
`addadmin [ID]`	اعطای دسترسی Admin به بازیکن آنلاین؛ در مستندات برای Server Console معرفی شده است.
`addwhitelist [ID]`	اعطای Whitelist Access.
`addunban [ID]`	اعطای Unban Access.
`fireacban [ID] [Reason]`	بن‌کردن بازیکن با دلیل مشخص.
`fireacunban [Ban ID]`	حذف بن با FIREAC Ban ID.

اتصال Resourceهای دیگر

Exports

FIREAC Exportهای کلاینت و سرور ارائه می‌دهد تا Resourceهای دیگر بتوانند مجازات مستند، Whitelist موقت و مدیریت Ban را از طریق خود آنتی‌چیت انجام دهند و منطق تکراری نسازند.

اکشن Client / Shared

FIREAC_ACTION

client_export

Lua

exports['FIREAC']:FIREAC_ACTION(source, "BAN", "Cheating", "Using godmode")

یک Action مستند FIREAC را با source، نوع Action، دسته و توضیح/Reason ارسال می‌کند.

Whitelist موقت

FIREAC_CHANGE_TEMP_WHITELIST

client + server

Lua

exports['FIREAC']:FIREAC_CHANGE_TEMP_WHITELIST(source, true, 15000)
local allowed = exports['FIREAC']:FIREAC_CHECK_TEMP_WHITELIST(source)

برای اکشن‌های Script شده و مورد اعتماد که موقتاً شبیه رفتار محافظت‌شده هستند کاربرد دارد. Manifest همچنین Alias تاریخی FIREAC_CHANGE_TEMP_WHHITELIST را برای سازگاری نگه داشته است.

مدیریت Ban سمت سرور

BanPlayer / UnbanPlayer

server_export

Lua

exports['FIREAC']:BanPlayer(playerId, reason, issuer)
exports['FIREAC']:UnbanPlayer(banId, issuer)

وقتی یک Resource مورد اعتماد سمت سرور باید Ban Record در FIREAC ایجاد یا حذف کند از Server Exportها استفاده کنید.

در Wrapper خود به Identity یا اطلاعات مجازات ارسالی از Client اعتماد نکنید.

Authorization و Identity Validation را سمت سرور نگه دارید؛ مطابق رویکرد Harden شده نسخه 7.2.18.

database.sql

دیتابیس و دسترسی‌های پایدار

FIREAC وضعیت Ban و Access را در MySQL نگه می‌دارد. Schema همان Releaseای را Import کنید که Deploy می‌کنید؛ Release 7.2.18 صراحتاً Schema پاک‌سازی‌شده بدون داده نمونه بازیکن را ارائه می‌کند.

قبل از اولین Start کردن FIREAC Import کنید.
oxmysql باید قبل از FIREAC فعال باشد.
قبل از Upgrade در Production از Ban/Access فعلی Backup بگیرید.
Schema قدیمی را با Resource جدیدی که ناقص Merge شده ترکیب نکنید.

MySQL

FIREACoxmysqldatabase

Ban · Admin · Whitelist · Unban Access

مهاجرت پایدار

ارتقا به 7.2.18

بک‌آپ

قبل از هر جایگزینی، از فولدر FIREAC، مقادیر Config در Production و دیتابیس Backup بگیرید.

جایگزین کنید، Merge نکنید

Resource کامل 7.2.18 را به‌عنوان یک واحد نسخه‌دار نصب کنید.

Schema فعلی را Import کنید

database.sql همراه 7.2.18 را با فرآیند Migration/Backup مناسب برای داده Production اعمال کنید.

Configهای عمدی را دوباره اعمال کنید

فقط تنظیماتی را منتقل کنید که عمداً نیاز دارید و Optionهای قدیمی حذف‌شده/پشتیبانی‌نشده را برنگردانید.

چرا 7.2.18 مهم است

سازگاری کامل ESX / QBCore / Standalone
رفع False Positive در اتصال، Spawn، Respawn و Character Load
اعتبارسنجی قوی‌تر Source / Identifier سمت سرور
بهبود Detection Cooldown و Evidence/Lifecycle

Grace Period برای Spawn، Camera، Ped و Admin Action
اعتبارسنجی و Rate Limit برای Client Report
رفع False Positive مربوط به Godmode Camera و Ped Changer اولیه
Schema پاک‌سازی‌شده و حذف Command/Configهای منسوخ

بررسی‌های عملیاتی

رفع اشکال

FIREAC Start نمی‌شود یا خطای دیتابیس می‌دهد

بررسی کنید oxmysql نصب شده و قبل از FIREAC Start می‌شود، Connection دیتابیس معتبر است و database.sql همان Release FIREAC Import شده است.

F9 یا /fireac پنل Admin را باز نمی‌کند

بررسی کنید AdminMenu.Enable برابر true باشد و بازیکن مجوز Admin در FIREAC داشته باشد. اگر ACE را فعال کرده‌اید، Rule مربوط به FIREAC.Admin واقعاً Grant شده باشد.

Screenshot به مقصد ارسال نمی‌شود

ScreenShot.Enable، وضعیت Resource discord-screenshot و Webhook را بررسی کنید. Resource متوقف یا Webhook نامعتبر این مسیر Evidence را مختل می‌کند.

هنگام Spawn / Respawn تشخیص اشتباه رخ می‌دهد

ابتدا نسخه کامل 7.2.18 را استفاده کنید. سپس Framework Readiness و مقادیر Grace در Detection را قبل از خاموش‌کردن حفاظت بررسی کنید. این نسخه مشخصاً کنترل False Positive مبتنی بر Lifecycle را اضافه/تقویت کرده است.

Teleport یا Action ادمین یک Protection را فعال می‌کند

برای Actionهای مدیریتی حساس، ترجیحاً از Workflow خود FIREAC استفاده کنید چون پنل فعلی Grace/Authorization را با آنتی‌چیت هماهنگ می‌کند. Admin Resource سفارشی باید Temp Whitelist/Grace را آگاهانه Integrate کند.

شرایط متن‌باز

مجوز و محدوده پروژه

AGPL

GNU Affero General Public License v3.0

FIREAC تحت AGPL-3.0 منتشر شده است. پیش از توزیع مجدد یا تغییر، به‌خصوص هنگام Deploy نرم‌افزار شبکه‌ای تغییر‌یافته، فایل LICENSE مخزن را مطالعه کنید.

LICENSE

محدوده امنیتی

FIREAC در خود پروژه به‌عنوان آنتی‌چیت رایگان برای حفاظت پایه معرفی شده است. امنیت آنتی‌چیت دفاع چندلایه است؛ Resourceها، Permissionها، Eventها و دیتابیس سرور را نیز Harden کنید و یک Resource را مرز کامل امنیتی در نظر نگیرید.