MC Nexus — Minecraft 资源聚合网站

中文

项目简介

MC Nexus 是一个现代化的 Minecraft 资源聚合网站，用于浏览和搜索社区中的模组、整合包、光影与资源包。网站采用橙白流动渐变、浅色玻璃面板以及红橙黄色渐变光晕卡片，并针对桌面端和移动端进行了响应式适配。

项目通过 Modrinth API 获取实时资源；当网络或 API 不可用时，会自动展示本地精选内容，保证基础浏览体验仍然可用。

主要功能

• 独立展示模组、整合包、光影和资源包
• 调用 Modrinth API 加载热门项目与下载量
• 支持关键词搜索和加载更多资源
• 支持按分类快速导航
• 点击卡片查看资源详情并跳转到 Modrinth 官方页面
• 启动欢迎页和进入动画
• 渐变描边、柔光与悬停动画资源卡片
• 桌面端三列、移动端单列响应式布局
• 图片加载失败与 API 请求失败时的本地回退

技术栈

• HTML5
• CSS3
• 原生 JavaScript
• Node.js 静态预览服务器
• Modrinth API

项目不依赖前端框架，也不需要安装 npm 依赖。

本地运行

需要先安装 Node.js。进入项目目录后运行：

node preview-server.mjs

然后访问：

http://127.0.0.1:4173/

点击启动页中的 I'M READY 即可进入资源浏览页面。实时资源需要可访问 Modrinth API 的网络环境。

项目结构

Minecraft Web/
├─ assets/img/          本地图片与接口失败时的备用图片
├─ downloads/           示例资源说明文件
├─ qa/                  项目效果截图
├─ index.html           页面结构
├─ styles.css           视觉样式与响应式布局
├─ script.js            资源请求、搜索和页面交互
├─ preview-server.mjs   本地静态预览服务器
└─ README.md            中英文项目说明

数据来源

资源名称、作者、下载量、版本及部分图片来自 Modrinth 和 Modrinth API。本站是独立展示项目，与 Mojang Studios、Microsoft 或 Modrinth 无官方关联。

---

English

About

MC Nexus is a modern Minecraft resource hub for discovering and searching community mods, modpacks, shaders, and resource packs. Its visual system combines a flowing orange-and-white background, light glass surfaces, and red-to-yellow glowing resource cards, with responsive layouts for desktop and mobile screens.

The site loads live projects from the Modrinth API. If the network or API is unavailable, it automatically falls back to a curated local dataset so the core browsing experience remains usable.

Features

• Separate sections for mods, modpacks, shaders, and resource packs
• Live popular-project and download data from the Modrinth API
• Keyword search and load-more controls
• Quick category navigation
• Resource detail dialog with links to official Modrinth project pages
• Animated welcome screen
• Gradient borders, soft glow, and hover motion on resource cards
• Three-column desktop and single-column mobile layouts
• Local image and resource fallbacks for failed requests

Tech Stack

• HTML5
• CSS3
• Vanilla JavaScript
• Node.js static preview server
• Modrinth API

No frontend framework or npm dependency installation is required.

Run Locally

Install Node.js, open the project directory, and run:

node preview-server.mjs

Then visit:

http://127.0.0.1:4173/

Select I'M READY on the welcome screen to enter the resource browser. Live resources require network access to the Modrinth API.

Project Structure

Minecraft Web/
├─ assets/img/          Local and fallback images
├─ downloads/           Example resource information files
├─ qa/                  Project screenshots
├─ index.html           Page structure
├─ styles.css           Visual styles and responsive layout
├─ script.js            Resource loading, search, and interactions
├─ preview-server.mjs   Local static preview server
└─ README.md            Chinese and English documentation

Data Source

Resource names, authors, download counts, versions, and some images are provided by Modrinth and the Modrinth API. This is an independent showcase project and is not officially affiliated with Mojang Studios, Microsoft, or Modrinth.