BlockGPT is a Minecraft server plugin that integrates the power of ChatGPT’s AI to provide instant answers about the game. Players can ask questions and receive help with crafting, combat, game mechanics, and more. Ideal for servers looking to improve the player experience with helpful, interactive AI.

Key commands include /help <question>, which sends questions directly to the AI, and /blockgpt reload to reload the plugin’s settings.

Requirements:
- Spigot or Paper server for Minecraft 1.20+
- Java 8 or higher
- An OpenAI API key (available at [OpenAI API]( https://platform.openai.com/api-keys))

Commands
/help <question>: Sends a question to the AI and receives a real-time response. Example: /help How do I make an anvil?
/blockgpt help: Displays a list of all commands available in the plugin.
/blockgpt reload: Reloads the plugin settings, applying any changes to the configuration file.
/blockgpt info: Displays information about API usage and communication status.
/blockgpt dev: Displays information about the plugin developer.

Permissions
blockgpt.use: Allows the player to use the /help command to interact with the AI. Default: All
blockgpt.admin: Allows the use of the administrative /blockgpt commands and their subcommands. Default: Operators
Plugin Configuration

BlockGPT configuration is done in the config.yml file, where you can adjust several parameters to customize the plugin's behavior, including the OpenAI API key, the messages displayed in the game, and the context sent to the AI.

Some important settings:
- token: Your OpenAI API key.
- model: The GPT model to use (example: gpt-4.1-nano-2025-04-14).
- messages: Customizable messages such as prefix, error message, and success when reloading the plugin.
- minecraft-context: The context sent to the AI, adjusted to provide answers about Minecraft.