YepHub

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)

Auth Commands (if enabled)

Admin Commands (/y prefix)

Kit Admin Commands

All kit admin commands require yephub.kits.admin.

Discord Slash Commands

Admin Discord Commands

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

Support

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

License

MIT License