pluGET/README.md

263 lines
9.5 KiB
Markdown
Raw Normal View History

2021-03-14 18:38:47 +00:00
2021-03-09 19:53:07 +00:00
2021-03-04 21:59:19 +00:00
<p align="center">
2021-03-05 19:20:11 +00:00
<img src="https://i.ibb.co/JyCxnQn/logoreal.png" alt="pluGET" border="0"></a>
2021-03-04 21:59:19 +00:00
</p>
2021-03-09 19:53:07 +00:00
<p align="center">
2021-07-09 18:36:17 +00:00
<a href="https://www.python.org/"> <img src="https://img.shields.io/badge/made%20with-python%20%F0%9F%90%8D-brightgreen" alt="madewithpython" border="0"></a>
2021-03-09 19:53:07 +00:00
</p>
<p align="center">
2021-03-14 18:15:06 +00:00
<a href="https://github.com/Neocky/pluGET/blob/main/LICENSE"> <img src="https://img.shields.io/github/license/Neocky/pluGET" alt="Apache-2.0" border="0"></a>
2021-03-14 18:12:56 +00:00
<a href="https://github.com/Neocky/pluGET/releases"> <img src="https://img.shields.io/github/v/release/Neocky/pluGET?include_prereleases" alt"latestrelease"></a>
<a href="https://github.com/Neocky/pluGET/releases"> <img src="https://img.shields.io/github/downloads/Neocky/pluGET/total" alt="downloads" border="0"></a>
2021-03-19 18:16:02 +00:00
<a href="https://hits.seeyoufarm.com"><img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FNeocky%2FpluGET&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false"/></a>
2021-03-14 17:51:43 +00:00
</p>
2021-03-14 17:02:09 +00:00
2021-03-09 19:53:07 +00:00
2021-03-14 21:30:07 +00:00
# pluGET
2021-04-03 18:36:33 +00:00
#### A powerful package manager which updates [Plugins](https://www.spigotmc.org/resources/) and Server Software for minecraft servers.
2021-03-19 18:02:38 +00:00
2021-06-27 00:18:34 +00:00
<img src="https://www.bildhost.com/images/2021/06/27/ezgif-1-28e102202188.gif" alt="pluGET.gif" border="0" />
2021-03-23 17:45:14 +00:00
2021-03-21 17:58:02 +00:00
<details>
<summary>Screenshots</summary>
`check all` to check installed plugins for updates:
![screenshot1](https://i.ibb.co/QM7xh7w/pluget-checkall-small.png)
`check all` with more plugins:
![screenshot2](https://i.ibb.co/VmSNh6K/pluget-checkall.png)
`help command` list all available commands:
![screenshot3](https://i.ibb.co/9VZCjD6/pluget-help2.png)
</details>
2021-03-19 18:02:38 +00:00
2021-03-21 17:58:02 +00:00
<img src="https://i.ibb.co/82dnyrK/image.png" alt="meme" border="0" height="350" width="350"></a>
2021-03-10 14:00:24 +00:00
2021-03-04 21:48:16 +00:00
## Issues? Found a bug?
2021-03-10 14:00:24 +00:00
[Create an issue.](https://github.com/Neocky/pluGET/issues/new/choose)
## About
2021-03-11 12:01:10 +00:00
This is a package manager for minecraft [Spigot](https://www.spigotmc.org/) servers and its forks (e.g. [PaperMC](https://papermc.io/)).
2021-03-11 13:24:28 +00:00
This is a standalone program written in python.
2021-04-03 18:33:58 +00:00
The program works with a locally installed server or with a remote host through SFTP/FTP, when configured in the config.
2021-03-11 13:02:15 +00:00
It uses the [Spiget](https://spiget.org/) API to download and compare plugin versions and can download the latest version of plugins from the [Spigot](https://www.spigotmc.org/) site.
2021-04-03 18:36:33 +00:00
It can also compare and download the latest update of specific server software (e.g. [PaperMC](https://papermc.io/)).
2021-03-11 13:02:15 +00:00
2021-07-14 19:11:36 +00:00
Plugin management was the hard part of managing a minecraft server. The time it took to check the [Spigot resource](https://www.spigotmc.org/resources/) page for updates for the installed plugins and updating all plugins manually which have available updates was too long and daunting.
2021-03-11 13:22:21 +00:00
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.
2021-03-11 13:02:15 +00:00
2021-03-10 14:00:24 +00:00
This program is suited for minecraft server owners who want to save time and stay on top of their plugin versions.
2021-03-11 13:22:21 +00:00
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.
2021-03-11 13:30:04 +00:00
2021-03-10 22:13:07 +00:00
Follow the [Installation](https://github.com/Neocky/pluGET#installation) guide below for an easy and hassle free setup of pluGET.
2021-03-11 13:02:15 +00:00
Read [Usage](https://github.com/Neocky/pluGET#usage) below to get some example inputs when using pluGET.
If you still have questions [here](https://github.com/Neocky/pluGET#need-help) is the best place to ask for support.
2021-03-10 14:00:24 +00:00
So what can it do exactly?
pluGET can:
2021-04-03 18:33:58 +00:00
- work locally or through SFTP/FTP
- manage plugins:
- 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
2021-05-14 22:47:06 +00:00
- manage server software:
- download a specific server software version
2021-04-03 18:36:33 +00:00
- check installed server software for update
- update installed server software to a specific version
- supported server software: [PaperMc](https://papermc.io/)
2021-03-11 13:02:15 +00:00
There are more features in the work. Check [Projects](https://github.com/Neocky/pluGET/projects) for a complete list.
2021-03-11 13:22:21 +00:00
**So why do it manually when you can use pluGET to automate it?** 🚀
2021-03-11 13:02:15 +00:00
[Get the latest release here.](https://github.com/Neocky/pluGET/releases)
2021-03-10 14:00:24 +00:00
2022-05-08 17:21:10 +00:00
## Donations :coffee:
If you feel like showing your love and/or appreciation for this project then how about buying me a coffee? :coffe::brown_heart:
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y8Y1CKZ43)
2022-04-18 14:27:04 +00:00
2021-03-13 22:05:46 +00:00
2021-03-10 14:00:24 +00:00
## Need help?
2021-05-14 23:30:22 +00:00
[<img src="https://i.ibb.co/CMKbT0L/rsz-1rsz-discord.png" alt="Discord" width="272"/>](https://discord.gg/475Uf4NBPF)
2021-03-10 14:00:24 +00:00
2021-03-06 21:14:13 +00:00
## Installation
### 1. Python
Python needs to be installed on your machine.
Get it [here](https://www.python.org/downloads/).
### 2. Dependencies
2021-03-06 21:14:13 +00:00
Install the needed packages for this project.
#### Automatically (Windows only)
Execute the `installer.bat` file to automaticcally install the needed packages for this project.
> Sometimes the security warning `Windows protected your PC` comes when launching the `installer.bat` file.
> This is a normal behaviour from the windows defender because this is a unknown `.bat` file.
> To run the `installer.bat` anyway, click `More Info` and then `Run anyway` when the message pops up.
2021-06-21 22:26:00 +00:00
#### Manually
2021-04-03 18:33:58 +00:00
Execute this command in the `\plugGET` folder:
2021-03-06 21:14:13 +00:00
```python
2021-03-24 22:06:27 +00:00
py -m pip install -r requirements.txt
2021-03-06 21:14:13 +00:00
```
2021-03-08 02:13:31 +00:00
2021-03-10 14:00:24 +00:00
### 3. Edit the Config
When run the first time, the `config.ini` file will be created in the `\src` folder and the program will close.
2021-03-10 14:00:24 +00:00
Edit the config to your needs and relaunch pluGET.
2021-03-08 21:26:44 +00:00
**Now you are good to go!**
## Start pluGET
### Windows:
Execute the `launcher.bat` in the `\pluGET` folder.
This will launch pluGET correctly.
> Sometimes the security warning `Windows protected your PC` comes when launching the `launcher.bat` file.
> This is a normal behaviour from the windows defender because this is a unknown `.bat` file.
> To run the `launcher.bat` anyway, click `More Info` and then `Run anyway` when the message pops up.
### Linux:
Use `cd` to change into the `/pluGET` directory and change the permission of the `launcher.sh` to make it executeable:
```
$ chmod +x launcher.sh
```
Execute the `launcher.sh` file:
```
$ ./launcher.sh
```
> On both OS you can also launch the `src/__main__.py` file.
2021-03-10 14:00:24 +00:00
2021-03-08 21:28:00 +00:00
## Usage
> As always, if you update plugins, shut down your server!
2021-03-10 14:00:24 +00:00
The following are examples of input for the general usage:
(Hint: [thingsInBrackets] are optional & 'all' can always be exchanged through the plugin name or the plugin id and reverse)
### General
#### Command help:
`help command [all/command]`
```
help command
```
<details>
<summary>Output</summary>
![Output](https://i.ibb.co/9VZCjD6/pluget-help2.png)
</details>
### Manage Plugins
2021-03-13 22:05:46 +00:00
#### Download the latest update of a specific package:
`get [pluginID/pluginName]`
2021-03-08 02:13:31 +00:00
```
2021-03-08 21:28:00 +00:00
get 'pluginID'
2021-03-08 02:13:31 +00:00
```
or:
```
2021-03-08 21:28:00 +00:00
get 'pluginName'
2021-03-08 02:13:31 +00:00
```
2021-06-19 22:54:30 +00:00
#### Check all plugins/one specific plugin for updates with optional changelog output:
`check [all/pluginName] [changelog]`
2021-03-08 02:13:31 +00:00
```
check all
```
2021-03-13 22:05:46 +00:00
or:
2021-03-08 02:13:31 +00:00
```
2021-06-19 22:54:30 +00:00
check 'pluginName' changelog
2021-03-08 02:13:31 +00:00
```
<details>
<summary>Output</summary>
![Output](https://i.ibb.co/VmSNh6K/pluget-checkall.png)
</details>
2021-03-13 22:05:46 +00:00
#### Update all plugins/one specific plugin:
`update [all/pluginName]`
2021-03-08 02:13:31 +00:00
```
update all
```
2021-03-13 22:05:46 +00:00
or:
2021-03-08 02:13:31 +00:00
```
update 'pluginName'
```
2021-03-13 22:05:46 +00:00
#### Remove a plugin with the ID/Name:
`remove [pluginID/pluginName]`
2021-03-12 00:44:39 +00:00
```
remove 'pluginID'
```
2021-03-13 22:05:46 +00:00
or:
2021-03-12 00:44:39 +00:00
```
remove 'pluginName'
```
2021-03-13 22:05:46 +00:00
#### Search for a plugin:
`search [pluginName]`
```
search 'pluginName'
```
2021-03-08 21:26:44 +00:00
#### Exit program:
2021-03-13 22:05:46 +00:00
`exit [anything]`
2021-03-08 21:26:44 +00:00
```
exit .
```
#### Get link to here:
2021-03-13 22:05:46 +00:00
`help [anything]`
2021-03-08 21:26:44 +00:00
```
help .
```
### Manage Server Software
#### Check installed server software for updates:
`check serverjar`
```
check serverjar
```
### Update installed server software to latest/specific version:
`update serverjar [Version]`
```
update serverjar 'PaperMCVersion'
```
### Download specific paper version:
`get-paper [paperBuild] [minecraftVersion]`
```
get-paper 550 1.16.5
```
or:
```
get-paper 321
```
## Known problems
### Can't get latest version/Update available
#### Inconsistent Names and Versions
For example:
![EssentialsX](https://i.ibb.co/fDyCYQ8/essentialsx.png)
EssentialsX is a prominent example of inconsisten version naming. The installed version is `2.18.2.0` but on [Spigot](https://www.spigotmc.org/resources/essentialsx.9089/update?update=371379) the version is only described as `2.18.2`.
That's the reason pluGET can't detect it automatically.
> There are of course many more plugins which have some sort of inconsistency which makes it sadly impossible for pluGET to detect them all. EssentialsX is used only as an example.
#### Solution
Download the plugins with the `get [pluginName]` command to make them detectable for pluGET.
After downloading EssentialsX with `get EssentialsX` and using `check all`:
![EssentialsX](https://i.ibb.co/ws5wHTj/essentialsx-2.png)
EssentialsX is now detected from pluGET and can update automatically when a new version comes out.
#### Bukkit plugins
For example:
![worldguard](https://i.ibb.co/7NJ9HRG/pluget-checkallonlyone.png)
As you can see the installed version was found but not the latest version for this plugin.
This is because this is a plugin which is not available on [Spigot](https://www.spigotmc.org/resources/).
pluGET supports currently only plugins from [Spigot](https://www.spigotmc.org/resources/).
In this example this is a bukkit plugin.