Blacket icon indicating copy to clipboard operation
Blacket copied to clipboard

The first ever open-source Blooket private server written entirely in TypeScript.

trafficstars

Logo

Blacket

The first ever open-source Blooket private server created by Xotic written entirely in JavaScript.
Get Help
Report Bug Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
    • Prerequisites
    • Installation
  3. License

About The Project

I absolutely love Blooket and almost everything about it, but always felt something was missing from it. Some very experienced developers have created Blooket cheats / hacks for the game, but not many have made something for Blooket as a whole. I have always wanted to create my own custom packs, blooks, games, and more. This is why I created Blacket, the first ever open-source Blooket private server.

(back to top)

Getting Started

Having any debian server should be good for Blacket. If you don't know where to start, I would recommend Linode for beginners.

Prerequisites

The following packages need to be installed before starting:

  • NodeJS

    cd ~
    curl -sL https://deb.nodesource.com/setup_20.x -o /tmp/nodesource_setup.sh
    sudo bash /tmp/nodesource_setup.sh
    sudo apt install nodejs
    
  • MySQL

    sudo apt update
    sudo apt-get install mysql-server
    

    Follow the instructions for all of the packages that will show on screen.

Installation

  1. Clone the repository into your home folder:

    cd /tmp
    git clone https://github.com/XoticLLC/Blacket.git
    mv -v /tmp/Blacket-master ~/blacket
    
  2. Move to the frontend directory and install dependencies:

    cd ~/blacket/frontend
    npm i
    
  3. Build the react app:

    npm run build
    
  4. Move to the backend directory and install dependencies:

    cd ../backend
    npm i
    
  5. Start an instance of Blacket:

    node .
    
  6. Open localhost:3000 in your browser to finish setting up your Blacket instance.

(back to top)

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

(back to top)