{"id":14969591,"url":"https://github.com/neocky/pluget","last_synced_at":"2025-04-04T15:09:23.935Z","repository":{"id":41481814,"uuid":"342166902","full_name":"Neocky/pluGET","owner":"Neocky","description":"🚚💨 Powerful Package manager which updates plugins \u0026 server software for minecraft servers","archived":false,"fork":false,"pushed_at":"2025-01-30T16:02:55.000Z","size":272,"stargazers_count":158,"open_issues_count":16,"forks_count":25,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-04T15:09:18.784Z","etag":null,"topics":["bukkit","ease","minecraft","minecraft-server","paper","papermc","plugin-manager","python","sftp","spigot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Neocky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"Neocky"}},"created_at":"2021-02-25T08:00:54.000Z","updated_at":"2025-04-03T06:33:25.000Z","dependencies_parsed_at":"2024-09-27T12:00:52.601Z","dependency_job_id":"ba0b9dd3-abed-425a-9f61-ec43d4e340c7","html_url":"https://github.com/Neocky/pluGET","commit_stats":{"total_commits":182,"total_committers":8,"mean_commits":22.75,"dds":"0.10439560439560436","last_synced_commit":"6ea80b9c66699b953bb24e29612b42d0e82206ab"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neocky%2FpluGET","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neocky%2FpluGET/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neocky%2FpluGET/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neocky%2FpluGET/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Neocky","download_url":"https://codeload.github.com/Neocky/pluGET/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198461,"owners_count":20900080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","ease","minecraft","minecraft-server","paper","papermc","plugin-manager","python","sftp","spigot"],"created_at":"2024-09-24T13:42:05.394Z","updated_at":"2025-04-04T15:09:23.918Z","avatar_url":"https://github.com/Neocky.png","language":"Python","readme":"\n\u003cp align=\"center\"\u003e\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./assets/branding/pluget-logo-white.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./assets/branding/pluget-logo-black.png\"\u003e\n  \u003cimg src=\"./assets/branding/pluget-logo-black.png\" alt=\"pluGET\" border=\"0\"\u003e\n\u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e  \n\u003ca href=\"https://www.python.org/\"\u003e \u003cimg src=\"https://img.shields.io/badge/made%20with-python%20%F0%9F%90%8D-brightgreen\" alt=\"madewithpython\" border=\"0\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e  \n\u003ca href=\"https://github.com/Neocky/pluGET/releases\"\u003e \u003cimg src=\"https://img.shields.io/github/v/release/Neocky/pluGET?include_prereleases\" alt\"latestrelease\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Neocky/pluGET/releases\"\u003e \u003cimg src=\"https://img.shields.io/github/downloads/Neocky/pluGET/total\" alt=\"downloads\" border=\"0\"\u003e\u003c/a\u003e\n\u003ca href=\"https://hits.seeyoufarm.com\"\u003e\u003cimg src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FNeocky%2FpluGET\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026icon=\u0026icon_color=%23E7E7E7\u0026title=hits\u0026edge_flat=false\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/475Uf4NBPF\"\u003e\u003cimg src=\"https://discordapp.com/api/guilds/801903246284685312/widget.png?style=shield\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# 🚚💨 pluGET  \nA powerful package manager which updates [Plugins](https://www.spigotmc.org/resources/) and Server Software for minecraft servers.   \n\n![pluget-27090b452c1e9](https://github.com/user-attachments/assets/9bfdafd8-2f89-4c00-96b3-05b78b0fdf71)\n\n\u003cdetails\u003e\n  \u003csummary\u003eOld Screenshots\u003c/summary\u003e  \n  \u003cimg src=\"https://user-images.githubusercontent.com/13088544/177011216-1360d444-278a-475e-9863-966c48c60ba7.gif\" alt=\"pluGET.gif\" border=\"0\" /\u003e\n\n  \n  `check all` to check installed plugins for updates:  \n  ![screenshot1](https://i.ibb.co/QM7xh7w/pluget-checkall-small.png)\n  \n  `check all` with more plugins:  \n  ![screenshot2](https://i.ibb.co/VmSNh6K/pluget-checkall.png)\n  \n  `help command` list all available commands:  \n  ![screenshot3](https://i.ibb.co/9VZCjD6/pluget-help2.png)\n  \n\u003c/details\u003e\n\n## 💡 About  \npluGET 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/)).\n\nPlugin 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.\n\nThis 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.\n\n\u003cimg src=\"https://i.ibb.co/82dnyrK/image.png\" alt=\"meme\" border=\"0\" height=\"350\" width=\"350\"\u003e\u003c/a\u003e\n\n## 📖 Features\n- Works locally or through SFTP/FTP\n- Runs directly from the console with command line arguments\n- Checks for updates and downloads the latest version of all/specific plugins\n- Checks for updates and downloads the latest version of your server software\n  - [PaperMc](https://papermc.io/)\n  - [Purpur](https://purpurmc.org/)\n  - [Waterfall](https://papermc.io/downloads#Waterfall)\n  - [Velocity](https://papermc.io/downloads#Velocity)\n\nThere are more features in the work. Check [Projects](https://github.com/Neocky/pluGET/projects) for a complete list.  \n\n**So why do it manually when you can use pluGET to automate it?** 🚀  \n[Get the latest release here.](https://github.com/Neocky/pluGET/releases)  \n\n\n## ☕ Support\nIf you feel like showing your love and/or appreciation for this project then how about buying me a coffee? ☕🤎\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y8Y1CKZ43)\n\n## ❓ Need help?\nCheck out the discord!\n\n[\u003cimg src=\"https://i.ibb.co/PQv3KtJ/Discord-Logo-Wordmark-Color.png\" alt=\"Discord\" width=\"300\"/\u003e](https://discord.gg/475Uf4NBPF)\n\n\n## 💻 Installation\n### 1. Python 3.10.4\nPython needs to be installed on your machine. Get it [here](https://www.python.org/downloads/).  \n\n### 2. Dependencies\nIn order to install dependencies run the `install_requirements_WINDOWS/LINUX` file, of course depending on your system.\n\n### 3. Edit the config\nWhen run pluGET for the first time, the `pluGET_config.yaml` file will be created in the main folder and the program will close.  \nEdit the config to your needs and relaunch pluGET.  \n**Now you are good to go!**  \n\n### 4. Running the program\nExecute the `pluget.py` file with python in the `\\pluGET` folder.  \nThis will launch pluGET correctly.  \n```python\n# Windows:\npy pluget.py\n# Linux\npython3 pluget.py\n```\n\n## 🚀 Usage and Commands\n\u003e [!Caution]\n\u003e As always, if you update plugins, shut down your server!  \n\n### • Show the information about all commands.\n\u003c!-- \u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e  \n  \n  ![Example output](https://i.ibb.co/9VZCjD6/pluget-help2.png)\n  \n\u003c/details\u003e --\u003e\n\n```\nhelp command [all/command]\n```\n\n### • Exit program:\n```\nexit .\n```\n\n### • Get link to this page:\n```\nhelp .\n```\n\n###  Manage Plugins\n#### • Download the latest update of a specific package: \n```\nget [pluginID/pluginName]\n```  \n\n#### • Check all plugins/one specific plugin for updates with optional changelog output:  \n\u003c!-- \u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e  \n  \n  ![Output](https://i.ibb.co/VmSNh6K/pluget-checkall.png)\n  \n\u003c/details\u003e --\u003e\n\n```\ncheck [all/pluginName] [changelog]\n```\n\n#### • Update all plugins/one specific plugin:  \n```\nupdate [all/pluginName]\n```  \n\n#### • Remove a plugin with the ID/Name:  \n```\nremove [pluginID/pluginName]\n```\n\n#### • Search for a plugin:  \n```\nsearch [pluginName]\n```\n\n### Manage Server Software\n\n#### • Check installed server software for updates:\n```\ncheck serverjar\n```\n\n#### • Update installed server software to latest/specific version:\n```\nupdate serverjar [Version]\n```\n\n#### • Download specific paper version:\n```\nget-paper [paperBuild] [minecraftVersion]\n```\n\n#### • Download specific waterfall version:\n```\nget-waterfall [waterfallBuild] [minecraftVersion]\n```\n\n#### • Download specific velocity version:\n```\nget-velocity [velocityBuild] [minecraftVersion]\n```\n\n#### • Download specific purpur version:\n```\nget-purpur [purpurBuild] [minecraftVersion]\n```\n\n## ✅ Command line arguments\npluGET supports all commands directly through the command line. Get the list of all available command line arguments with the `-h` argument.\n\nExample direct command line call:\n```shell\npy pluget.py check all\n```\n\n## ⛔ Known problems\n\n### Can't get latest version/Update available\n\n#### Inconsistent Names and Versions\nExample:\n![EssentialsX](https://i.ibb.co/fDyCYQ8/essentialsx.png)  \nEssentialsX 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`.  \nThat's the reason pluGET can't detect it automatically.  \n\u003e 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.  \n\n#### Solution\nDownload the plugins with the `get [pluginName]` command to make them detectable for pluGET.  \nAfter downloading EssentialsX with `get EssentialsX` and using `check all`:  \n![EssentialsX](https://i.ibb.co/ws5wHTj/essentialsx-2.png)  \nEssentialsX is now detected from pluGET and can update automatically when a new version comes out.  \n\n### Bukkit plugins\nExample:  \n![worldguard](https://i.ibb.co/7NJ9HRG/pluget-checkallonlyone.png)  \nAs you can see the installed version was found but not the latest version for this plugin.  \nThis is because this is a plugin which is not available on [Spigot](https://www.spigotmc.org/resources/).\npluGET supports currently only plugins from [Spigot](https://www.spigotmc.org/resources/).  \nIn this example this is a bukkit plugin.  \n","funding_links":["https://ko-fi.com/Neocky","https://ko-fi.com/Y8Y1CKZ43"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneocky%2Fpluget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneocky%2Fpluget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneocky%2Fpluget/lists"}