{"id":13592627,"url":"https://github.com/py-mine/PyMine-Server","last_synced_at":"2025-04-08T23:33:56.539Z","repository":{"id":37998902,"uuid":"322730934","full_name":"py-mine/PyMine-Server","owner":"py-mine","description":"A fast and easy to use, moddable, Python based Minecraft server!","archived":false,"fork":false,"pushed_at":"2022-12-13T13:33:23.000Z","size":48556,"stargazers_count":176,"open_issues_count":21,"forks_count":33,"subscribers_count":18,"default_branch":"main","last_synced_at":"2024-08-02T16:45:20.845Z","etag":null,"topics":["async","async-networking","asyncio","java-edition","mc","mc-server","mcje","mcpy","mcserver","minecraft","minecraft-server","minecraftserver","plugins","plugins-api","pymc","pymine","python","pythonmine","pythonminecraft","server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/py-mine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-19T00:00:04.000Z","updated_at":"2024-08-02T07:52:24.000Z","dependencies_parsed_at":"2023-01-28T12:32:08.891Z","dependency_job_id":null,"html_url":"https://github.com/py-mine/PyMine-Server","commit_stats":null,"previous_names":["py-mine/pymine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-mine%2FPyMine-Server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-mine%2FPyMine-Server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-mine%2FPyMine-Server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/py-mine%2FPyMine-Server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/py-mine","download_url":"https://codeload.github.com/py-mine/PyMine-Server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223346926,"owners_count":17130531,"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":["async","async-networking","asyncio","java-edition","mc","mc-server","mcje","mcpy","mcserver","minecraft","minecraft-server","minecraftserver","plugins","plugins-api","pymc","pymine","python","pythonmine","pythonminecraft","server"],"created_at":"2024-08-01T16:01:11.451Z","updated_at":"2025-04-08T23:33:56.534Z","avatar_url":"https://github.com/py-mine.png","language":"Python","readme":"# \u003cimg src=\"https://i.imgur.com/nPCcxts.png\" height=25\u003e PyMine\n[![discord](https://img.shields.io/discord/936788458939224094.svg?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://discord.gg/qcyufdMVQP)\n\u003c!--- ![views](https://api.ghprofile.me/view?username=py-mine/PyMine-Server\u0026color=0FAE6E\u0026style=flat\u0026label=views) ---\u003e\n![quality](https://www.codefactor.io/repository/github/py-mine/pymine-server/badge)\n![contributors](https://img.shields.io/badge/dynamic/json?color=0FAE6E\u0026label=contributors\u0026query=contributors.length\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2Fpy-mine%2FPyMine%2Fmain%2F.all-contributorsrc)\n![code size](https://img.shields.io/github/languages/code-size/py-mine/PyMine?color=0FAE6E)\n![build status](https://img.shields.io/github/workflow/status/py-mine/PyMine/Python%20App?color=0FAE6E)\n![code style](https://img.shields.io/badge/code%20style-black-000000.svg)\n\n\n*PyMine - The fastest, easiest to use, Python-based Minecraft Server!*\n\n\n## Features\n*Note: This list is not always up to date, and doesn't contain all the features that PyMine offers*\n\n- [X] **Windows \u0026 Linux Support** - *completed and always will be a thing*\n- [x] **Joinable** - *completed, players can load into the world*\n- [ ] **Playable** - *currently a work in progress*\n- [ ] **Packet Models** - *missing some clientbound packets*\n- [x] **Status + Login Logic** - *completed*\n- [ ] **Play Logic** - *currently a work in progress*\n- [ ] **World Generation** - *superflat world generation has been completed, normal world gen is a work in progress*\n- [ ] **Entities/Entity AI** - *not started yet*\n- [x] **Plugin API** - *completed, but more will be added as the development continues*\n- [x] **Command/Argument Parsing** - *parsers for primitive types and actual parsing has been completed*\n- [x] **Query Support** - *completed*\n- [ ] **RCON Support** - *not started yet*\n\n\n## Contributing\n- We'd love to have your help! Please read [CONTRIBUTING.md](https://github.com/py-mine/PyMine/blob/main/CONTRIBUTING.md) to get started!\n\n\n## Installation / Usage\n*Check out [the docs](https://pymine.readthedocs.io/) for more info*\n### Installing from source\n- First, clone the repository `git clone https://github.com/py-mine/PyMine.git` and move into that directory (`cd PyMine`)\n- Next, install the required Python packages via pip (`python3 -m pip install -r requirements.txt`, `poetry install`)\n- To run the server, you should run `python3 pymine`.\n- It is recommended you do not use regular Python, but [PyPy3](https://www.pypy.org/)\n\n\n## API/Plugin Examples\n- [example-plugin](https://github.com/py-mine/example-plugin) - *the official example plugin*\n\n\n## Contributors ✨\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://iapetus11.me\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/38477514?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMilo Weinberg\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Iapetus-11\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#design-Iapetus-11\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"#plugin-Iapetus-11\" title=\"Plugin/utility libraries\"\u003e🔌\u003c/a\u003e \u003ca href=\"#data-Iapetus-11\" title=\"Data\"\u003e🔣\u003c/a\u003e \u003ca href=\"#mentoring-Iapetus-11\" title=\"Mentoring\"\u003e🧑‍🏫\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Iapetus-11\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"#question-Iapetus-11\" title=\"Answering Questions\"\u003e💬\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/issues?q=author%3AIapetus-11\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#example-Iapetus-11\" title=\"Examples\"\u003e💡\u003c/a\u003e \u003ca href=\"#ideas-Iapetus-11\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"#projectManagement-Iapetus-11\" title=\"Project Management\"\u003e📆\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/pulls?q=is%3Apr+reviewed-by%3AIapetus-11\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Iapetus-11\" title=\"Tests\"\u003e⚠️\u003c/a\u003e \u003ca href=\"#infra-Iapetus-11\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Sh-wayz\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/67710582?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eSh-wayz\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Sh-wayz\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/issues?q=author%3ASh-wayz\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Sh-wayz\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"#example-Sh-wayz\" title=\"Examples\"\u003e💡\u003c/a\u003e \u003ca href=\"#question-Sh-wayz\" title=\"Answering Questions\"\u003e💬\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/pulls?q=is%3Apr+reviewed-by%3ASh-wayz\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Sh-wayz\" title=\"Tests\"\u003e⚠️\u003c/a\u003e \u003ca href=\"#projectManagement-Sh-wayz\" title=\"Project Management\"\u003e📆\u003c/a\u003e \u003ca href=\"#infra-Sh-wayz\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Ammar-sys\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/69536330?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAmmar-sys\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/py-mine/PyMine/commits?author=Ammar-sys\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/emerald73\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/70043252?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eemerald\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/py-mine/PyMine/commits?author=emerald73\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/pulls?q=is%3Apr+reviewed-by%3Aemerald73\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"#ideas-emerald73\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/issues?q=author%3Aemerald73\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#projectManagement-emerald73\" title=\"Project Management\"\u003e📆\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=emerald73\" title=\"Tests\"\u003e⚠️\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/itsmewulf\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/63970738?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ePaul Przybyszewski\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/py-mine/PyMine/commits?author=itsmewulf\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/ashwinvin\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/38067089?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAshwin Vinod\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-ashwinvin\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=ashwinvin\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=ashwinvin\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://sofi.codes\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/20756843?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eimSofi\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/py-mine/PyMine/issues?q=author%3Aimsofi\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://kevinthomas.codes/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/46242684?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eKevin Thomas\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-TrustedMercury\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=TrustedMercury\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://milanm.tk\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/29466935?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMilan Mehra\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-milanmdev\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/the456gamer\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/42748092?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ethe456gamer\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-the456gamer\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=the456gamer\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/issues?q=author%3Athe456gamer\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#infra-the456gamer\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/DigonIO\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/21240743?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJendrik A. Potyka\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-jpotyka\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=jpotyka\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/py-mine/PyMine/commits?author=jpotyka\" title=\"Tests\"\u003e⚠️\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpy-mine%2FPyMine-Server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpy-mine%2FPyMine-Server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpy-mine%2FPyMine-Server/lists"}