pluGET/README.md
2021-03-12 01:44:39 +01:00

4.6 KiB

pluGET

madewithpython

Apache-2.0 stars downloads

pluGET

A powerfull package manager which handles Plugins for minecraft servers.

Issues? Found a bug?

Create an issue.

About

This is a package manager for minecraft Spigot servers and its forks (e.g. PaperMC).
This is a standalone program written in python.
The program works with a locally installed server or with a remote host through SFTP, when configured in the config.
It uses the Spiget API to download and compare plugin versions and can download the latest version of plugins from the Spigot site.

Plugin management was the hard part of mangaging a minecraft server. The time it took to check the Spigot ressource page for updates for the installed plugins and updating all plugins manually which have available updates was too long and shocking.
So I built pluGET to automate and ease the plugin handling of a minecraft server and to turn the most time consuming part of managing a minecraft server to an easy one.

This program is suited for minecraft server owners who want to save time and stay on top of their plugin versions.
The program input and the associated config file are pretty simple so every server owner and not only the most tech savy ones can use pluGET to ease their plugin handling.

Follow the Installation guide below for an easy and hassle free setup of pluGET.
Read Usage below to get some example inputs when using pluGET.
If you still have questions here is the best place to ask for support.

So what can it do exactly?
pluGET can:

  • work locally or through sftp
  • download the latest version of a plugin
  • update every installed/one specific plugin
  • check for an update of every installed/one specific plugin
  • remove a plugin from the plugin folder

There are more features in the work. Check Projects for a complete list.

So why do it manually when you can use pluGET to automate it? 🚀
Get the latest release here.

Need help?

Discord

Installation

Python

Python needs to be installed on your machine.
Get it here.

Dependencies

Install the needed packages for this project.
Execute this command in the \plugGET folder:

pip install -r requirements.txt

Edit the Config

When run the first time, the config.ini file will be created in the root package folder and the program will close.
Edit the config to your needs and relaunch pluGET.
Now you are good to go!

Usage

Execute the launcher.bat in the \pluGET folder. This will launch pluGET correctly.
Another way is to launch the src\__main__.py file.
The following are examples of input for the general usage:
(Hint: 'all' can always be exchanged through the plugin name or the plugin id and reverse)

Download the latest update of a specific package:

get 'pluginID'

or:

get 'pluginName'

Check all installed plugins for updates:

check all

Check one plugin for updates:

check 'pluginName'

Update all installed plugins:

update all

Update only one plugin:

update 'pluginName'

Remove a plugin with the id:

remove 'pluginID'

Remove a plugin with the name:

remove 'pluginName'

Exit program:

exit .
help .