🌟 LuminolCraft Official Website

The official website for LuminolCraft Minecraft Server

🎮 About LuminolCraft

LuminolCraft is a professional Minecraft server community offering two distinct gameplay experiences:

• 🌱 Pure Survival Server - Original Minecraft experience with basic survival commands
• ⚡ Comprehensive Survival Server - RPG + Skills + Slimefun integration

🏆 Server Features

Feature	Pure Survival	Comprehensive Survival
Gameplay	Original Minecraft	RPG + Skills + Slimefun
Commands	/tpa, /home, /rtp	Full command suite
Protection	None	Complete territory system
Death System	Drop items in overworld	No item loss in all dimensions
Redstone	No restrictions	Full automation support

🚀 Website Features

✨ Core Functionality

• 🎨 Dynamic Backgrounds - 22 rotating game screenshots (3.6s intervals)
• 📰 News System - JSON-based content management with Markdown support
• 🔍 Advanced Search - Tag filtering, keyword search, pagination
• 📱 Responsive Design - Perfect mobile, tablet, and desktop support
• 🌙 Theme Support - Light/Dark mode with system preference detection

🛠️ Technical Stack

• Frontend: HTML5, CSS3, JavaScript ES6+
• Styling: Flexbox/Grid, CSS Variables, Media Queries
• Libraries: Font Awesome 7.0.0, Marked.js, MiSans Font
• Deployment: Netlify, Netlify Functions, Cloudflare Pages
• CORS Solution: Cloudflare Pages proxy for optimal performance
• Architecture: Modular JavaScript architecture with separate concerns

📁 Project Structure

craft.luminolsuki.moe/
├── 🎯 Pages
│   ├── index.html # Homepage
│   ├── support.html # Support page
│   ├── monitoring.html # Server monitoring
│   └── news/
│       ├── news.html # News listing
│       ├── news-detail.html # News detail
│       └── news.json # News data
├── ⚡ JavaScript Modules
│   ├── js/
│   │   ├── main.js # Main entry point
│   │   ├── utils.js # Utility functions
│   │   ├── navigation.js # Navigation system
│   │   ├── background.js # Background carousel
│   │   ├── news.js # News management
│   │   ├── font-manager.js # Font management
│   │   ├── theme.js # Theme management
│   │   ├── monitoring.js # Server monitoring
│   │   ├── debug-manager.js # Debug management
│   │   └── version.js # Version tracking
│   └── netlify/functions/ # Server functions
│       ├── news.js # News API
│       └── version.js # Version API
├── 🎨 Stylesheets
│   ├── css/
│   │   ├── fonts.css # Font resources
│   │   ├── desktop/ # Desktop styles
│   │   │   ├── styles.css # Main stylesheet
│   │   │   ├── navigation.css # Navigation styles
│   │   │   ├── footer.css # Footer styles
│   │   │   ├── news-styles.css # News page styles
│   │   │   ├── support-styles.css # Support page styles
│   │   │   └── monitoring-styles.css # Monitoring styles
│   │   └── mobile/ # Mobile responsive styles
│   │       ├── mobile.css # Mobile main styles
│   │       ├── navigation-mobile.css # Mobile navigation
│   │       ├── news-mobile.css # Mobile news styles
│   │       ├── support-mobile.css # Mobile support styles
│   │       └── monitoring-mobile.css # Mobile monitoring styles
└── 🖼️ Resources
    ├── images/ # Game screenshots and icons
    ├── sitemap.xml # SEO sitemap
    ├── _redirects # Netlify redirects
    └── BingSiteAuth.xml # Search engine verification

🚀 Quick Start

🚀 Quick Start

Local Development

Local Development

1. Clone Repository

git clone https://github.com/LuminolCraft/craft.luminolsuki.moe.git
cd craft.luminolsuki.moe

2. Start Development Server

# Using Live Server (VS Code extension)
# Or any local HTTP server

Netlify Deployment

Netlify Deployment

1. Connect to GitHub Repository
2. Configure Auto-deployment
3. Set Environment Variables (if needed)
4. Access Deployed Website

🔧 Development Guide

Adding New Features

1. JavaScript Modules: Create new modules in js/ directory
2. Stylesheets: Add corresponding CSS files as needed
3. Page Structure: Maintain consistent HTML structure and navigation
4. Mobile Support: Add corresponding mobile styles

News System Management

1. Add News: Edit news/news.json file
2. Markdown Content: Add corresponding files in News-content/ directory
3. Image Resources: Upload to image hosting and update links
4. Caching: System automatically handles cache refresh

CORS Solution

The website implements an intelligent CORS bypass solution:

• Problem: CORS policies preventing direct access to external content
• Solution: Automatic URL conversion to Cloudflare Pages
• Example: raw.githubusercontent.com → luminolcraft-news.pages.dev
• Benefits: Faster loading, better reliability, global CDN acceleration

Modular Architecture

The website uses a modular JavaScript architecture:

• Separation of Concerns: Each module handles a specific functionality
• Maintainability: Easy to update and debug individual features
• Scalability: Simple to add new features without affecting existing code
• Performance: Only load necessary modules per page

🔀 Code Contributions

1. Fork the repository
2. Create feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'Add amazing feature'
4. Push branch: git push origin feature/amazing-feature
5. Create Pull Request

🐛 Issue Reporting

Use GitHub Issues to report problems, please include:

• Problem description
• Reproduction steps
• Environment information
• Screenshots (if applicable)

📞 Contact Us

📞 Contact Us

💬 Community

• QQ Group: Available through website homepage
• Discord: Coming soon

🌐 External Platforms

• GitHub Organization: LuminolMC, LuminolCraft
• Server Forums: MineBBS, klpbbs, mcmod

📜 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

🏷️ Trademark Notice

• "Minecraft" and "我的世界" are registered trademarks of Mojang AB
• LuminolCraft is an independent game server with no affiliation to Mojang AB or Microsoft
• Website content © 2025 Luminol Team. All rights reserved.

📚 Resource Credits

• Website uses MiSans open source font
• Icons from Font Awesome open source project
• Image resources hosted on Cloudflare Pages

⭐ Star History

If your star could make this project more popular, that would be amazing! If your star could make this project more popular, that would be amazing!

---

🌟 If you think this project is great, please give us a Star! 🌟 If you think this project is great, please give us a Star!

Made with ❤️ by LuminolCraft Team

---

🔗 Links

• 🌐 Website: craft.luminolsuki.moe
• 📱 Server Status: Monitoring Page
• 📰 News: News Center
• 💬 Support: Support Page

---

🌐 Language / 语言

• English: README.md
• 中文: README_CN.md (Current / 当前)

---

Last updated: October 26, 2025