HughPH.Box2D 2025.3.10.2104

.NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher. 
dotnet add package HughPH.Box2D --version 2025.3.10.2104
                    


                    

                
NuGet\Install-Package HughPH.Box2D -Version 2025.3.10.2104
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="HughPH.Box2D" Version="2025.3.10.2104" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="HughPH.Box2D" Version="2025.3.10.2104" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="HughPH.Box2D" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add HughPH.Box2D --version 2025.3.10.2104
                    


                    

                
#r "nuget: HughPH.Box2D, 2025.3.10.2104"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#addin nuget:?package=HughPH.Box2D&version=2025.3.10.2104
                    


                            Install HughPH.Box2D as a Cake Addin
                        

                    

                
#tool nuget:?package=HughPH.Box2D&version=2025.3.10.2104
                    


                            Install HughPH.Box2D as a Cake Tool

Box2D-dotnet-bindings

Box2D 3.x Bindings for dotnet (C#, F#, VB, ...)

What is it?

This is a "link" from dotnet to Box2D 3.x, with an API that should be more familiar and comfortable to dotnet users. World has a Bodies property, Body has a Shapes property and a Joints property, and so on. Delegates are fully formed, rather than being vague IntPtrs. All methods and most properties are PascalCased and have XML documentation.

How is this better than Box2D.NetStandard/another port of Box2D 2.x?

Box2D 3.x contains significant efficiency improvements that make use of SIMD intrinsics. While it's not impossible to implement in C# - intrinsics have been available since dotnet 6 - it's probably unlikely that Box2D 3.x will be ported into Box2D.NetStandard: one of the challenges with Box2D.NetStandard has always been keeping it up-to-date with changes to Box2D 2.x, and the performance was never on par. Since Box2D 3.x builds to shared libraries, it makes much more sense all round to simply write bindings to that library than to put time into porting it. It also means I can target .net standard 2.1 instead of dotnet 6 or above.

How is this better than Hexa.NET.Box2D or Box2D.NET?

Hexa.NET.Box2D and Box2D.NET are auto-generated with code generators, and are direct mappings of the Box2D API. This, by contrast, is a hand-crafted API that is designed to be more idiomatic to dotnet coders. These bindings also have full XmlDoc comments and fully defined delegates. In this case "better" is probably subjective: Hexa.NET.Box2D and Box2D.NET are API-complete in that they include DynamicTree functions, while this library brings quality of life improvements. This API is complete up to 3.0.0 and will be upgraded to 3.1.0 as early as possible.

Getting things working

Just install this package. It should work. If not, please raise an issue in the github repository: https://github.com/HughPH/Box2D-dotnet-bindings/issues

Known limitations / quirks

  • The native binaries are built from Erin's Box2D mainline, not the latest release tag. This will capture any latest bugfixes, but could introduce bugs - in which case, revert to the previous version.
  • Extensions to the Box2D API won't appear automagically. Please feel free to submit a PR if you want to add something.
  • The native binaries are built for Windows x64 and Linux x64 only.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • .NETStandard 2.1

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.