# Weapon Collision Setup
## 1. **MainGripCollision**
* Used for: **Primary hand grip**
* Place around the **main handle/grip area**
* This defines where the player holds the weapon
***
## **2.SecondaryGripCollision**
* Used for: **Secondary hand support**
* Place on the **front part of the weapon**
* Helps with two-hand interaction
***
## 3. **SlideGrabCollision**
* Used for: **Grabbing Handle or Slider**
* Place it over the **interactive moving part**
* Handle (M4 / Shotgun)
* Slider (AK / Pistol)
### **Shotgun Special Case (Important)**
If your shotgun uses **secondary grip for reload**\
(example: M3 Benelli style pump):
* You **do NOT need SlideGrabCollision**
**What to do:**
* Select **SlideGrabCollision**
* Set **Scale → (0, 0, 0)**
* Select **Class Default** -> Under Shotgun Customization Category -> Enable [**use SecondaryGrab As Slider Grab**](#user-content-fn-1)[^1]
This disables it completely and avoids unwanted interaction conflicts.
***
## **4. Magazine /** Shell **Collision**
* Used for: **Attaching Magazine / Insterting Shotgun Shell ( Bullet )**
* Place at the **magazine /** **shell insertion point**
* Ensure overlap is clean and centered for proper snapping
***
## **5. SilencerCollision**
* Used for: **Attaching Silencer**
* Place at the **end of the barrel**
* Ensure correct alignment for clean attachment
***
## **6. Scope Collision**
* Used for: **Attaching Scopes**
* Place along the **top rail area**
* Cover the full usable space where scopes can attach
***
## **7. Single Shell Insert Collision (Shotgun Only)**
* Used for: **Manual shell insertion (John Wick style)**
* Place at the **open chamber location**
* Ensure:
* Shell overlaps correctly
* Direction allows smooth insertion into slider/chamber
***
## **Important Tips**
* Keep collisions **tight and accurate** (avoid oversized boxes)
* Always test overlap in-game after setup
* Misplaced collision = attachment or interaction issues
[^1]:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://voxel-vision.gitbook.io/advanced-vr-template/add-your-own-weapon/images-and-media.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.