Minecraft 皮肤管理平台

一个基于 Next.js 构建的现代化 Minecraft 皮肤管理平台，支持皮肤上传、管理、角色创建和 Yggdrasil 认证。

功能特性

• 📤 皮肤上传与管理 - 支持上传、预览和管理多个 Minecraft 皮肤
• 👤 角色中心 - 创建和管理游戏角色，支持多角色切换
• 🔐 外置登录 - 通过拖拽功能实现与 PCL2 等启动器的 Yggdrasil 认证
• 📚 使用教程 - 提供基础教程、Yggdrasil 教程等帮助文档
• 🎨 响应式设计 - 适配桌面和移动设备的现代化界面
• 🌙 暗色模式 - 支持亮色/暗色主题切换

技术栈

• 前端框架: Next.js 14 + React 18
• 类型系统: TypeScript
• 样式方案: Tailwind CSS 4 + Radix UI
• 认证系统: NextAuth.js
• API 调用: Axios
• 图标库: Lucide React

安装与运行

前置要求

• Node.js 20+
• npm 或 yarn

安装步骤

1. 克隆项目

git clone [仓库地址]
cd my-app

2. 安装依赖

npm install
# 或
yarn install

3. 启动开发服务器

npm run dev
# 或
yarn dev

4. 构建生产版本

npm run build
npm start
# 或
yarn build
yarn start

项目结构

├── public/             # 静态资源文件
│   ├── skins/          # 皮肤文件存储
│   └── images/         # 其他图片资源
├── src/                # 源代码目录
│   ├── app/            # Next.js App Router
│   │   ├── (auth)/     # 认证相关页面
│   │   ├── api/        # API 路由
│   │   ├── character-center/ # 角色中心页面
│   │   ├── dashboard/  # 皮肤管理仪表盘
│   │   ├── help/       # 帮助文档页面
│   │   ├── skins/      # 皮肤上传和管理
│   │   └── user-home/  # 用户主页
│   ├── components/     # 可复用组件
│   │   ├── Navbar.tsx  # 导航栏组件
│   │   ├── auth/       # 认证相关组件
│   │   ├── skins/      # 皮肤相关组件
│   │   └── ui/         # UI 组件库
│   ├── lib/            # 工具函数和 API 调用
│   ├── styles/         # 全局样式和主题
│   └── types/          # TypeScript 类型定义
└── next.config.js      # Next.js 配置文件

使用指南

皮肤上传

1. 登录平台后，在用户主页点击"上传皮肤"卡片
2. 选择符合要求的 PNG 格式皮肤文件
3. 上传成功后可在"我的皮肤"中查看和管理

Yggdrasil 认证

1. 在用户主页找到"外置登录"卡片
2. 拖拽此卡片到 PCL2 等支持 Yggdrasil 认证的启动器
3. 启动器将自动完成认证流程

角色管理

1. 点击"角色中心"卡片进入角色管理界面
2. 可以创建新角色、编辑现有角色信息
3. 为不同角色分配不同的皮肤

注意事项

• 皮肤文件必须为 PNG 格式，且符合 Minecraft 皮肤尺寸规范
• 3D 预览功能尚未实现，目前使用 2D 预览
• 部分功能可能需要后端 API 支持，请确保相关接口已正确配置

许可证

MIT

贡献指南

欢迎提交 Issue 和 Pull Request！

联系方式

如有问题或建议，请通过以下方式联系我们：

• Email: [项目邮箱]
• GitHub: [项目仓库地址]