🛡️ Custom Realm Ban List

This repository contains a public custom ban list formatted for Realm Bot.

---

🚀 How to Use This Template

1. Click "Use this template" > "Create a new repository" at the top right of this page.
2. Make your repository Public (Private repositories are not supported).
3. Edit ban-list.json to add your banned players.
4. Copy your file's Raw URL and paste it into the Ban List Explorer on Realm Bot.

📖 Official Documentation:
For complete formatting rules, field definitions, and limit details, visit the Realm Bot Custom Ban List Format Guide.

---

📝 Quick Field Reference

Required Fields

• xuid (string): 16-digit numeric Xbox User ID (must be wrapped in quotes).
• username (string): Displayed gamertag (up to 64 chars).
• reason (string): Public moderation explanation (up to 2,000 chars).

Supported Ban Types (type)

nuking | crashing | cheating | exploiting | harassment | threats | ban_evasion | other

Statuses (status)

active | expired | revoked

---

⚠️ Key Limits & Guidelines

• Format: Root must be a JSON array [...].
• Limits: Max 5,000 records / 2 MiB file size limit / 8-second fetch timeout.
• Privacy: Only include public HTTPS evidence links. Do NOT publish passwords, staff notes, Discord links, or reporter identities.