vrc-autopilot

Platform

VRCPositionHUDを利用してOSCで移動・視点を操作する自動化ツール

動作環境

Windows 10/11
Python 3.12+
VRChat (デスクトップモード、OSC有効)
VRCPositionHUD を組み込んだアバター

インストール

uv add vrc-autopilot

サンプルコード

移動・照準・押下は Pilot API を使用して記述します。

でかプ軽量化スイッチ自動化 ※マップデータ同梱

CLI

uv run <コマンド> で実行します。フラグ詳細は各 --help で確認可能です。

コマンド	用途
`decode-demo`	HUDを読み取り、座標と姿勢を表示するサンプル
`map-room`	壁沿いに歩いて部屋マップを記録する
`find-button`	複数地点からボタンを三角測量して座標を推定する
`probe-axes`	入力軸の応答特性を測ってプラントモデルを同定する
`calibrate-world`	ワールドごとに変わる移動速度を測り、ゲインの倍率を補正
`bode-margins`	同定プラント上で全制御ループの安定余裕(ωc/PM/GM)とボード線図を出す
`log-video`	制御ログCSVを一人称3D+2D地図の動画(mp4)に再生

開発者向け

全体像とモジュール対応: docs/architecture.md
プラント特性の測定手順: docs/system-identification.md
制御ゲインの根拠と調整手順: docs/gain-tuning.md
オフライン検証の組み方: docs/verification.md
各コマンドの使用方法: docs/usage.md

Metadata

Release files for vrc-autopilot 1.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vrc-autopilot 1.3.1
File	Size	Uploaded
vrc_autopilot-1.3.1.tar.gz	637.7 kB	Aug 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vrc-autopilot 1.3.1
File	Interpreter	ABI	Platform	Reset
vrc_autopilot-1.3.1-py3-none-any.whl 108.9 kB Aug 11, 2026	Python 3	none	any	Details

Total release size: 746.6 kB

Release files / vrc_autopilot-1.3.1.tar.gz

Download URL	vrc_autopilot-1.3.1.tar.gz
Size	637.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`f49d72febe9102fbab1c34024aaa1bdb8c3cbb52afdf30c2b33e132507a9e274`
BLAKE2b-256 checksum How to use checksums	`8919f5240e0bdcf9aa5b533309e2a5b3aec3e6d9ca27d0f82c91a7774fdcb66f`
Upload date	Aug 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/njm2360/vrc-autopilot
Publishing commit: github.com/njm2360/vrc-autopilot/tree/436ca7d9e6a40b96d6eddba234d1997f22b09688

Workflow

Publishing configuration: github.com/njm2360/vrc-autopilot/blob/436ca7d9e6a40b96d6eddba234d1997f22b09688/.github/workflows/publish.yml
Publishing logs: github.com/njm2360/vrc-autopilot/actions/runs/31491275266/attempts/1

Artifact

Subject: vrc_autopilot-1.3.1.tar.gz
SHA-256 checksum: f49d72febe9102fbab1c34024aaa1bdb8c3cbb52afdf30c2b33e132507a9e274 Verifying attestations

Release files / vrc_autopilot-1.3.1-py3-none-any.whl

Download URL	vrc_autopilot-1.3.1-py3-none-any.whl
Size	108.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`00f0afb7b4105dddb2ae90119f2ab91280dd34eadbb4b4e4c0163f45f0f489bc`
BLAKE2b-256 checksum How to use checksums	`fd42d3adf032c62406a5b16a86f188f2d79c8681fd694d305346753daf578f7b`
Upload date	Aug 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/njm2360/vrc-autopilot
Publishing commit: github.com/njm2360/vrc-autopilot/tree/436ca7d9e6a40b96d6eddba234d1997f22b09688

Workflow

Publishing configuration: github.com/njm2360/vrc-autopilot/blob/436ca7d9e6a40b96d6eddba234d1997f22b09688/.github/workflows/publish.yml
Publishing logs: github.com/njm2360/vrc-autopilot/actions/runs/31491275266/attempts/1

Artifact

Subject: vrc_autopilot-1.3.1-py3-none-any.whl
SHA-256 checksum: 00f0afb7b4105dddb2ae90119f2ab91280dd34eadbb4b4e4c0163f45f0f489bc Verifying attestations