Plugins + Scripts GPU Raycast

perfectbloo · Feb 23, 2026

perfectbloo submitted a new resource:

GPU Raycast - Raycast person atoms on the GPU with advanced hit info

Read more about this resource...

PiggyCat · Feb 28, 2026

I am working on creating a scene where an empty atom can cast a ray and print out "hit" if hit a person but had no luck at all and i am not sure what is going on. I have loaded the gpuraycast.cslist as scene plugin and set up the path to GpuRaycastHit.cs and GpuRaycastApi.g.cs, but all i am getting when casting the ray (thru button trigger) is

GPU Raycast Exception: Object reference not set to an instance of an object
Stack: at perfectbloo.GpuRaycast.GpuRaycastApi.Raycast (Vector3 origin, Vector3 direction, perfectbloo.GpuRaycast.GpuRaycastHit& hit, Single maxDistance, Int32 layerMask) [0x00000] in <filename unknown>:0
at GunRaycastPlugin.Shoot () [0x00000] in <filename unknown>:0

below is my code, appreciate if anyone with experience can share some light...thx

Untitled (z3ommvfz) - PasteCode.io

pastecode.io

perfectbloo · Feb 28, 2026

The problem is this line:

C#:

_api = new GpuRaycastApi(this);

You must pass the GpuRaycast plugin here, not your own plugin. Below is how you can do using my Core plugin, otherwise you need to implement your own solution to get the GpuRaycast instance from the scene plugins.

Add these to your cslist:

Code:

perfectbloo.Core.1:/Custom/Scripts/perfectbloo/Core/Source/Core/Extensions/AtomEx.cs
perfectbloo.Core.1:/Custom/Scripts/perfectbloo/Core/Source/Core/Extensions/MVRScriptEx/Ui/UiElement.cs
perfectbloo.Core.1:/Custom/Scripts/perfectbloo/Core/Source/Core/Extensions/SuperControllerEx.cs
perfectbloo.Core.1:/Custom/Scripts/perfectbloo/Core/Source/Core/Plugins/UserConfirmPanel.cs
perfectbloo.Core.1:/Custom/Scripts/perfectbloo/Core/Source/Core/ScenePlugin.cs

Then you can raycast like:

C#:

using perfectbloo.Core;
using perfectbloo.GpuRaycast;

[...]

private ScenePlugin<GpuRaycastApi> gpuRaycast = new ScenePlugin<GpuRaycastApi>(
    GpuRaycastApi.Author,
    GpuRaycastApi.PackageName,
    GpuRaycastApi.PluginName,
    GpuRaycastApi.ScriptName
);

[...]

if (gpuRaycast.Api?.Raycast(...) == true) { [...] }

When you access gpuRaycast.Api, this will also automatically add GpuRaycast as a scene plugin if it's missing. You can change that behavior by setting gpuRaycast.AutoCreate = false (it is enabled by default).

perfectbloo · Feb 28, 2026

perfectbloo updated GPU Raycast with a new update entry:

v1:1.0.1 [2]

Fixes

Fix non-person atoms were not occluding raycasts

Read the rest of this update entry...

perfectbloo · Feb 28, 2026

@PiggyCat FYI the suggestion from earlier will fix the exception, but there might still be issues.

First off, I just released an update to fix some bugs. The shader I use to perform raycasts did not render non-person atoms correctly, which meant they wouldn't occlude persons. Also, I used the wrong layer mask as a default, and I'm seeing you're trying to raycast on layer 29, too. But actually all atoms are rendered on the default layer (so layer mask = 1). I just got lucky because I forgot to bit shift, so I did not notice anything wrong

The default of the Raycast function is now set correctly, and you shouldn't even need to pass a layer mask yourself.

Secondly, I forgot to mention an important detail in the resource description:

VaM uses custom vertex and normal buffers to render person atoms. If you try to raycast before these are updated, your raycast will fail since the persons are not rendered correctly. The safest place to raycast is in a Coroutine after yielding WaitForEndOfFrame.

So you'll need to do something like this:

C#:

private void YourFunction()
{
    StartCoroutine(YourRaycast());
}

private IEnumerator YourRaycast()
{
    yield return new WaitForEndOfFrame();
    [...]
    if (gpuRaycast.Api?.Raycast(...) == true) { [...] }
}

PiggyCat · Feb 28, 2026

perfectbloo said:
@PiggyCat FYI the suggestion from earlier will fix the exception, but there might still be issues.

First off, I just released an update to fix some bugs. The shader I use to perform raycasts did not render non-person atoms correctly, which meant they wouldn't occlude persons. Also, I used the wrong layer mask as a default, and I'm seeing you're trying to raycast on layer 29, too. But actually all atoms are rendered on the default layer (so layer mask = 1). I just got lucky because I forgot to bit shift, so I did not notice anything wrong The default of the Raycast function is now set correctly, and you shouldn't even need to pass a layer mask yourself.

Secondly, I forgot to mention an important detail in the resource description:

So you'll need to do something like this:

C#:

private void YourFunction() { StartCoroutine(YourRaycast()); } private IEnumerator YourRaycast() { yield return new WaitForEndOfFrame(); [...] if (gpuRaycast.Api?.Raycast(...) == true) { [...] } }

Hey perfectbloo, thanks for the update.

I did notice you used a code routine so I did something similar, updated the path referencing version 2 of the raycast plugins, also used
layerMask 1 as well.
However I am still trying to fix something here because the ray cast seems unable to hit person atom.
I rendered a yellow beam to visualize the ray cast and I saw the beam clearly penetrated the person, so the aiming should be correct, but still the raycast return false. I also tried removing clothing/hair as well. Right now still trying to figure out what is going on.
I have attach my code below in case anyone is interested.

Untitled (5h3ocu47) - PasteCode.io

pastecode.io

perfectbloo · Feb 28, 2026

Hmm weird, your code works fine for me. You can see in the video below, the raycast hits on skin, and misses on clothing as expected.

My guess is, there's either something in your scene blocking the raycast, or there's some issue with your person atom appearance. So here's two things you can try:

Try to raycast the default person atom (no custom appearance) in your scene.
Try to raycast your appearance preset in an empty scene.

Like that we can maybe narrow down the issue.

PiggyCat · Feb 28, 2026

perfectbloo said:
Hmm weird, your code works fine for me. You can see in the video below, the raycast hits on skin, and misses on clothing as expected.

My guess is, there's either something in your scene blocking the raycast, or there's some issue with your person atom appearance. So here's two things you can try:

Try to raycast the default person atom (no custom appearance) in your scene.

Try to raycast your appearance preset in an empty scene.

Like that we can maybe narrow down the issue.

View attachment 570102

Hi I have figured out this issue

1. You must have textures on your person ( Duh! yeah I didn't. trying to save some memory lol)
2. Raycast conflicts with SubsurfaceScattering plugin from Hunting Succubus, if I have Subsurface Scattering active then the ray cast would fly through the person

PiggyCat · Mar 1, 2026

Working on a

GPU Raycast–based shooting plugin demonstrated alongside the third-person WASD plugin. The ray cast applies physical force when a Person atom is hit and optionally triggers a hit-reaction animation.

perfectbloo · Mar 1, 2026

PiggyCat said:
Working on a GPU Raycast–based shooting plugin demonstrated alongside the third-person WASD plugin. The ray cast applies physical force when a Person atom is hit and optionally triggers a hit-reaction animation.

Oh, cool stuff! Glad to see you've sorted out all the issues. Are you planning to make this basically into a game?

Just make sure you're not violating any hub content policies with shooting sexy zombie girls haha

perfectbloo · Friday at 8:29 AM

perfectbloo updated GPU Raycast with a new update entry:

v1:1.1.0 [3]

Features

Add alpha threshold to raycast skin behind transparent clothing

Read the rest of this update entry...

PiggyCat · Monday at 8:54 PM

perfectbloo said:
perfectbloo updated GPU Raycast with a new update entry:

v1:1.1.0 [3]

Read the rest of this update entry...

Hi I just want to raise the v3 seems to break, seeing this error "GPU Raycast Crash: Object reference not set to an instance of an object". but v2 is working completely fine.

perfectbloo · 2026-03-10T09:51:42-0400

PiggyCat said:
Hi I just want to raise the v3 seems to break, seeing this error "GPU Raycast Crash: Object reference not set to an instance of an object". but v2 is working completely fine.

Thanks for letting me know! However, I don't see this error myself

Can you provide the whole log entry including the stack trace? If this log is from your example above, you'd have to log SuperController.LogMessage("GPU Raycast Crash: " + e); instead of e.Message to see the whole error.

PiggyCat · 2026-03-10T17:15:48-0400

perfectbloo said:
Thanks for letting me know! However, I don't see this error myself Can you provide the whole log entry including the stack trace? If this log is from your example above, you'd have to log SuperController.LogMessage("GPU Raycast Crash: " + e); instead of e.Message to see the whole error.

Hello, here is the full error, It happens on every call, consistently, even on a fresh VaM start, and It only started with v3, v2 works perfectly.
Could it be that the new "alpha threshold / transparent clothing" feature added in v3 initializes something during Raycast that doesn't exist in Unity 2018.1.9's rendering pipeline?

All ragdolls reset.
Playing: Reload on Shooter
Playing: Shoot on Shooter
GPU Raycast Crash: System.NullReferenceException: Object reference not set to an instance of an object
at perfectbloo.GpuRaycast.GpuRaycastApi.Raycast (Vector3 origin, Vector3 direction, perfectbloo.GpuRaycast.GpuRaycastHit& hit, Single maxDistance, Int32 layerMask) [0x00000] in <filename unknown>:0
at GunRaycastPlugin+<ShootCoroutine>c__Iterator0.MoveNext () [0x00000] in <filename unknown>:0
Playing: Shoot on Shooter
GPU Raycast Crash: System.NullReferenceException: Object reference not set to an instance of an object
at perfectbloo.GpuRaycast.GpuRaycastApi.Raycast (Vector3 origin, Vector3 direction, perfectbloo.GpuRaycast.GpuRaycastHit& hit, Single maxDistance, Int32 layerMask) [0x00000] in <filename unknown>:0
at GunRaycastPlugin+<ShootCoroutine>c__Iterator0.MoveNext () [0x00000] in <filename unknown>:0
Playing: Shoot on Shooter
GPU Raycast Crash: System.NullReferenceException: Object reference not set to an instance of an object
at perfectbloo.GpuRaycast.GpuRaycastApi.Raycast (Vector3 origin, Vector3 direction, perfectbloo.GpuRaycast.GpuRaycastHit& hit, Single maxDistance, Int32 layerMask) [0x00000] in <filename unknown>:0
at GunRaycastPlugin+<ShootCoroutine>c__Iterator0.MoveNext () [0x00000] in <filename unknown>:0
Playing: Reload on Shooter
All ragdolls reset.

perfectbloo · 2026-03-10T18:11:07-0400

PiggyCat said:
perfectbloo.GpuRaycast.GpuRaycastApi.Raycast (Vector3 origin, Vector3 direction, perfectbloo.GpuRaycast.GpuRaycastHit& hit, Single maxDistance, Int32 layerMask)

Thanks for providing the full error! I see the v2 Raycast method signature in your log. It's missing the new alphaThreshold as a last parameter. My guess is you have the v3 plugin loaded in your scene, but try to use it with the v2 API in your own plugin. Have you updated the version to v3 in your own plugin's cslist file?

PiggyCat · 2026-03-10T21:35:28-0400

perfectbloo said:
Thanks for providing the full error! I see the v2 Raycast method signature in your log. It's missing the new alphaThreshold as a last parameter. My guess is you have the v3 plugin loaded in your scene, but try to use it with the v2 API in your own plugin. Have you updated the version to v3 in your own plugin's cslist file?

yes, my bad, that was the issue. thanks

PiggyCat · 2026-03-10T23:56:49-0400

I have pllublished a plugin made using this plugin

Plugins + Scripts - Aim and Shoot - History

hub.virtamate.com

Plugins + Scripts GPU Raycast

Active member

New member

Active member

Active member

Fixes​

Active member

New member

Active member

New member

New member

Active member

Active member

Features​

New member

Active member

New member

Active member

New member

New member

Similar threads

Fixes

Features