https://github.com/zerozshare/openfriendplugin
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.
https://github.com/zerozshare/openfriendplugin
friends-list friendslist minecraft minecraft-plugin paper spigot velocity xbox-live
Last synced: 15 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/zerozshare/openfriendplugin
- Owner: zerozshare
- License: other
- Created: 2026-05-12T23:56:32.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-24T10:21:56.000Z (about 1 month ago)
- Last Synced: 2026-05-24T12:22:16.262Z (about 1 month ago)
- Topics: friends-list, friendslist, minecraft, minecraft-plugin, paper, spigot, velocity, xbox-live
- Language: Java
- Homepage: https://openfriend.net
- Size: 79.1 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> ## ⚠️ Unofficial — not affiliated with Microsoft, Mojang, or the Xbox brand
>
> 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.
> ## 🚧 Current scope: offline-mode servers only
>
> 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.
---
# OpenFriend Plugin
Bridge 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.
## Install
Pick the jar matching your Minecraft version and drop it into `plugins/`:
| Server type | File |
|---|---|
| Spigot / Paper | `OpenFriend-spigot-.jar` |
| Velocity | `OpenFriend-velocity-0.1.0.jar` |
Start the server. On first run the plugin:
1. Extracts the matching `openfriend--` binary to `plugins/OpenFriend/bin/`
2. Generates `plugins/OpenFriend/auth.pem` after the operator completes a Microsoft device-code login (one-time)
3. Begins broadcasting presence and accepting Friends-List joins
## Configuration
`plugins/OpenFriend/config.yml`:
```yaml
enabled: true
target: 127.0.0.1:25565 # backend Minecraft server (use the server's own port)
interval-s: 30 # presence interval
no-auto-accept: false # auto-accept incoming friend requests
verbose: false
skin:
file: "" # path relative to plugins/OpenFriend/
variant: classic # classic or slim
```
## OP status
OPs see a status report on join:
```
[OpenFriend] status:
account: HIKA2021 (28dc6a27-...)
presence: PLAYING_HOSTED_SERVER ✓
signaling: connected
bypass: enabled
```
## Online-mode support
This plugin alone works with **offline-mode** servers. To accept online-mode joins via Friends List, also install the **OpenFriendBypass** plugin.
## License
MIT. See `LICENSE` in this directory.