Mirrored_Repos/pluGET
1
0
Fork 0
mirror of https://github.com/Neocky/pluGET.git synced 2024-04-29 16:12:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Reverted formatting changes

Browse Source
This commit is contained in:
pazdikan 2022-07-04 14:29:59 +02:00
parent 744f2e5988
commit b539d11f67
1 changed files with 34 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
README.md
View File

@ -1,3 +1,5 @@
<p align="center"> <p align="center">
<img src="https://i.ibb.co/JyCxnQn/logoreal.png" alt="pluGET" border="0"></a> <img src="https://i.ibb.co/JyCxnQn/logoreal.png" alt="pluGET" border="0"></a>
</p> </p>
@ -13,8 +15,8 @@
<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> <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>
</p> </p>
# pluGET
# pluGET
A powerful package manager which updates [Plugins](https://www.spigotmc.org/resources/) and Server Software for minecraft servers. A powerful package manager which updates [Plugins](https://www.spigotmc.org/resources/) and Server Software for minecraft servers.
<img src="https://user-images.githubusercontent.com/13088544/177011216-1360d444-278a-475e-9863-966c48c60ba7.gif" alt="pluGET.gif" border="0" /> <img src="https://user-images.githubusercontent.com/13088544/177011216-1360d444-278a-475e-9863-966c48c60ba7.gif" alt="pluGET.gif" border="0" />
@ -34,7 +36,6 @@ A powerful package manager which updates [Plugins](https://www.spigotmc.org/reso
</details> </details>
# About # About
pluGET is a standalone package manager written in python for minecraft [Spigot](https://www.spigotmc.org/) servers and its forks (e.g. [PaperMC](https://papermc.io/)). The program works with a locally installed servers or with a remote host through SFTP/FTP, when configured in the config. It uses the [Spiget](https://spiget.org/) API to download and compare plugin versions and download the latest version of plugins from the [Spigot](https://www.spigotmc.org/) site. It can also compare and download the latest update of specific server software (e.g. [PaperMC](https://papermc.io/)). pluGET is a standalone package manager written in python for minecraft [Spigot](https://www.spigotmc.org/) servers and its forks (e.g. [PaperMC](https://papermc.io/)). The program works with a locally installed servers or with a remote host through SFTP/FTP, when configured in the config. It uses the [Spiget](https://spiget.org/) API to download and compare plugin versions and download the latest version of plugins from the [Spigot](https://www.spigotmc.org/) site. It can also compare and download the latest update of specific server software (e.g. [PaperMC](https://papermc.io/)).
Plugin management is the hard part of managing a minecraft server. The time it takes to manually check the [Spigot resources](https://www.spigotmc.org/resources/) page for updates and manually downloading all plugins is too long and daunting. 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. Plugin management is the hard part of managing a minecraft server. The time it takes to manually check the [Spigot resources](https://www.spigotmc.org/resources/) page for updates and manually downloading all plugins is too long and daunting. 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.
@ -44,7 +45,6 @@ This program is suited for minecraft server owners who want to save time and sta
<img src="https://i.ibb.co/82dnyrK/image.png" alt="meme" border="0" height="350" width="350"></a> <img src="https://i.ibb.co/82dnyrK/image.png" alt="meme" border="0" height="350" width="350"></a>
# Features # Features
- Works locally or through SFTP/FTP - Works locally or through SFTP/FTP
- Runs directly from the console with command line arguments - Runs directly from the console with command line arguments
- Checks for updates and downloads the latest version of all/specific plugins - Checks for updates and downloads the latest version of all/specific plugins
@ -58,37 +58,33 @@ There are more features in the work. Check [Projects](https://github.com/Neocky/
**So why do it manually when you can use pluGET to automate it?** 🚀 **So why do it manually when you can use pluGET to automate it?** 🚀
[Get the latest release here.](https://github.com/Neocky/pluGET/releases) [Get the latest release here.](https://github.com/Neocky/pluGET/releases)
# Donations ☕
# Donations ☕
If you feel like showing your love and/or appreciation for this project then how about buying me a coffee? ☕🤎 If you feel like showing your love and/or appreciation for this project then how about buying me a coffee? ☕🤎
[<img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ko-fi" width="300"/>](https://ko-fi.com/Y8Y1CKZ43) [<img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ko-fi" width="300"/>](https://ko-fi.com/Y8Y1CKZ43)
# Need help?
# Need help?
[<img src="https://i.ibb.co/PQv3KtJ/Discord-Logo-Wordmark-Color.png" alt="Discord" width="300"/>](https://discord.gg/475Uf4NBPF) [<img src="https://i.ibb.co/PQv3KtJ/Discord-Logo-Wordmark-Color.png" alt="Discord" width="300"/>](https://discord.gg/475Uf4NBPF)
# Installation # Installation
## 1. Python 3.10.4 ## 1. Python 3.10.4
Python needs to be installed on your machine. Get it [here](https://www.python.org/downloads/). Python needs to be installed on your machine. Get it [here](https://www.python.org/downloads/).
## 2. Dependencies ## 2. Dependencies
In order to install dependencies run the `install_requirements_WINDOWS/LINUX` file, of course depending on your system. In order to install dependencies run the `install_requirements_WINDOWS/LINUX` file, of course depending on your system.
## 3. Edit the config ## 3. Edit the config
When run pluGET for the first time, the `pluGET_config.yaml` file will be created in the main folder and the program will close. When run pluGET for the first time, the `pluGET_config.yaml` file will be created in the main folder and the program will close.
Edit the config to your needs and relaunch pluGET. Edit the config to your needs and relaunch pluGET.
**Now you are good to go!** **Now you are good to go!**
## 4. Running the program ## 4. Running the program
Execute the `pluget.py` file with python in the `\pluGET` folder. Execute the `pluget.py` file with python in the `\pluGET` folder.
This will launch pluGET correctly. This will launch pluGET correctly.
```python ```python
# Windows: # Windows:
py pluget.py py pluget.py
@ -97,13 +93,11 @@ python3 pluget.py
``` ```
# Usage # Usage
> As always, if you update plugins, shut down your server! > As always, if you update plugins, shut down your server!
## Commands: ## Commands:
### • Show the information about all commands. ### • Show the information about all commands.
<!-- <details> <!-- <details>
<summary>Output</summary> <summary>Output</summary>
@ -116,27 +110,22 @@ help command [all/command]
``` ```
### • Exit program: ### • Exit program:
``` ```
exit . exit .
``` ```
### • Get link to this page: ### • Get link to this page:
``` ```
help . help .
``` ```
## Manage Plugins ## Manage Plugins
### • Download the latest update of a specific package: ### • Download the latest update of a specific package:
``` ```
get [pluginID/pluginName] get [pluginID/pluginName]
``` ```
### • Check all plugins/one specific plugin for updates with optional changelog output: ### • Check all plugins/one specific plugin for updates with optional changelog output:
<!-- <details> <!-- <details>
<summary>Output</summary> <summary>Output</summary>
@ -149,19 +138,16 @@ check [all/pluginName] [changelog]
``` ```
### • Update all plugins/one specific plugin: ### • Update all plugins/one specific plugin:
``` ```
update [all/pluginName] update [all/pluginName]
``` ```
### • Remove a plugin with the ID/Name: ### • Remove a plugin with the ID/Name:
``` ```
remove [pluginID/pluginName] remove [pluginID/pluginName]
``` ```
### • Search for a plugin: ### • Search for a plugin:
``` ```
search [pluginName] search [pluginName]
``` ```
@ -169,41 +155,34 @@ search [pluginName]
## Manage Server Software ## Manage Server Software
### • Check installed server software for updates: ### • Check installed server software for updates:
``` ```
check serverjar check serverjar
``` ```
### • Update installed server software to latest/specific version: ### • Update installed server software to latest/specific version:
``` ```
update serverjar [Version] update serverjar [Version]
``` ```
### • Download specific paper version: ### • Download specific paper version:
``` ```
get-paper [paperBuild] [minecraftVersion] get-paper [paperBuild] [minecraftVersion]
``` ```
### • Download specific waterfall version: ### • Download specific waterfall version:
``` ```
get-waterfall [waterfallBuild] [minecraftVersion] get-waterfall [waterfallBuild] [minecraftVersion]
``` ```
### • Download specific waterfall version: ### • Download specific waterfall version:
``` ```
get-velocity [velocityBuild] [minecraftVersion] get-velocity [velocityBuild] [minecraftVersion]
``` ```
# Command line arguments # Command line arguments
pluGET supports all commands directly through the command line. Get the list of all available command line arguments with the `-h` argument. pluGET supports all commands directly through the command line. Get the list of all available command line arguments with the `-h` argument.
Example direct command line call: Example direct command line call:
```shell ```shell
py pluget.py check all py pluget.py check all
``` ```
@ -213,23 +192,19 @@ py pluget.py check all
## Can't get latest version/Update available ## Can't get latest version/Update available
### Inconsistent Names and Versions ### Inconsistent Names and Versions
Example: Example:
![EssentialsX](https://i.ibb.co/fDyCYQ8/essentialsx.png) ![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`. 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. 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. > 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 ### Solution
Download the plugins with the `get [pluginName]` command to make them detectable for pluGET. Download the plugins with the `get [pluginName]` command to make them detectable for pluGET.
After downloading EssentialsX with `get EssentialsX` and using `check all`: After downloading EssentialsX with `get EssentialsX` and using `check all`:
![EssentialsX](https://i.ibb.co/ws5wHTj/essentialsx-2.png) ![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. EssentialsX is now detected from pluGET and can update automatically when a new version comes out.
### Bukkit plugins ### Bukkit plugins
Example: Example:
![worldguard](https://i.ibb.co/7NJ9HRG/pluget-checkallonlyone.png) ![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. As you can see the installed version was found but not the latest version for this plugin.