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 (GUI selector via /top)
• Achievements — automatic playtime and death milestone announcements

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
• 24 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, kit manager
• 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

Kit System

• Badge-based kit claiming — kits locked behind the 8 rank tiers
• /kit command — claim, create, edit, delete, set badge/cooldown, list, reload
• Kit GUIs — claim menu with rank progress bar, item preview, editable creation/editing
• Cooldowns — per-kit cooldowns (0 = one-time claim)
• Kit Manager in the Admin Panel — full /kit functionality without commands

Home System

• /sethome, /home, /delhome — named homes with a GUI (limit configurable via homes.max-homes)
• TPA-style warmup — configurable teleport delay with title display

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 (/pt)
/stats [player]	Full stats card (/mystats)
/top [page]	Playtime leaderboard (GUI selector) (/leaderboard, /lb)
/deaths [page]	Death leaderboard
/online	Online players + badges (/players)
/menu	Open unified GUI menu
/link	Link your Discord account
/unlink	Unlink your Discord account
/scoreboard	Toggle sidebar scoreboard (/sb)
/kit [name]	Claim a kit
/sethome [name]	Set a home at your current location
/home [name]	Teleport to a saved home
/delhome [name]	Delete a saved home
/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

Kit Admin Commands

Command	Description
/kit create <name>	Create a kit by placing items in a GUI
/kit edit [name]	Edit kit items
/kit delete [name]	Delete a kit
/kit set <name> badge	Set required badge rank
/kit set <name> cooldown [minutes]	Set claim cooldown
/kit list	Open kit claim menu
/kit reload	Reload kits from database

All kit admin commands require yephub.kits.admin.

---

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
/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
/tps	Server TPS and MSPT
/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

homes:
  max-homes: 5
  warmup-seconds: 3

kits:
  enabled: true

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
• kits-messages.yml — kit system messages
• homes-messages.yml — home system messages

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
yephub.kits	true	Claim rank kits
yephub.kits.admin	op	Create, edit, delete kits

---

Support

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

---

License

MIT License