SampSharp.OpenMp.ColAndreas
1.0.0-preview.2026.44.2
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
<PackageReference Include="SampSharp.OpenMp.ColAndreas" Version="1.0.0-preview.2026.44.2" />
<PackageVersion Include="SampSharp.OpenMp.ColAndreas" Version="1.0.0-preview.2026.44.2" />
<PackageReference Include="SampSharp.OpenMp.ColAndreas" />
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"
#:package SampSharp.OpenMp.ColAndreas@1.0.0-preview.2026.44.2
#addin nuget:?package=SampSharp.OpenMp.ColAndreas&version=1.0.0-preview.2026.44.2&prerelease
#tool nuget:?package=SampSharp.OpenMp.ColAndreas&version=1.0.0-preview.2026.44.2&prerelease
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:
RayCastLineand 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, andcolAndreas.IsPlayerFacingWater(player), a port of the include'sCA_IsPlayerFacingWater - Ground height:
FindZ_For2DCoord/FindZ_For3DCoord, casting from+700down to-1000by 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 withRemoveBuildingForPlayeron the client - Model geometry: bounding sphere and bounding box per model id, plus
ContactTestfor "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 | Versions 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. |
-
net10.0
- SampSharp.OpenMp.Core (>= 1.0.0-prerelease2)
- SampSharp.OpenMp.Entities (>= 1.0.0-prerelease2)
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 |