Shell Bridge

Shell Bridge

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

by
718 Downloads
fabricutility
Rent Server with this Mod

Screenshots

Shell Bridge

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

Shell Bridge 1.3.0release
MC 1.21.8fabric
September 8, 2025
Shell Bridge 1.2.1release
MC 1.20, 1.20.1fabric
July 17, 2023
Shell Bridge 1.2.1release
MC 1.19.3, 1.19.4fabric
April 6, 2023

How to Install Shell Bridge on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).

3

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

fabric

Minecraft Versions

1.21.8, 1.20.1, 1.20 (+2 more)

Server-side

Unsupported

Recommended 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.

Rent Modded Server

Install Shell Bridge with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-All-Rights-Reserved
Server-side
Unsupported

Supported Versions

1.21.81.20.11.201.19.41.19.3