An open API service indexing awesome lists of open source software.

https://github.com/tmaster055/minecraft-server-installer

A command line tool for installing a minecraft server!
https://github.com/tmaster055/minecraft-server-installer

arclight bukkit bungeecord fabric folia forge installer minecraft minecraft-server mohist neoforge paper pufferfish purpur quilt server spigot sponge vanilla waterfall

Last synced: 3 months ago
JSON representation

A command line tool for installing a minecraft server!

Awesome Lists containing this project

README

        

# Minecraft-Server-Installer
## Description
This Tool is made for an easy Minecraft Server Setup!
You can easily install a Minecraft Server with over 10 different packages
and nearly all Versions out there!
## Getting started

- ### Installation
Run this command in your command prompt!
```shell
pip install mc-server-tool
```
To update:
```shell
pip install -U mc-server-tool
```
- ### Documentation
```shell
mc-server-tool --help
```
```
usage: mc-server-tool [-h] [--install] [--start] [--settings] [--install_java_21] [--version VERSION]
[--package {Forge,Fabric,Paper,Vanilla,Spigot,Pufferfish,Bukkit,Purpur,Neoforge,Quilt,Folia,Mohist,Arclight,Sponge}] [--path PATH] [--port PORT]
[--ram RAM]

Minecraft Server Tool Arguments

options:
-h, --help show this help message and exit
--install To install a new Server!
--start To start a Server in your path!
--settings To open the settings of the Server in your path!
--install_java_21 To install java version 21 to run the server!
--version VERSION Choose a minecraft version e.x 1.20.1, 1.21...
--package {Forge,Fabric,Paper,Vanilla,Spigot,Pufferfish,Bukkit,Purpur,Neoforge,
Quilt,Folia,Mohist,Arclight,Sponge,BungeeCord,Waterfall}
Choose a Modloader-Package e.x Forge, Vanilla...
--path PATH Pick a folder were to save/edit the server!
It is creating a new folder in it!
e.x C:Users/User/Server (Default is User Directory!)
--port PORT Choose a Port for the Server! Default is 25565
--ram RAM Choose how many RAM the server may use! Default is 4 Gigabyte!
```
- ### Examples
Installs a server with version 1.20.4:
```shell
mc-server-tool --install --version 1.20.4
```
Installs a server with version 1.20.4 on Paper:
```shell
mc-server-tool --install --version 1.20.4 --package Paper
```
Installs and starts the server with 5G max ram usage:
```shell
mc-server-tool --install --version 1.20.4 --ram 5
```
Installs with the port 27767:
```shell
mc-server-tool --install --version 1.20.4 --port 27767
```
Starts your server again:
```shell
mc-server-tool --start
```
Starts your Forge server if you have multiple servers in one folder:
```shell
mc-server-tool --start --package Forge
```
You can also specify the path on start and installation:
```shell
mc-server-tool --start --path /home/user/downloads
```
You also let install java 21:
```shell
mc-server-tool --install_java_21
```
### Package Support
| Supported Packages | Status | Supported Packages | Status | Supported Packages | Status |
|--------------------|---------|----------------------|----------------------------------------------------------------------------|--------------------|---------|
| Vanilla | ✔️ | Forge | ➖ (installing is fine but
starting and configuring
may not work) | Folia | ✔️ |
| Paper | ✔️ | Neoforge | ✔️ | Mohist | ✔️ |
| Spigot | ✔️ | Fabric | ✔️ | Arclight | ✔️ |
| Bukkit | ✔️ | Pufferfish | ✔️ | Sponge | ✔️ |
| Quilt | ✔️ | Purpur | ✔️ | BungeeCord | ✔️ |
| Waterfall | ✔️ |

Note: Not all versions are tested and there may occur problems with some versions!
### Upcoming Tasks
- [x] Make Forge work
- [x] Make Neoforge work
- [x] Make starting easier with package and version
- [ ] Implement more different error messages
- [ ] Add support for more packages
- [ ] Add support for MCPE Server
## Support
If you see any issues you can open one in github or contact me on discord
with the Username`Tmaster055`!