McLinuxBridge

SECURITY!!

Hello People! Im not responsible for any server destruction used accidently with this plugin, your server MUST have luckperms plugin. Without this, ANY NON OPERATOR PERSON WILL BE ABLE TO USE THIS PLUGIN AND RUN RM -RF!! luckperms disables every plugin's command, except when you enable them seperatly if plugin supports removing and adding permissons to use luckperms. LUCKLILY, you can install our latest plugin version to get the fix that only op people can use the plugin, which will NOT need luckperms. still use luckperms for like optional support permissons. Bye!

WARNING & HOSTING RECOMMENDATION

IMPORTANT: Many free hosting services (like freemcserver.net) strictly block process execution, resulting in bash: Exec failed, error: 13 (Permission denied) errors when attempting to run shell commands.

I highly recommend using this plugin on MCServerHost!

• Secret Specs: Even on their free plans, the underlying node hardware actually runs on ultra-fast enterprise components (up to 3.7+ TB NVMe storage arrays and 5.7 GHz AMD Ryzen 9 / Radeon processors), despite displaying basic plan allocations on their dashboard.
• Full Terminal Access: MCServerHost allows user-space execution threads, letting you use this tool to inspect machine telemetry, manage server files, and perform full map backups natively. (McServerHoster needs premium for backups, so this tool is good for backuping!)
• Custom Plugin Support: You need a host that allows custom .jar uploads (or SFTP access) to install this tool. Hosters without custom plugin support won't offer tools like this in their default plugin lists!

Overview

An ultra-lightweight, efficient cross-platform server administration plugin designed to establish a direct, real-time command pipeline into your host operating system directly from your server console or game chat.

Whether your server runs on Linux, Windows, or macOS, MCLinuxBridge automatically detects the underlying operating system and routes commands cleanly through native system shells (bash, /bin/sh, cmd.exe, or zsh).

Key Features

• Multi-OS Execution Engine: Automatically detects host operating system properties at runtime and invokes the correct native shell (Command Prompt on Windows, Zsh on macOS, or Bash/SH on Linux).
• Native Java File System Fallbacks: Includes built-in Java file readers (/mclinux list, /mclinux disk) that bypass OS-level binary blocks on restricted containers.
• Auto-Embedded Fastfetch: Bundles a portable fastfetch binary directly inside the JAR file that automatically extracts and installs into plugins/MCLinuxBridge/bin/ upon initial server boot.
• Configurable Command Whitelist: Generates a local config.yml file allowing server owners to enable security filters and restrict execution rights to explicitly approved base commands.
• Dynamic Tab-Completion Dropdowns: Pressing Tab in game chat opens an interactive option box suggesting base commands (help, web, disk, reload, cancel, free, df, uname, ls).
• Built-in Java Web File Browser: Hosts a zero-dependency, dark-mode HTTP file explorer directly on port 12732 for browser-based directory inspection.
• Live Asynchronous Streaming: Spawns background worker threads to capture terminal logs line-by-line without freezing your primary game tick loop.
• Process Interruption Control: Includes a /mclinux cancel sub-command to forcefully terminate active or hanging background tasks on demand.
• Watchdog Protection: Applies an automatic 30-second execution cutoff to protect host hardware resources from hanging processes.

Usage Guide

Ensure your user account has appropriate operator privileges, or execute commands directly through your server web panel:

• /mclinux help - Displays the in-game command guide and usage overview.
• /mclinux web - Displays the link to your built-in Java Web File Browser.
• /mclinux disk - Runs native Java storage diagnostics (bypasses shell permission locks).
• /mclinux reload - Hot-reloads your config.yml whitelist settings.
• /mclinux cancel - Forcibly terminates any currently running background process.
• /mclinux <command> - Executes raw terminal or command prompt entries (if permitted by config.yml).

Quick System Diagnostics

• /mclinux free -h (RAM footprint and memory pool analysis)
• /mclinux df -h (Hard drive space allocation tracking)
• /mclinux uname -a (Kernel distribution and OS architecture details)

Security Warning

This plugin exposes direct underlying operating system execution access. It should only be deployed on private local testing networks or trusted standalone nodes. Server administrators should utilize the built-in config.yml whitelist to restrict available commands when operating in multi-user environments.