[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81718":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":18,"hasPages":18,"topics":20,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":14,"starSnapshotCount":14,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},81718,"OpenFriendMC","zerozshare\u002FOpenFriendMC","zerozshare","Release hub for the OpenFriend ecosystem — backporting the Minecraft Java Edition Friends List (snapshot 26.2+) to any server. Ships Core (Go), Mod (Fabric), Plugin (Paper\u002FVelocity), Bypass, and OpenMix.","https:\u002F\u002Fopenfriend.net",null,"Go",43,1,0,4,43.3,"Other",false,"main",[21,22,23,24,25,26,27],"friends-list","friendslist","minecraft","openfriend","snapshot-26-2","xbox-live","zshare","2026-06-12 04:01:35","# OpenFriendMC — OpenFriend release hub\n\u003Cimg width=\"1920\" height=\"1080\" alt=\"openfriend-all-version\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F162c92c3-74a9-48fd-80e2-2f63dbb5f110\" \u002F>\n\n\nBridge Minecraft Java Edition's Friends List (snapshot 26.2+) to any TCP Minecraft server.\n\nThis repository (**[zerozshare\u002FOpenFriendMC](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendMC)**) is the central distribution point. **All release assets — Core binaries, OpenFriend plugin jars, OpenFriendBypass plugin jars, OpenFriend mod jars (Fabric \u002F Forge \u002F Forge-Legacy) — are uploaded here under [Releases](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendMC\u002Freleases).** The Go binary's auto-update feature pulls from this repo by name. Source code for each component lives in its own repository (see the table below).\n\nOfficial site: **https:\u002F\u002Fopenfriend.net\u002F**\nTeam: **ZSHARE** ([zpw.jp](https:\u002F\u002Fzpw.jp))\n\n[![Join our Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20the%20community-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FYRTyXEwVsE)\n\nCome chat, ask questions, share builds, and shape the roadmap.\n\n> ## ⚠️ Unofficial — not affiliated with Microsoft, Mojang, or the Xbox brand\n>\n> 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 and are used here for descriptive interoperability purposes only.\n>\n> OpenFriend speaks the same network protocols the official Minecraft Java Edition client uses. **Use it 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> ## 🚧 Current scope: offline-mode servers only\n>\n> Right now, OpenFriend bridges Friends-List joins **only to offline-mode Minecraft servers**. The online-mode bypass (Floodgate-style auth skip) is **implemented but not yet verified end-to-end** because Paper \u002F Spigot have not released a build matching snapshot 26.2 — once they do, the bypass plugin will be smoke-tested and certified for online-mode use. Until then: set `online-mode=false` on the backend server you bridge to.\n\n## What's new in v1.0.7 (current)\n\nReliability release focused on the **WebRTC tunnel quality**. If you tried OpenFriend earlier and hit \"Connecting…\" timeouts or laggy joins on heavy modpacks, this release fixes those:\n\n- **No more silent SCTP drops on heavy login handshakes.** Backpressure now propagates from the WebRTC send queue back into the local TCP socket via TCP flow control — Forge mod-registry sync for 90+ mod packs (Hexxit-Updated, large horror packs, kitchen-sink) no longer corrupts mid-handshake.\n- **ICE candidate path visibility.** Every successful join logs whether it went `LAN-direct`, `P2P (NAT-traversed, full bandwidth)`, or `TURN-relay (bandwidth limited by relay)` — so you immediately know if slowness is a relay-bandwidth issue.\n- **Explicit STUN server + relaxed ICE timeouts** for higher P2P success rate vs. relay fallback on tricky NATs.\n- **First-class 1.8.9 Forge support** via standalone ForgeGradle 2.1.6 (the toolchain the 1.8.9 community originally used). Now ships alongside 1.7.10 and 1.12.2 in the Legacy bundle.\n- **Multi-session bug fixed.** Same friend joining twice in quick succession (reconnect, two clients, race conditions) no longer kills the first session.\n\nSee per-component release notes: [Core](RELEASE_NOTES_v1.0.7_core.md) · [Fabric](RELEASE_NOTES_v1.0.7_fabric.md) · [Forge](RELEASE_NOTES_v1.0.7_forge.md) · [Plugin](RELEASE_NOTES_v1.0.7_plugin.md)\n\n## What it does\n\nOpenFriend lets your friends join your Minecraft server through the in-game **Friends List** (introduced in Java Edition snapshot 26.2). Six independently-shippable components, mix and match. Source code lives in separate repositories — pre-built artifacts ship here under [Releases](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendMC\u002Freleases).\n\n| Component | Source repository | What it does |\n|---|---|---|\n| **OpenFriend Core** (CLI \u002F Go binary) | [zerozshare\u002FOpenFriendCore](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendCore) | Authenticates with your Microsoft account, broadcasts presence, accepts incoming Friends-List joins, and bridges the WebRTC data channel to a real Minecraft server. 5 prebuilt platform binaries (macOS arm64\u002Famd64, Linux arm64\u002Famd64, Windows amd64) |\n| **OpenFriend Mod** (Fabric + modern Forge + NeoForge) | [zerozshare\u002FOpenFriendMod](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendMod) | Brings the snapshot 26.2 Friends List UI to **MC 1.16.5 – 1.21.11** across Fabric (26 builds), Forge (18 builds), and NeoForge (in progress). Built via Architectury Loom + an in-house preprocessor (OpenProcess) that lets one source tree target 30+ MC API generations. Embeds Core as a subprocess |\n| **OpenFriend Mod — Legacy** (Forge 1.7.10 \u002F 1.8.9 \u002F 1.12.2) | [zerozshare\u002FOpenFriendModLegacy](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendModLegacy) | Same Friends UI ported to pre-Loom legacy Forge. 1.7.10 \u002F 1.12.2 use RetroFuturaGradle 1.4.9; **1.8.9** uses standalone ForgeGradle 2.1.6 (the only FG version that supports it). 1.6.4 and older are out of scope — their pre-2014 username-based auth predates Mojang's OAuth, so the Friends List API isn't reachable from those clients |\n| **OpenFriend Plugin** (Spigot \u002F Paper \u002F Velocity) | [zerozshare\u002FOpenFriendPlugin](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendPlugin) | Drops the Core binary into your server, starts it as a managed subprocess, surfaces status in chat for OPs. 73 Spigot jars (1.8 → 1.21.11) + 1 Velocity jar |\n| **OpenFriend Bypass** (Spigot \u002F Paper) | [zerozshare\u002FOpenFriendBypass](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenFriendBypass) | Optional. Skips encryption auth on **online-mode** servers for Friends-List-routed connections (Floodgate-style). 30 builds covering modern MC versions on Java 17+ |\n| **OpenMix** (UI toolkit library) | [zerozshare\u002FOpenMix](https:\u002F\u002Fgithub.com\u002Fzerozshare\u002FOpenMix) | Renderer-agnostic Java UI toolkit extracted from the mod. Powers the mod's overlay across all MC versions; reusable in other projects |\n\n## Quick start\n\n### CLI (standalone)\n\n```\n.\u002Fopenfriend --target 127.0.0.1:25565\n```\n\nFirst run prints a Microsoft device code. Authenticate once, the token is encrypted to your machine and reused.\n\n### Plugin (Spigot \u002F Paper \u002F Velocity)\n\n1. Drop these into `plugins\u002F`:\n   - `OpenFriend-spigot-\u003CMCver>.jar` (bridge plugin, or `OpenFriend-velocity-*.jar` for Velocity)\n   - `OpenFriendBypass-\u003CMCver>.jar` (optional, for online-mode servers)\n   - `packetevents.jar` (required when using the Bypass plugin)\n2. Start the server. The plugin extracts the Core binary, generates `bypass.pem`, and prompts you to restart.\n3. Restart. OPs see a status report in chat on login.\n\n### Mod (Fabric \u002F Forge \u002F Forge-Legacy)\n\n1. Install the loader for your target Minecraft version:\n   - **Fabric**: https:\u002F\u002Ffabricmc.net\u002Fuse\u002Finstaller\u002F  (MC 1.16.5 – 1.21.11)\n   - **Forge modern**: install the matching Forge installer  (MC 1.16.5 – 1.21.8)\n   - **Forge legacy**: install Forge for 1.7.10 \u002F 1.8.9 \u002F 1.12.2\n2. Drop the matching jar into `mods\u002F`:\n   - Fabric → `OpenFriend-fabric-\u003CMCver>.jar`\n   - Forge modern → `OpenFriend-forge-\u003CMCver>.jar`\n   - Forge legacy → `OpenFriend-forge-\u003CMCver>.jar` (same naming, from the legacy bundle)\n3. Launch Minecraft. A new **Friends** button appears on Title \u002F Pause \u002F Multiplayer screens.\n4. Click it → first run prompts a Microsoft device code (URL + code shown in `latest.log`). After signing in once, your full Friends overlay opens: list \u002F requests \u002F search \u002F host \u002F blocked.\n\nNo Fabric API dependency required. The Core binary for every platform is bundled inside each jar (~22 MB jar) and auto-launches on first use via JSON-RPC stdio. **47 mod builds total** (26 Fabric + 18 Forge + 3 Forge-Legacy).\n\n## Status\n\nOpenFriend is in **test mode** (v1.0.7). Feature matrix:\n\n| | Standalone CLI | Plugin (Spigot\u002FVelocity) | Mod (Fabric) | Mod (Forge) | Mod (Forge-Legacy) |\n|---|:---:|:---:|:---:|:---:|:---:|\n| Microsoft authentication | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Presence broadcasting | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Friends list management | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Skin upload | ✓ | ✓ | — | — | — |\n| Host mode (accept joins) | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Join mode (join a friend) | ✓ | — | ✓ | ✓ | ✓ |\n| Offline-mode backend | ✓ | ✓ | ✓ | ✓ | ✓ |\n| Online-mode backend | ⚠ via Bypass | ⚠ via Bypass | ✓ native (Mod ↔ Mod) | ✓ native | ✓ native |\n| Machine-bound credential | ✓ | ✓ | ✓ (via Core) | ✓ (via Core) | ✓ (via Core) |\n| Auto-update (Core) | ✓ | notify-only | bundled | bundled | bundled |\n| In-game HUD toasts | — | — | ✓ | ✓ | ✓ (1.7.10: in-game only) |\n| WebRTC backpressure (v1.0.7) | ✓ | ✓ | ✓ | ✓ | ✓ |\n| ICE path diagnostics (v1.0.7) | ✓ | ✓ | ✓ | ✓ | ✓ |\n| NeoForge build | — | — | — | — | — |\n| Bedrock \u002F Java protocol bridge | ✗ | ✗ | ✗ | ✗ | ✗ |\n\n✓ implemented · ⚠ implemented but not yet end-to-end verified · ⏳ planned · ✗ not planned · — not applicable\n\n### Coming soon\n\n- **NeoForge mod builds** — same Architectury setup as Forge, mostly a matter of validating per-version mappings against Mojang's new artifact layout.\n- **Snapshot 26.x \u002F 1.21.9-11 Forge builds** — blocked on Forge upstream publishing Gradle artifacts for those MC versions (Fabric builds already shipped).\n- **Self-hosted TURN server option** — for users whose NAT keeps falling back to Mojang's relay and hitting bandwidth limits. v1.0.7 added the diagnostic logging that tells you when you're stuck on relay; v1.1 adds the way out.\n- **Real player skin heads on legacy MC versions (1.16.5 – 1.19.x)** — currently shows a hashed-color placeholder.\n- **Geyser-style protocol translation** so a 1.20.x server can accept a 26.2-snapshot client through OpenFriend.\n- **In-game `\u002Fopenfriend` commands** for OPs.\n\n## Open source dependencies — Thanks\n\n- [pion\u002Fwebrtc](https:\u002F\u002Fgithub.com\u002Fpion\u002Fwebrtc) — pure Go WebRTC\n- [coder\u002Fwebsocket](https:\u002F\u002Fgithub.com\u002Fcoder\u002Fwebsocket) — Go WebSocket client\n- [google\u002Fuuid](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fuuid) — UUID handling\n- [denisbrodbeck\u002Fmachineid](https:\u002F\u002Fgithub.com\u002Fdenisbrodbeck\u002Fmachineid) — cross-platform machine identification\n- [golang.org\u002Fx\u002Fimage](https:\u002F\u002Fpkg.go.dev\u002Fgolang.org\u002Fx\u002Fimage) — Catmull-Rom image scaling\n- [retrooper\u002Fpacketevents](https:\u002F\u002Fgithub.com\u002Fretrooper\u002Fpacketevents) — cross-version Bukkit packet manipulation\n- [ForgeGradle 2.1.6](https:\u002F\u002Fgithub.com\u002FMinecraftForge\u002FForgeGradle) — the only FG version that natively supports MC 1.8.9, used by our Legacy bundle\n- [Architectury Loom](https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-loom) — multi-loader gradle plugin powering the 18-version Forge matrix\n- [RetroFuturaGradle](https:\u002F\u002Fgithub.com\u002FGTNewHorizons\u002FRetroFuturaGradle) — modern-Gradle support for legacy MC versions (1.7.10 \u002F 1.12.2)\n- Mojang's protocol design — referenced for compatibility (no Mojang code is shipped here)\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\n\"Minecraft\", \"Xbox\", \"Xbox Live\", and related marks are trademarks of Microsoft Corporation and Mojang AB. OpenFriend is **not affiliated with, endorsed by, or sponsored by** Microsoft Corporation, Mojang AB, or the Xbox brand.\n","OpenFriendMC 是一个旨在将 Minecraft Java 版好友列表功能（快照 26.2+）移植到任何 TCP Minecraft 服务器的项目。其核心功能包括通过 Go 语言编写的 Core 组件、适用于 Fabric 的 Mod、适用于 Paper\u002FVelocity 的插件以及 OpenMix 和 Bypass 插件，支持多种服务器环境。该项目特别适合需要在自建或授权运营的离线模式 Minecraft 服务器上实现好友列表功能的场景。当前版本重点改进了 WebRTC 隧道质量，提高了连接稳定性和速度，特别是在处理大型模组包时表现更佳。",2,"2026-06-11 04:06:06","CREATED_QUERY"]