قبل از شروع: از فایل‌های اصلی خود نسخهٔ پشتیبان بگیرید.

ابزار توسعه‌دهنده / پردازش محلی

بازرس RenderWare

اعتبارسنجی و تعمیر فایل‌های DFF و TXD داخل مرورگر. هیچ فایلی آپلود نمی‌شود.

همان قوانین ساختاری بازرس رسمی RenderWare در MTA استفاده می‌شود: موارد «خطا» همان چیزهایی هستند که کلاینت MTA رد می‌کند.

تنظیمات تعمیر

فقط اصلاحات ساختاری قطعی در فایل ZIP نوشته می‌شود و فایل‌های اصلی دست نمی‌خورند. هشدارهای مربوط به دادهٔ تکسچر بازنویسی نمی‌شوند؛ خرابی‌های ساختاری غیرقابل‌بازیابی ممکن است نیاز به خروجی گرفتن دوباره داشته باشند (مثلاً با Magic.TXD یا باز و ذخیره کردن در همین ادیتور).

نتایج بررسی

RWگزارش اینجا نمایش داده می‌شود.

DFF — فایل‌های مدل

سلامت چانک‌ها (هدر، اندازهٔ اعلام‌شده، تو در تو بودن، نوع) · ساختار مدل (متریال‌ها، تکسچرها و اکستنشن‌ها به ترتیبی که بازی انتظار دارد) · محدودیت داده‌ها (اندازهٔ رشته‌ها، هم‌ترازی ۴ بایتی نام‌ها) · دادهٔ اضافه بعد از ریشهٔ مدل.

TXD — دیکشنری‌های تکسچر

ساختار دیکشنری و مرز چانک‌ها · تطابق هدر تکسچر با دادهٔ پیکسل در هر سطح میپ (ابعاد، فرمت، اندازه) · شناسهٔ پلتفرم و دادهٔ اضافه.

جایگزین خط فرمان

خودکارسازی با پایتون

اعتبارسنج مستقل را از ترمینال اجرا کنید. پوشهٔ resources را بدهید تا به‌صورت بازگشتی همراه همهٔ زیرپوشه‌ها بررسی شود. فقط از کتابخانهٔ استاندارد پایتون استفاده می‌کند و روی ویندوز و لینوکس کار می‌کند.

دانلود اسکریپت پایتون

استفاده از داخل پوشهٔ سرور MTA

  1. 1
    اسکریپت پایتون را دانلود کنید.
  2. 2
    آن را در پوشهٔ deathmatch سرور MTA، کنار پوشهٔ resources قرار دهید:
    deathmatch/
    ├── validate_renderware.py
    └── resources/

    مسیر نمونه در ویندوز:

    C:\Program Files (x86)\MTA San Andreas 1.6\server\mods\deathmatch
  3. 3
    PowerShell یا یک ترمینال را در همان پوشهٔ deathmatch باز کنید.
  4. 4
    همهٔ فایل‌های ‎.dff و ‎.txd داخل resources را به‌صورت بازگشتی اعتبارسنجی کنید.
    python ./validate_renderware.py ./resources

    وضعیت اعتبار هر فایل گزارش می‌شود.

  5. 5
    برای همهٔ فایل‌های ‎.dff و ‎.txd داخل resources و زیرپوشه‌هایش تعمیر قطعی را امتحان کنید.
    python ./validate_renderware.py ./resources --repair

    فایل‌های ‎.repaired.dff یا ‎.repaired.txd کنار فایل‌های اصلی نوشته می‌شوند و وضعیت هر مورد (موفق یا ناموفق) گزارش می‌شود. فایل‌هایی که ساختار مبهم دارند نوشته نمی‌شوند. فایل‌های اصلی فقط با افزودن ‎--overwrite جایگزین می‌شوند.

هشدار: فایل‌های تعمیرشده به‌طور پیش‌فرض پسوند ‎.repaired.dff یا ‎.repaired.txd دارند. ‎--overwrite را فقط وقتی اضافه کنید که واقعاً می‌خواهید فایل‌های اصلی جایگزین شوند.
محدودهٔ تعمیر: گزینهٔ ‎--repair فقط تعمیرهای ساختاری قطعی را روی DFF و TXD انجام می‌دهد و دادهٔ خراب تکسچر را حدس نمی‌زند یا بازنویسی نمی‌کند — برای ساخت TXD معتبر از Magic.TXD استفاده کنید.

در لینوکس از مسیر معادل پوشهٔ deathmatch استفاده کنید و در صورت نیاز به‌جای python بنویسید python3.

برای بررسی دقیق‌تر، ‎--verbose را اضافه کنید تا جزئیات یافته‌ها، تغییرات تعمیر و علت خطاها نمایش داده شود. برای دیدن همهٔ گزینه‌ها validate_renderware.py --help را اجرا کنید.

python ./validate_renderware.py ./resources --repair --verbose

مهم: این ابزار آزمایشی است و ممکن است نتیجهٔ ناقص یا نادرست بدهد. قبل از اعتبارسنجی، تعمیر یا جایگزینی فایل‌ها از نسخه‌های اصلی پشتیبان مستقل بگیرید و همهٔ خروجی‌ها را قبل از استفاده بررسی کنید.

اسکریپت validate_renderware.py را تیم Multi Theft Auto منتشر کرده است (nightly.mtasa.com/rwtool)؛ یک نسخه برای راحتی اینجا قرار داده شده.