{"id":25998631,"url":"https://github.com/johnkearney1/minegpt","last_synced_at":"2025-03-05T17:34:29.787Z","repository":{"id":191098785,"uuid":"616216654","full_name":"JohnKearney1/MineGPT","owner":"JohnKearney1","description":"MineGPT is a minecraft bot that responds to chat messages and interacts with the world using the ChatGPT API.","archived":false,"fork":false,"pushed_at":"2023-09-12T03:17:06.000Z","size":100,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T23:42:48.384Z","etag":null,"topics":["bot","bots","chatbot","chatgpt","chatgpt-bot","chatgpt-plugin","javascript","minecraft"],"latest_commit_sha":null,"homepage":"https://kearneyjohn.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JohnKearney1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-03-19T23:35:37.000Z","updated_at":"2024-07-27T19:46:57.000Z","dependencies_parsed_at":"2023-08-28T05:31:44.814Z","dependency_job_id":"8663669e-172d-498c-9667-25636cb24651","html_url":"https://github.com/JohnKearney1/MineGPT","commit_stats":null,"previous_names":["johnkearney1/minegpt"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKearney1%2FMineGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKearney1%2FMineGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKearney1%2FMineGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKearney1%2FMineGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnKearney1","download_url":"https://codeload.github.com/JohnKearney1/MineGPT/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242070470,"owners_count":20067271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","bots","chatbot","chatgpt","chatgpt-bot","chatgpt-plugin","javascript","minecraft"],"created_at":"2025-03-05T17:33:18.501Z","updated_at":"2025-03-05T17:34:29.778Z","avatar_url":"https://github.com/JohnKearney1.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [MineGPT](https://github.com/JohnKearney1/MineGPT)\n[![GitHub issues](https://img.shields.io/github/issues/JohnKearney1/MineGPT)](https://github.com/JohnKearney1/MineGPT/issues)\n[![GitHub closed-issues](https://img.shields.io/github/issues-closed/JohnKearney1/MineGPT)](https://github.com/JohnKearney1/MineGPT/issues?q=is%3Aissue+is%3Aclosed)\n[![GitHub stars](https://img.shields.io/github/stars/JohnKearney1/MineGPT)](https://github.com/JohnKearney1/MineGPT/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/JohnKearney1/MineGPT)](https://github.com/JohnKearney1/MineGPT/network/members)\n[![Release](https://img.shields.io/github/release/JohnKearney1/MineGPT)]()\n[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://www.redhat.com/en/topics/open-source/what-is-open-source)\n[![GitHub contributors](https://img.shields.io/github/contributors/JohnKearney1/MineGPT)](https://github.com/JohnKearney1/MineGPT/graphs/contributors)\n[![GitHub Activity](https://img.shields.io/github/commit-activity/m/JohnKearney1/MineGPT)](https://github.com/JohnKearney1/MineGPT/activity)\n\n![MineGPT](MineGPT.png)\n\nMineGPT is a minecraft bot that responds to chat messages using the ChatGPT API. It supports a variety of commands, pre-made characters, helpful behaviors, and more!\n\nAll chats sent in the game that are **not** commands are sent to ChatGPT for a response. The response is printed in game \u0026 the chat is recorded in the console.\n\n## How to use\n\n1. Install node.\n2. Navigate to the MineGPT directory in your command prompt, terminal or IDE.\n3. Install the dependencies: `npm install`\n4. Configure your account info: in *`.env`* Add the server ip, account information, and openAI API key. (More info below!)\n5. Run the bot: `node MineGPT.js`\n\n## Default Behaviors\nThe bot has only a few continuous behaviors:\n\n1. If there is a player nearby, MineGPT will look at them.\n2. If the bot has bread, it will auto-eat it when hungry.\n3. MineGPT will auto-respawn when it dies.\n4. MineGPT will attempt to re-connect to the server if it is disconnected.\n\nAll other behaviors are triggered by commands or chat messages.\n\n## Commands\n\nAll commands are sent as ingame chats to the bot, and override the ChatGPT functionality to preform some other task. All commands begin with the prefix `!`.\n```\n- !help -\u003e Shows a list of commands\n\n- !follow -\u003e Toggles following the nearest entity on and off\n- !follow \u003cstop\u003e -\u003e Force stops following all entities\n- !follow \u003cplayer\u003e \u003cusername\u003e -\u003e Follows the specified player until stopped\n\n- !goto \u003cx\u003e \u003cy\u003e \u003cz\u003e -\u003e Goes to the specified coordinates\n- !goto \u003cusername\u003e -\u003e Goes to the specified player\n\n- !sleep -\u003e Locates the nearest bed, goes to it, and sleeps\n- !wake -\u003e Wakes the bot from it's sleep\n\n- !equip \u003citem\u003e? -\u003e Equips the specified item, or next item if no item is specified\n- !drop \u003citem\u003e? -\u003e Drops the specified item, or next item if no item is specified\n\n- !ask \u003cquestion\u003e -\u003e Asks the bot a question (alias command for ordinary chat)\n- !newchat -\u003e Wipes the chat history and starts a new conversation\n- !togglechat -\u003e Toggles ChatGPT off and on. Does not send requests to GPT when off.\n\n- !prompt \u003ccharacter\u003e -\u003e Sets the character to use for the next conversation\n- Characters: pirate, doctor, cowboy, robot, alien, lore\n\n```\n\n## Setting up the `.env` (Your Account Info)\n\nThe default .env looks like this:\n\n```\nMINEGPT_HOST=localhost\nMINEGPT_PORT=25565\nMINEGPT_VERSION=1.20.1\nMINEGPT_AUTH=microsoft\nMINEGPT_USERNAME=example@example.com\nMINEGPT_PASSWORD=password123\nMINEGPT_OPENAI_API_KEY=sk-000000000000000000000000000000000000000\n```\n- Host: The IP address of the server to connect to (or localhost) without the port number  \n- Port: The port your server is running on. 25565 is the default.\n- Version: The version of Minecraft your server is running. 1.20.1 is the default.\n- Auth: `minecraft` or `mojang` depending on how you login to your account. (mojang is depreciated)  \n- Username: The email or username you use to login to your Minecraft Account\n- Password: The password you use to login to your Minecraft Account\n- OpenAI: Your OpenAI API key. You can obtain one from [platform.openai.com](https://platform.openai.com/account/api-keys).\n\n## Disclaimer\nMineGPT is not affiliated with Mojang, Microsoft, or OpenAI. It is an open source project that uses their services. You are responsible for how you use it. Please use responsibly.\n\nThis project is created with [mineflayer](https://github.com/PrismarineJS/mineflayer)!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnkearney1%2Fminegpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnkearney1%2Fminegpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnkearney1%2Fminegpt/lists"}