https://github.com/makingspidersense/mss-aframe-kit
A collection of A-Frame components by Making Spider Sense.
https://github.com/makingspidersense/mss-aframe-kit
a-frame aframe game-development gamedev metaverse oculus oculus-quest threejs virtual-reality virtualreality vr webvr webxr
Last synced: about 1 month ago
JSON representation
A collection of A-Frame components by Making Spider Sense.
- Host: GitHub
- URL: https://github.com/makingspidersense/mss-aframe-kit
- Owner: MakingSpiderSense
- Created: 2025-03-11T02:42:33.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-12T04:08:43.000Z (9 months ago)
- Last Synced: 2025-09-12T06:19:54.986Z (9 months ago)
- Topics: a-frame, aframe, game-development, gamedev, metaverse, oculus, oculus-quest, threejs, virtual-reality, virtualreality, vr, webvr, webxr
- Language: JavaScript
- Homepage:
- Size: 1.46 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MSS A-Frame Kit
## Overview
**mss-aframe-kit** is a collection of A-Frame components built for my projects. I've decided to make it public in case anyone else finds these extras useful in their own A-Frame scenes. While others are free to use it, I don't plan on providing active support for this project at this time and flexibility may be limited.
Each A-Frame component is maintained in its own folder under `src/components/`. Some components include their own README files and examples. Check out the docs folder for more information. The project includes both minified and unminified builds in the `dist/` folder.
Tested up to **A-Frame 1.7.0**.
## Featured Components
- 🏃 [arm-swing-movement](docs/arm-swing-movement/README.md) enables intuitive, full-body locomotion in VR by translating natural arm-swinging gestures into forward (or backward) movement. This component is ideal for VR experiences where you want users to physically feel like they're walking or jogging through the environment - without the need for specialized hardware like an omnidirectional treadmill. It uses the Z-axis reversal of each controller to detect "steps", dynamically calculates a target speed, and moves the player rig accordingly. It supports nav-mesh constrained movement, adjustable smoothing, speed limits, and even synchronized footstep sound playback for added realism.
- ✋ [holdable](docs/holdable/README.md) is an alternative to the `grabbable` component in the "Super Hands" library. I needed a few features that weren't immediately supported, so I ended up building something I could tailor to my needs. It works with the `cannon.js` option in the aframe-physics-system and lets you either preserve an object's original position and rotation when grabbed or define a specific grip pose, which can be useful for things like swords.
- 🎧 [music-player](docs/music-player/README.md) lets you define a playlist of songs and control playback through VR controllers or keyboard keys. It includes shuffle and loop modes, and is ideal for creating a radio-like experience in your VR scenes.
- 👐 [raycaster-manager](docs/raycaster-manager/README.md) handles VR controller raycaster toggling between controllers, activating one at a time with visual and audio feedback.
**Note:** There are other components in the kit as well, but if they are not listed here, they should be considered to be in a more beta state.
## Conflicts
If a custom component shares a name with one from `mss-aframe-kit` and it's not needed, it can be removed before registering the new one. For example:
```javascript
delete AFRAME.components["holdable"];
```
## License
You are free to use *mss-aframe-kit* in your own projects.