MLGame

[TOC]

賽車

遊戲版本：1.7.2

更新

增加金幣出現頻率 1 coin per 1.6s
減少電腦車子出現數量 max 12
修正電腦車晃動機制
玩家車左右移動速度調整為 3 pixel

遊戲說明

遊戲開始時，玩家的車由畫面2/3的地方開始起跑，電腦的車子將會從畫面上方或下方進入。玩家的車子不會超過畫面前300像素。如果車子離開遊戲畫面(速度過慢導致從畫面下方離開、撞到左右兩側邊線)將判定為出局；碰撞到其他車子，不論電腦或是其他玩家則雙方都將出局。當有任一玩家距離達到20000，或是所有玩家因碰撞等原因出局時則遊戲結束。

普通模式，依照車子行走距離，存活的玩家，距離大者勝。
金幣模式，依金幣數量多寡，存活的玩家，金幣多者勝。

執行

直接執行預設是兩人遊戲 python main.py
- 車子加速、剎車、左移、右移：1P - UP、DOWN、LEFT、RIGHT，2P - W、S、A、D
搭配MLGame執行，請將遊戲放在MLGame/games資料夾中，遊戲資料夾需命名為RacingCar
- 手動模式： python MLGame.py -m RacingCar <the number of user> [difficulty]
- 機器學習模式： python MLGame.py -i ml_play_template.py RacingCar <the number of user> [difficulty]

遊戲參數

difficulty:遊戲模式，可選擇"NORMAL"或"COIN"，預設為"NORMAL"。
the number of user：指定遊戲玩家人數，最少需一名玩家。單機手動模式最多兩名(鍵盤位置不足)，機器學習模式至多四名。

詳細遊戲資料

座標系

使用 pygame 的座標系統，原點在遊戲區域的左上角，x 正方向為向右，y 正方向為向下。遊戲物件的座標皆在物件的中心點。

遊戲區域

800 * 800 像素。

遊戲物件

玩家車子

40 * 80 像素大小的矩形
每場遊戲開始時，所有玩家的車子會隨機分配至不同車道
初始車速是0，最高車速為15，當車子沒有在加速或剎車時將會怠速至0.9~1.2之間。
車子顏色：1P:白色; 2P:黃綠色; 3P:粉紅色; 4P:淺藍色。

電腦車子

40 * 80 像素大小的矩形
車子從畫面上方或下方出現，不會左右移動切換車道，但會在自己的車道內左右晃動。前方有車(不論是電腦還是玩家)會剎車減速，否則不斷加速至最高速
每台車最高速度皆不一樣。
當遊戲中車子(包含玩家與電腦)數量未超過15輛時，每1.2秒將隨機產生三台車，位置為第123/456/789車道各一。

金幣

20 *20像素大小的矩形
隨機從畫面上方出現，以5 pixel/frame的速度下降。
電腦車子碰到金幣時金幣不會消失。

撰寫玩遊戲的程式

程式範例在 ml/ml_play_template.py。

初始化參數

def __init__(self, player):
    self.player = player
    if self.player == "player1":
        self.player_no = 0
    elif self.player == "player2":
        self.player_no = 1
    elif self.player == "player3":
        self.player_no = 2
    elif self.player == "player4":
        self.player_no = 3
    self.car_vel = 0
    self.car_pos = ()

"player": 字串。其值只會是 "player1" 、 "player2" 、 "player3" 或 "player4"，代表這個程式被哪一台車使用。

遊戲場景資訊

由遊戲端發送的字典物件，同時也是存到紀錄檔的物件。

def update(self, scene_info):
    """
    Generate the command according to the received scene information
    """
    self.car_pos = scene_info[self.player]
    for car in scene_info["cars_info"]:
        if car["id"]==self.player_no:
            self.car_vel = car["velocity"]
    if scene_info.__contains__("coins"):
         self.coin_num = car["coin_num"]
    self.computer_cars = scene_info["computer_cars"]
    self.coins_pos = scene_info["coins"]

    if scene_info["status"] != "ALIVE":
        return "RESET"

    return ["SPEED", "MOVE_LEFT"]

以下是該字典物件的鍵值對應：

"frame"：整數。紀錄的是第幾影格的場景資訊
"status"：字串。目前的遊戲狀態，會是以下的值其中之一：
- "ALIVE"：遊戲正在進行中
"computer_cars"：[(x, y)] list裡面包含數個tuple。電腦車子的位置。
"player1"：(x, y) tuple。1P的位置。
"player2"：(x, y) tuple。2P的位置。
"player3"：(x, y) tuple。3P的位置。
"player4"：(x, y) tuple。4P的位置。
"cars_info"：[{"id":int, "pos":(x,y), "velocity":int, "coin_num":int}] list裡面包含數個字典。每個字典裡包含了車子的編號、位置、速度、金幣數量。金幣模式下，字典內容將新增金幣位置:
"coins"：[(x, y)] list裡面包含數個tuple。金幣的位置。

遊戲指令

傳給遊戲端用來控制板子的指令。