Minecraft MCP Server

# Setup Complete! 🎉 Your GitHub repositories are now properly configured with git submodules. ## What Was Done ### 1. Forked Repositories - ✅ https://github.com/hibukki/mineflayer (fork of PrismarineJS/mineflayer) - ✅ https://github.com/hibukki/minecraft-mcp-server (fork of yuniko-software/minecraft-mcp-server) ### 2. Pushed Mineflayer Changes Your 2 custom commits are now on your mineflayer fork: - `ca9d4796` - once: 20s -> 2s timeout - `44991237` - craft: check distance, clearer error ### 3. Set Up Submodule - mineflayer is now a git submodule pointing to your fork - Committed to main repo with `.gitmodules` configuration - All changes pushed to GitHub ### 4. Updated Documentation - Added "Development Setup" section to README - Documented mineflayer modifications - Clear clone instructions with `--recurse-submodules` ## Repository Structure ``` hibukki/minecraft-mcp-server/ ├── src/ # Main MCP server code ├── mineflayer/ # Git submodule → hibukki/mineflayer │ ├── lib/ │ │ ├── plugins/craft.js (modified) │ │ └── promise_utils.js (modified) │ └── ... └── README.md # Updated with setup instructions ``` ## For Users Cloning Your Repo They'll run: ```bash git clone --recurse-submodules https://github.com/hibukki/minecraft-mcp-server.git cd minecraft-mcp-server npm install cd mineflayer && npm install && cd .. npm run build ``` ## For Opening PRs to Upstream ### Mineflayer PRs ```bash cd mineflayer # Make changes, commit git push my-fork master # Open PR from hibukki/mineflayer → PrismarineJS/mineflayer ``` ### Minecraft-MCP-Server PRs ```bash cd /Users/yonatancale/Development/minecraft-mcp-server # Make changes, commit git push origin main # Open PR from hibukki/minecraft-mcp-server → yuniko-software/minecraft-mcp-server ``` ## Next Steps 1. **Test the setup**: Try cloning your repo fresh in a different directory to verify the submodule works 2. **Open PRs**: Your mineflayer changes (timeout and distance check) are great candidates for upstream PRs 3. **Continue developing**: Make more changes to either repo independently ## Useful Git Submodule Commands ```bash # Update submodule to latest commit from your fork git submodule update --remote mineflayer # Check submodule status git submodule status # Work inside the submodule cd mineflayer git checkout master # make changes, commit, push cd .. git add mineflayer git commit -m "mineflayer: update to latest" ``` ## Links - Main repo: https://github.com/hibukki/minecraft-mcp-server - Mineflayer fork: https://github.com/hibukki/mineflayer - Upstream mineflayer: https://github.com/PrismarineJS/mineflayer - Upstream minecraft-mcp-server: https://github.com/yuniko-software/minecraft-mcp-server