Pinecone Pack Manager

Pinecone Pack Manager is a modern, fast, and fully autonomous Desktop Application for managing Minecraft modpacks. It acts as a powerful Graphical User Interface (GUI) over packwiz, taking away the hassle of the command line.

Whether you are creating a new modpack from scratch, adding mods from CurseForge and Modrinth, or deploying your finished server directly via SFTP — Pinecone Pack Manager does it all in a beautiful, intuitive interface.

✨ Features

• 📦 100% Autonomous & Portable: packwiz is bundled directly into the application. No internet required for initial setup, no dependencies to install, no go needed! Just run the .exe and it works out of the box.
• 🎨 Modern Interface: Built with React, TypeScript, Vite, and Tailwind CSS.
• 🔍 Easy Mod Management: Add mods directly from Modrinth and CurseForge just by pasting a URL or Slug. The app handles dependencies and metadata automatically.
• 🚀 Smart Server Deployment: Blazing fast SFTP deploy mechanism. It syncs only new/updated mods, automatically removes deleted .jar files from your remote server, and safely backs up old configurations.
• 📝 Human-Readable Errors: Say goodbye to cryptic command-line errors. The app translates network timeouts and rate limits (Error 429) into clear, actionable advice.
• 🐙 Git Integration: Automatically commit and push your pack.toml updates to your Git repository.
• 📤 Export Ready: Generate .mrpack files for Modrinth distribution with a single click.

📥 Download & Install

Just navigate to the Releases page and download the pre-compiled standalone executable.

No installation required! Unzip the folder and run Pack Manager.exe.

🛠️ Build from Source

If you want to modify the code or build the application yourself:

Prerequisites

• Node.js (v18 or newer recommended)

Setup

1. Clone this repository:

   git clone https://github.com/your-username/pinecone-pack-manager.git
   cd pinecone-pack-manager

2. Install dependencies:

   npm install

3. Run in Development Mode:

   npm run dev

4. Build the standalone executable:

   npm run electron:build

   The compiled app will be available in dist-electron-release/win-unpacked/.

💡 How to Use

1. Open/Create a Modpack: Click "Create New Modpack" or select a folder containing an existing pack.toml.
2. Add Mods: Click "Add Mod", select your platform (Modrinth/CurseForge), and paste the link.
3. Deploy to Server: Go to the "Server Deploy" tab, enter your SFTP credentials, and hit "Deploy". The app will compile the server-build/ directory and sync it remotely.

📄 License

This project is open-source. Feel free to fork, modify, and contribute!