Skip to content

Commit

Permalink
Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
misyltoad committed Aug 28, 2022
0 parents commit 11adbb5
Show file tree
Hide file tree
Showing 59 changed files with 11,926 additions and 0 deletions.
7 changes: 7 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# This file is here so GitHub uses 4-space tabs...

root = true

[*]
indent_style = tab
indent_size = 4
52 changes: 52 additions & 0 deletions .github/workflows/artifacts-windows.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
name: Build Artifacts for Windows

on: [push, pull_request, workflow_dispatch]

jobs:
build-set-windows:
runs-on: windows-2022

steps:
- name: Checkout Mini Source SDK 2013
id: checkout-minisdk
uses: actions/checkout@v3
with:
repository: 'Joshua-Ashton/mini-source-sdk-2013'

- name: Checkout VPhysics Jolt
id: checkout-code
uses: actions/checkout@v3
with:
path: 'mp/src/vphysics_jolt'
submodules: recursive

- name: Find Visual Studio
id: find-vs
shell: pwsh
run: |
$installationPath = Get-VSSetupInstance `
| Select-VSSetupInstance -Require Microsoft.VisualStudio.Workload.NativeDesktop -Latest `
| Select-Object -ExpandProperty InstallationPath
Write-Output "VSDEVCMD=${installationPath}\Common7\Tools\VsDevCmd.bat" `
| Out-File -FilePath "${Env:GITHUB_ENV}" -Append
- name: Build MSVC x86
id: build
shell: pwsh
working-directory: 'mp/src'
run: |
& "${Env:COMSPEC}" /s /c "`"${Env:VSDEVCMD}`" -arch=x86 -host_arch=x64 -no_logo && set" `
| % { , ($_ -Split '=', 2) } `
| % { [System.Environment]::SetEnvironmentVariable($_[0], $_[1]) }
.\fix_registry.bat
.\createjoltprojects.bat
devenv jolt.sln /upgrade
msbuild jolt.sln /nodeReuse:false /t:Rebuild /p:Configuration=Release /p:Platform=x86 /m /v:minimal
- name: Upload artifacts
id: upload-artifacts
uses: actions/upload-artifact@v2
with:
name: vphysics_jolt_sdk2013_win32
path: mp/game
if-no-files-found: error
3 changes: 3 additions & 0 deletions .gitmodules
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[submodule "joltphysics/src"]
path = joltphysics/src
url = https://github.com/jrouwe/JoltPhysics/
7 changes: 7 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
Copyright 2022 Joshua Ashton and Josh Dowell (Slartibarty)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
100 changes: 100 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
![VPhysics Jolt Logo](assets/cube_base_nobg.png "VPhysics Jolt")

## What is Volt? ⚡

Volt (VPhysics Jolt) is a replacement for Source's VPhysics which uses IVP/Havok<br>
Created by [Joshua Ashton (🐸✨)](https://github.com/Joshua-Ashton) [@phys_ballsocket](https://twitter.com/phys_ballsocket) and [Josh Dowell (Slartibarty)](https://github.com/Slartibarty) [@Slartbarty](https://twitter.com/Slartbarty).

Volt is designed to be incredibly high performance, supporting thousands of objects at once without bringing tick/framerate down to a crawl.

In our testing, the performance overhead from having thousands of objects moving at once, now comes from the client code needing to update/render, as going out of the PVS of these objects will still cause them to be simulated, but will no longer be rendered.

## Features

Volt is mostly feature complete, but is missing some things such as support for raycast vehicles, breakable constraints, and perhaps other things we've missed!

It is our goal to implement any missing features at some point.

Below is a feature table of Volt vs VPhysics and the Bullet VPhysics project.
If we missed anything we don't support or we do, feel free to add to it.
It is not meant to be a bash on anyone elses work however, the Bullet VPhysics project was a great inspiration to us!

| Feature | VPhysics | Volt (VPhysics Jolt) | Bullet VPhysics |
|:--------------|:--------:|:-------------:|:---------------:|
| Constraints (except Pulleys) | ✔️ | ✔️ | ✔️ |
| Pulleys | ✔️ |||
| Breakable constraints | ✔️ |||
| Motors (Motion Controllers) | ✔️ | ✔️ | ✔️ |
| Motors (Constraint) | ✔️ | ✔️ ||
| Ragdolls | ✔️ | ✔️ (some bugs) | ✔️ |
| Triggers | ✔️ | ✔️ ||
| Object touch callbacks | ✔️ | ✔️ ||
| Prop damage/breaking | ✔️ | ✔️ ||
| Fluid events | ✔️ | ✔️ ||
| Prop splashing effects | ✔️ | ✔️ ||
| Wheeled Vehicles | ✔️ | ✔️ | ✔️ |
| Raycast Vehicles (ie. Airboat) | ✔️ || 〰️ (janky) |
| NPCs/Doors (Shadow Controllers) | ✔️ | ✔️ | ✔️ |
| Save/Restore Support | ✔️ | ✔️ ||
| Portal Support | ✔️ | ✔️ ||
| Game per-object collide callback support<br>eg. no-collide | ✔️ | ✔️ ||
| Crash-resistant solver || ✔️ | (no data) |
| Supports thousands of objects without lag || ✔️ ||
| Multithreaded || ✔️ | ✔️ (partially) |
| Proper player controller | ✔️ | ❌ (needs work!) | ✔️ (partially) |

## Bugs

VPhysics Jolt is not without its flaws, however. See the [issue tracker](https://github.com/Joshua-Ashton/VPhysics-Jolt/issues) for bugs that are known.

There are definitely going to be bugs that we don't know about or haven't encountered, or different quirks across engine branches.

## How to build

The Volt code is provided as-is, it is up to you to build it for your SDK, etc.

Volt should build fine against Source SDK 2013 and Alien Swarm SDK on a MSVC or GCC compiler with at least C++20 support.

*If you are building directly against the public SDK 2013 and Alien Swarm SDKs, you will need to do minor work to memoverride.cpp to make it compatible with the newer compilers and newer Windows SDKs.*

Unfortunately we cannot redistribute the additional code/headers needed to build Volt for games such as Garry's Mod which uses a different VPhysics interface (CS:GO's) to what is found in the Valve-provided public SDKs.

## Download

For each release, binary builds are provided for Garry's Mod and Source SDK 2013 on the [Releases](https://github.com/Joshua-Ashton/VPhysics-Jolt/releases/) page.

## Media

### Lots of Melons + Dumpster
[![Lots of Melons + Dumpster](https://img.youtube.com/vi/gPDQkmfQCsc/0.jpg)](https://www.youtube.com/watch?v=gPDQkmfQCsc "Lots of Melons + Dumpster")

### Physically Simulated Chain
[![Physically Simulated Chain](https://img.youtube.com/vi/tVmQTmbSJM0/0.jpg)](https://www.youtube.com/watch?v=tVmQTmbSJM0 "Physically Simulated Chain")

### Lots of Balls Test
[![Lots of Balls Test](https://img.youtube.com/vi/tYfiTyRtmz8/0.jpg)](https://www.youtube.com/watch?v=tYfiTyRtmz8 "Lots of Balls Test")

### Wheels + Weld Car Dupe Test
[![Weld Car Dupe Test](https://img.youtube.com/vi/5_QbbXbIrg8/0.jpg)](https://www.youtube.com/watch?v=5_QbbXbIrg8 "Weld Car Dupe Test")

### Door + NPC (Physics Shadowed Objects) Test
[![Door + NPC (Physics Shadowed Objects) Test](https://img.youtube.com/vi/SdEj7HTuJmU/0.jpg)](https://www.youtube.com/watch?v=SdEj7HTuJmU "Door + NPC (Physics Shadowed Objects) Test")

### Lots of Cubes + Ragdolls + Funnel
[![Lots of Cubes + Ragdolls + Funnel](https://img.youtube.com/vi/CLVnSwg33Dk/0.jpg)](https://www.youtube.com/watch?v=CLVnSwg33Dk "Lots of Cubes + Ragdolls + Funnel")

### Slow Mo Cubes
[![Slow Mo Cubes](https://img.youtube.com/vi/GzW_4bufwEk/0.jpg)](https://www.youtube.com/watch?v=GzW_4bufwEk "Slow Mo Cubes")

### Propane in Dumpster
[![Propane in Dumpster](https://img.youtube.com/vi/10vvRJVHGQc/0.jpg)](https://www.youtube.com/watch?v=10vvRJVHGQc "Propane in Dumpster")

*Have some cool media of stuff going on in Volt you'd like to add? Feel free to make a pull request!*

## Projects using Volt

### [Portal 2: Desolation](https://emberspark.games/desolation/)

### [Prelude Online](https://prelude.online/)

# Have fun! 🐸⚡
Binary file added assets/cube_base_nobg.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 11adbb5

Please sign in to comment.