🌟 ValeSMP Website

The official website for ValeSMP - A semi-vanilla Minecraft survival experience

📋 Table of Contents

• ✨ Features
• 🛠️ Tech Stack
• 📁 Project Structure
• 🎮 Server Information
• 🔧 Configuration
• 📊 API Endpoints
• 🤝 Contributing
• 📝 License
• 💖 Support
• 🙏 Acknowledgments

✨ Features

🌐 Core Features

• 🗺️ Live World Maps - Real-time Pl3xmap integration
• 📊 Player Statistics - Stats tracking & leaderboards
• 📖 Server Guide - Comprehensive and up-to-date documentation for players
• 🎯 Awards System - 200+ achievement categories
• 👥 Hall of Fame - Top player rankings for stats
• 🌙 Dark Mode - Dark theme by default

🔧 Technical Features

• ⚡ Next.js 15 - Latest React framework
• 🎨 Tailwind CSS - Utility-first styling
• 📱 Fully Responsive - Multi-OS compatible design
• 🚀 Fast Performance - Optimized builds
• 🐳 Docker Ready - Containerized deployment

🛠️ Tech Stack

Category	Technologies
Frontend
Styling
Icons
Deployment
Minecraft

📁 Project Structure

valesmp-website/
├── 📂 public/
│   ├── 🎨 cursors/         # Custom minecraft cursors
│   ├── 🔤 fonts/           # Ranyth custom fonts
│   ├── 🖼️ images/          # Static images
│   └── 📄 favicon.ico
├── 📂 src/
│   ├── 📂 app/
│   │   ├── 📄 layout.tsx    # Root layout
│   │   ├── 📄 page.tsx      # Homepage
│   │   ├── 📂 guide/        # Server guide
│   │   ├── 📂 maps/         # Live maps
│   │   ├── 📂 stats/        # Player statistics
│   │   ├── 📂 privacy/      # Privacy policy
│   │   ├── 📂 terms/        # Terms of use
│   │   └── 📂 api/
│   │       └── 📂 stats/    # Stats API
│   ├── 📂 components/
│   │   ├── 📂 ui/           # shadcn/ui components
│   │   └── 📄 *.tsx         # Custom components
│   └── 📂 lib/
│       └── 📄 minecraft-stats.js
├── 📄 tailwind.config.ts
├── 📄 next.config.ts
└── 📄 package.json

🎮 Server Information

Server	Address	Version	Description
Main Server	play.valesmp.com	1.21.11	Velocity proxy endpoint
Survival	Internal	1.21.11	Main survival world
Creative	Internal	1.21.11	Creative plots
Resource	Internal	1.21.11	Monthly resetting world

🗺️ Live Maps

• Survival: survival.valesmp.com
• Creative: creative.valesmp.com
• Resource: resource.valesmp.com

🔧 Configuration

Custom Fonts

The site uses custom Minecraft-style fonts by @em.il located in /public/fonts/:

• Ranyth_uppercase.ttf - For headings
• Ranyth_upperlower.ttf - For mixed case text

📊 API Endpoints

Stats API Proxy

All stats API calls are proxied through Next.js for security

External APIs Used

• Minecraft Server Status: https://api.mcsrvstat.us/2/play.valesmp.com
• Player Avatars: https://crafatar.com/avatars/:username

🤝 Contributing

We love ideas for contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request
6. If our staff team like it, we may just implement your feature :D

Development Guidelines

• 🎯 Follow the existing code style
• 📝 Update documentation for new features
• ✅ Ensure all tests pass
• 🎨 Match the dark theme aesthetic
• 📱 Test responsive design

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

💖 Support

Love ValeSMP? Here's how you can support us:

Server Costs

Current monthly costs: ~£110

• 🖥️ Server Hosting: Takes up the main chunk of that cost
• 🌐 Domain & related IP: Additional annual costs, difficult to accumulate into that cost, so we don't
• 💾 Backup Storage: Redundant backups

🙏 Acknowledgments

• Mojang Studios - For creating Minecraft
• PurpurMC - Fork of PaperMC
• Velocity - PaperMC's Proxy software
• Next.js - React framework
• shadcn/ui - UI components
• Our Amazing Community - For making ValeSMP special! 💚

---

Made with ❤️ by the ValeSMP Team

Website • Discord • GitHub • Patreon