# 📞 UserPhone — Connect Across Discord

Ever wanted to talk to people from other servers without leaving yours? **UserPhone** makes it happen. Dial up random servers, chat in real-time, and meet new people — all without joining a single invite link.

UserPhone is a **cross-server communication bot** that connects your channel with up to **2 other servers at once**. Messages are relayed seamlessly using webhooks, so you see everyone's **real username, avatar, and messages** as if they were right there in your server. Send text, emojis, GIFs, images, and even stickers — it all goes through.

---

## 🔥 What Makes UserPhone Different?

Most userphone bots connect two servers. That's it. One-on-one, and if the conversation is dry, you're stuck skipping over and over.

**UserPhone lets you expand calls to up to 3 servers at once.**

Here's how it works: you start a normal 1-on-1 call with `c.call`. If another server is waiting in the queue, UserPhone lets you know — and either side can use `c.accept` to invite them into the conversation. Now three communities are chatting together in real-time, all seeing each other's real usernames and avatars. It's the difference between a phone call and a group chat — and no other userphone bot does this.

- 🔹 **1-on-1 calls** — classic random matching with `c.call`
- 🔹 **Group expansion** — accept a third server into your call with `c.accept`
- 🔹 **Consent-based** — no one joins your call unless someone in the call approves
- 🔹 Every participant sees everyone else's real username and avatar
- 🔹 All media types supported — text, GIFs, images, stickers, emojis

---

## ⚡ How It Works

1. Add UserPhone to your server
2. Set up a channel with `c.config add #channel`
3. Type `c.call` to connect with a random server
4. Start chatting! Messages relay instantly with full usernames and avatars
5. Someone else waiting? Use `c.accept` to bring a third server into the call
6. Use `c.hangup` when you're done or `c.skip` to find someone new

It's that simple. No sign-ups, no accounts, no extra setup.

---

## 🛠️ Commands

| Command | Shortcut | What It Does |
|---|---|---|
| `c.call` | `c.c` | Start a 1-on-1 call with a random server |
| `c.accept` | — | Let a waiting server join your active call (up to 3) |
| `c.hangup` | `c.h` | End the current call |
| `c.skip` | `c.s` | Skip to a new match instantly |
| `c.friendme` | `c.fm` | Share your username so they can add you |
| `c.report` | `c.r` | Report someone for breaking guidelines |
| `c.status` | — | Check if you're in a call + global stats |
| `c.config` | — | Set up which channels UserPhone uses (admin) |
| `c.leaderboard` | `c.lb` | See the top servers by activity |
| `c.serverstats` | — | View your server's call stats and rank |

---

## 💬 Full Media Support

UserPhone doesn't just relay text. Everything you send comes through:

- ✅ **Text & Emojis** — standard and custom emojis
- ✅ **GIFs** — Tenor, Giphy, and direct uploads
- ✅ **Images & Files** — photos, screenshots, attachments
- ✅ **Stickers** — Discord stickers displayed as embedded images
- ✅ **Real Identity** — your display name and avatar show on the other side

No stripped-down, text-only experience. It feels like the other person is actually in your server.

---

## 🏆 Server Leaderboard

Every call counts. UserPhone tracks your server's total calls, messages, and talk time, then ranks all servers globally. Compete for the top spot and show off your community's social energy.

Use `c.leaderboard` to see the global top 10, or `c.serverstats` to see where your server stands.

---

## 🛡️ Safety & Moderation

We take safety seriously. UserPhone includes built-in tools to keep conversations clean:

- **Report system** — use `c.report` during a call to flag bad behavior
- **User bans** — repeat offenders get banned from UserPhone entirely
- **Server bans** — entire servers can be blocked if needed
- **Server blocking** — admins can block specific servers from being matched with theirs
- **Channel control** — restrict UserPhone to specific channels so it doesn't interfere with the rest of your server

---

## 👋 Make Friends Across Discord

Hit it off with someone? Use `c.friendme` during a call to share your Discord username with the other side. It's completely opt-in — your info is only shared when **you** choose to share it. The other person gets your username and avatar so they can send you a friend request directly.

---

## ⚙️ Easy Setup for Admins

Getting UserPhone running takes about 30 seconds:

1. **Invite UserPhone** using the button above
2. Run `c.config add #phone-chat` in the channel you want to use
3. Done. Your members can now `c.call` from that channel.

You can add multiple channels, remove them anytime, or reset with `c.config reset`. UserPhone checks that it has the right permissions (Send Messages, Manage Webhooks, Read Messages) before activating in a channel, so there are no surprises.

---

## ❓ FAQ

**Q: How do group calls work?**
You start a normal call with `c.call`. Once you're connected 1-on-1, if another server is waiting in the queue, UserPhone will notify you. Either side can type `c.accept` to let them join, expanding the call to 3 servers. The third server doesn't just barge in — someone already in the call has to approve it first.

**Q: Does UserPhone ever match me with my own server?**
No. Calls always connect two different servers.

**Q: Is there a cooldown?**
Yes — a short cooldown between commands prevents spam. Calls also have a maximum duration to keep things moving.

**Q: Can I choose who I connect with?**
Not currently — matchmaking is random. That's part of the fun!

**Q: Is my info shared automatically?**
Never. Your username is only shared if you explicitly use `c.friendme`. Otherwise the other side only sees your display name and avatar through the webhook relay.

**Q: What permissions does UserPhone need?**
Send Messages, Read Messages, Manage Webhooks, Embed Links, Attach Files, Read Message History, Add Reactions, and Use External Emojis.

---

## 🔗 Links

- 🌐 **Support Server:** [Join here](https://discord.gg/8MfVMPmCKW)
- 🗳️ **Vote for UserPhone:** Help us grow by voting on this page!
- 💬 **Feedback?** Join the support server or use `c.report` for issues

---

*UserPhone is actively developed and regularly updated. Have a feature idea? Drop by the support server and let us know!*

Abstimmung für PhoneBot

Möchtest du uns unterstützen?