{"id":13666982,"url":"https://github.com/starlis/empirecraft","last_synced_at":"2025-04-26T15:32:01.282Z","repository":{"id":38711648,"uuid":"49810066","full_name":"starlis/empirecraft","owner":"starlis","description":"EmpireCraft Server Software","archived":false,"fork":false,"pushed_at":"2024-07-04T12:51:52.000Z","size":7593,"stargazers_count":94,"open_issues_count":0,"forks_count":12,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-08-02T07:01:47.848Z","etag":null,"topics":["bukkit","if-you-use-this-dont-expect-support","mc-dev","minecraft","minecraft-fork","minecraft-server","paper","paper-minecraft","paper-spigot","paperspigot","spigot","spigot-fork"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/starlis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2016-01-17T09:03:16.000Z","updated_at":"2024-07-04T12:51:57.000Z","dependencies_parsed_at":"2023-10-02T02:50:27.714Z","dependency_job_id":"fa948144-531b-48bc-ba62-8d54260088ea","html_url":"https://github.com/starlis/empirecraft","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starlis%2Fempirecraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starlis%2Fempirecraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starlis%2Fempirecraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starlis%2Fempirecraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/starlis","download_url":"https://codeload.github.com/starlis/empirecraft/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251008706,"owners_count":21522158,"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","if-you-use-this-dont-expect-support","mc-dev","minecraft","minecraft-fork","minecraft-server","paper","paper-minecraft","paper-spigot","paperspigot","spigot","spigot-fork"],"created_at":"2024-08-02T07:00:20.733Z","updated_at":"2025-04-26T15:32:01.268Z","avatar_url":"https://github.com/starlis.png","language":"Shell","funding_links":[],"categories":["Server Software"],"sub_categories":["Forks"],"readme":"# EmpireCraft\n## What\nEmpireCraft is a fork of [Paper](https://github.com/PaperMC/Paper) used by the [Empire Minecraft](https://ref.emc.gs/Aikar?gam=EmpireCraft) Server.\n\nIt contains many gameplay changes to suit our server and some potential performance improvements to be contributed back to Paper.\n\nWe also have many APIs that we privately use but [may choose not to](#why-we-dont-release-all-apis) publicly PR upstream.\n\n## Why we don't release all APIs\nAPIs are tough to design. In public projects such as Bukkit, Spigot, Paper, etc., once an API is commited, it's almost forever. You can't go breaking it without solid justification. This is the politics game.\n\nWith that in mind, much thought has to be given to our APIs in current and future use cases and applications to ensure it can be extended without breaking. \n\nThis is a lot of politics that we don't have time in our lives to deal with.\n\nTherefore, we write APIs to OUR base needs, which is often not 'complete' or 'up to style guidelines' of upstream repositories. We do not have the time to write code that we personally do not need for these APIs.\n\nWe also want to retain the ability to make breaking changes to these APIs if it results in a better way to do things or performance improvements.\n\nBy contributing it upstream, we would give up that power.\n\nSo that is why we have many extremely useful APIs that are not PR'd upstream. Several APIs may find their way upstream at some point.\n\n## License, Support, \u0026 Usage of Patches\nAll patches written by Aikar, Starlis LLC, and/or Contractors of Starlis LLC that are included within EmpireCraft are licensed MIT, and are free to be used in your own fork.\n\nWe offer __ABSOLUTELY NO SUPPORT__ for these patches. If you wish to use them, you must take the effort to extract them from our repo, apply them to your own, and repair any code changes to get it to compile.\n\nIf we make any breaking changes, and you still wish to use these patches, it's your job to fix the changes!\n\nSo in summary, we love to share! Use anything we wrote in this repo how ever you please, but support it yourself :)\n\nSee [PaperMC/Paper](https://github.com/PaperMC/Paper), and [PaperMC/Paperweight](https://github.com/PaperMC/paperweight) for the license of material used by this project.\n\n## OS Support \u0026 Scripts\nWe only directly support the latest LTS Ubuntu for shell scripts. It may work elsewhere... but no promises.\n\nSome scripts may try to push to our repos, please change that if you fork :)\n\n## API\n\n### Dependency Information\nMaven\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.empireminecraft.empirecraft\u003c/groupId\u003e\n    \u003cartifactId\u003eempirecraft-api\u003c/artifactId\u003e\n    \u003cversion\u003e1.21.4-R0.1-SNAPSHOT\u003c/version\u003e\n    \u003cscope\u003eprovided\u003c/scope\u003e\n\u003c/dependency\u003e\n```\n\nGradle\n```kotlin\ndependencies {\n    compileOnly(\"com.empireminecraft.empirecraft:empirecraft-api:1.21.4-R0.1-SNAPSHOT\")\n}\n```\n\nWe do not currently have a publicly available repository at this time. one would need to compile and publish locally as needed.\n\n## Building and setting up\n\n#### Initial setup\nFirst, \u003cu\u003eclone\u003c/u\u003e this repository. Do not download it.\n\nThen run the following command in the root directory:\n\n```\n./gradlew applyAllPatches\n```\n\nThe project is now ready for use in your IDE.\n\n#### Creating a patch\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n#### Compiling\n\nUse the command `./gradlew build` to build the API and server. Compiled JARs\nwill be placed under `empirecraft-api/build/libs` and `empirecraft-server/build/libs`.\n**These JARs are not used to start a server.**\n\nTo compile a server-ready bundler jar, run `./gradlew createMojmapBundlerJar`.\nTo install the `empirecraft-api` and `empirecraft` dependencies to your local Maven repo, run `./gradlew publishToMavenLocal`. The compiled bundler jar will be in `empirecraft-server/build/libs`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarlis%2Fempirecraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstarlis%2Fempirecraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarlis%2Fempirecraft/lists"}