maael/pocketcraft

FFXIV Pocketcraft镜像说明

镜像概述

FFXIV Pocketcraft是针对最终幻想14（FFXIV）的游戏数据管理工具，基于Node.js和MongoDB构建，支持从xivdb.com获取食谱与物品数据，并按多语言区域（英/德/法/日）存储，适用于开发FFXIV相关辅助应用或数据分析服务。

核心功能

1. 从xivdb.com导入食谱数据到MongoDB
2. 提取物品信息并关联食谱
3. 多语言区域数据库管理（自动生成_en/_de/_fr/_ja后缀的数据库）
4. 支持开发环境热重载与生产环境构建部署
5. 提供数据导入、提取、备份/恢复等命令工具

使用场景

• FFXIV游戏内容辅助应用的后端数据支撑
• 游戏内食谱与物品的数据分析与展示
• 个人或团队开发FFXIV相关工具的基础服务

配置说明

依赖要求

• MongoDB服务（需提前部署）
• Node.js环境（镜像内部已包含，外部无需额外安装）

环境配置

1. 复制镜像内的.env.schema文件为.env
2. 填写.env中的配置项：
   • MONGO_URI：MongoDB连接地址
   • MONGO_DB：基础数据库名称（自动生成多语言后缀）
   • 其他可选配置（如端口、日志路径等）

数据初始化

运行以下命令填充数据库：

bash
# 导入食谱数据
yarn import-recipes
# 提取物品信息
yarn extract-items

Docker部署示例

单容器运行（需提前启动MongoDB）

bash
docker run -d \
  --name pocketcraft \
  -p 3000:3000 \
  -v $(pwd)/.env:/app/.env \
  --link mongodb:mongodb \
  docker.xuanyuan.run/maael/pocketcraft \
  yarn start

Docker Compose部署

yaml
version: '3'
services:
  pocketcraft:
    image: docker.xuanyuan.run/maael/pocketcraft
    ports:
      - "3000:3000"
    volumes:
      - ./env:/app/.env
    depends_on:
      - mongodb
    command: yarn start
  mongodb:
    image: docker.xuanyuan.run/mongo:latest
    ports:
      - "27017:27017"
    volumes:
      - mongo_data:/data/db
volumes:
  mongo_data:

常用命令

• 开发模式：yarn dev（热重载）
• 生产模式：yarn build && yarn start
• 数据备份：yarn db-dump
• 数据恢复：yarn db-restore
• 代码检查：yarn lint