{"id":13626244,"url":"https://github.com/feather-rs/feather","last_synced_at":"2025-05-14T06:13:03.378Z","repository":{"id":38330975,"uuid":"191701609","full_name":"feather-rs/feather","owner":"feather-rs","description":"A Minecraft server implementation in Rust","archived":false,"fork":false,"pushed_at":"2024-04-12T16:09:15.000Z","size":11234,"stargazers_count":2672,"open_issues_count":109,"forks_count":144,"subscribers_count":54,"default_branch":"main","last_synced_at":"2025-05-11T07:46:01.850Z","etag":null,"topics":["ecs","gamedev","minecraft","minecraft-server","minecraft-server-software","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/feather-rs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2019-06-13T06:10:42.000Z","updated_at":"2025-05-11T06:43:43.000Z","dependencies_parsed_at":"2024-01-08T07:57:45.903Z","dependency_job_id":"c17bca24-64aa-4451-b096-5b4ab50149f1","html_url":"https://github.com/feather-rs/feather","commit_stats":{"total_commits":1096,"total_committers":62,"mean_commits":"17.677419354838708","dds":"0.49452554744525545","last_synced_commit":"2f99d76aaad022e65550c88594b7b9b259503c16"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feather-rs%2Ffeather","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feather-rs%2Ffeather/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feather-rs%2Ffeather/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feather-rs%2Ffeather/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/feather-rs","download_url":"https://codeload.github.com/feather-rs/feather/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254080872,"owners_count":22011516,"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":["ecs","gamedev","minecraft","minecraft-server","minecraft-server-software","rust"],"created_at":"2024-08-01T21:02:13.866Z","updated_at":"2025-05-14T06:13:03.331Z","avatar_url":"https://github.com/feather-rs.png","language":"Rust","funding_links":[],"categories":["Rust","Game Development"],"sub_categories":[],"readme":"# Feather\n[![build](https://github.com/feather-rs/feather/workflows/build/badge.svg)](https://github.com/feather-rs/feather/actions)\n[![Discord](https://img.shields.io/discord/619316022800809995?logo=discord)](https://discordapp.com/invite/4eYmK69)\n\nA Minecraft server implementation written in Rust.\n\n__Note__: This project is currently inactive. Consider contributing to [`valence`](https://github.com/valence-rs/valence) instead.\n\n### Supported Minecraft versions\n\nFeather supports 1.16.5 clients and world saves. We do not currently have plans to support multiple versions at once, but\nwe may consider this in the future.\n\n### Goals\n\nThe Feather project aims to provide a Minecraft server that is _fast_, _modular_, and paired with an ergonomic plugin API.\n\nOur mid-term goal is to make Feather usable on hub and minigame servers. The limited set of gameplay features available in Feather\nis not a problem for such servers that require a small subset of vanilla functionality. On the other hand, Feather's modularity\nand performance lends itself to these types of servers. Therefore, our current focus is\non building a rich plugin API to enable these use cases.\n\nIn the long term, Feather could be used on larger, more survival-like servers, where its performance should allow many players to simultaneously play on the same world requiring very few resources.\n\n### Ecosystem\n\nThe Feather ecosystem consists of several repositories:\n* [`libcraft`](https://github.com/feather-rs/feather/tree/main/libcraft), a set of Rust crates providing Minecraft functionality.\n* [`quill`](https://github.com/feather-rs/feather/tree/main/quill), our work-in-progress plugin API. Quill plugins are written in Rust and compiled to WebAssembly. Feather runs them in a sandboxed WebAssembly VM.\n* `feather`, the server software built on top of `libcraft` and `quill`.\n\n### Performance\n\nComparisons to vanilla performance _will_ be extremely misleading, because Feather implements so few features. But if you really want them:\n\n* Feather can handle 1,000,000 entities spawned by a plugin before it starts to max out the CPU. The vanilla server will croak long before then.\n* Feather can handle 500 concurrent player connections with each player walking in a random direction.\n\nThese results _will_ change after more features are implemented in Feather, so take them with a grain of salt.\n\nMemory usage in Feather is proportional to the number of loaded chunks, not player counts. In the 500 player test, the server uses ~40 MiB of RAM\nuntil the players start to spread out. In the 1,000,000 entities test, it uses 400 MiB of RAM without any chunks loaded.\n\n### Running\nWe offer precompiled binaries for Windows, Linux, and macOS at [GitHub Actions](https://github.com/feather-rs/feather/actions/workflows/main.yml).\nNB: Do **NOT** use github releases, they are majorly outdated\n\nTo run Feather:\n* Extract the downloaded archive.\n* Run the binary.\n  * On Linux and macOS: `./feather-server` in the server directory\n  * On Windows: double-click `feather-server.exe`\n  \nThe server will create a configuration file (`config.toml`) which you can modify.\n\nFeather will generate a world by default. If you want to load a vanilla world,\ncopy the world save to the server directory under the name \"world\" (by default).\n\nWarning: Feather world persistence is fairly new and will likely cause problems\nwhen attempting to open Feather worlds in vanilla. Do not let Feather touch worlds\nyou care about unless they have been backed up.\n\n### Compiling\nIf you are on another platform, compile the server yourself to try it out:\n```bash\ngit clone https://github.com/feather-rs/feather\ncd feather\ncargo build --release\n```\n\nCompiling from source requires the latest stable version of Rust. Older Rust versions may be able\nto compile Feather, but they are not guaranteed to keep working.\n\nThe server executable will be located in `target/release`.\n\n### Architecture\n\nFor contributors, we have a work-in-progress explanation of Feather's architecture [here](docs/architecture.md).\n\n### FAQ\n\n* Is Feather production ready?\n\nNot yet. There are numerous bugs and missing features which have yet to be resolved,\nand the codebase has not been tested enough to consider the server production ready.\n\n* How can I contribute?\n\nCheck out our [issue tracker](https://github.com/feather-rs/feather/issues) to find out what needs to be worked on. Feel free\nto join [our Discord](https://discordapp.com/invite/4eYmK69) and ask questions whenever you need. Thanks for your interest in contributing!\n\n* Are there other ways I can help?\n\nYes! We're always looking for people to test out the server and find bugs. If you find anything that doesn't\nseem right to you, please submit an issue on the issue tracker.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeather-rs%2Ffeather","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffeather-rs%2Ffeather","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeather-rs%2Ffeather/lists"}