SampSharp.OpenMp.ColAndreas 1.0.0-preview.2026.44.2

This is a prerelease version of SampSharp.OpenMp.ColAndreas.
dotnet add package SampSharp.OpenMp.ColAndreas --version 1.0.0-preview.2026.44.2
                    
NuGet\Install-Package SampSharp.OpenMp.ColAndreas -Version 1.0.0-preview.2026.44.2
                    
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="SampSharp.OpenMp.ColAndreas" Version="1.0.0-preview.2026.44.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SampSharp.OpenMp.ColAndreas" Version="1.0.0-preview.2026.44.2" />
                    
Directory.Packages.props
<PackageReference Include="SampSharp.OpenMp.ColAndreas" />
                    
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 SampSharp.OpenMp.ColAndreas --version 1.0.0-preview.2026.44.2
                    
#r "nuget: SampSharp.OpenMp.ColAndreas, 1.0.0-preview.2026.44.2"
                    
#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.
#:package SampSharp.OpenMp.ColAndreas@1.0.0-preview.2026.44.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SampSharp.OpenMp.ColAndreas&version=1.0.0-preview.2026.44.2&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SampSharp.OpenMp.ColAndreas&version=1.0.0-preview.2026.44.2&prerelease
                    
Install as a Cake Tool

SampSharp.OpenMp.ColAndreas

Managed C# bindings for ColAndreas on open.mp x64, for gamemodes running on the SampSharp open.mp host. ColAndreas keeps a Bullet-physics copy of the GTA: San Andreas static collision world server-side, so the server can answer questions the game engine normally only answers on the client: what is under this point, what does this ray hit, where is the ground here.

Unlike the sibling bridges in this family, this repository is managed only. There is no native shim to build: the bindings P/Invoke the CASharp_* exports of colandreas.dll directly.

About this fork

This is a fork of VS-RP/SampSharp.OpenMp.ColAndreas. It adds:

VS-RP's repository This fork
Install Build from source, with SampSharp checked out next to it The NuGet package SampSharp.OpenMp.ColAndreas
SampSharp Referenced as projects from that checkout The SampSharp.OpenMp.Core and SampSharp.OpenMp.Entities NuGet packages
Model id of a ray hit Not returned (RayCastLine returns only bool) RayCastLineModel, which returns the model id, 0 on a miss. For example, water is ColAndreasConstants.WaterObject (20000)
Pawn include helpers None IsPlayerFacingWater and WaterObject, ported from colandreas.inc

Namespaces and method names are unchanged, so code written for VS-RP's version works as is.

Install

dotnet add package SampSharp.OpenMp.ColAndreas --prerelease

The package depends on SampSharp 1.0 prereleases, so its versions are previews too.

Architecture

┌──────────────────────────────────────────────────────────────────────┐
│  C# gamemode                                                         │
│     IColAndreasService                                               │
└──────────────────────────────────────────────────────────────────────┘
                               │   P/Invoke (CASharp_* exports)
                               ▼
┌──────────────────────────────────────────────────────────────────────┐
│  colandreas.dll  (open.mp component, Bullet physics + .cadb)         │
└──────────────────────────────────────────────────────────────────────┘

Runtime dependencies

Component Where from
colandreas.dll/.so ColAndreas open.mp build
SampSharp.dll SampSharp/src/sampsharp-component/
.NET 10 runtime System-wide
ColAndreas.cadb Collision database, ships with the plugin

IsDataLoaded reports whether the .cadb was found and parsed; IsInitialized reports whether Init() has built the dynamics world. Call Init() once at startup. Everything else returns garbage until you do.

Wiring

services.AddColAndreas();

Surface

  • Ray casts: RayCastLine and variants returning the hit point, the hit model id (RayCastLineModel), the collision model id, the surface normal, the reflection vector, or the hit object's rotation
  • Water: ColAndreasConstants.WaterObject, the model id a ray reports on water, and colAndreas.IsPlayerFacingWater(player), a port of the include's CA_IsPlayerFacingWater
  • Ground height: FindZ_For2DCoord / FindZ_For3DCoord, casting from +700 down to -1000 by default: high enough to clear the LV and SF airports, low enough to catch underwater terrain
  • Collision objects: create, destroy, move, rotate and tag user objects in the physics world, independent of the visible objects players see
  • Building removal: RemoveBuilding / RestoreBuilding, to keep the collision world in step with RemoveBuildingForPlayer on the client
  • Model geometry: bounding sphere and bounding box per model id, plus ContactTest for "would this model at this position intersect anything"
  • Math helpers: EulerToQuat / QuatToEuler

Method names deliberately follow the legacy x86 SampSharp.ColAndreas binding, including the unidiomatic FindZ_For2DCoord, so gamemode code can move to open.mp x64 without a rename pass.

Building

dotnet build SampSharp.OpenMp.ColAndreas.csproj

SampSharp comes from NuGet, so no other repository needs to be checked out.

Releases

.github/workflows/release.yml publishes the NuGet package SampSharp.OpenMp.ColAndreas to nuget.org, with NuGet trusted publishing:

When Version
Every push to main 1.0.0-preview.<year>.<week>.<n>
Every tag The tag's version

colandreas.dll itself isn't part of this repository; it comes from the ColAndreas open.mp build.

License

Apache-2.0, see LICENSE. That covers the bindings in this repository; ColAndreas itself is licensed separately by its authors.


Powered by vs-rp.org

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on SampSharp.OpenMp.ColAndreas:

Package Downloads
OpenRP.Framework

OpenRP.Framework is the open source library of Open Roleplay, an ambitious SA-MP roleplay gamemode developed for open.mp (Open Multiplayer, a multiplayer mod for GTA San Andreas) using the SampSharp framework.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-preview.2026.44.2 92 11/8/2026
1.0.0-preview.2026.44.1 51 11/8/2026