はじめに
Pyxelは、世界初？レトロ3Dエンジンになり、以前からフランスの学校で使われていたり、TIC80はupdateしていたり、Robloxは子どもに人気のようで、ゲームエンジン界隈、さまざまな、いろいろな可能性を秘めています。
今回、Playloadを授業で紹介し、サンプルを体験してもらいました。
音ゲー好きな生徒は、キーボード操作しながら、感覚的に、音を作っているのを見て、驚きました。様々な可能性を感じます。ありがとうございます。
GitHubからダウンロードしたプロジェクトがLive Serverで動かない時の解決法（Playloadを例に）
GitHubで見つけた面白そうなWebアプリケーション（今回は kitao/playload）のソースコードをダウンロードして、ローカルで動かそうとした際にいくつかエラーに遭遇しました。
無事にローカル開発環境を構築できるまでの手順と、エラーの解決方法を自身の備忘録としてまとめます。
Windows11環境です。
1. 最初のつまずき：Live Serverで404エラー
ソースコードをZIPでダウンロード・解凍し、VS Codeの「Live Server」拡張機能で site/index.html を開いてみました。しかし、画面は真っ白で、コンソールを見ると以下のようなエラーが出ていました。
GET /playload/app 404 (Not Found)
原因
このプロジェクトは単なる静的なHTML/CSS/JSの構成ではなく、Node.jsを使ったビルド環境（パッケージ管理）を前提としていました。
また、本番環境の公開URL（〇〇.com/playload/）に合わせて内部のパスが絶対パスでハードコードされているため、Live Serverのルート（http://127.0.0.1:5500/）で開くとフォルダ階層が合わずにエラーとなってしまいます。
2. 正しい環境構築手順（npmコマンドの実行）
プロジェクトのルート（package.json がある階層）をVS Codeで開き、ターミナルから公式の開発サーバーを立ち上げる必要があります。
パッケージのインストール
まず、必要なパッケージをインストールするためにターミナルで以下のコマンドを実行します。
npm install
【エラー発生】PowerShellの実行ポリシーによるブロック
ここで、Windows環境特有の以下のようなエラーが発生しました。
npm: ファイル C:\...\npm.ps1 を読み込めません。ファイル C:\...\npm.ps1 はデジタル署名されていません。現在のシステムでこのスクリプトを実行することはできません。
解決策：
これはWindowsの標準ターミナル（PowerShell）のセキュリティ機能が原因です。VS Codeのターミナルで以下のコマンドを実行し、現在のユーザーに対してスクリプトの実行を許可します。
npm.cmd install
上記でインストールできました。
または、
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
※確認メッセージが出たら Y を入力してEnterを押します。
（セキュリティ設定を変更したくない場合は、ターミナルをPowerShellから「Command Prompt」に変更して実行することでも回避可能です。）
コマンドプロンプトでインストールできました。
3. 開発サーバーの起動とURLのトラップ
パッケージのインストールが完了したら、開発サーバーを起動します。
npm.cmd run dev
ターミナルに以下のようなログが表示され、サーバーが起動しました。
[wrangler:info] Ready on http://127.0.0.1:8765
[wrangler:info] GET / 404 Not Found (19ms)
最後の罠：ルートURLが404になる
ログの通り、http://127.0.0.1:8765/ にアクセスしても「404 Not Found」になってしまいます。
しかし、これはサーバーの起動失敗ではありません。このアプリは /playload/ というサブディレクトリ下で動くように設定されているためです。
解決策：
ブラウザのアドレスバーに直接、正しいパスを含めたURLを入力します。
👉 http://127.0.0.1:8765/playload/
これで無事に、ローカル環境でアプリケーションの画面を表示させることができました！
まとめ
-
package.jsonがあるプロジェクトはLive Serverではなく、Node.js（npm installとnpm run devなど）を使って起動する - WindowsのPowerShellでnpmがブロックされたら
Set-ExecutionPolicyで権限を変更するか、コマンドプロンプトを使う。npm.cmdと打った方が良い。 - 開発サーバーが立ち上がっても404になる場合、プロジェクトの設定（ルーティング）で特定のサブディレクトリ（例：
/playload/）が指定されていないか確認する
ローカルで専用の開発サーバーが立ち上がったことで、ファイルを書き換えるとブラウザの画面も自動で更新（ホットリロード）されるようになり、快適にコードの練習ができるようになりました。
追記
別のパソコン教室のネットワーク環境では、インストール時、セキュリティでダウンロードできませんでした。
ローカルで作成した、playloadとnode.jsを圧縮し、teams経由で、ダウンロードし解凍し、node.jsが動くように
環境変数を変更します。playloadフォルダで
$env:Path += ";C:\Users\yourname\Documents\node-v26.13.0-win-x64"
\playload> npm.cmd run dev
ありがとうございます。
参考資料
Playloadのコミュニティ、開発者に感謝申し上げます。