{"id":15175122,"url":"https://github.com/austin-bowen/mcdl","last_synced_at":"2025-03-28T13:34:10.571Z","repository":{"id":57440287,"uuid":"89907087","full_name":"austin-bowen/mcdl","owner":"austin-bowen","description":"A simple program for downloading Minecraft server software, such as (Craft)Bukkit and Spigot.","archived":true,"fork":false,"pushed_at":"2023-07-25T20:56:08.000Z","size":51,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-09T21:29:34.870Z","etag":null,"topics":["bukkit","bungeecord","cauldron","craftbukkit","genisys","hexacord","mcpc","minecraft","minecraft-servers","nukkit","paperspigot","spigot","tacospigot","thermos","waterfall"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/austin-bowen.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-05-01T07:56:09.000Z","updated_at":"2024-09-11T14:25:51.000Z","dependencies_parsed_at":"2023-07-13T17:22:16.725Z","dependency_job_id":null,"html_url":"https://github.com/austin-bowen/mcdl","commit_stats":null,"previous_names":["saltyhash/mcdl"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austin-bowen%2Fmcdl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austin-bowen%2Fmcdl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austin-bowen%2Fmcdl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austin-bowen%2Fmcdl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/austin-bowen","download_url":"https://codeload.github.com/austin-bowen/mcdl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246037865,"owners_count":20713483,"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","bungeecord","cauldron","craftbukkit","genisys","hexacord","mcpc","minecraft","minecraft-servers","nukkit","paperspigot","spigot","tacospigot","thermos","waterfall"],"created_at":"2024-09-27T12:03:28.047Z","updated_at":"2025-03-28T13:34:10.239Z","avatar_url":"https://github.com/austin-bowen.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"mcdl - Minecraft Downloader\n===========================\n\n    WARNING: Yive has removed the API from `Yive's Mirror \u003chttps://yivesmirror.com/\u003e`_, effectively rendering\n    mcdl useless from now on... :'(  However, Minecraft software can still be downloaded from the site directly.\n    I will keep this GIT repository up, in the hopes that he re-establishes the API.\n\nA simple program for downloading pre-built Minecraft software, such as CraftBukkit and Spigot.\n\nYou can use mcdl to quickly download the latest .jar file for your\nfavorite Minecraft server, grab a specific server API version for plugin\ndevelopment, etc. mcdl uses `Yive's Mirror \u003chttps://yivesmirror.com/\u003e`_\n(no affiliation) to download pre-built Minecraft software for projects such as:\n\n* `Bukkit / CraftBukkit \u003chttps://bukkit.org/\u003e`_\n* `BungeeCord \u003chttps://www.spigotmc.org/\u003e`_\n* `Spigot \u003chttps://www.spigotmc.org/\u003e`_\n* `Thermos \u003chttps://cyberdynecc.github.io/Thermos/\u003e`_\n* `Torch \u003chttps://github.com/TorchSpigot/Torch\u003e`_\n* `Waterfall \u003chttps://github.com/WaterfallMC/Waterfall\u003e`_\n* ... and many more!\n\nUsage\n-----\n\n::\n\n    mcdl get  \u003cproject\u003e \u003cfile\u003e [dest]  Download the project file\n    mcdl list \u003cproject\u003e                List the project files\n\nExamples\n--------\n\nFind and download a specific version of CraftBukkit\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n::\n\n    $ mcdl list craftbukkit\n      Craftbukkit Files                     |  MC Ver      |  Size\n    ----------------------------------------+--------------+------------\n      craftbukkit-latest.jar                |  Latest      |  20.78MB\n      craftbukkit-0.0.1-SNAPSHOT.1000.jar   |  1.7.3 Beta  |  8.11MB\n      craftbukkit-0.0.1-SNAPSHOT.1060.jar   |  1.7.3 Beta  |  8.14MB\n      ...\n      craftbukkit-1.11-R0.1-SNAPSHOT.jar    |  1.11        |  19.05MB\n      craftbukkit-1.11.2-R0.1-SNAPSHOT.jar  |  1.11.2      |  20.79MB\n      craftbukkit.src.zip                   |  Unknown     |  880.63kB\n    $ mcdl get craftbukkit craftbukkit-1.11.2-R0.1-SNAPSHOT.jar\n    Downloading CraftBukkit file \"craftbukkit-1.11.2-R0.1-SNAPSHOT.jar\"...\n      |████████████████████████████████| 100% of 20.79MB (ETA 0:00:00)\n    Saving to file \"./craftbukkit-1.11.2-R0.1-SNAPSHOT.jar\"...  Done.\n    $ ls\n    craftbukkit-1.11.2-R0.1-SNAPSHOT.jar\n\nDownload a Spigot build to a specific path\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n::\n\n    $ mcdl get spigot spigot-latest.jar /path/to/server/spigot.jar\n    Downloading Spigot file \"spigot-latest.jar\"...\n      |████████████████████████████████| 100% of 23.40MB (ETA 0:00:00)\n    Saving to file \"/path/to/server/spigot.jar\"...  Done.\n    $ ls /path/to/server/\n    spigot.jar\n\nSome time later (perhaps run by a cron job)...\n\n::\n\n    $ mcdl get spigot spigot-latest.jar /path/to/server/spigot.jar\n    File \"/path/to/server/spigot.jar\" is already up-to-date\n\nInstallation (Linux)\n--------------------\n\nIf you have `Python3 \u003chttps://www.python.org/downloads/\u003e`_ installed, then you\ncan use pip to install mcdl to your system:\n\n::\n\n    $ sudo pip3 install mcdl\n\nTo uninstall mcdl:\n\n::\n\n    $ sudo pip3 uninstall mcdl\n\nTo upgrade mcdl to the latest version:\n\n::\n\n    $ sudo pip3 install --upgrade mcdl\n\nUse Case: Automatic Server Updates (Linux)\n------------------------------------------\n\nYou can use cron to automatically run mcdl to download the latest\nserver file. Here is a bare-bones example procedure for setting up a cron job\nto automatically download the latest CraftBukkit .jar file every week:\n\n::\n\n    $ cd /etc/cron.weekly/\n    $ sudo touch upgrade-craftbukkit       # Create file\n    $ sudo chmod +x upgrade-craftbukkit    # Make it executable\n\nNow edit the upgrade-craftbukkit file as superuser with your favorite text editor and write something like this:\n\n::\n\n    #!/bin/sh\n    \n    # Downloads the latest CraftBukkit .jar file\n    \n    mcdl get craftbukkit craftbukkit-latest.jar /path/to/server/craftbukkit.jar\n    \n    # File downloaded?\n    if [ $? -eq 0 ]; then\n        # Optionally, some command here to restart your Minecraft server\n        # ...\n    fi\n\ncron will now run the upgrade-craftbukkit file every week, downloading\nthe latest CraftBukkit .jar file into your server's directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faustin-bowen%2Fmcdl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faustin-bowen%2Fmcdl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faustin-bowen%2Fmcdl/lists"}