🎮 Minecraft Enchantment Tracker

A comprehensive web application for managing and tracking enchantments for your Minecraft server's villager trading hall. Built with Next.js, MongoDB, and deployed on Vercel.

🚀 Live Demo

• Production: https://mineraftserver.vercel.app
• Alt URLs:
  • https://mineraftserver-jgero961-8734s-projects.vercel.app
  • https://mineraftserver-git-main-jgero961-8734s-projects.vercel.app

✨ Features

📊 Dashboard

• Real-time progress tracking
• Overall completion percentage
• Category-wise breakdown (Armor, Weapons, Tools)
• Visual progress bars with Minecraft theming

✨ Enchantments Page

• Complete list of all Minecraft enchantments
• Search and filter functionality
• Status tracking (To-Do, In Progress, Done)
• Detailed enchantment information (workstation, max level, compatible items)

📦 Items Page

• Comprehensive item list organized by category
• Required and optional enchantments for each item
• Optimal anvil order calculations
• Progress tracking for each item
• Category filtering

✅ To-Do List

• Interactive checklist for workstation completion
• Click to toggle status (To-Do → In Progress → Done)
• Real-time database updates
• User tracking (who completed what)
• Visual sparkle effects on completion

🛠️ Tech Stack

• Frontend: Next.js 15 with TypeScript
• Styling: Tailwind CSS with custom Minecraft theme
• Database: MongoDB Atlas
• Deployment: Vercel
• Version Control: GitHub
• Animation: Framer Motion
• Icons: Lucide React

📋 Database Schema

Enchantments

• Name, description, max level
• Workstation type
• Compatible items
• Status (todo/inprogress/done)
• Update tracking

Items

• Name, category
• Required enchantments (with levels)
• Optimal anvil order
• Progress percentage
• Notes and tips

Users

• Username, email, role

Logs

• Action tracking
• User attribution
• Timestamps

🎨 Minecraft UI Theme

• Pixelated, blocky design elements
• Grass block and enchantment table aesthetics
• Custom color palette (enchant purple, gold, diamond blue)
• Interactive buttons with hover effects
• Progress bars with glowing effects

🚀 Quick Start

Prerequisites

• Node.js 18+
• MongoDB Atlas account
• Vercel account (for deployment)

Local Development

1. Clone the repository

   git clone https://github.com/Betscape/mineraftserver.git
   cd mineraftserver

2. Install dependencies

   npm install

3. Set up environment variables Create .env.local:

   MONGODB_URI=your_mongodb_connection_string
   

4. Run development server

   npm run dev

   Open http://localhost:3000

5. Seed the database

   • Navigate to the home page
   • Click "Seed Database" button
   • This populates the database with 40+ enchantments and 15+ items

Deployment

The application is already connected to Vercel. Any push to the main branch will automatically trigger a deployment.

git add .
git commit -m "Your changes"
git push origin main

📊 Data Included

40+ Enchantments

• All armor enchantments (Protection, Thorns, Feather Falling, etc.)
• Weapon enchantments (Sharpness, Looting, Fire Aspect, etc.)
• Tool enchantments (Efficiency, Fortune, Silk Touch, etc.)
• Special enchantments (Mending, Infinity, Channeling, etc.)

15+ Items

• Armor: Helmet, Chestplate, Leggings, Boots
• Weapons: Sword, Axe, Bow, Crossbow, Trident
• Tools: Pickaxe, Shovel, Fishing Rod
• Other: Elytra, Shield

🔗 Connections

✅ GitHub

• Repository: https://github.com/Betscape/mineraftserver
• Branch: main
• Auto-sync: Enabled

✅ Vercel

• Project: mineraftserver
• Organization: jgero961-8734s-projects
• Auto-deploy: Enabled on push to main

✅ MongoDB

• Cluster: cluster0.n1v0f5m.mongodb.net
• Database: valorant-party-finder
• Environment Variables: Configured in Vercel

📖 Usage Guide

1. First Time Setup: Click "Seed Database" on the home page to populate with Minecraft data

2. View Progress: Navigate to Dashboard to see overall completion statistics

3. Browse Enchantments: Go to Enchantments page to view all available enchantments and their details

4. Check Items: Visit Items page to see what enchantments each item needs

5. Track Progress: Use the To-Do List to check off workstations as you complete them

   • Click any item to cycle through: To-Do → In Progress → Done → To-Do

6. Collaborate: Multiple users can update simultaneously, changes sync in real-time

🎯 Key Features

• ✅ Real-time Updates: MongoDB integration ensures instant synchronization
• 🎨 Minecraft Themed: Authentic blocky UI with enchantment glow effects
• 📱 Responsive Design: Works on desktop, tablet, and mobile
• 🔍 Search & Filter: Quickly find enchantments and items
• 📊 Progress Tracking: Visual progress bars and statistics
• 👥 Collaborative: Track who completed what and when
• ⚡ Fast: Static generation with dynamic API routes
• 🌐 Deployed: Live on Vercel with automatic deployments

📁 Project Structure

mineraftserver/
├── app/                     # Next.js app directory
│   ├── api/                 # API routes
│   │   ├── enchantments/    # Enchantment CRUD
│   │   ├── items/           # Item CRUD
│   │   ├── stats/           # Statistics aggregation
│   │   └── seed/            # Database seeding
│   ├── dashboard/           # Dashboard page
│   ├── enchantments/        # Enchantments list page
│   ├── items/               # Items list page
│   ├── todo/                # To-do list page
│   └── page.tsx             # Home page
├── components/              # Reusable components
│   ├── MinecraftButton.tsx
│   ├── MinecraftPanel.tsx
│   ├── Navigation.tsx
│   └── ProgressBar.tsx
├── lib/                     # Utilities
│   ├── mongodb.ts           # Database connection
│   └── seedData.ts          # Seed data
├── models/                  # MongoDB schemas
│   ├── Enchantment.ts
│   ├── Item.ts
│   ├── User.ts
│   └── Log.ts
└── public/                  # Static assets

🤝 Contributing

This is a personal project, but feel free to fork and customize for your own Minecraft server!

📝 License

ISC

🎮 Credits

Built for Minecraft server players managing villager trading halls and enchantment collections.

---

Status: ✅ LIVE AND DEPLOYED

All systems operational! Happy enchanting! ⛏️✨