Kaboom 💥

Table of contents

1. Introduction
2. Rules
3. Installation
   1. Binary Package
   2. From Source
4. Run Locally
   1. Server
   2. Client
5. 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!

Installation

Binary package

Download the kaboom-setup-1.0.exe for windows and kaboom_1.0_all.deb on linux.

Kaboom has been tested on Ubuntu 22.04, Ubuntu 24.04, Debian 12, Windows 10, Windows 11, Mac OS.

From source

Clone the project

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

Go to the game directory

  cd Kaboom

Install dependancies and build package

  #linux
  ./kaboom_install.sh 

  #windows (bat)
  ./kaboom_install.bat

  #windows (ps1)
  ./kaboom_install.ps1

Run client

  #linux
  ./Kaboom

  #windows
  ./Kaboom

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 before building

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)
  E-mail : [email protected]
  Discord : missclick.net
• @Elise (Graphic designer)