The Roblox launcher that puts parents in control for PC using java. Only showing approved games. The parent-controlled Roblox launcher whitelists approved games, block everything else, and let kids request new ones.
Please submit all problems/issues/suggestions to https://github.com/stormtheory/bloxbox-java/issues
✅ Debian 11+
✅ Ubuntu 20.04/22.04+
✅ Linux Mint 20+
✅ Windows 7/10/11
- Java JDK 25+
No external database or installer required.
[ New Features ]
[ Big Ticket Items ]
[ New Data Storage ]
// ===== MATH GATE - DoMath =====
// Master switch: set DO_MATH_ENABLED=true in config.properties to require
// the child to solve math problems before the launcher window opens.
// Quiz mode:
// single one question, no retry
// single-fail_loop one question, retry until correct
// multi N questions, each retried until correct (default)
// while infinite loop
# Operations to include (comma-separated, spaces around commas are fine)
# Options: addition, subtraction, multiplication, division
# Aliases: add, sub, multiply/mul, div
#
# Easy - addition, subtraction
# Medium - addition, subtraction, multiplication
# Hard - multiplication, division
# All - addition, subtraction, multiplication, division
# Easy — just adding and taking away
DO_MATH_LEVEL=addition, subtraction
# Medium — add times tables
DO_MATH_LEVEL=addition, subtraction, multiplication
# Hard — times tables and division only
DO_MATH_LEVEL=multiplication, division
# All four
DO_MATH_LEVEL=addition, subtraction, multiplication, division
1) Download the latest released .jar package files off of github at https://github.com/stormtheory/bloxbox-java/releases and install on your system.
#### Windows/Linux/MacOS ####
# Download then execute like normal:
Linux: bloxbox_0.0.1_amd64.deb
Redhat: bloxbox_0.0.1_amd64.rpm
MacOS: bloxbox_0.0.1_amd64.dmg
Windows: bloxbox_0.0.1_amd64.exe
sudo dpkg -i bloxbox_*amd64.deb
sudo dnf install bloxbox_*amd64.rpm
Download the zip file of the code, off of Github. This is found under the [<> Code] button on https://github.com/stormtheory/bloxbox-java.
Install required packages:
a) Java JDK 25 download and install from https://www.oracle.com/java/technologies/downloads/#java25
b) For Windows: https://github.com/wixtoolset/wix3/releases/latest wix314.exe download and install.
c) For Linux:
# Fedora / RHEL / Rocky / Alma
sudo dnf install rpm-build
# openSUSE
sudo zypper install rpm-build
# Debian / Mint / Ubuntu
sudo apt install fakeroot dpkg-dev binutils
Get Required JavaFX packages:
d) At https://gluonhq.com/products/javafx/ download for your platform the SDK and extract the zip/tar folder.
e) Within the lib folder move all files(.jar|.so|.properties) within to the lib of blox-java/lib/linux or blox-java/lib/windows or blox-java/lib/macos.
bloxbox-java/
└── lib/
├── windows/ ← contents of the Windows SDK lib/
├── linux/ ← contents of the Linux SDK lib/
├── macos-x64/ ← contents of the macOS x64 SDK lib/
└── macos-arm/ ← contents of the macOS aarch64 SDK lib/
Build the Installer
f) For all but Windows run `./build -p`
g) For Windows, see "Windows Build" below for more steps.
h) An installer will be outputed to the dist folder
i) Install like normal
g) For Windows, in PowerShell run (NOTE: this takes a long time 30min+):
#### Open an Admin Terminal #################
Start-Process powershell -ArgumentList "-NoExit -Command `"cd '$PWD'`"" -Verb RunAs
########## OPTION 2 TEMPORARILY DISABLE CERT SECURITY but ONLY FOR THIS SESSION ####################
#### Temporarily allows unsigned scripts for this terminal session only ###########################
Set-ExecutionPolicy -Scope Process Bypass
##### Run commands to create installer package
$env:_JAVA_OPTIONS = ""
$env:PATH = "C:\Program Files (x86)\WiX Toolset v3.14\bin;C:\Program Files\Java\jdk-25.0.3\bin;" + $env:PATH
.\run.ps1 -jp
h) An installer will be outputed to the dist folder
i) Install like normal
Download the zip file of the code, off of Github. This is found under the [<> Code] button on https://github.com/stormtheory/bloxbox-java.
Extract directory from the zip file. Run the following commands within the directory.
# Download JavaFX SDK from https://gluonhq.com/products/javafx/
# Extract into ./lib/linux/ or into the folder for your platform
bloxbox-java/
└── lib/
├── windows/ ← contents of the Windows SDK lib/
├── linux/ ← contents of the Linux SDK lib/
├── macos-x64/ ← contents of the macOS x64 SDK lib/
└── macos-arm/ ← contents of the macOS aarch64 SDK lib/
# MacOS Install or edit code:
cd bloxbox-java
./build.sh -br # Build and Run
# or
./build.sh -r # Run
./build.sh -p # Build MacOS installer
# Linux Install or edit code:
cd bloxbox-java
./build.sh -br # Build and Run
# or
./build.sh -r # Run
./build.sh -p # Build Linux installer
# Linux:
cd bloxbox-java
./build.sh -r
# Windows:
Within the folder run command:
.\run.ps1
Use the GUI menu, python admin.py is not currently supported.
Parent Admin Window
Parent controls
## Use the following command and arguments for the old python admin.py:
sudo /opt/bloxbox/app/admin.py init — first-time setup
sudo /opt/bloxbox/app/admin.py list — show approved games
sudo /opt/bloxbox/app/admin.py add — approve a new game
sudo /opt/bloxbox/app/admin.py remove — remove an approved game
sudo /opt/bloxbox/app/admin.py requests — view pending requests from child
sudo /opt/bloxbox/app/admin.py clear-requests — clear all reviewed requests
/opt/bloxbox/
bin/
bloxbox ← launcher, symlinked to /usr/bin/bloxbox by dpkg
lib/
runtime/ ← trimmed JRE
app/
bloxbox.jar
lib/ ← only the linux .so files, nothing else