🎮 Pokemon Legends Z-A
Automation Tool

Nintendo Switchを自動操作して、Pokemon Legends Z-Aのレストラン作業を効率化！
Linux/Ubuntu環境で動作する、初心者にも優しい自動化ツールです。

Linux対応 初心者向け MIT License
🚀 今すぐ始める 📋 機能を見る
Nintendo Switch Macro Control Panel
Status: [Running] Macro is running
Bluetooth: [Active] Adapter is enabled
[1] Start Macro
[2] Stop Macro
[3] Restart Bluetooth
[4] Environment Check

✨ 主な機能

🎯

ZL+A自動連打

レストランでの作業を自動化。ZLボタンを押しながらAボタンを自動で連打し続けます。

⚡

簡単操作

ENTERキーで開始/停止、CTRL+Yで停止。プログラミング知識不要で誰でも使えます。

🔗

Bluetooth接続

Bluetooth経由でNintendo Switchに接続。ケーブル不要で快適に操作できます。

🛠️

複数マクロ対応

4つの異なるレストラン用マクロを用意。用途に応じて使い分けできます。

🌍

多言語対応

日本語、英語、中国語、フランス語、ドイツ語、スペイン語に対応。

🔒

安全設計

教育目的で設計。オンラインゲームでの使用は推奨されません。

🚀 インストール方法

1

システム要件

💻 Ubuntu 24.04 LTS (または他のDebian系Linux)
📶 Bluetooth機能 (内蔵またはUSBアダプタ)
🎮 Nintendo Switch本体
2

プロジェクトのダウンロード

GitHubからクローン 
git clone https://github.com/coffin299/pokemon_legends_z-a_automation_tool.git
cd pokemon_legends_z-a_automation_tool
3

自動セットアップ

ワンクリックセットアップ 
# 実行権限を付与
chmod +x setup.sh

# セットアップを実行
./setup.sh
⚠️

セットアップには管理者権限が必要です。パスワードの入力が求められます。

4

完了！

セットアップが完了したら、コントロールパネルを使用してマクロを実行できます。

コントロールパネル起動 
./control_panel.sh

🎮 使い方

1️⃣

Switchの準備

ホーム → 「コントローラー」→ 「持ちかた/順番を変える」を開く

2️⃣

コントロールパネル起動

./control_panel.sh を実行

3️⃣

マクロ選択

メニューから「1」を選択してマクロを開始

4️⃣

操作

ENTERキーで開始/停止、CTRL+Yで停止

🎮 操作方法

ENTER マクロ開始/停止/再開
Ctrl + Y マクロ停止
Ctrl + C プログラム終了

🎯 利用可能なマクロ

レストラン・フツー

基本

基本的なZL+A連打マクロ。最もシンプルで安定した動作を提供します。

実行シーケンス:

  1. ZLボタンを0.2秒押す
  2. ZL+Aを同時に0.5秒押す
  3. 0.1秒待機
  4. 繰り返し

リストランテ ニ・リュー・ド・キワミ

高級

高級レストラン用の複合マクロ。ZL+A+Y+Xの組み合わせで効率的な操作を実現。

実行シーケンス:

  1. ZLボタンを0.2秒押す
  2. ZL+Aを同時に0.3秒押す
  3. ZL+Yを同時に0.3秒押す
  4. ZL+Xを同時に0.3秒押す
  5. 0.1秒待機
  6. 繰り返し

restaurant_le_Nah

英語版

英語版の基本マクロ。国際的なユーザー向けに最適化されています。

実行シーケンス:

  1. ZLボタンを0.2秒押す
  2. ZL+Aを同時に0.5秒押す
  3. 0.1秒待機
  4. 繰り返し

restaurant_le_Yeah_and_Wow

複合

複数のボタン組み合わせを使用した高度なマクロ。複雑な操作を自動化します。

実行シーケンス:

  1. ZLボタンを0.2秒押す
  2. ZL+Aを同時に0.3秒押す
  3. ZL+Yを同時に0.3秒押す
  4. ZL+Xを同時に0.3秒押す
  5. 繰り返し

🔧 トラブルシューティング

🔍

環境チェック

まずは環境チェックを実行して問題を特定しましょう。

./control_panel.sh → 「4」環境チェック
📶

Bluetooth接続エラー

Bluetoothアダプタが見つからない、接続できない場合の対処法。

  1. コントロールパネル → 「3」Bluetooth再起動
  2. 手動で sudo systemctl restart bluetooth
  3. Switchの「持ちかた/順番を変える」画面を確認
⌨️

キー入力が効かない

ENTERキーやCTRL+Yが反応しない場合の対処法。

  1. マクロ実行中のターミナルウィンドウをクリック
  2. ウィンドウが選択状態であることを確認
  3. ENTERキーまたはCTRL+Yを押す
🛑

マクロが停止しない

マクロが止まらない場合の強制停止方法。

  1. コントロールパネル → 「2」マクロ停止
  2. 手動で sudo pkill -f switch_macro.py
🔐

権限エラー

Permission deniedエラーが発生する場合。

必ず ./control_panel.sh を使用して起動してください。このスクリプトが内部で正しくsudoを使用します。

🐍

Python環境エラー

nxbt: command not foundなどのエラーが発生する場合。

必ず ./control_panel.sh を使用して起動してください。このスクリプトが自動で仮想環境を有効にします。

🌍 多言語対応

🇯🇵 日本語 🇺🇸 English 🇨🇳 简体中文 🇹🇼 繁體中文 🇪🇸 Español 🇫🇷 Français 🇩🇪 Deutsch

⚠️ 重要な注意事項

🚨

BANのリスク

このツールは連射コントローラー/マクロコントローラー同様の自動化ツールです。

  • Nintendo利用規約違反の可能性があります
  • 本体・アカウントBANの可能性があります
  • オンライン機能が使用できなくなる可能性があります
✅

安全な使用条件

  • 完全オフライン専用のSwitch
  • サブ機での使用
  • シングルプレイゲームのみ
  • 教育・研究目的

法的責任: 作成者は使用によって生じたいかなる損害やBANについても責任を負いません。使用は完全に自己責任です。