e00fdf473a
+ addressed every code safety demands compiler had in order to make it possible to build in release configuration without suppressing warning(warning C4244 still had to be suppressed because it was coming from external libraries xxhash and stb) + changed to proxying XInput9_1_0 instead of directx11 interface + recoded protocolbuffer helper + improved variable namings in fileshare - removed ida_defs.h header as its not needed anymore
56 lines
3.1 KiB
Markdown
56 lines
3.1 KiB
Markdown
|
|
|
|
|
|
|
|
## 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](https://shield-bo4.gitbook.io/).
|
|
|
|
|
|
## 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](https://github.com/momo5502). 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:
|
|
- [x] Online Battle.NET Connection Requirement Removal
|
|
- [x] Built-in Demonware Server Emulation
|
|
- [x] BlackBox Crash Reporting Component
|
|
- [x] In-game Interactable Console
|
|
- [x] GSC & Lua Modding Support
|
|
- [ ] Enable Aim-Assist for Game Controllers
|
|
- [ ] Miscellaneous Features such as 1st-Person View FOV
|
|
|
|
### SERVER-SIDE:
|
|
- [x] Fully Functional Online Server Emulator
|
|
- [ ] Implement Basic Matchmaking with QOS Logic
|
|
- [ ] Try to Create Dedicated Server off Public Ship Builds
|