Skip to content

Mytai20100/freeroot-jar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Freeroot-jar - Minecraft Server Root Bypass Access in any hosting

Server Version Plugin Version Language Minecraft Stars Views Downloads

Hosting restrictions and gain root access on Minecraft servers

FeaturesInstallationCommandsExamplesSsh


Overview

FreeRoot-jar is a powerful tool that allows you to bypass Minecraft hosting restrictions and execute Linux commands directly from your server. Perfect for shared hosting environments where root access is restricted.

Current Versions:

  • Server.jar: v1.4.1
  • Plugin (freeroot.jar): v1.6

Features

  • Root Access Bypass: Execute Linux commands without root permissions
  • Architecture Support: Compatible with x86_64 (amd64) and aarch64 (arm64)
  • Multi-Server Support: Works with Bukkit, Paper, Spigot, and more
  • Log Management: Hide/show command output logs
  • Startup Commands: Auto-execute commands on plugin load
  • Restricted Host Support: Works even on heavily restricted hosting environments

Prerequisites

Before using FreeRoot.jar, ensure you have:

  • ✓ Bash shell environment
  • ✓ Internet connectivity
  • ✓ Wget installed
  • ✓ Supported CPU architecture: x86_64 (amd64) or aarch64 (arm64)
  • ✓ Minecraft server (Bukkit/Paper/Spigot compatible)
  • ✓ Git installed

Installation

Method 1: Server.jar (Standalone)

Step 1: Download Server.jar

wget https://github.com/Mytai20100/freeroot-jar/raw/refs/heads/main/server.jar

Or download manually: Download server.jar

Step 2: Run Server

java -Xmx1024M -Xms512M -jar server.jar nogui

That's it! Enjoy your root access


Method 2: Plugin Installation (For Existing Servers)

Step 1: Download Plugin

wget https://github.com/Mytai20100/freeroot-jar/raw/refs/heads/main/freeroot.jar

Or download manually: Download freeroot.jar

Step 2: Install Plugin

  1. Place freeroot.jar in your server's plugins folder:
   YourServer/
   ├── plugins/
   │   └── freeroot.jar  ← Place here
   ├── server.jar
   └── ...

Step 3: First Run (Important!)

  1. Start your server for the first time
  2. You will see an error - this is intentional!
  3. Stop the server
  4. Start the server again - Now it will work perfectly ✓

Supported Server Types

FreeRoot.jar is compatible with:

  • Bukkit
  • Spigot
  • Paper
  • Purpur
  • Any Bukkit-based server

Supported Architectures

Architecture Support Status
x86_64 (amd64) ✓ Fully Supported
aarch64 (arm64) ✓ Fully Supported

Commands

ssh

Use user:root ;pass:root

Example:

PS C:\Users\mytai>ssh [email protected] -p 2222

          Password authentication

          ([email protected]) Password:root

Core Commands

Command Description
/root <command> Execute any Linux command
/root disable-log Hide command output logs
/root enable-log Show command output logs
/root startup <command> Set command to run on plugin load

Example Commands for version plugin

# Check system information
/root uname -a

# List files in current directory
/root ls -la

# Check disk usage
/root df -h

# Run neofetch
/root neofetch

# Check network interfaces
/root ip a

Configuration

Automatic Startup Commands with version plugin

Method 1: Using Command

/root startup curl neofetch.sh | bash

Method 2: Edit config.yml

Location: plugins/freeroot/config.yml

startup-commands:
  - "curl neofetch.sh | bash"
  - "curl google.com"

Advanced Configuration with version server.jar

Dealing with Restricted Hosts

Some hosting providers block input/output or restrict apt functionality. Here's how to bypass these restrictions:

Step 1: Locate root.sh

Find the root.sh file inside the freeroot plugin directory.

Step 2: Append Custom Commands

Add this snippet at the end of root.sh:

$ROOTFS_DIR/usr/local/bin/proot \
  --rootfs="${ROOTFS_DIR}" \
  -0 -w /root -b /dev -b /sys -b /proc -b /etc/resolv.conf --kill-on-exit \
  /bin/bash -c '
    export DEBIAN_FRONTEND=noninteractive;
    apt update -y && apt upgrade -y;
    # Add your custom commands here
    # apt install neofetch -y
  '

Step 3: Customize

Uncomment or add any commands you need:

apt install neofetch htop curl wget -y
neofetch

Example Use Cases for plugin

Example 1: Neofetch =)

/root neofetch

Example 2: hellminer for server.jar

See full example: example.sh

Troubleshooting

Issue: "Permission Denied" Error

Solution:

/root chmod +x /path/to/script

Issue: Plugin doesn't work on first run in old version

Solution: This is normal behavior! Just restart your server once.

Issue: apt doesn't work

Solution: Use the Advanced Configuration method with proot.


Tips

  1. Disable logs when not needed:
   /root disable-log
  1. Use startup commands for frequently used tasks
  /root startup <command>
3. **Keep plugin updated** to the latest version

4. **server resources** regularly:
```bash
   /root neofetch

Documentation

File Structure

plugins/
└── freeroot/
    └── config.yml           # Configuration file

Configuration Options

# config.yml
enable-logs: true
startup-commands:
  - "command1"
  - "command2"

License

Copyright (c) 2025-2030. All rights reserved.

Licensed under the MIT License - see the LICENSE file for details.


Credits

Original Projects

Special Thanks

  • PRoot developers and foxytouxxx

Source code

Other source code

Other version for node.js,bun/typescript,python,rust,ruby,php,golang,nim,d,zig,v,odin,haskell,ocaml,f#,kotlin,swift,zsh,elixir,erlang,clojure,scala,groovy,julia,raku,haxe,lua,scheme,commonlisp,red,assembly

Node.js # node main.js

Bun/TypeScript # bun run main.ts

Python # python main.py

Rust # cargo build --release && ./target/release/main

Ruby # ruby main.rb

Php # php main.php

Golang # go run main.go

Nim # nim r main.nim

D # rdmd main.d

Zig # zig run main.zig

V # v run main.v

Odin # odin run main.odin -file

Haskell # runghc main.hs

OCaml # ocamlfind ocamlopt ... main.ml

F# # dotnet fsi main.fsx

Kotlin # kotlinc main.kt -include-runtime -d main.jar && java -jar main.jar

Swift # swift main.swift

Zsh # chmod +x main.zsh && ./main.zsh

Elixir # elixir main.exs

Erlang # escript main.erl

Clojure # clojure main.clj

Scala # scala-cli main.scala

Groovy # groovy main.groovy

Julia # julia main.jl

Raku # raku main.raku

Haxe # haxe --main Main --interp or compile cpp/hl

Lua # lua main.lua

Scheme # guile main.scm

Common Lisp # sbcl --script main.lisp

Red # red main.red

Assembly # bash build_asm.sh

⚠ Disclaimer

This tool is provided for educational purposes and legitimate server administration only.

  • X Do NOT use this to violate hosting Terms of Service
  • X Do NOT use this for malicious purposes
  • Always respect your hosting provider's policies
  • Use responsibly and ethically The developers are not responsible for any misuse of this tool.

Make by Mytai20100