{"id":15017123,"url":"https://github.com/obsidianmc/obsidian","last_synced_at":"2025-05-15T17:06:16.238Z","repository":{"id":28757936,"uuid":"169994653","full_name":"ObsidianMC/Obsidian","owner":"ObsidianMC","description":"A C# implementation of the Minecraft server protocol.","archived":false,"fork":false,"pushed_at":"2025-05-13T05:09:52.000Z","size":7577,"stargazers_count":438,"open_issues_count":19,"forks_count":45,"subscribers_count":20,"default_branch":"1.21.x","last_synced_at":"2025-05-15T17:06:09.477Z","etag":null,"topics":["csharp","hacktoberfest","lightweight","minecraft","minecraft-server","minecraft-server-protocol","net7","net8","net9","netcore","obsidian"],"latest_commit_sha":null,"homepage":"","language":"C#","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/ObsidianMC.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}},"created_at":"2019-02-10T15:46:56.000Z","updated_at":"2025-05-13T10:44:27.000Z","dependencies_parsed_at":"2023-01-17T00:00:46.849Z","dependency_job_id":"b86eb15e-a37d-4f26-a5bc-81fc2b22aea9","html_url":"https://github.com/ObsidianMC/Obsidian","commit_stats":{"total_commits":1535,"total_committers":41,"mean_commits":37.4390243902439,"dds":0.6723127035830618,"last_synced_commit":"972d2297db73b7dab14ad707376fe49bd2f76493"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObsidianMC%2FObsidian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObsidianMC%2FObsidian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObsidianMC%2FObsidian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObsidianMC%2FObsidian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ObsidianMC","download_url":"https://codeload.github.com/ObsidianMC/Obsidian/tar.gz/refs/heads/1.21.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254384988,"owners_count":22062422,"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":["csharp","hacktoberfest","lightweight","minecraft","minecraft-server","minecraft-server-protocol","net7","net8","net9","netcore","obsidian"],"created_at":"2024-09-24T19:49:54.772Z","updated_at":"2025-05-15T17:06:11.228Z","avatar_url":"https://github.com/ObsidianMC.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](https://i.imgur.com/jU1lkP4.png)\n\n---\n\n[![.NET Build](https://github.com/ObsidianMC/Obsidian/actions/workflows/dotnet.yml/badge.svg)](https://github.com/ObsidianMC/Obsidian/actions/workflows/dotnet.yml)\n[![Discord](https://img.shields.io/discord/772894170451804220.svg)](https://discord.gg/gQBtqyXChu)\n\nObsidian is a C# .NET implementation of the Minecraft server protocol. Obsidian is currently still in development, and a lot of love and care is being put into the project!\n\nFeel free to join our [Discord](https://discord.gg/gQBtqyXChu) if you're curious about the current state of the project, questions are always welcome!\n\n[![Obsidian Discord](https://discord.com/api/guilds/772894170451804220/embed.png?style=banner2)](https://discord.gg/gQBtqyXChu)\n\n## ✅ Roadmap\n- [x] A custom plugin framework\n- [x] Player movement/Info and chat\n- [x] Basic chunk loading\n- [x] Block breaking/placing\n- [x] Other gamemodes besides creative\n- [x] Usable storage and crafting blocks\n- [x] Low memory usage\n- [x] Inventory management\n- [x] Daylight and weather cycle\n- [x] World generation\n- [x] Liquid physics\n- [ ] Mobs AI \u0026 pathfinding\n- [ ] Redstone circuits\n\n## 💻 Contribute\nContributions are always welcome!\nRead about how you can contribute [here](https://github.com/ObsidianMC/Documentation/blob/master/articles/contrib.md)\n\n## 🔌 Develop plugins\nPlugins are cool! Wanna make them yourself?\nFind out about plugin development [here](https://docs.obsidianmc.net/articles/contrib.html)\n\n## 🔥 Development builds\nVery early development builds are available over at the [GitHub Actions](https://github.com/ObsidianMC/Obsidian/actions) page for this repository.\n- Ensure you have the latest [.NET Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/9.0) installed\n- Find the latest `.NET Build` [action](https://github.com/ObsidianMC/Obsidian/actions?query=branch%3Amaster) and scroll to the bottom of the page to find the artifacts.\n- Unzip the artifact and run `dotnet ObsidianApp.dll` to start the server.\n- On first run, a config file is generated. Fill this file with your preferenced values and run the previous command again.\nEasy, isn't it?\n\n## 🐟 Docker\nYou can now run Obsidian using Docker! As of right now, no image is available on DockerHub yet, but it will be sometime soon.\n\nFor now, to run Obsidian on Docker you will have to follow the following steps:\n1. Clone Obsidian `git clone https://github.com/ObsidianMC/Obsidian.git`\n2. Go to Obsidian's cloned directory `cd Obsidian`\n3. Build the docker image `docker build . -t obsidian`\n4. Run the container `docker run -d -p YOUR_HOST_PORT:25565 -v YOUR_SERVERFILES_PATH:/files --name YOUR_CONTAINER_NAME obsidian`\n5. Obsidian will pregenerate a config file. Fill it out in `YOUR_SERVERFILES_PATH/config.json`\n6. Start Obsidian's container again. `docker restart YOUR_CONTAINER_NAME`\n\n### Docker Compose\nThere's also docker-compose support.\n1. Clone Obsidian `git clone https://github.com/ObsidianMC/Obsidian.git`\n2. Go to Obsidian's cloned directory `cd Obsidian`\n3. Run `docker-compose up -V` to generate the `config.json`\n4. Edit your `docker-compose.yml` file, along with `files/config.json`\n5. `docker-compose up -Vd` to have the server run! The world, plugin and other server related files will be created in the `files` directory.\n\n## 😎 The Obsidian Team\n- [Naamloos](https://github.com/Naamloos) (creator)\n- [Tides](https://github.com/Tides) (developer)\n- [Craftplacer](https://github.com/Craftplacer/) (developer)\n- [Seb-stian](https://github.com/Seb-stian) (developer)\n- [Jonpro03](https://github.com/Jonpro03) (developer)\n\n## 💕 Thank-you's\nThank you to [`#mcdevs`](https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge/MCDevs) for additional support.\n\nThank you to [TkTech](https://tkte.ch/) for hosting [Wiki.vg](https://tkte.ch/articles/2024/11/11/sunsetting.html) and for the [`#mcdevs`](https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge/MCDevs) community documenting Minecraft's protocol.\n\nThank you to the [Minecraft Wiki](https://minecraft.wiki) for continuing to host Wiki.vg's contents after the site shut down [[1](https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge)] [[2](https://tkte.ch/articles/2024/11/11/sunsetting.html)], as well as providing further resources on Minecraft's inner workings.\n\nThank you to Mojang for creating this wonderful game named [Minecraft](https://www.minecraft.net).\n\n**...and of course the biggest thank you to everyone that contributed!**\n\n\u003ca href=\"https://github.com/obsidianserver/obsidian/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=obsidianserver/obsidian\" /\u003e\n\u003c/a\u003e\n\n\u003csub\u003e\u003csup\u003eMade with [contributors-img](https://contributors-img.web.app)\u003c/sup\u003e\u003c/sub\u003e\n\n![repobeats](https://repobeats.axiom.co/api/embed/18e251a59758b25b1ecebdfe0f4b6b4004b8d0f9.svg \"Repobeats analytics image\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobsidianmc%2Fobsidian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fobsidianmc%2Fobsidian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobsidianmc%2Fobsidian/lists"}