Dragon Ball Z: Burst Limit Recompiled - ALPHA (Version 4.1)
https://github.com/iExplosiveRage/DBZ-Burst-Limit-Recompiled

This is an early alpha. Expect bugs.
No game data is included. You need your own copy of the game.

HOW TO PLAY
1. (Only if the game does not start) install the Visual C++ Redistributable (x64):
   https://aka.ms/vs/17/release/vc_redist.x64.exe
2. Run burstlimit.exe. The first time, it asks for your Dragon Ball Z: Burst Limit
   Xbox 360 disc image (.iso): pick it, and the game files are copied into the
   "game_data_root" folder (about 3.3 GB, only once). The .iso isn't changed.
   Only the US (NTSC-U) version works - the installer checks it.
   (You can still extract the game yourself into "game_data_root" instead:
   it must contain default.xex and LONG2DATA.)

NEW IN 4.1
- Install from your .iso on the first start (see above).
- Much faster: about 2x the FPS at native 4K (100 -> 190+ on an RTX 4080 in our
  tests), +40% with DLAA, +32% on an AMD integrated GPU. Results vary by PC.
- Mods menu: Main Menu > Mods (under Options). Put mods in the "mods" folder next to
  burstlimit.exe (one folder per mod) and switch them on or off - no restart needed.
  PS3 model mods work too (converted automatically). See MODS below.
- Ki Charge (optional, off by default): hold L3 to charge your Ki, like Shin Budokai.
  On the ground and in the air, with a finishing pose when your Ki is full.
  Turn it on in F1 > GAME > Ki charge. Online, the host's setting is used by both.
  Two looks:
  1. Built-in: Burst Limit's own Aura Spark animation, with wind and dust in your
     aura's color. Nothing to download.
  2. Shin Budokai 2 style (a separate mod, not part of this release): put the
     SB2_Ki_Charge folder in the "mods" folder and switch it on in Main Menu > Mods.
- "Online" instead of "Xbox LIVE" in the menus, and a new "Online Battle" title.
- PlayStation, Nintendo Switch and Xbox Series button icons, sharp at any resolution,
  with the matching controller picture in Control Settings. They follow the controller
  you use (F1 > DISPLAY > Button icons to pick one).
- Save export / import: F1 > SAVE. Export makes a zip of your save in the "saves"
  folder; Import loads one back (also saves from Xenia). Your current save is backed up
  first.
- Texture packs: DDS (BC7) packs are supported, and decoding is about 8x faster.
  Tip: keep big packs on an SSD, not a hard drive - it's the main cause of stutter.
  With 32 GB of RAM or more you can also raise texture_replace_ram_mb in
  burstlimit.toml (for example texture_replace_ram_mb = 12288).
- Online: version 4.1 only plays with 4.1 (rooms are version-locked).

MODS
- mods\<Mod name>\<file>   - the file is named like the file inside the game's archive
  LONG2DATA_US.CPK, for example mods\My_Goku\BCGOK002.NUX
- An optional mod.toml in the mod's folder gives it a name:
  name = "My Goku"   author = "..."   version = "1.0"   description = "..."
- Main Menu > Mods > Browse mods: switch them on or off, then Apply.
- The game's own files are never changed.
- Online, rooms only match players with the same mods on.

ONLINE - both players need THIS SAME version (4.1)
- Host:  Versus > Online Battle > Player Match > Create Match > pick the rules.
         Keep "Private Session" OFF (ON hides the room from the list).
         Then wait in the Session Lobby.
- Guest: Versus > Online Battle > Player Match > Custom Match.
         Leave every search page on Random and press A. The host's room shows
         with their name: pick it.
- Both press Ready! in the Session Lobby.
- If Windows Firewall asks, allow burstlimit.exe (private and public networks).
- The two PCs connect directly; if that's not possible, through a relay server.
- Your name: open burstlimit.toml with Notepad and write it in
  online_name = "YourName"   (max 15 characters, English letters and numbers).
  Leave it empty ("") to use your Windows user name.
- Input delay: F1 > GAME > Online input delay. The HOST's value is used by both.
  2 = very low ping, 3-4 = normal (4 is the default), 6-8 = high ping.
  The online settings are copied from the host and can't change during a session.
- If something goes wrong online, send burstlimit.log (next to burstlimit.exe)
  in a GitHub issue.

ONLINE (old method: Radmin VPN / LAN) - still works
- Host: Host_Online.bat, enter your Radmin IP, create a Player Match.
- Join: Join_Online.bat, enter your Radmin IP then the host's IP, search for a Player Match.
- Allow burstlimit.exe through Windows Firewall (the game's UDP port is 59395).
- "Online input speed" (F1 > GAME) is used by this method. It shows when
  "Online input delay" is set to "Game default".
- Local_Online_Test.bat runs two copies on one PC to test.

TIP - 30 FPS with an NVIDIA GPU?
- Don't set "Max Frame Rate" to 60 in the NVIDIA Control Panel / NVIDIA App for this
  game: it locks the game to 30. Use the game's own setting instead:
  F1 > GAME > Frame rate.

- F1 (or Back + Start on the controller) = settings menu: resolution, upscalers
  (AMD FSR, NVIDIA DLSS, CAS), frame rate (30 / 60 / 120 / 144 / unlocked), field of
  view, effects, button icons, Ki charge, saves, free camera... Changes apply right
  away and are saved to burstlimit.toml.
- F3 = FPS panel.
- Character select: RB / LB = start the match transformed (Super Saiyan Goku,
  Final Form Frieza, Perfect Cell...). Versus and Training, not online matches.
- Texture packs: put the pack in textures\replace (next to burstlimit.exe) and turn on
  "Texture pack" in the settings menu.
- Free camera: Insert on the keyboard, or Y in the settings menu. Works in cinematics
  and super attacks too. Numpad 0 (or X in the free camera) freezes the game for a photo.
  Both keys can be changed in Settings > Game.
  Left stick moves, right stick looks, LB/RB down/up, LT/RT slower/faster,
  D-pad up/down zoom, D-pad left/right tilt, A hides the HUD, Y resets, B exits.
- Controller works out of the box. Keyboard: run burstlimit.exe --mnk_mode=true

THIRD-PARTY
- NVIDIA DLSS: this software uses NVIDIA DLSS (nvngx_dlss.dll), distributed under the
  NVIDIA RTX SDKs license (licenses\NVIDIA-RTX-SDKs-LICENSE.txt). NVIDIA, GeForce RTX and
  DLSS are trademarks of NVIDIA Corporation. This project is not affiliated with or
  endorsed by NVIDIA.
- AMD FidelityFX: amd_fidelityfx_loader_dx12.dll and amd_fidelityfx_upscaler_dx12.dll
  (AMD FSR 4 / 3.1.5, licenses\AMD-FidelityFX-SDK-license.md) and amd_fidelityfx_dx12.dll
  (FSR 1/2/3 present effects). This project is not affiliated with or endorsed by AMD.
- libjuice (online connections), Mozilla Public License 2.0, used unmodified
  (licenses\libjuice-LICENSE.txt). Source: https://github.com/paullouisageneau/libjuice
- Button icons: Xelu's Free Controller Prompts by Nicolae "Xelu" Berbece, CC0 (public
  domain): https://thoseawesomeguys.com/prompts/

--------------------------------------------------------------------------

دراغون بول زد: بيرست لِمِت - نسخة ريكومب (ألفا - الإصدار 4.1)

هذي نسخة تجريبية، ومتوقع فيها مشاكل.
ما فيها ملفات اللعبة، لازم تكون عندك نسختك من اللعبة.

طريقة التشغيل
1. (بس إذا اللعبة ما اشتغلت) ثبّت Microsoft Visual C++ Redistributable (x64):
   https://aka.ms/vs/17/release/vc_redist.x64.exe
2. شغّل burstlimit.exe. أول مرة بتطلب منك ملف الـISO حق لعبة Dragon Ball Z: Burst Limit
   للإكس بوكس 360: اختاره، وملفات اللعبة بتنسخ في مجلد "game_data_root" (حوالي 3.3 جيجا،
   مرة وحدة بس). ملف الـISO نفسه ما يتغير.
   تشتغل بس النسخة الأمريكية (NTSC-U)، والتثبيت يتأكد منها.
   (وتقدر برضو تستخرج ملفات اللعبة بنفسك داخل "game_data_root": لازم يكون فيه
   default.xex ومجلد LONG2DATA.)

الجديد في 4.1
- تثبيت اللعبة من ملف الـISO أول تشغيل (الشرح فوق).
- أسرع بكثير: تقريباً ضعف الفريمات على 4K (من 100 إلى 190+ على RTX 4080 في تجاربنا)،
  و +40% مع DLAA، و +32% على كرت AMD المدمج. النتيجة تختلف حسب الجهاز.
- قائمة المودز: القائمة الرئيسية > Mods (تحت Options). حط المودات في مجلد "mods" جنب
  burstlimit.exe (كل مود بمجلد)، وشغلها أو طفها بدون ما تعيد تشغيل اللعبة.
  مودات موديلات PS3 تشتغل بعد (تتحول لحالها). الشرح تحت في المودز.
- شحن الكي Ki Charge (اختياري، مطفي افتراضياً): اضغط مطولاً على L3 عشان تشحن الكي، مثل
  Shin Budokai. على الأرض وفي الجو، ولما يمتلي الكي تسوي الشخصية حركة النهاية.
  شغله من F1 > GAME > Ki charge. في الأونلاين إعداد الهوست يمشي على الاثنين.
  فيه نوعين:
  1. المدمج: حركة Aura Spark من Burst Limit نفسها، مع ريح وغبار بلون هالتك. ما يحتاج تحميل.
  2. ستايل Shin Budokai 2 (مود منفصل، مو جزء من هذا التحديث): حط مجلد SB2_Ki_Charge داخل
     مجلد "mods"، وشغله من القائمة الرئيسية > Mods.
- "Online" بدل "Xbox LIVE" في القوائم، وعنوان جديد "Online Battle".
- أزرار PlayStation و Nintendo Switch و Xbox Series، واضحة على أي دقة، مع صورة اليد
  المناسبة في Control Settings. تتبع اليد اللي تلعب فيها (أو اختار من
  F1 > DISPLAY > Button icons).
- تصدير واستيراد التخزينة: F1 > SAVE. التصدير يسوي ملف zip لتخزينتك في مجلد "saves"،
  والاستيراد يرجعها (حتى تخزينات Xenia). تخزينتك الحالية تنحفظ نسخة منها قبل.
- باكات التكستشرز: صار يدعم باكات DDS (BC7)، وفك الصور صار أسرع تقريباً 8 مرات.
  نصيحة: حط الباكات الكبيرة على SSD مو هارد عادي، الهارد هو أكبر سبب للتقطيع.
  وإذا عندك 32 جيجا رام أو أكثر، ارفع texture_replace_ram_mb في burstlimit.toml
  (مثلاً texture_replace_ram_mb = 12288).
- الأونلاين: نسخة 4.1 تلعب بس مع 4.1 (الغرف مقفلة على نفس النسخة).

المودز
- mods\<اسم المود>\<الملف>   اسم الملف نفس اسمه داخل أرشيف اللعبة LONG2DATA_US.CPK،
  مثلاً mods\My_Goku\BCGOK002.NUX
- ملف mod.toml اختياري داخل مجلد المود يعطيه اسم:
  name = "My Goku"   author = "..."   version = "1.0"   description = "..."
- القائمة الرئيسية > Mods > Browse mods: شغل أو طف، بعدين Apply.
- ملفات اللعبة الأصلية ما تتغير أبداً.
- في الأونلاين، الغرف تطلع بس للي عندهم نفس المودات مشغلة.

الأونلاين - لازم الاثنين يستخدمون نفس هذي النسخة (4.1)
- الهوست: Versus > Online Battle > Player Match > Create Match واختار القوانين.
  خل "Private Session" على OFF (لو ON الغرفة ما تطلع في القائمة).
  بعدها انتظر في الـSession Lobby.
- اللي يدخل: Versus > Online Battle > Player Match > Custom Match.
  خل كل صفحات البحث على Random واضغط A. بتطلع لك غرفة الهوست باسمه، اختارها.
- الاثنين يضغطون Ready! في الـSession Lobby.
- إذا جدار الحماية (Windows Firewall) طلب إذن، اسمح لـ burstlimit.exe (الشبكات الخاصة والعامة).
- الجهازين يتصلون ببعض مباشرة، وإذا ما قدروا يتصلون عن طريق سيرفر وسيط.
- اسمك: افتح burstlimit.toml بالمفكرة (Notepad) واكتبه في
  online_name = "YourName"   (أقصى شي 15 حرف، حروف إنجليزية وأرقام بس).
  خله فاضي ("") عشان ياخذ اسم مستخدم الويندوز حقك.
- تأخير الضغطات: F1 > GAME > Online input delay. قيمة الهوست هي اللي تمشي على الاثنين.
  2 = بنق واطي جداً، 3-4 = عادي (4 هو الافتراضي)، 6-8 = بنق عالي.
  إعدادات الأونلاين تنسخ من الهوست وما تتغير خلال الجلسة.
- إذا صارت مشكلة بالأونلاين، أرسل ملف burstlimit.log (جنب burstlimit.exe) في Issue على GitHub.

الأونلاين (الطريقة القديمة: Radmin VPN أو شبكة محلية) - للحين تشتغل
- الهوست: شغّل Host_Online.bat واكتب IP حقك في Radmin وسوّ Player Match.
- اللي يدخل: شغّل Join_Online.bat واكتب IP حقك بعدين IP الهوست، ودوّر على Player Match.
- اسمح لـ burstlimit.exe في جدار الحماية (منفذ اللعبة UDP 59395).
- خيار "Online input speed" (F1 > GAME) حق هذي الطريقة، ويطلع إذا "Online input delay"
  على "Game default".
- Local_Online_Test.bat يشغل نسختين على نفس الجهاز للتجربة.

نصيحة - اللعبة على 30 فريم وكرتك NVIDIA؟
- لا تحط "Max Frame Rate" على 60 في NVIDIA Control Panel أو NVIDIA App لهذي اللعبة:
  يقفل اللعبة على 30. استخدم خيار اللعبة نفسها: F1 > GAME > Frame rate.

- زر F1 (أو Back + Start في اليد) يفتح قائمة الإعدادات: الدقة، رفع الدقة (AMD FSR و
  NVIDIA DLSS و CAS)، الفريمات (30 / 60 / 120 / 144 / مفتوحة)، زاوية الرؤية، المؤثرات،
  شكل الأزرار، شحن الكي، التخزينة، الكاميرا الحرة... التغييرات تنطبق على طول وتنحفظ في
  burstlimit.toml.
- زر F3 يعرض الفريمات.
- شاشة اختيار الشخصيات: RB / LB تختار التحول اللي تبدأ فيه القتال (قوكو سوبر ساين،
  فريزا الشكل الأخير، سيل الكامل...). في Versus والتدريب، مو في الأونلاين.
- باكات التكستشرز: حط الباك في مجلد textures\replace (جنب burstlimit.exe)
  وشغّل "Texture pack" من قائمة الإعدادات.
- الكاميرا الحرة: زر Insert بالكيبورد، أو Y داخل قائمة الإعدادات. تشتغل بالكت
  سينز والضربات الخاصة بعد. زر 0 بالنمباد (أو X وانت بالكاميرا) يوقف اللعبة عشان تصوّر.
  تقدر تغيّر الزرين من الإعدادات > Game.
  العصا اليسار تحرك، اليمين تلف، LB/RB نزول وطلوع، LT/RT أبطأ وأسرع،
  الأسهم فوق وتحت زوم، يمين ويسار ميلان، A يخفي الواجهة، Y يرجع الكاميرا، B يطلع.
- اليد تشتغل على طول. للكيبورد: شغّل burstlimit.exe --mnk_mode=true

برامج خارجية
- NVIDIA DLSS: البرنامج يستخدم NVIDIA DLSS (nvngx_dlss.dll) تحت رخصة NVIDIA RTX SDKs
  (licenses\NVIDIA-RTX-SDKs-LICENSE.txt). NVIDIA و GeForce RTX و DLSS علامات تجارية لشركة
  NVIDIA. المشروع مو تابع لإنفيديا ولا مدعوم منها.
- AMD FidelityFX: الملفات amd_fidelityfx_loader_dx12.dll و amd_fidelityfx_upscaler_dx12.dll
  (AMD FSR 4 / 3.1.5، الرخصة licenses\AMD-FidelityFX-SDK-license.md) و amd_fidelityfx_dx12.dll
  (FSR 1/2/3). المشروع مو تابع لـAMD ولا مدعوم منها.
- libjuice (اتصال الأونلاين)، رخصة Mozilla Public License 2.0، بدون تعديل
  (licenses\libjuice-LICENSE.txt).
- أيقونات الأزرار: Xelu's Free Controller Prompts من Nicolae "Xelu" Berbece، رخصة CC0
  (ملكية عامة): https://thoseawesomeguys.com/prompts/
