t8-mod/README.md

55 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

2024-05-16 17:35:57 -04:00
# T8-Mod
2023-07-12 03:03:55 -04:00
2023-03-06 15:40:07 -05:00
![code](https://raw.githubusercontent.com/project-bo4/shield-development/master/assets/readme_header.jpg)
## SHIELD
2024-05-23 02:53:38 -04:00
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.
2023-03-06 15:40:07 -05:00
Squashed commit of the following: commit f44d146e4ac906ff898e8968c6857fd2280f6d20 Author: project-bo4 <127137346+project-bo4@users.noreply.github.com> Date: Thu May 11 13:39:29 2023 -0700 remove lpc package from repository commit 29fb0f63e50de468ab0b9db35f7e8fdadf58afc3 Author: project-bo4 <themanwithantidote@gmail.com> Date: Thu May 11 13:06:13 2023 -0700 generic improvements + added identity configuration + objectstore improvements + added battlenet 'US' servers to blocklist + some other minor improvements commit 5d5e31099ebcce5a637b9a02d4936a97fb0802a7 Author: project-bo4 <themanwithantidote@gmail.com> Date: Sat Mar 25 16:32:52 2023 -0700 lpc improvements + fix lpc issue with foreign languages(non-english) not being considered in listing + check lpc files pre-start and warn user if missing any of core items commit 2de1a54b6f4cc5c44dc906871021cfbc85057ca9 Author: project-bo4 <themanwithantidote@gmail.com> Date: Thu Mar 23 12:45:56 2023 -0700 demonware improvements + handle object store uploadUserObject + silence bdUNK125 commit 710dcc3ec6178071d67c27e5bf6705f08cabe7e2 Author: project-bo4 <themanwithantidote@gmail.com> Date: Mon Mar 20 13:43:56 2023 -0700 forgot to update names commit 217682dfb07b35f7a09399fb2698924bb7fe8b77 Author: project-bo4 <themanwithantidote@gmail.com> Date: Mon Mar 20 11:09:18 2023 -0700 upload lpc and update readme commit 83f812b33b90791a8d13b9468f27da51e0a4f2b9 Author: project-bo4 <themanwithantidote@gmail.com> Date: Mon Mar 20 10:53:43 2023 -0700 demonware emulator + demonware emulator + platform name and id + xxhash and picoproto - remove g_runframe hook -disable discovery(save time) + improvements to utils + add new resources
2023-05-11 16:50:11 -04:00
## DEMONWARE
2024-05-23 02:53:38 -04:00
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.
2023-03-21 03:14:36 -04:00
2023-03-06 15:40:07 -05:00
2024-02-09 15:19:48 -05:00
## INSTRUCTIONS
2023-07-12 03:03:55 -04:00
2024-05-23 02:53:38 -04:00
> 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 run Black Ops 4 through Battle.NET Launcher once to get those files downloaded.
2023-03-06 15:40:07 -05:00
2024-05-23 02:53:38 -04:00
1- Clone repository with its sub-modules and use ```generate.bat``` to make a Visual Studio solution, then compile project and copy ``d3d11.dll`` into your BO4 folder.
2023-03-06 15:40:07 -05:00
2024-02-09 15:19:48 -05:00
2- Start BlackOps4.exe
2023-03-06 15:40:07 -05:00
2024-05-23 02:53:38 -04:00
*In case you wanted to revert back to using the original Battle.NET servers, just delete the generated ``d3d11.dll`` file from your game folder. You can re-generate and copy ```d3d11.dll``` back later whenever you want to re-install the client.*
2023-07-12 03:03:55 -04:00
2024-02-09 15:19:48 -05:00
## SHIELD DOCUMENTATION
Documentation on shield can be found [here](https://shield-bo4.gitbook.io/).
2023-07-12 03:03:55 -04:00
## SUBMITTING ISSUES
2024-05-23 02:53:38 -04:00
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.
2023-03-07 08:45:02 -05:00
Squashed commit of the following: commit f44d146e4ac906ff898e8968c6857fd2280f6d20 Author: project-bo4 <127137346+project-bo4@users.noreply.github.com> Date: Thu May 11 13:39:29 2023 -0700 remove lpc package from repository commit 29fb0f63e50de468ab0b9db35f7e8fdadf58afc3 Author: project-bo4 <themanwithantidote@gmail.com> Date: Thu May 11 13:06:13 2023 -0700 generic improvements + added identity configuration + objectstore improvements + added battlenet 'US' servers to blocklist + some other minor improvements commit 5d5e31099ebcce5a637b9a02d4936a97fb0802a7 Author: project-bo4 <themanwithantidote@gmail.com> Date: Sat Mar 25 16:32:52 2023 -0700 lpc improvements + fix lpc issue with foreign languages(non-english) not being considered in listing + check lpc files pre-start and warn user if missing any of core items commit 2de1a54b6f4cc5c44dc906871021cfbc85057ca9 Author: project-bo4 <themanwithantidote@gmail.com> Date: Thu Mar 23 12:45:56 2023 -0700 demonware improvements + handle object store uploadUserObject + silence bdUNK125 commit 710dcc3ec6178071d67c27e5bf6705f08cabe7e2 Author: project-bo4 <themanwithantidote@gmail.com> Date: Mon Mar 20 13:43:56 2023 -0700 forgot to update names commit 217682dfb07b35f7a09399fb2698924bb7fe8b77 Author: project-bo4 <themanwithantidote@gmail.com> Date: Mon Mar 20 11:09:18 2023 -0700 upload lpc and update readme commit 83f812b33b90791a8d13b9468f27da51e0a4f2b9 Author: project-bo4 <themanwithantidote@gmail.com> Date: Mon Mar 20 10:53:43 2023 -0700 demonware emulator + demonware emulator + platform name and id + xxhash and picoproto - remove g_runframe hook -disable discovery(save time) + improvements to utils + add new resources
2023-05-11 16:50:11 -04:00
## NOTES
2024-05-23 02:53:38 -04:00
- Base SDK (well kinda...) used by this project is developed by [Maurice Heumann](https://github.com/momo5502); Thanks to the guy.
2023-03-06 15:40:07 -05:00
2024-05-23 02:53:38 -04:00
- 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.
2023-03-06 15:40:07 -05:00
2024-05-23 02:53:38 -04:00
- 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.
2023-07-12 03:03:55 -04:00
## Roadmap
### CLIENT-SIDE:
2024-05-23 02:53:38 -04:00
- [x] Online Battle.NET Connection Requirement Removal
2023-07-12 03:03:55 -04:00
- [x] Built-in Demonware Server Emulation
- [x] BlackBox Crash Reporting Component
2023-09-06 11:36:48 -04:00
- [x] In-game Interactable Console
2024-05-23 02:53:38 -04:00
- [x] GSC & Lua Modding Support
2024-02-09 15:19:48 -05:00
- [ ] Enable Aim-Assist for Game Controllers
2024-05-23 02:53:38 -04:00
- [ ] Miscellaneous Features such as 1st-Person View FOV
- [ ] Fix *uncommon* Runtime "Black Screen" issue along other instabilities
2023-09-06 11:36:48 -04:00
2023-07-12 03:03:55 -04:00
### SERVER-SIDE:
2023-09-06 11:36:48 -04:00
- [x] Fully Functional Online Server Emulator
2024-05-23 02:53:38 -04:00
- [ ] Implement Basic Matchmaking with QOS Logic
2023-07-12 03:03:55 -04:00
- [ ] Try to Create Dedicated Server off Public Ship Builds