project-bo4/shield-development

SHIELD

A very experimental modification platform for Call of Duty®: Black Ops 4 run by the community, aiming at improving both functionality and performance of the original game.

DEMONWARE

As of May 11, 2023, we have merged the 'demonware' branch into 'master'. It includes a built-in demonware server emulator which allows the player to start a game without an active connection to the official online servers.

INSTRUCTIONS

You should already have the publisher files required for playing online (found under the LPC folder of your game directory). If this is not the case, then start Black Ops 4 through Battle.NET launcher once to get those files downloaded.

1- Clone repository with its sub-modules using git bash and run generate.bat to make a visual studio solution which you will find inside build folder named shield-development.sln, then you will have to bring up the vs project with it and compile the project with release configuration.

2- Find and copy the compiled XInput9_1_0.dll from the build output folder into your BlackOps4 folder.

3- Start the game with BlackOps4.exe. you will know if you got it correctly if you see a ( ͡❛ ͜ʖ ͡❛) splash screen.

In case you wanted to revert the game back to the original Battle.NET servers, just remove the proxy dll XInput9_1_0.dll from your game folder. You can put it back whenever you want to re-install the client.

SHIELD DOCUMENTATION

Documentation with some more information regarding client's features and user manual can be found here.

SUBMITTING ISSUES

The Github Issues section is only for reporting programmatical errors related to the client. Please don't use it for requesting features or seeking help with personal issues such as experiencing faulty game data or similar problems. Use Battle.NET's 'Scan And Repair' feature to fix those problems.

NOTES

• Base Software Framework used by this project is initially authored by Maurice Heumann. furthermore its been improved and refined by us to support feature expansions.

• There are some 3rd-party project/tools that have influenced and helped the project in particular ways; If you belive there is something originated from you and want to be credited, please contact any of our social media accounts.

• This Project is created purely for educational purposes. It's free and open-sourced under the GNU License. Developers are not responsible or liable for misuse of this product.

Roadmap

CLIENT-SIDE:

• Online Battle.NET Connection Requirement Removal
• Built-in Demonware Server Emulation
• BlackBox Crash Reporting Component
• In-game Interactable Console
• GSC & Lua Modding Support
• Enable Aim-Assist for Game Controllers
• Miscellaneous Features such as 1st-Person View FOV

SERVER-SIDE:

• Fully Functional Online Server Emulator
• Implement Basic Matchmaking with QOS Logic
• Try to Create Dedicated Server off Public Ship Builds

shield-development's Issues

Can't get past connecting to online service

I am using the debug-64 dll because release doesn't compile, and I don't know what else to show you other than this information.
2023-04-01 11:47:59 [ DEBUG ] [ DISCOVERY ]: Signature scanning complete. 27/28 successful
2023-04-01 11:47:59 [ DEBUG ] [ SYSTEM ]: game version string: BlackOps4 CL(13869365) BEYQBBUILD106 DEV [Wed Feb 22 16:31:32 2023]
2023-04-01 11:48:00 [ DEBUG ] [ NETWORK ]: [gethostbyname]: "Mickalebs-Computer"
2023-04-01 11:48:00 [ DEBUG ] [ NETWORK ]: [gethostbyname]: "Mickalebs-Computer"
2023-04-01 11:48:00 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "ops4-stun.us.demonware.net" "(null)"
2023-04-01 11:48:00 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "ops4-stun.eu.demonware.net" "(null)"
2023-04-01 11:48:00 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "ops4-stun.au.demonware.net" "(null)"
2023-04-01 11:48:00 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "ops4-stun.jp.demonware.net" "(null)"
2023-04-01 11:48:12 [ DEBUG ] [ IAT-HOOKS ]: Diverted USER32.DLL::GetSystemMetrics from 00007FF6F39A53E0 to 00007FFCF84E06E0
2023-04-01 11:48:12 [ INFO ] =======================================================================================================
2023-04-01 11:48:12 [ INFO ] Project-BO4 Initializing ... BlackOps4.exe[0x7FF6E0A40000]
2023-04-01 11:48:12 [ INFO ] =======================================================================================================
2023-04-01 11:48:18 [ DEBUG ] get_system_metrics(4096)
2023-04-01 11:48:19 [ DEBUG ] [ DISCOVERY ]: Starting signature scan; total defined symbols: 28
2023-04-01 11:48:20 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "ops4-pc-auth3.prod.demonware.net" "443"
2023-04-01 11:48:20 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "level3.blizzard.com" "80"
2023-04-01 11:48:20 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "blzddist1-a.akamaihd.net" "443"
2023-04-01 11:48:20 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "us.cdn.blizzard.com" "80"
2023-04-01 11:48:20 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "level3.ssl.blizzard.com" "443"
2023-04-01 11:48:20 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "us.cdn.blizzard.com" "443"
2023-04-01 11:48:20 [ DEBUG ] get_system_metrics(0)
2023-04-01 11:48:20 [ DEBUG ] get_system_metrics(1)
2023-04-01 11:48:30 [ DEBUG ] [ NETWORK ]: [getaddrinfo]: "ops4-pc-auth3.prod.demonware.net" "443"
2023-04-01 11:48:31 [ DEBUG ] [ NETWORK ]: [gethostbyname]: "Mickalebs-Computer"

Leveling

I have a problem where in the lobby my level is 1 and ingame it shows im 55, and it does not unlock for me the weapons and everything in lobby.

is it possible to use commands

such as unlocking all, max level, and mastery

Linux/SteamOS support?

I wanted to ask if there would be support for the Steam Deck. The game runs perfectly so I was curious if this future modification would be supported on the platform as well or if testing is needed, I can help out through that.

Can't level up in zombies

Even though I'm level 29, it says I'm level 1 and I can't use any unlocks. Does anyone have a fix for this?

LPC Files missing

Attempted to launch for the first time, and it says I need LPC files not provided by the download

Yeees.

Thanks for opensourcing. If you add a little bit of credits, I would be very happy :)
Thank you and good luck with it :D

[DEMONWARE] Issue with people cloning wrong branch

[bug] pause menu

In game especially on zombies, unable to pause game, change class, quit game ect
Until death or match ends

Tag der toten randomly game overs when alt tabing

The game just ends, couldn't find a pattern but it only happens in tag

commands

hello is there any docs of the commands that are usable?

broken links in Shield Documentation

links no longer available (I just copied them from Documentation):
Demonware Server Emulator
Download DwServer here .
Automatic Setup
Install DwServer installer from here .
Manual Setup
Download server from here.
Open ports
Automatic
Download FIREWALL RULES.BAT here.
### p.s. Maybe more but that all I found and they all server related

Error when playing Alpha Omega

an error occurred: Zulu 523 Lion
just goes back to action report from prevous match/lobby

Aim assist

Hi, is it possible for you to add aim assist to the client

Is this repo required for running BO4 client independent from Treyarch's servers in today's state?

How to switch languages

How to switch languages

Possible features

Again this isn’t no rush as I’m enjoying the mod client you have made.
but at some point in the future it would be good to have these features.

gcs scripting: to add mods to game such as mod menus for lan use/ non ranked matches

Servers, lan connection
To play with players online and locally

Dedicated servers for blackout (anti cheat?)
It would be good to play blackout again but with anticheat added to stop hackers,
It would be great having different modes to. Such as gun game, zombies only, snipers only, ect

As time/ money consuming as it may be,
It would be good to have set dedicated servers by default so players have an always up to date servers to play on. (And a way for dontations, this could help with server cost and keep players for longer)

Friends list, - away to add players, send invites, block ect

voice chat: it would be good to be able to use a mic instead of text on the game as I’m a controller user and many others will be too.

cloud storage, profiles?
the ability to make an account to log in to play the mod, add friends, game progress ect,
If this is added, please make a playnite addon where you can log in via addon or have a virtual on screen keyboard for controllers and a way to navigate around.

Disconnected from server

Whenever I launch the client, the intro cinematic will be skipped and I will be stuck on the title screen with a "Disconnected from server" message. Pressing retry just leaves me stuck on the main menu with "connecting to server" in the bottom left corner

[Bug] Crashes when trying to launch in Parallels on an Apple Silicon Mac

Since the official game doesn't launch in any way shape or form on macOS, I decided "what have I to lose?" so I tried this. Launching at least showed the ( ͡° ͜ʖ ͡°) boot view, then it errors and says "check minidump".

System Info

CPU - M2 Pro (8 cores allocated to Windows, 4 to macOS)
Memory - 16GB (10GB allocated to Windows, 6 to macOS)
Host OS Version - macOS Sonoma 14.4 beta 3
VM OS Version - Windows 11 Pro ARM (Insider Build 26052)

Minidump File

shield-crash-2024-03-07-22-40-38.zip

Discord

is there anyway we can get a updated discord link in the readme, the ones on twitter are all broken and the server is hard to find.

Online play

can we play with our friends using virtual lan apps such as radminVPN or Hamachi or ... ?

Error whenever loading into anything [bug]

Title. Zombies, Multiplayer bot lobbies, everything. I get an error about 2 or 3 seconds after loading into any match saying "Project-BO$ ERROR Fatal error ((0xC0000005) at 0x00007FF71221A4E4 (0x0000000003C5A4E4). A minidump has been written." I am playing on an ROG ALLY in 30W Turbo mode.

Fatal error problem.

Was playing zombies on blood of the dead and on about round 10-11 I paused the game for a min and after comming back to my pc I just saw this error

What does this mean

Connect to p2p

Is there a command like iw4x where you type “connect ” but I can’t find it in this one, has ur changed or something?

broken russian language

when i start the game via rr_* or ru_, it doesn't want to work
via rr_ - infinite connecting to server, even with Offline mode
via ru_* - game crush + all files in LPC are deleted except ru_* and tc_*

crash reports

I have no idea where to post crashes so I thought id post them here.
bo4-crash-2023-07-03-18-59-07.zip

i was going threw all the calling cards to get rid of the green unseen icon cause im ocd. when going into the tiger cheata section i crashed.

Crash in PaP Area in Ancient Evil

BlackOps4.20230923-141335.dmp.zip
This is the dump file. I crashed randomly on round 15, I think. Error Code 1975752514. I was in pap place, doing trials. I was using the latest patch with the modified 999 elixir thingy that was shared in the discord and approved (I think).

gcs scripting & Servers

is there any chance you guys are going to add servers and scripting?

no rush just wondering?

Please switch to using minhook lib instead of dll

Would simplify things a bit and then only require d3d11.dll

[DEMONWARE] Various issues

• Is there a way to change the name?--- Fixed with "ate47" PR.
• Is it possible to access the console somehow?
• Can you add the playlist to the demonware emulator?
• You can add aim assist?
• You plan to load .gsc and .lua in the future?