Verilog project

• Verilog project
  • Introduction
  • Usage
  • Game mechanic
    • Overview
    • Singleplayer
    • Multiplayer

Introduction

This is a game based on Undertale: Bad Time Simulator but way easier.

We implemented multiplayer with UART communication. Details are in multiplayer section.

Project is written mostly in Verilog hardware description language. We are using Digilent's BASYS 3 FPGA board and Xilinx Vivado software 2017.3 version.

Requirements

• BASYS 3 FPGA board
• VGA monitor with at least 1024x768 resolution and VGA cable (game is written to work precisly at this resolution)
• USB mouse
• Micro USB cable to power on BASYS 3
• PC with Vivado on it

For playing in multiplayer second set is needed.

Usage

Generate Bitstream and program Your device. Game is ready to play.

How to generate bitstream

Press and hold the shift key, then press the left mouse button on project folder. Choose "Open PowerShell window here" and type vivado -mode tcl -source run.tcl -tclargs open to open Vivado GUI. From there click "Generate Bitstream" in bottom left corner. Open Hardware Manager than Open Target and Auto Connect. When Generate Bitstream is done choose Program Device.

For playing on multiplayer it is necessary to do it on two different PC's and BASYS'es.

Game mechanic

Overview

Our goal is to make a game similar to Undertale's fight mechanic but with mouse instead of keyboard. The sole purpose of the game is surviving as long as possible. In multiplayer mode player can win by surviving more time than opponent.

Singleplayer

As said before the only objective of this mode is to survive as long as possible. Move mouse to avoid obstacles. In both single- and multiplayer, you will be able to see number of obstacles you have managed to clear on on-board LED display, this counter is updated after each obstacle and does not disappear until start of the next game.

Multiplayer

In multiplayer your goal is to survive longer than opponent. It is made only for two persons. You can track opponent's health in red bar on the left sige of game area.

In lobby BASYS is sending 'R' letter constantly via UART to other player. The game starts when both UART's receive 'R' letters. When someone loose the game he sends 'L' letter to other player and game over screen is displayed. Receiving 'L' letter is interpreted as winning over enemy so victory screen will be shown to player who won.

When someone loses HP, UART is sending 'H' letter to opponent to indicate that loss. Receiving 'H' letter decrease opponent health on your screen.

Connecting with other player

UART communication between two BASYS connected to another PC can be done by connecting COM ports over TCP/IP. The easiest way is to be connected to the same network. It can by bypassed by using tools like Hamachi.

For connecting COM ports from two PC we used Serial to Ethernet connector. It has 14 days free trial with is enough to test it. Another great software for it is VSPE. It has free version for 32-bit systems. Unfortunately 64-bit system application is paid only.

After connecting COM ports nothing else has to be done manually.