pycon2019-pongpy

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

pycon2019-pongpy

★ 12 Open GitHub ↗

PyCon2019 JX通信社ブースで参加者募集中！ピンポンゲームの挑戦者求む！

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# JX通信社 ピンポンゲームチャレンジ - PyCon JP 2019

![](https://pbs.twimg.com/media/EEVLO9PU8AApFFE?format=jpg&name=large)
https://twitter.com/jxpress_corp/status/1172426002833690624?s=20

## 概要

**強いアルゴリズムを組んで賞品をゲットしよう!!**

- PyConJP 2019 のJX通信社ブースで、アルゴリズムを組んだ **コンピュータ同士** のピンポンゲーム大会を実施します！
- Python で最強のピンポンチームを目指しましょう!
- 上位者には賞品も用意しています.

### ピンポンゲームルール概要

![](https://github.com/pistatium/pong/blob/master/resources/pongpy.gif?raw=true)

- 11点先取、デュースあり
- 前衛、後衛の2体1チーム
- チェンジコートなし
- ゲームが長引くにつれ双方のチームの間隔が中央へ

## キャンペーン参加方法

- PyConJP 2019 JX通信社ブースにてどなたでもご参加いただけます.
- 参加者は右上のボタンからこのレポジトリを Fork してください.
- Fork したレポジトリに下記の手順で Pong チームを実装してください.
- 実装が終わったら弊社ブースにお越しください.
    - GitHub のアカウント名でエントリーできます.
- プログラムでなく人力での参戦も可能です。ゲームの腕に自身がある方はぜひ参戦ください.
- キャンペーンの終了は PyConJP のスポンサーブース終了時間に準じます.

### ルール

- 11点先取、デュースあり
- チェンジコートなし
- ゲームが長引いた場合は双方のバーが前方に寄っていきます

## チームの実装方法

### 環境構築

- [本ゲーム](https://github.com/pistatium/pong)は[pyxel](https://github.com/kitao/pyxel)を使って実装されています
    - macOS/Linux では`pyxel` 自体のほかに、`sdl2` が必要となります
    - OS ごとのインストール方法は上記公式 Repository を参照してください
- Pythonの依存ライブラリインストール用にPipfileとrequirements.txtを用意していますので、お手元の環境に合わせてご利用ください
- セットアップができていれば、環境変数を以下の通り指定し `pongpy challenger:ChallengerTeam enemy:EnemyTeam` でゲームが開始されます
    - `PYTHONPATH`: このリポジトリのルートディレクトリ
    - `PLAYER_NAME`: 画面に表示するプレーヤー(あなた)の名前

- mac + brew の環境であれば以下でインストールできます.

```
brew install python3 sdl2 sdl2_image
pip3 install -U pyxel
```
- 他のOSについては公式 Repository を参照してください.

#### 2.レポジトリのフォーク
- GitHub 右上のボタンから個人のレポジトリへフォークしてください.
- フォーク後、ローカルに clone してきます.

```
git clone git@github.com:${GitHubのユーザー名}/pycon2019-pongpy.git
cd pycon2019-pongpy
```

#### 3.キャンペーン用のゲームをインストール
- Pipfile と requirements.txt を用意していますので、お好きな方法でインストールしてください.

```
# requirements.txt を使う場合
pip3 install -r requirements.txt
```

- インストールが完了したら `pongpy` コマンドを実行して動くか試してみてください.
- ウインドウが開きゲームが始まればインストール完了です.

### pongpy コマンドの使い方
- `pongpy` コマンドでは引数にチームを指定することができます.
- 第一引数が左側チーム、第二引数が右側チームの指定になります.
    - 第一引数のみ指定した場合、pongpy デフォルトのチームとの対戦になります.
- `PLAYER_NAME=GitHubのユーザー名 pongpy challenger:ChallengerTeam enemy:EnemyTeam` コマンドを実行してみてください.
    - ローカルに実行時はゲーム画面上に表示するためのものなので、任意の値でも構いません。
    - (例)`PLAYER_NAME=jxpress pongpy challenger:ChallengerTeam enemy:EnemyTeam`
    - challenger.py と enemy.py で実装されたチームの対戦が始まります.
    - PLAYER_NAME 環境変数は画面に表示されるチーム名です.  
    - 実行できない場合 `export PYTHONPATH=$(pwd)` などをしてパスの確認をしてください.

- `pongpy teams.manual_team:ManualTeam` のコマンドを実行すると左チームを手動操作できます.
    - `I,K,W,S` のキーで操作が可能です

### 実装方法

- `challenger.py` がエントリー用のチームとなります.
    - このファイルを編集して、チームを実装してください.
    - ファイル名、クラス名の `ChallengerTeam` を変更すると参加できません.
- `enemy.py` はデバッグ用のダミーチームです.
    - こちらは自由に変更して構いませんが、ブースでの対戦時には利用されません.
- 実装が完了したら GitHub のレポジトリに Push してください.

#### challenger.py

- 以下の2つの関数を実装していただきます.
    - `atk_action`: 前衛の青色のバーをコントロール
    - `def_action`: 後衛のオレンジ色のバーをコントロール
- それぞれの関数は毎フレームごとに呼ばれ、行動を決定します.
- それぞれの関数は `info: GameInfo`, `state: State` を受け取り、int型の数値を返します. 
    - 引数の `info` から以下の情報が取得できます.
        − フィールドのサイズ
        - ボールのサイズ
        - バーの幅、1フレームあたりの最大移動距離
    - 引数の `state` から現在のゲーム状況が取得できます.
        - 自チームのバーの位置
        - 敵チームのバーの位置
        - ボールの位置
        - 経過フレーム数
        - 自陣の向き
            - キャンペーンでは常に左側チーム固定になります.
    - 返り値が正であれば下へ、負であれば上に向かってバーが動きます.
        - 0 の場合は停止します.
        - 取れる値の範囲は info から取得してください.
- 実装のサンプルを /teams に載せてます.
    
- より詳しい実装方法については以下を参照してください.
    - [GitHub: pistatium/pong](https://github.com/pistatium/pong)

### 関連
* [JX通信社 エンジニアブログ: 報道を自動化するエンジニアはゲーム自動化の夢を見るか](https://tech.jxpress.net/entry/2019/03/22/190724)
  * このゲームはもともと弊社の社内勉強会がきっかけで作られました.

pycon2019-pongpy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README