ptcg-telop

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #golang #go #rust #docker #nodejs #java #awesome #cli #kubernetes #ios

(★ 14)

ポケモンカードゲームのライブ配信用NodeCGバンドル。安全なドラフト＆ライブ機能で、リアルタイムに盤面を更新。

ptcg-telop 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[简体中文](./README.chs.md) | [繁体中文](./README.cht.md) | [English](./README.en.md)

---
# PTCG-Telop

PTCG-Telopは、[NodeCG](https://www.nodecg.dev/)フレームワークをベースにした、ポケモンカードゲームの生放送・配信用のリアルタイムグラフィックパッケージです。

プレイヤーの盤面情報（HP、ダメージ、エネルギー、どうぐ、状態異常など）をリアルタイムで管理し、配信画面にオーバーレイ表示することができます。操作の安全性を最優先に設計されており、全ての操作を一度「ドラフト（下書き）」としてキューに格納し、確認後に一括で「ライブ（本番）」画面に適用するワークフローを採用しています。

## 主な機能

-   **プレイヤーごとの詳細な盤面管理**: 各プレイヤーのバトル場・ベンチのポケモンを個別に管理。
-   **マスターコントロールパネルによる一括操作**: 複数のポケモンへのエネルギー追加やダメージ計算などを効率的に実行。
-   **安全な放送運用**: 「ドラフト」と「ライブ」の2段階更新システムにより、操作ミスが本番画面に即時反映されるのを防ぎます。
-   **Pythonスクリプトによるカードデータベース生成**: デッキリストから必要なカード情報を自動で抽出し、データベースを構築します。
-   **柔軟な状態管理**: ダメージ、追加HP、エネルギー、どうぐ、状態異常（どく・やけど・ねむり等）を柔軟に設定可能。
-   **Camera-Modeレイアウト**: 左右のプレイヤーエリアにカメラ映像用フレームを確保し、ベンチをコンパクト表示へ切り替えます。
-   **ターン数表示**: 先攻・後攻アイコンの横に現在のターン数を表示します。

## スクリーンショット

## 前提条件

このバンドルを動作させるには、以下のソフトウェアがインストールされている必要があります。

-   [Node.js](https://nodejs.org/) (v22.12.0以上必須、v22.19.0 LTSでテスト済み)
-   [Python](https://www.python.org/) (v3.13でテスト済み)
-   [Git](https://git-scm.com/) (任意。プロジェクトの更新に使用します)

## インストール方法

---
### 🐳 Docker デプロイ (推奨 / 最も簡単)

環境構築不要で、最も簡単に起動・運用できる方法です。

1. [Docker Desktop](https://www.docker.com/products/docker-desktop/) をインストールし、起動しておきます。
2. [Releases](https://github.com/lwb058/ptcg-telop/releases) ページから `Docker_Deploy.zip` をダウンロードし、任意の空フォルダに解凍します。
3. フォルダ内の `start_docker.bat` (Windows) または `start_docker.command` (Mac) をダブルクリックして実行します。
4. 起動後、ブラウザで `http://localhost:9090` にアクセスします。

---
### 🔰 直導入 (Dockerを使用しない場合)

PCに直接Node.jsやPython環境を構築する方法です。

1.  本リポジトリの [**Releases**](https://github.com/lwb058/ptcg-telop/releases) ページにアクセスします。
2.  最新リリースの`Assets`欄から、`NodeCG_PTCG_vX.X.X.zip` をダウンロードし、解凍します。
3.  （もし未導入の場合）[Node.js](https://nodejs.org/) と [Python](https://www.python.org/) をインストールします。**【重要】Pythonをインストールする際は、インストーラーの最初の画面で`Add Python to PATH`のチェックボックスを必ずオンにしてください。**
4.  解凍したフォルダの中にある `install.bat` (Windows) または `install.command` (Mac) をダブルクリックして実行します。必要なコンポーネントが自動でインストールされます。
    *※Macのみ: 初回インストール時にXcodeライセンスの同意プロセスが自動で実行され、Macのログインパスワードの入力を求められる場合があります。*
5.  インストール完了後、`start.bat` (Windows) または `start_MacOS.command` (Mac) をダブルクリックするとシステムが起動します。

---
### 🚀 アップデート方法

> **【重要】**
> v1.5.0より前のバージョンから更新する場合、データロジックの根本的な変更により、互換性の問題や予期せぬバグが発生する可能性があります。
> これを防ぐため、更新後は必ず**SETTINGSパネル**にある「**データベースをクリア**」ボタンを押して、既存のデータベースをすべて削除してください。

既に古いバージョンをお使いの方は、「パッチファイル」を使って簡単にアップデートできます。

1.  本リポジトリの [**Releases**](https://github.com/lwb058/ptcg-telop/releases) ページにアクセスします。
2.  最新リリースの`Assets`欄から、`patch_vX.X.X.zip` をダウンロードし、解凍します。
3.  中にある `assets` と `bundles` の2つのフォルダをコピーします。
4.  現在お使いの `nodecg` フォルダの中に直接貼り付け、既存のファイルをすべて上書きしてください。

---
### マニュアルインストール

開発者や、手動で環境を構築したい方向けの手順です。

1.  **ホストディレクトリの作成とNodeCGのインストール**:
    任意の場所にホストディレクトリを作成し、NodeCGをnpm依存としてインストールします。
    ```bash
    mkdir nodecg && cd nodecg
    npm init -y
    npm install nodecg@2.6.4
    ```

2.  **PTCG-Telopバンドルのクローン**:
    ホストディレクトリ内に`bundles`フォルダを作成し、このリポジトリをクローンします。
    ```bash
    mkdir bundles && cd bundles
    git clone https://github.com/lwb058/ptcg-telop.git
    ```

3.  **バンドル依存関係のインストール**:
    バンドルディレクトリで依存関係をインストールします。
    ```bash
    cd ptcg-telop
    npm install
    ```

4.  **アセット（画像・動画素材）の配置**:
    このバンドルは、背景画像や進化動画などの表示に画像・動画ファイルを使用します。これらはリポジトリに含まれていないため、別途ダウンロードが必要です。
    1.  本リポジトリの [**Releases**](https://github.com/lwb058/ptcg-telop/releases) ページにアクセスします。
    2.  最新のリリースから、アセットパッケージ（例: `assets_v1.0-beta.zip`）をダウンロードします。
    3.  ダウンロードしたファイルを解凍し、中のファイルをすべてホストディレクトリの `assets/ptcg-telop/` に配置します。（もし `assets/ptcg-telop` ディレクトリが存在しない場合は、作成してください）

5.  **Python環境のセットアップ**:
    バンドルの`python`ディレクトリに移動し、必要なライブラリをインストールします。
    ```bash
    cd bundles/ptcg-telop/python
    pip install -r requirements.txt
    ```
    *もし`requirements.txt`がなければ、`card_utils_jp.py`や`extract_deck_cards_jp.py`でimportしているライブラリ（例: `requests`, `beautifulsoup4`など）を手動でインストールしてください。*

## ディレクトリ構造

このプロジェクトは、NodeCGの`bundles`ディレクトリ内に配置されることを前提としています。主要なファイルとディレクトリの役割は以下の通りです。

```
nodecg/                            (ホストランタイムディレクトリ)
├── package.json                   (ホスト用 package.json)
├── node_modules/
│   └── nodecg/                    (NodeCGコア、npm installで導入)
├── assets/
│   └── ptcg-telop/
│       ├── element/               (UI要素のフォルダ)
│       ├── icons/                 (エネルギーや異常状態アイコンなどのフォルダ)
│       ├── fx/                    (エフェクト動画のフォルダ)
│       ├── font/                  (フォントのフォルダ)
│       ├── card_img_*/            (自動作成、カード画像のフォルダ)
│       └── database_*.json        (自動作成、カードデータベースのファイル)
├── bundles/
│   └── ptcg-telop/
│       ├── dashboard/             (管理画面のパネル)
│       ├── graphics/              (配信に表示される画面)
│       ├── extension/             (サーバーサイドのロジック)
│       ├── python/                (カード情報取得用スクリプト)
│       ├── i18n/                  (多言語対応用ファイル)
│       ├── package.json           (バンドルの設定ファイル)
│       └── その他のファイル
├── cfg/                           (設定ファイル)
├── db/                            (データベース)
└── logs/                          (ログファイル)
```

-   **`assets/ptcg-telop/`**: 配信で使う背景画像や動画などを配置する場所です。
-   **`dashboard/`**: `http://localhost:9090`でアクセスする操作パネルのファイル群です。
-   **`graphics/`**: OBSなどに取り込むための、配信用グラフィック画面のファイル群です。
-   **`python/`**: デッキコードからカード情報を取得し、データベースを生成するためのスクリプト群です。

## 使用方法

1.  **システムの起動**:
    -   **かんたん導入パッケージ利用者**: `start.bat` (Windows) または `start_MacOS.command` (Mac) をダブルクリックして起動します。
    -   **手動インストーラー**: ホストディレクトリで、以下のコマンドを実行します。
    ```bash
    node node_modules/nodecg/index.js
    ```

2.  **ダッシュボードへのアクセス**:
    Webブラウザで `http://localhost:9090` を開きます。
    `ptcg-telop`という名前のタブが表示され、各種コントロールパネル（Master Control, Player L/Rなど）にアクセスできます。

3.  **基本操作**:
    -   **Playerパネルでのデッキ設定**:
        1.  [ポケモンカードゲーム公式ホームページのデッキ構築ページ](https://www.pokemon-card.com/deck/)等で、使用したいデッキの「デッキコード」を取得します。
        2.  Playerパネル内の`DeckID`入力欄にデッキコードを入力し、「Set」ボタンを押します。
        3.  システムが自動でカード情報を取得し、データベースを構築・更新します。
        4.  その後、ドロップダウンメニューからポケモンを選択し、盤面に配置します。
    -   **Master Controlパネル**: 選択したポケモンに対して、ダメージ計算やエネルギー付付などの一括操作を行います。
    -   **操作フロー**: 全ての操作は、まずドラフトとしてキューに追加され、`Apply`ボタンを押すとライブ画面に反映されます。`Discard`ボタンで破棄できます。

4.  **配信ソフトでの画面設定 (OBS等)**:
    NodeCGのグラフィックは、複数のレイヤー（層）を重ねて一つの画面を構成しています。OBS等の配信ソフトに以下のURLを「ブラウザソース」として追加してください。

最適な表示を得るために、OBSのソースリストで以下の順序（上が最前面）で配置することを推奨します。

1.  **カード展示レイヤー**: `http://localhost:9090/bundles/ptcg-telop/graphics/card.html`
    2.  **拡張ベンチレイヤー**: `http://localhost:9090/bundles/ptcg-telop/graphics/extra.html`
    3.  **メイン盤面レイヤー**: `http://localhost:9090/bundles/ptcg-telop/graphics/main.html`

## 注意点

-   **実行ディレクトリ**: 起動コマンドは、必ずNodeCGの**ホストディレクトリ**（`package.json`があるディレクトリ）で実行してください。
-   **データベース**: データベースはPlayerパネルからデッキコードをセットすることで自動生成されます。手動での操作は不要です。
-   **操作フロー**: このシステムの操作は「Playerパネルで個別の状態を設定」→「Masterパネルで選択・一括操作」→「MasterパネルでApply/Discard」という流れが基本です。

## ライセンス

このプロジェクトはMITライセンスの下で公開されています。

## Special Thanks

本システムの簡体字中国語カードデータベースは、[tcg.mik.moe](https://tcg.mik.moe/)（開発者: [CrystM39](https://x.com/CrystM39)）様より提供されています。心より感謝申し上げます。

ptcg-telop

ptcg-telop 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ptcg-telop

ptcg-telop 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README