NexusMC Web - Minecraft Server Website v1.0.0

What is NexusMC Web?​

NexusMC Web is a complete, self-hosted website solution for Minecraft servers. Unlike static HTML templates, this is a full-stack application with a real backend, database, admin panel, payment processing, and a Spigot/Paper bridge plugin — all controllable from a powerful admin dashboard. No coding required after setup.

Perfect for: Survival, SMP, Factions, Prison, Skyblock, Minigames, or any Minecraft network.

Features​

Public Website​

• Stunning Homepage — Animated hero section with live player count, gamemode showcase, announcements feed, feature cards, and CTA. Fully responsive.
• Server Store — Full shopping cart, coupon codes, Stripe Checkout payments, auto-delivery to MC server. Supports sale prices, featured items, and categories. Or link to an external store (Tebex, etc).
• Gamemodes Page — Showcase your gamemodes with status badges, player counts, custom colors and icons.
• Staff Page — Display your team with MC head avatars, roles, and custom role colors.
• Vote Page — Vote site links with reward descriptions. Built-in Votifier v1 server — no separate Votifier plugin needed.
• FAQ Page — Searchable, categorized FAQ with accordion layout.
• Punishments Page — Public LiteBans-style ban/mute/warn/kick list with search, filters, and pagination.
• Announcements — News feed on the homepage with type badges (Update, Event, Maintenance, Alert) and pin support.
• Maintenance Mode — One-click lock page for non-staff visitors.

User System​

• Full Account System — Register, login, profile page with order history, connections, and security settings.
• OAuth Login — Optional Google and Discord sign-in. Link/unlink from profile.
• MC Account Linking — Quick-link or verified link via in-game /nexusweb link command.
• Order History — Users see their past purchases in their profile.

Admin Panel​

• Dashboard — Content counts, live MC server status (TPS, players, version), inline console with command execution.
• Server Manager — Live player table with health bars, food, armor, ping, gamemode, world, coordinates. Player actions (kick, ban, message, teleport, gamemode, OP). Broadcast, whitelist controls. TPS history graph. Full console with chat log.
• Store Manager — CRUD for items, categories, delivery commands ({player} placeholder), refund clawback commands. Sale prices, featured flags, perk lists.
• Order Manager — View all orders, payment status, delivery status, admin notes. Manual delivery trigger. Stripe refund with configurable clawback commands.
• Punishment Manager — Create/revoke bans, mutes, warns, kicks from the web panel. Auto-executes commands on MC server. Configurable command templates. Duration support (30m, 7d, 1y, permanent).
• Role Manager (RBAC) — Full role-based access control. 21 granular permissions. Create custom roles, assign permissions, set colors. Owner-protected roles.
• User Manager — View all registered users, change roles, see linked accounts.
• Email Templates — 4 default email templates (welcome, order confirmation, order delivered, password reset). Full HTML editor with {{variable}} placeholders and live preview. Dark-themed email wrapper.
• Everything Else — Gamemodes, Staff, Vote Sites, FAQ, FAQ Categories, Features, Coupons, Announcements — all fully manageable with no code.

Minecraft Bridge Plugin​

• Live Stats — Player count, TPS, player list with health/food/armor/gamemode/world/coordinates pushed to the website in real-time.
• Command Execution — Run any MC command from the web console.
• Auto-Delivery — Store purchases automatically execute delivery commands on the MC server.
• Built-in Votifier — No separate Votifier plugin needed. Receives votes and triggers reward commands.
• Punishment Capture — Listens for ban/mute/kick/warn commands issued in-game and syncs them to the web panel.
• Account Linking — Players verify their MC account via /nexusweb link <code> in-game.
• Auto-Reconnect — Plugin automatically reconnects if the websocket drops.
• Spigot & Paper — Compatible with Spigot, Paper, and Folia. Java 17+.

Customization​

• 7 Color Themes — Red, Blue, Green, Purple, Gold, Pink, Teal. One-click switch from admin panel.
• All Content Editable — Server name, IP, version, hero text, Discord URL, banner messages — all from Settings.
• Responsive Design — Looks great on desktop, tablet, and mobile.
• Dark Theme — Sleek dark UI designed specifically for gaming communities.

Tech Stack​

• Frontend: React 18 + Vite + Tailwind CSS + Framer Motion
• Backend: Node.js + Express + MongoDB + JWT
• Payments: Stripe Checkout with webhooks
• Email: Nodemailer with DB-driven templates
• MC Bridge: WebSocket + custom Spigot/Paper plugin
• Auth: Email/password + Google OAuth + Discord OAuth

Requirements​

• Node.js 18+
• MongoDB (local or Atlas free tier)
• A VPS or hosting provider (DigitalOcean, Vultr, Hetzner, etc.)
• Java 17+ and Maven (for building the MC plugin)
• Stripe account (for payments — optional, store works without it)

Quick Setup​

1. Extract the ZIP
2. Run setup.bat (Windows) or ./setup.sh (Linux/Mac)
3. Edit server/.env with your MongoDB URI
4. Run npm run dev
5. Open http://localhost:5173
6. Login at /account with default admin credentials
7. Change your password in Settings

Full setup guide (GUIDE.txt) included with detailed instructions for Stripe, MC plugin, hosting, and production deployment.

Screenshots​

Updates & Support​

• Free updates for the lifetime of the product
• Support via BuiltByBit messages — response within 24 hours
• Bug fixes and feature improvements included