YepHub

A comprehensive Minecraft server management plugin with player stats, Discord integration, backups to multiple cloud providers, and more.

Built for Purpur 26.2+ / Java 25+. Compatible with Paper, Spigot, and Bukkit derivatives.

---

Player Stats & Progression

• Playtime tracking — automatic session tracking with daily/weekly stats
• Kill/Death tracking — PvP kills, mob kills, K/D ratios
• Block stats — blocks placed and broken
• Login streaks — consecutive day tracking with best streak records
• Leaderboards — top players by playtime, kills, deaths

Badge/Rank System

• 8 ranks based on playtime: Newbie → Rookie → Regular → Active → Veteran → Elite → Legend → Mythic
• Gradient-colored prefixes — each badge has a unique color gradient
• Customizable — edit settings/badges.yml to change names, time thresholds, and colors
• Admin rank override — manually set a player's rank via GUI
• Discord role sync — auto-assigns Discord roles based on in-game rank

Discord Integration

• Live server monitor — auto-updating embed showing online players, TPS, uptime
• Chat bridge — bidirectional in-game ↔ Discord chat sync
• Account linking — link Minecraft ↔ Discord for unified profiles
• 26+ slash commands — /playtime, /stats, /top, /server, /whois, /link, /online, /tps, /kick, /ban, and more
• Event embeds — join/leave/death/advancement announcements in Discord
• Server restart notifications — countdown embeds in Discord

Multi-Provider Backup System

• 5 storage providers — Google Drive, Dropbox, OneDrive, SFTP, FTP
• OAuth2 bundled — Google Drive, Dropbox, and OneDrive work out of the box
• Config-based — SFTP and FTP use host/username/password from config
• Provider selection — switch providers via in-game GUI or command
• Scheduled backups — configurable interval (default: every 6 hours)
• Smart cleanup — auto-delete oldest backup when storage is full
• Backup download — download backups from Discord with provider selection

Server Management

• GUI Menu (/menu) — unified chest GUI for stats, leaderboards, settings, admin tools
• Player settings — toggle chat sync, TPA, auto-accept TPA
• Admin panel — inventory inspect, rank change, player moderation, backup providers
• Restart manager — scheduled restarts with bossbar countdown
• Lag clear — automatic entity clearing with countdown messages
• Item stack manager — auto-merges nearby dropped items with floating count holograms
• Anti-Xray — DDA ray-tracing that hides ores behind opaque blocks
• Percentage-based sleep — configurable player count for night skip with progress messages
• Scoreboard — sidebar stats display with customizable messages

Authentication (Optional)

• Cracked/offline-mode login — /register, /login, /changepassword
• Session persistence — auto-login from same IP within configurable hours
• Login timer — bossbar countdown with kick on timeout

Teleport System

• TPA requests — /tpa, /tpahere, /tpaccept, /tpdeny
• Warmup countdown — configurable teleport delay with title display
• Auto-accept — per-player setting to auto-accept TPA requests

---

Player Commands (standalone)

Command	Description
/playtime [player]	View your or a player's playtime
/stats [player]	Full stats card
/top [page]	Playtime leaderboard
/deaths [page]	Death leaderboard
/online	Online players + badges
/menu	Open unified GUI menu
/link	Link your Discord account
/unlink	Unlink your Discord account
/scoreboard	Toggle sidebar scoreboard
/tpa <player>	Send teleport request
/tpahere <player>	Request player to teleport to you
/tpaccept	Accept teleport request
/tpdeny	Deny teleport request

Auth Commands (if enabled)

Command	Description
/register <password> <confirm>	Register new account
/login <password>	Login to account
/changepassword <old> <new>	Change password

Admin Commands (/y prefix)

Command	Description
/yhelp	Show all commands
/yrestart <time>	Schedule restart (e.g. 5m, 1h)
/yrestart cancel	Cancel scheduled restart
/yrestart status	View restart countdown
/yreload	Reload config + Discord bot
/ybackup	Show all backup providers
/ybackup auth <provider>	Link a provider (Google Drive, Dropbox, OneDrive)
/ybackup auth <provider> <code>	Enter auth code to link
/ybackup start [provider]	Run backup now
/ybackup status	View backup system status
/ybackup unlink	Remove storage link
/lagclear	Force-clear lag-causing entities
/lagclear status	View entity count

---

Discord Slash Commands

Command	Description
/playtime [player]	View playtime (with chart)
/stats <player>	Full stats card
/top	Top 10 playtime leaderboard
/kills	PvP kills leaderboard
/deaths	Death leaderboard
/server	Live server status
/whois <player>	Look up any player's stats
/online	List online players
/tps	Server TPS and MSPT
/leaderboard	Top 10 playtime leaderboard
/link <code>	Link Minecraft account
/unlink	Unlink account
/mylink	Check linked account
/help	Show all commands

Admin Discord Commands

Command	Description
/restart <time>	Schedule restart
/restart-cancel	Cancel restart
/restart-status	Restart countdown
/backup	Trigger backup (with provider selection)
/backup-status	Backup status
/backup-download	Download backup (with provider selection)
/broadcast <message>	Server-wide broadcast
/say <message>	Send as server
/online	List online players
/kick <player> [reason]	Kick player
/ban <player> [reason]	Ban player

---

All settings are in plugins/YepSMP/config.yml. Key options:

server:
  name: "YepHub"              # Server name shown everywhere
  java-ip: "YOUR_JAVA_IP"
  bedrock-ip: "YOUR_BEDROCK_IP"
  show-bedrock: true          # Show Bedrock IP in Discord embed
  port: 25565

discord:
  enabled: true
  bot-token: "YOUR_BOT_TOKEN"
  guild-id: "YOUR_GUILD_ID"

stats:
  scoreboard-enabled: true
  save-interval: 300

auth:
  enabled: false              # Cracked/offline-mode login

teleport:
  enabled: true
  warmup-seconds: 3

lagclear:
  enabled: true
  interval-minutes: 5

backup:
  enabled: false
  provider: google-drive      # google-drive | dropbox | onedrive | sftp | ftp
  interval-hours: 6

  google-drive:
    client-id: "..."
    client-secret: "..."

  dropbox:
    app-key: "..."
    app-secret: "..."

  onedrive:
    client-id: "..."
    client-secret: "..."

  sftp:
    host: ""
    port: 22
    username: ""
    password: ""
    path: "/backups"

  ftp:
    host: ""
    port: 21
    username: ""
    password: ""
    path: "/backups"

server:
  one-player-sleep: false
  one-player-sleep-percent: 1  # 1 = instant skip, 50 = 50% of players needed

Customizable Badges

Edit plugins/YepSMP/settings/badges.yml to customize rank names, time thresholds, and colors:

badges:
  NEWBIE:
    display: "Newbie"
    time-hours: 0
    hex-color: "#95A5A6"
    hex-color-2: "#7F8C8D"
  ROOKIE:
    display: "Rookie"
    time-hours: 1
    hex-color: "#2ECC71"
    hex-color-2: "#27AE60"
  # ... up to MYTHIC

Run /yreload after changes.

Customizable Messages

Edit files in plugins/YepSMP/messages/:

• tpa-messages.yml — TPA system messages
• auth-messages.yml — login/register messages
• lagclear-messages.yml — lag clear announcements
• scoreboard-messages.yml — sidebar scoreboard layout

Use {server-name} as a placeholder — it's replaced with server.name from config.

---

Requirements

• Server software: Purpur 26.2+ (or Paper/Spigot/Bukkit compatible)
• Java: 25+
• Optional: Floodgate (for Bedrock player support)

---

Permissions

Permission	Default	Description
yephub.stats	true	View own stats
yephub.stats.others	op	View other players' stats
yephub.admin	op	Admin commands
yephub.tpa	true	Use teleport requests
yephub.tpa.bypass	op	Bypass teleport confirmation

---

Support

• GitHub Issues: Report bugs or request features
• Discord: Join our server for support

---

License

MIT License