{"id":50775508,"url":"https://github.com/zerozshare/openfriendplugin","last_synced_at":"2026-06-11T23:01:52.212Z","repository":{"id":359967552,"uuid":"1237162656","full_name":"zerozshare/OpenFriendPlugin","owner":"zerozshare","description":"Paper / Spigot / Velocity plugin that publishes your Minecraft server to your Microsoft Friends List — runs the bundled OpenFriend Core as a managed subprocess so friends see and join your server straight from the in-game Friends List.","archived":false,"fork":false,"pushed_at":"2026-05-24T10:21:56.000Z","size":81,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T12:22:16.262Z","etag":null,"topics":["friends-list","friendslist","minecraft","minecraft-plugin","paper","spigot","velocity","xbox-live"],"latest_commit_sha":null,"homepage":"https://openfriend.net","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zerozshare.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-12T23:56:32.000Z","updated_at":"2026-05-24T10:22:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zerozshare/OpenFriendPlugin","commit_stats":null,"previous_names":["zerozshare/openfriendplugin"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/zerozshare/OpenFriendPlugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerozshare%2FOpenFriendPlugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerozshare%2FOpenFriendPlugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerozshare%2FOpenFriendPlugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerozshare%2FOpenFriendPlugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zerozshare","download_url":"https://codeload.github.com/zerozshare/OpenFriendPlugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerozshare%2FOpenFriendPlugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34221150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["friends-list","friendslist","minecraft","minecraft-plugin","paper","spigot","velocity","xbox-live"],"created_at":"2026-06-11T23:01:50.148Z","updated_at":"2026-06-11T23:01:52.203Z","avatar_url":"https://github.com/zerozshare.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e ## ⚠️ Unofficial — not affiliated with Microsoft, Mojang, or the Xbox brand\n\u003e\n\u003e OpenFriend is an **independent, community-built** project. It is **not** developed, endorsed, supported, sponsored, certified, or otherwise officially connected to Microsoft Corporation, Mojang AB, Mojang Studios, or the Xbox brand. \"Minecraft\", \"Xbox\", \"Xbox Live\", \"Microsoft\", and \"Mojang\" are trademarks of their respective owners. Use OpenFriend on accounts you control, on servers you operate or have permission to operate on. You assume all risk associated with running this software.\n\n\u003e ## 🚧 Current scope: offline-mode servers only\n\u003e\n\u003e OpenFriend bridges Friends-List joins **only to offline-mode Minecraft servers** at this time. The online-mode bypass (Floodgate-style auth skip) is **implemented but not yet verified end-to-end** because Paper / Spigot have not released a build matching snapshot 26.2. Set `online-mode=false` on the backend server you bridge to until the bypass is certified.\n\n---\n\n# OpenFriend Plugin\n\nBridge plugin for Paper / Spigot / Velocity servers. Drops the OpenFriend Core binary into the server, manages it as a subprocess, surfaces status to OPs in chat.\n\n## Install\n\nPick the jar matching your Minecraft version and drop it into `plugins/`:\n\n| Server type | File |\n|---|---|\n| Spigot / Paper | `OpenFriend-spigot-\u003cMCver\u003e.jar` |\n| Velocity | `OpenFriend-velocity-0.1.0.jar` |\n\nStart the server. On first run the plugin:\n\n1. Extracts the matching `openfriend-\u003cos\u003e-\u003carch\u003e` binary to `plugins/OpenFriend/bin/`\n2. Generates `plugins/OpenFriend/auth.pem` after the operator completes a Microsoft device-code login (one-time)\n3. Begins broadcasting presence and accepting Friends-List joins\n\n## Configuration\n\n`plugins/OpenFriend/config.yml`:\n\n```yaml\nenabled: true\ntarget: 127.0.0.1:25565        # backend Minecraft server (use the server's own port)\ninterval-s: 30                 # presence interval\nno-auto-accept: false          # auto-accept incoming friend requests\nverbose: false\nskin:\n  file: \"\"                     # path relative to plugins/OpenFriend/\n  variant: classic             # classic or slim\n```\n\n## OP status\n\nOPs see a status report on join:\n\n```\n[OpenFriend] status:\n  account: HIKA2021 (28dc6a27-...)\n  presence: PLAYING_HOSTED_SERVER ✓\n  signaling: connected\n  bypass: enabled\n```\n\n## Online-mode support\n\nThis plugin alone works with **offline-mode** servers. To accept online-mode joins via Friends List, also install the **OpenFriendBypass** plugin.\n\n## License\n\nMIT. See `LICENSE` in this directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerozshare%2Fopenfriendplugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzerozshare%2Fopenfriendplugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerozshare%2Fopenfriendplugin/lists"}