ModParksは、日本発 of Minecraft Java Edition向けMOD、プラグイン・リソースパック等の公開・共有プラットフォームです。 ユーザーは自身が作成したプロジェクトを投稿し、バージョンごとにファイルを管理・配布することができます。

Minecraftのコミュニティにおいて、MODやプラグインの配布は複数の海外プラットフォームに分散していますが、日本のユーザーにとっては言語の壁やサポートの面でハードルがある場合があります。ModParksは、直感的でモダンなUIと多言語対応（日本語・英語）を提供し、誰でも簡単にプロジェクトを公開・検索できるハブとなることを目指しています。

• プロジェクト管理
  • MOD、プラグイン、リソースパック、データパックなどのプロジェクトを作成可能。
  • バージョン管理システム: 対応するMinecraftバージョン（1.20.1など）やローダー（Fabric, Forge, NeoForge, Paperなど）を指定してファイルをアップロード。
  • Markdown形式でのリッチなプロジェクト説明文（README）の記述。
• 充実した検索・フィルター機能
  • プラットフォーム（MOD / プラグイン）、対応バージョン、ローダーによる高度な絞り込み検索。
  • ダウンロード数や更新日時による並び替え。
• コレクション・リスト機能
  • ユーザーがお気に入りのプロジェクトをまとめた「リスト（コレクション）」を作成・公開可能。
  • 他のユーザーが作成したリストをフォローして最新 of MOD構成を追跡。
• コミュニティ機能（アイデア・フィードバック）
  • 「アイデア」としてユーザーが欲しいMODやプラグインの構想を投稿し、開発者と交流できる場を提供。
  • 開発者と利用者が直接コミュニケーションを取れるコメント・フィードバック機能。
• 外部連携・統合
  • CurseForge や Modrinth などの主要プラットフォームと連携。
  • 外部プラットフォームからのダウンロード数の合算表示、同期機能。
  • GitHub Webhook連携: GitHubのReleaseと連動し、新しいバージョンを全自動でModParksに取り込む機能を搭載。

ModParksは、モダンなWeb技術をベースに構築されたフルスタックアプリケーションです。

• フロントエンド / バックエンド: Next.js 15 (App Router)
• UIライブラリ: Material-UI (MUI v5)
• 言語: TypeScript (厳格な型チェックを適用)
• データベース ORM: Drizzle ORM
• データベース: Cloudflare D1 / Turso (SQLiteベース)
• ファイルストレージ: Cloudflare R2 (S3互換ストレージ)
• 認証: NextAuth.js (GitHub, DiscordなどのOAuth対応)
• 多言語対応 (i18n): next-intl (汎用テキストは Common 名前空間等で一元管理)

主要なディレクトリ構成は以下の通りです：

• app/ : Next.js App Routerのルーティングとページ定義（[locale] で多言語対応）
• components/ : 再利用可能なUIコンポーネント（機能ごとにディレクトリ分割）
• db/ : Drizzle ORMのスキーマ定義とマイグレーションファイル
• lib/ : ユーティリティ関数、APIクライアント、サーバーアクション等のビジネスロジック
• messages/ : 多言語対応用のJSONファイル (en_us.json, ja_jp.json)
• docs-md/ : プラットフォーム全体のドキュメント・仕様書

• 開発環境セットアップガイド : 開発に必要な前提条件、環境構築手順
• データベース設計とスキーマ : 主要テーブル定義とリレーションシップ
• APIリファレンス : 各種APIエンドポイントの仕様
• CLIコマンドガイド : CLIツールの操作方法