# AUMSS - Artyom's Udon Modular Scripting System

UdonSharp utility scripts for VRChat worlds. Every component is under **Add Component → Artyom Scripting System**.

## Components

| Component | What it does | Docs |
| --- | --- | --- |
| Bone Look At Player | Turns an object (a bone, a camera) to face the nearest player | [BoneLookAtPlayer](Documentation~/BoneLookAtPlayer.md) |
| Checkpoint | Moves the local player's respawn point when they reach it | [Checkpoint](Documentation~/Checkpoint.md) |
| Impact Sound Player | Plays a small, medium or large sound depending on how hard something hits | [ImpactSoundPlayer](Documentation~/ImpactSoundPlayer.md) |
| Jump Pad Controller | Launches players and pickups in an arc onto a target | [JumpPad](Documentation~/JumpPad.md) |
| Laser Beam Controller | Draws a laser to whatever it hits | [LaserBeam](Documentation~/LaserBeam.md) |
| Laser Receiver Controller | Turns things on while a laser reaches it | [LaserReceiver](Documentation~/LaserReceiver.md) |
| Linked Object System | Drives Animator bools from synced interactions and triggers | [LinkedObjectSystem](Documentation~/LinkedObjectSystem.md) |
| Pickup Fizzler | Portal-style fizzler that respawns pickups (under review) | [PickupFizzler](Documentation~/PickupFizzler.md) |
| Pickup Following Mover Fix | Keeps pickups riding on moving platforms | [PickupMovementFixer](Documentation~/PickupMovementFixer.md) |
| Pickup Speed Limiter | Caps how fast a thrown pickup can fly | [PickupSpeedLimiter](Documentation~/PickupSpeedLimiter.md) |
| Timed Teleport | Teleports a player a moment after they walk in | [TimedTeleport](Documentation~/TimedTeleport.md) |

### Deprecated

**Interact Script**, **Logic Script**, **Pickup Detector** and **Player Trigger** are replaced by the Linked Object System. They're under **Artyom Scripting System → _DEPRECATED_**, and keep working in existing scenes, but shouldn't be used in new ones. ([InteractScript](Documentation~/InteractScript.md) still has its docs.)

Leave a fix/issue if you can figure out anything cause I sure don't care to change these junky files /shrug

## Installation

AUMSS is a VPM package (`dev.av2x.aumss`) for VRChat world projects. It requires the VRChat Worlds SDK 3.5.0 or newer.

### ALCOM / VRChat Creator Companion

1. Add this repository in ALCOM or VCC (in VCC: **Settings → Packages → Add Repository**):

   ```
   https://gogs.av2x.dev/av2x/AUMSS/raw/vpm/index.json
   ```

2. Open your world project's packages and add **AUMSS - Artyom's Udon Modular Scripting System**. New versions show up there as updates.

### Manual

Clone the repo into your project's `Packages/dev.av2x.aumss` folder:

```
git clone https://gogs.av2x.dev/av2x/AUMSS.git Packages/dev.av2x.aumss
```

A manual install doesn't get updates through ALCOM or VCC. Run `git pull` in that folder instead.

### Upgrading from the old unitypackage

Delete the old `Artyom Scripting System` folder from `Assets` before adding the package. The package uses the same script and program asset GUIDs, so existing scenes keep their references.