ModParks

ModParks は、Minecraft Java Edition 向けの Mod および Plugin プラットフォームです。 日本発のプラットフォームとして、開発者とプレイヤーがより円滑に作品を共有し、コミュニケーションできる場を提供することを目的としています。

特徴 (Features)

• プロジェクトの公開と探索: ModやPluginを検索、発見、ダウンロード。
• バージョン管理: バージョンごとのJar/Zipファイルのアップロード（Cloudflare R2対応）または外部URL（GitHub Releases, Modrinth, CurseForge 等）へのリンク機能。
• 多言語対応 (i18n): 日本語と英語の表示切り替え（next-intl による実装）。
• 認証: GitHub アカウントを用いたセキュアなログイン（Auth.js / NextAuth）。
• アイデアボード: ユーザーが「こんなModが欲しい！」を投稿・議論し、実現されたプロジェクトと紐付けられる機能。
• 通報システム: ガイドライン違反のプロジェクトを管理者に報告する機能。

技術スタック (Tech Stack)

• Framework: Next.js (App Router, v15)
• Language: TypeScript
• Styling / UI: Material-UI (MUI v6)
• Database: Cloudflare D1
• ORM: Drizzle ORM
• Storage: Cloudflare R2
• Authentication: Auth.js (NextAuth v5)
• i18n: next-intl

ローカル開発環境のセットアップ (Getting Started)

1. 前提条件

• Node.js (v20以上)
• npm, yarn, または pnpm

2. リポジトリのクローン

git clone https://github.com/Pitan76/modparks.git
cd modparks

3. パッケージのインストール

npm install

4. 環境変数の設定

プロジェクトルートにある .env.local.example を参考に、.env.local を作成してください。

# 例: .env.local
AUTH_SECRET="your-auth-secret" # 任意のランダムな文字列
AUTH_GITHUB_ID="your-github-client-id"
AUTH_GITHUB_SECRET="your-github-client-secret"

5. データベースのセットアップ（ローカルD1）

ローカル開発用の D1 データベースにマイグレーションを適用します。

npm run db:generate
npm run db:migrate:local

6. 開発サーバーの起動

npm run dev

ブラウザで http://localhost:3000 にアクセスして確認してください。

注意: ローカル開発環境では wrangler.getPlatformProxy のキャッシュ機構 (lib/proxy.ts) によって、Next.jsのホットリロード時にも重いプロキシインスタンスの再起動が防がれ、軽快に動作するよう設計されています。

フォルダ構成

• app/: Next.js App Router (ルーティング, Server Components)
• components/: 再利用可能なReactコンポーネント (UI, フォーム等)
• db/: Drizzle ORM のスキーマ定義 (schema.ts)
• lib/: データベース接続 (db.ts), APIクライアント, アクション群, バリデーション等
• messages/: next-intl 向けの翻訳ファイル (ja.json, en.json)

ライセンス (License)

このプロジェクトは MIT License の元に公開されています。

タスク

• Modrinth、CurseForgeとの連携
  • ModrinthやCurseForgeからプロジェクトを連携できる仕組み（ModrinthやCFのAPIキーはアカウント設定から登録する）
  • インポートしたプロジェクトは、ModParks上でも更新できるようにする
  • ダウンロードファイルの代わりにModrinthやCurseForgeのプロジェクトへのリンクを掲載できるようにする
  • ダウンロード数をModrinthやCurseForgeに連携する（ダウンロード数の同期と合算するが、外部DL数として管理する）
  • issueのタブを設置する（GitHub Issuesなどへのリンクも可能にする、もし外部に設定した場合はタブを押すとその設定したissuesに飛ぶ）
• リストの作者名をクリックするとその人のプロフィールにリンクするようにする
• 他人のリストをフォローできるようにする（フォロワー数を表示する、これはフォロワー一覧は表示しない）
• 作者をフォローできるようにする（フォロー数も表示する、そのフォロー数をクリックすると見れる、フォロワー数も表示するし、それをクリックするとフォロワー一覧を見れる）
• リストのアイコンを設定できるようにする、アイコンは自分でアップロードするかリストに入れているプロジェクトの中から選択してそのプロジェクトのアイコンにする
• リストを編集、削除できる機能を実装する（リストページからできるようにする、自分が作成したリストのみ）
• プロジェクトを新規作成するときに、ModrinthやCurseForgeのプロジェクトからインポートできるようにする
• フロントエンドとバックエンドを完全にわけるためにあらかじめ、APIを固めておく
• アイデアボードから、プロジェクト作成へ落とし込める仕組み（アイデアボードからプロジェクトを新規作成する）
• アイデアボードの公開範囲を管理できるようにする（公開/非公開）
• プロジェクトにもコメント機能を実装する（デフォルトはユーザーが設定できるが、設定していないときはプロジェクトのコメント機能を無効にしておく、管理から有効にできる）
• リストを編集するダイアログとボタン
• リストのアイコン表示、説明