2025-10-06 18:54:26 +08:00
|
|
|
|
# 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. 克隆项目
|
|
|
|
|
|
```bash
|
|
|
|
|
|
git clone [仓库地址]
|
|
|
|
|
|
cd my-app
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
2. 安装依赖
|
|
|
|
|
|
```bash
|
|
|
|
|
|
npm install
|
|
|
|
|
|
# 或
|
|
|
|
|
|
yarn install
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
3. 启动开发服务器
|
|
|
|
|
|
```bash
|
|
|
|
|
|
npm run dev
|
|
|
|
|
|
# 或
|
|
|
|
|
|
yarn dev
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
4. 构建生产版本
|
|
|
|
|
|
```bash
|
|
|
|
|
|
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](LICENSE)
|
|
|
|
|
|
|
|
|
|
|
|
## 贡献指南
|
|
|
|
|
|
|
|
|
|
|
|
欢迎提交 Issue 和 Pull Request！
|
|
|
|
|
|
|
|
|
|
|
|
## 联系方式
|
|
|
|
|
|
|
|
|
|
|
|
如有问题或建议，请通过以下方式联系我们：
|
|
|
|
|
|
|
|
|
|
|
|
- Email: [项目邮箱]
|
|
|
|
|
|
- GitHub: [项目仓库地址]
|
