Obsidian.API
1.0.0-nightly-9
dotnet add package Obsidian.API --version 1.0.0-nightly-9
NuGet\Install-Package Obsidian.API -Version 1.0.0-nightly-9
<PackageReference Include="Obsidian.API" Version="1.0.0-nightly-9" />
paket add Obsidian.API --version 1.0.0-nightly-9
#r "nuget: Obsidian.API, 1.0.0-nightly-9"
// Install Obsidian.API as a Cake Addin #addin nuget:?package=Obsidian.API&version=1.0.0-nightly-9&prerelease // Install Obsidian.API as a Cake Tool #tool nuget:?package=Obsidian.API&version=1.0.0-nightly-9&prerelease
Obsidian 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!
Feel free to join our Discord if you're curious about the current state of the project, questions are always welcome!
✅ Roadmap
- A custom plugin framework
- Player movement/Info and chat
- Basic chunk loading
- Block breaking/placing
- Other gamemodes besides creative
- Usable storage and crafting blocks
- Low memory usage
- Inventory management
- Daylight and weather cycle
- World generation
- Liquid physics
- Mobs AI & pathfinding
- Redstone circuits
💻 Contribute
Contributions are always welcome! Read about how you can contribute here
🔌 Develop plugins
Plugins are cool! Wanna make them yourself? Find out about plugin development here
🔥 Development builds
Very early development builds are available over at the GitHub Actions page for this repository.
- Ensure you have the latest .NET Runtime installed
- Find the latest
.NET Build
action and scroll to the bottom of the page to find the artifacts. - Unzip the artifact and run
dotnet ObsidianApp.dll
to start the server. - On first run, a config file is generated. Fill this file with your preferenced values and run the previous command again. Easy, isn't it?
🐟 Docker
You can now run Obsidian using Docker! As of right now, no image is available on DockerHub yet, but it will be sometime soon.
For now, to run Obsidian on Docker you will have to follow the following steps:
- Clone Obsidian
git clone https://github.com/ObsidianMC/Obsidian.git
- Go to Obsidian's cloned directory
cd Obsidian
- Build the docker image
docker build . -t obsidian
- Run the container
docker run -d -p YOUR_HOST_PORT:25565 -v YOUR_SERVERFILES_PATH:/files --name YOUR_CONTAINER_NAME obsidian
- Obsidian will pregenerate a config file. Fill it out in
YOUR_SERVERFILES_PATH/config.json
- Start Obsidian's container again.
docker restart YOUR_CONTAINER_NAME
Docker Compose
There's also docker-compose support.
- Clone Obsidian
git clone https://github.com/ObsidianMC/Obsidian.git
- Go to Obsidian's cloned directory
cd Obsidian
- Run
docker-compose up -V
to generate theconfig.json
- Edit your
docker-compose.yml
file, along withfiles/config.json
docker-compose up -Vd
to have the server run! The world, plugin and other server related files will be created in thefiles
directory.
😎 The Obsidian Team
- Naamloos (creator)
- Tides (developer)
- Craftplacer (developer)
- Seb-stian (developer)
- Jonpro03 (developer)
💕 Thank-you's
Thank you to #mcdevs
for additional support.
Thank you to Wiki.vg for documenting Minecraft's protocol.
Thank you to Mojang for creating this wonderful game named Minecraft.
...and of course the biggest thank you to everyone that contributed!
<a href="https://github.com/obsidianserver/obsidian/graphs/contributors"> <img src="https://contributors-img.web.app/image?repo=obsidianserver/obsidian" /> </a>
<sub><sup>Made with contributors-img</sup></sub>
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- SharpNoise (>= 0.12.1.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.0-nightly-9 | 77 | 3/6/2024 |
1.0.0-nightly-8 | 57 | 3/6/2024 |
1.0.0-nightly-7 | 48 | 3/3/2024 |
1.0.0-nightly-6 | 59 | 2/23/2024 |
1.0.0-nightly-5 | 87 | 2/21/2024 |
1.0.0-nightly-19 | 29 | 8/17/2024 |
1.0.0-nightly-18 | 37 | 7/24/2024 |
1.0.0-nightly-17 | 41 | 7/13/2024 |
1.0.0-nightly-16 | 42 | 6/24/2024 |
1.0.0-nightly-15 | 51 | 6/22/2024 |
1.0.0-nightly-14 | 48 | 6/15/2024 |
1.0.0-nightly-13 | 44 | 5/26/2024 |
1.0.0-nightly-12 | 43 | 5/26/2024 |
1.0.0-nightly-11 | 47 | 5/4/2024 |
1.0.0-nightly-10 | 59 | 3/6/2024 |