Kaboom 💥

Table of contents

1. Introduction
2. Rules
3. Screenshots
4. Installation
   1. Binary Package
   2. From Source
5. Run Locally
   1. Server
   2. Client
6. Authors

Introduction

🇫🇷 Kaboom est un jeu-vidéo multi-joueur en ligne open-source entièrement développé en python avec PyQT5.

🇬🇧 Kaboom is an open-source online multiplayer video game developed entirely in Python with PyQT5.

Rules

🇫🇷 Trouvez un mot contenant la syllabe affichée à l'écran avant que la bombe explose ! Attention, vous ne connaissez pas le temps imparti !

🇬🇧 Find a word containing the syllable displayed on the screen before the bomb explodes! Be careful, you don't know the time limit!

Screenshots

Installation

Binary package

Download the setup.exe on windows and setup.deb on linux.

Tested on Ubuntu 22.04 and Windows 11.

From source

Clone the project

  git clone https://github.com/Gabrieleirbag1/Kaboom

Go to the game directory

  cd Kaboom

Install dependencies

  #linux
  ./kaboom_install.bash 

  #windows
  kaboom_install.bat

Run client

  #linux
  ./run_client.bash

  #windows
  run_client.bat

Run Locally

Kaboom is hosted 24 hours a day on a dedicated server. However, you can launch the server locally with your own settings.

⚠️ Caution: If you plan to host the server locally, you'll need to configure your router to open the necessary ports. Usage of Linux is also recommanded, as it simplifies the use of sockets and MQTT.

Move to the Server directory

  cd Server/

To host it on your own server, you can modify the configuration files.

Open confs/socket.csv

host,0.0.0.0
port,22222

Change host address if you want to allow only certain addresses. Adjust the port value if you need to alter the TCP port which the script will use.

Open confs/mqtt.csv

broker,missclick.net
port,1883
topic,test
user,siphano
password,F4llenKingdoms##

For the MQTT part, you'll need to establish your own MQTT broker. If you skip these steps, MQTT functionality will not be available, but you can still use mine. The MQTT server allows you to see the words people are writing in real time.

Move to the Client directory

  cd Client/

Open confs/socket.csv

server,missclick.net
port,22222

Change host address to your server address / DNS. Adjust the port value if you need to alter the TCP port which the script will use.

Authors

• @Missclick (Developer)
• @Elise (Graphic designer)