vrc-autopilot
VRCPositionHUDを利用してOSCで移動・視点を操作する自動化ツール
[!WARNING] 本ツールの使用によって生じたいかなる結果についても、作者は一切の責任を負いません。自己責任で使用してください。 使用にあたっては各ワールド・コミュニティのルールに従ってください。自動化を歓迎しない場所では使わないこと。
動作環境
- 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
1 maintainer
Metadata
1 maintainer
Release files for vrc-autopilot 1.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vrc_autopilot-1.2.1.tar.gz | 637.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vrc_autopilot-1.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 745.6 kB
Release files / vrc_autopilot-1.2.1.tar.gz
| Download URL | vrc_autopilot-1.2.1.tar.gz |
|---|---|
| Size | 637.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0b40feeadb1b8f0caa1e389cbbaca4dad09c43f6155564ec73e662e86242c1f4
|
|
BLAKE2b-256 checksum How to use checksums |
b15ced90fa02267e9c1f839d0ecb7cf42cbc140083841e834fcd58958dbfe72d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 27, 2026.
Transparency logRelease files / vrc_autopilot-1.2.1-py3-none-any.whl
| Download URL | vrc_autopilot-1.2.1-py3-none-any.whl |
|---|---|
| Size | 108.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
781d763be1f41372fbbfa084051d2e44aadec467214e7c1275da5d0672da0a53
|
|
BLAKE2b-256 checksum How to use checksums |
7ca6cd4c8d023d63f058776c67a92b516b8d7066171d2f8b5649c58e0a4f56b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 27, 2026.
Transparency log
