{"id":15014998,"url":"https://github.com/sya-ri/minecraft-server-gradle-plugin","last_synced_at":"2026-01-07T07:24:00.047Z","repository":{"id":54668591,"uuid":"379604443","full_name":"sya-ri/minecraft-server-gradle-plugin","owner":"sya-ri","description":"Launch Minecraft servers using Gradle task. For Bukkit, Spigot, Paper, etc..","archived":false,"fork":false,"pushed_at":"2025-04-01T12:12:29.000Z","size":331,"stargazers_count":38,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T09:09:24.106Z","etag":null,"topics":["bukkit","bukkit-plugin","bungeecord","bungeecord-plugin","fabric","fabric-mod","gradle","gradle-plugin","minecraft","minecraft-server","mohist","mohist-plugin","paper","paper-plugin","spigot","spigot-plugin","velocity","velocity-plugin","waterfall","waterfall-plugin"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/sya-ri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null},"funding":{"ko_fi":"sya_ri"}},"created_at":"2021-06-23T13:00:55.000Z","updated_at":"2025-03-02T03:16:05.000Z","dependencies_parsed_at":"2023-01-31T07:15:47.846Z","dependency_job_id":"293f9648-5748-44d2-9f8d-75f0563c16a9","html_url":"https://github.com/sya-ri/minecraft-server-gradle-plugin","commit_stats":{"total_commits":153,"total_committers":5,"mean_commits":30.6,"dds":0.5294117647058824,"last_synced_commit":"e90e87f02071b1e13e49a370afb7e0d0792749f2"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":"cortinico/kotlin-gradle-plugin-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sya-ri%2Fminecraft-server-gradle-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sya-ri%2Fminecraft-server-gradle-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sya-ri%2Fminecraft-server-gradle-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sya-ri%2Fminecraft-server-gradle-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sya-ri","download_url":"https://codeload.github.com/sya-ri/minecraft-server-gradle-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248543850,"owners_count":21121838,"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","bukkit-plugin","bungeecord","bungeecord-plugin","fabric","fabric-mod","gradle","gradle-plugin","minecraft","minecraft-server","mohist","mohist-plugin","paper","paper-plugin","spigot","spigot-plugin","velocity","velocity-plugin","waterfall","waterfall-plugin"],"created_at":"2024-09-24T19:46:22.352Z","updated_at":"2026-01-07T07:24:00.041Z","avatar_url":"https://github.com/sya-ri.png","language":"Kotlin","funding_links":["https://ko-fi.com/sya_ri"],"categories":[],"sub_categories":[],"readme":"# minecraft-server-gradle-plugin\n\n[![Pre Merge Checks](https://github.com/sya-ri/minecraft-server-gradle-plugin/workflows/Pre%20Merge%20Checks/badge.svg)](https://github.com/sya-ri/minecraft-server-gradle-plugin/actions?query=workflow%3A%22Pre+Merge+Checks%22)\n[![License](https://img.shields.io/github/license/sya-ri/minecraft-server-gradle-plugin.svg)](LICENSE)\n![Language](https://img.shields.io/github/languages/top/sya-ri/minecraft-server-gradle-plugin?color=blue\u0026logo=kotlin)\n[![Gradle Plugin Portal](https://img.shields.io/maven-metadata/v/https/plugins.gradle.org/m2/dev/s7a/gradle/minecraft/server/dev.s7a.gradle.minecraft.server/maven-metadata.xml.svg?colorB=007ec6\u0026label=Gradle%20Plugin%20Portal)](https://plugins.gradle.org/plugin/dev.s7a.gradle.minecraft.server)\n\nLaunch Minecraft servers using Gradle task. For Bukkit, Spigot, Paper, etc..\n\n## Installation\n\n### build.gradle\n\n```groovy\nplugins {\n    id 'dev.s7a.gradle.minecraft.server' version '4.0.2'\n}\n```\n\n### build.gradle.kts\n\n```kotlin\nplugins {\n    id(\"dev.s7a.gradle.minecraft.server\") version \"4.0.2\"\n}\n```\n\n## Options\n\n| Name            | Default                 | Description                                                                             |\n|-----------------|-------------------------|-----------------------------------------------------------------------------------------|\n| jarUrl          | **Required**️           | URL to Download the .jar                                                                |\n| jarName         | `server.jar`            | Jar File Name After Download                                                            |\n| serverDirectory | `build/MinecraftServer` | Working Directory                                                                       |\n| jvmArgument     | `[]`                    | [Java Options](https://docs.oracle.com/javase/7/docs/technotes/tools/windows/java.html) |\n| serverArgument  | `[]`                    | [Server Options](https://www.spigotmc.org/wiki/start-up-parameters/)                    |\n| nogui           | `true`                  | Without Vanilla GUI                                                                     |\n| agreeEula       | `false`                 | Agree to the Minecraft EULA                                                             |\n\n## Example\n\n\u003e [!WARNING]\n\u003e This plugin doesn't have a default task. So you have to define it yourself.\n\n### Simple usage\n\n#### build.gradle.kts\n\n```kotlin\ntask\u003cLaunchMinecraftServerTask\u003e(\"launchMinecraftServer\") {\n    jarUrl.set(JarUrl.Paper(\"1.19.2\"))\n    agreeEula.set(true)\n}\n```\n\n### For testing a plugin\n\n#### build.gradle.kts\n\n```kotlin\ntask\u003cLaunchMinecraftServerTask\u003e(\"testPlugin\") {\n    dependsOn(\"build\")\n\n    doFirst {\n        copy {\n            from(layout.buildDirectory.asFile.get().resolve(\"libs/${project.name}.jar\"))\n            into(layout.buildDirectory.asFile.get().resolve(\"MinecraftServer/plugins\"))\n        }\n    }\n\n    jarUrl.set(JarUrl.Paper(\"1.19.2\"))\n    agreeEula.set(true)\n}\n```\n\n### For testing a multi-version supporting plugin\n\n#### build.gradle.kts\n\n```kotlin\nlistOf(\n    \"8\" to \"1.8.8\",\n    \"9\" to \"1.9.4\",\n    \"10\" to \"1.10.2\",\n    \"11\" to \"1.11.2\",\n    \"12\" to \"1.12.2\",\n    \"13\" to \"1.13.2\",\n    \"14\" to \"1.14.4\",\n    \"15\" to \"1.15.2\",\n    \"16\" to \"1.16.5\",\n    \"17\" to \"1.17.1\",\n    \"18\" to \"1.18.2\",\n    \"19\" to \"1.19.4\",\n    \"20\" to \"1.20.4\"\n).forEach { (name, version) -\u003e\n    task\u003cLaunchMinecraftServerTask\u003e(\"testPlugin$name\") {\n        dependsOn(\"build\")\n\n        doFirst {\n            copy {\n                from(layout.buildDirectory.asFile.get().resolve(\"libs/${project.name}.jar\"))\n                into(layout.buildDirectory.asFile.get().resolve(\"MinecraftServer$name/plugins\"))\n            }\n        }\n\n        serverDirectory.set(layout.buildDirectory.asFile.get().resolve(\"MinecraftServer$name\").absolutePath)\n        jarUrl.set(JarUrl.Paper(version))\n        agreeEula.set(true)\n    }\n}\n```\n\n## Supported `JarUrl`\n\n- Paper\n- Velocity\n- Waterfall\n- Fabric\n- Mohist\n- LocalFile\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsya-ri%2Fminecraft-server-gradle-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsya-ri%2Fminecraft-server-gradle-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsya-ri%2Fminecraft-server-gradle-plugin/lists"}