A fork of https://github.com/faroukbmiled/BOIIIWD - Call of Duty: Black Ops III Workshop Mod & Custom Map Downloader | Rebranded for T7x
Go to file
2023-09-29 17:29:48 +01:00
boiiiwd_package revert back to bs4 for item sizes for now due to API being inconsistent 2023-09-29 17:29:48 +01:00
.gitignore Refactor project 2023-09-20 02:33:09 -02:30
build.py Refactor project 2023-09-20 02:33:09 -02:30
README.md v0.3.1 2023-09-26 18:51:22 +01:00
requirements.txt use latest pyinstaller 2023-09-19 03:03:58 -02:30

BOIIIWD

  • A Feature-rich GUI Steam Workshop downloader for BO3 (boiii client) built using CustomTkinter

Usage (exe):

  • Run BOIIIWD.exe and use it (it'll ask you to download steamcmd within the app if not found)
  • That's it slap in your workshop item link or just the id then hit Download and wait for it to finish, when it does just launch your game (Please check Notes before you ask anything)
  • If the exe is getting flagged as a virus by your ac it is obviously a false positive, if you still do not trust it you can compile/freeze it yourself (VirusTotal Scan)

Usage (script):

Features:

  • Improves steamcmd's stability while downloading
  • Auto installs mods and maps to boiii
  • Queue -> download items in queue
  • Library tab -> lists your downloaded items
  • Item updater -> Checks your items for updates (redownloads them,no way for now to "update" them only) -> Under Library tab
  • Steam to boiii -> Item mover (moves items (mods,maps) from steam to boiii client) -> Under settings tab
  • Themes -> Under settings tab
  • Bunch of useful settings -> Under settings tab

Freezing into an exe (pyinstaller):

Queue tab (beta)

  • added Queue tab which has a text field that you can slap in workshop ids/links in 2 formats, for example:

3010399939,2976006537,2118338989 or

2976006537
2118338989
2113146805

Notes:

  • It saves your input except for workshop id
  • If you do not know where to find your map in-game check this video out ,for mods find "mods" in the game's main menu
  • Initializing SteamCMD for the first time could take some time depending on your internet speed
  • New item update window: Right click on an item (mouse3) -> will open the item in the browser (Steam Workshop)
  • BOIIIWD requires having "boiiiwd_library.json" in the app's directory for the new features to work -> clicking on the library tab will generate the JSON file (please don't touch it)
  • v0.3.1 and up program will use windows registry to save window coordinates (height , width ,x_pos, y_pos)

PS (Library tab):

  • Mouse1 -> copy id
  • Mouse2 (scroll wheel btn) -> Open item path in explorer
  • Mouse3 -> Copy path
  • Ctrl + Mouse 1 (after Mouse1) -> Append to clipboard

Known bugs:

  • Rare UI bug => instead of showing a warning message, its window goes invisible and leads to the whole ui becoming unclickable (end the task from task manager)
  • Possible logic bugs related to the progress bar , sometimes it carries on progressing when you pressed stop => please raise an issue if this happens often
  • If the exe is getting flagged as a virus by your ac it is obviously a false positive, if you still do not trust it you can compile/freeze it yourself
  • VirusTotal

todos:

  • add a menu that shows you current installed mods/maps
  • fix the progress bar => progress bar logic based on an estimation
  • other improvements regarding the download (steamcmd likes to fail sometimes for no reason) => added a way to keep looping when steamcmd crashes and it will eventually finishes
  • add a queue window that you can slap in a bunch of items to download sequentially and or simultaneously
  • add an option to login with your account => delayed (do we really need it?)

Themes:

  • If you choose "custom" theme a file called boiiiwd_theme.json will be created in the current folder (where the exe at) , Don't add anything or edit any keyes just modify the colours, If you mess up something you can just rename the file and it'll go back to the default theme (you can always press custom again and the file will be created again, based on which theme you choose before)