
Shell Bridge
A Minecraft mod that allows you to run shell commands from chat.
Screenshots

About this Mod
A Minecraft mod that allows you to run shell commands via chat. \
It supports Linux and Windows shells. [ Bash & Powershell ]
use $config script_command "powershell.exe {path}" if on windows
Demo .gif
Commands
$help [command name (optional) - lists commands
$exec [args] - executes arguments in shell
$stop - stops current process
$cd [path] - changes working directory of the shell
$clear - clears the chat
$config- change config
$run - runs a script (more changes to come to this soon)
Config help
only option is $config script_command [value]
this is used when you do $run [path]
you can do {path} to put where the script path is
the reason for this is because different os use different executors such as bash or powershell
also it means you can do python or any other scripting command
Shell to minecraft?
This is a feature being worked on
Commands
asplayer [what does player put in chat]
powershell - script.ps1:
param (
[Parameter(Mandatory=$true)]
[string]$argument
)
$hostname = "localhost"
$port = 1234
$socket = New-Object System.Net.Sockets.TcpClient($hostname, $port)
$stream = $socket.GetStream()
$writer = New-Object System.IO.StreamWriter($stream)
$reader = New-Object System.IO.StreamReader($stream)
$writer.WriteLine($argument)
$writer.Flush()
$response = $reader.ReadLine()
Write-Host $response
$socket.Close()
to run it:
.\script.ps1 -argument "asplayer [what does player put in chat]"
bash script.sh:
#!/bin/bash
argument=$1
hostname="localhost"
port=1234
exec 3<>/dev/tcp/$hostname/$port
echo "$argument" >&3
response=$(head -n 1 <&3)
echo $response
exec 3<&-
exec 3>&-
to run it:
./script.sh "asplayer [what does player put in chat]"
About Project
Author:
Username-31415
Contributor:Silverainox
Future releases will add support for based API's like Git, Pastebin, etc to allow users working with their beloved software directly from Minecraft.
We also value community feedback and reports as its critical for us to eventually perfect this project :)
If you have any questions or have a suggestion, feel free to join our community Discord server
[ Szmelc & Friends ] ~ [ Based Projects Server ] - https://discord.gg/dtEvHFXnSb
My discord username is:
@3_14159265358
Available Versions
How to Install Shell Bridge on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).
Install Mod
Open the mod browser in the dashboard and search for "Shell Bridge". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.8, 1.20.1, 1.20 (+2 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Shell Bridge server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.8). You can switch loaders with one click in the panel.
Is Shell Bridge compatible with fabric?
Shell Bridge officially supports fabric for Minecraft 1.21.8, 1.20.1, 1.20. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Shell Bridge – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Shell Bridge consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Shell Bridge with just one click on your server.