Skip to content

Latest commit

 

History

History
65 lines (46 loc) · 2.71 KB

README.md

File metadata and controls

65 lines (46 loc) · 2.71 KB

Map Viewer for Call of Duty

This project is a browser-based viewer for Call of Duty maps, specifically supporting maps from Call of Duty 1 and Call of Duty: United Offensive. It uses babylon.js for rendering, allowing you to explore these maps in a 3D environment directly in your browser.

mp_uo_harbor.bsp ratskitchen2.bsp

Key Features

  • View maps from Call of Duty 1 and Call of Duty: United Offensive directly in your browser.
  • All original assets
  • Load and display original assets, including:
    • 3D models
    • Skyboxes
    • Lightmaps
    • Ambient audio

Future Potential

Support for Call of Duty 2 and Call of Duty 4 maps could be added with minimal effort.

Known Issues

  • Bad character controller
  • Z-fighting
  • Missing water animations
  • Transparency
  • Incorrect model rotations: Happens if they were rotated in multiple axes

Contributing

Contributions are welcome! If you’d like to improve this project, feel free to:

  • Open an issue for suggestions or bug reports.
  • Submit a pull request with your changes.

Running Locally

Follow these steps to set up the project locally:

  • Clone this repo
  • Create the public/cod/ folders. Extract all your .pk3 files into this folder.
  • Create the file public/cod/index. This file should contain a list of all the files in the folder (and sub-folders).
    • Example linux command to do this: find . -type f -printf '%P\n' > index
    • Example PowerShell command to do this: Get-ChildItem -Recurse | Where-Object { -not $_.PSIsContainer } | ForEach-Object { $_.FullName.Replace((Get-Location).Path + "\", "").Replace("\", "/") } | Sort-Object | Set-Content index
  • run npm install
  • run npm run dev
  • A local server should be accessible at http://localhost:3000

Acknowledgments

This project relies heavily on the work of these 2 projects:

Original Author TS translation
LibBSP wfowler1 libbsp-js
Call of Duty asset importer for Blender mauserzjeh libxmodel-js

Legal Disclaimer

This project is not affiliated with or endorsed by Activision or any other rights holders of the Call of Duty franchise.