Local Setup

• clone the repo
• run ./gradlew in the root of the repo
• download paper mc server version 1.21.1
• setup the server
• download voicechat bukkit plugin 2.5.24
• download imagery api 1.2.1
• download ImageFrame 1.7.10 for printing out photos on maps
• place the jar files in the plugins folder of your server
• install fabric for 1.21.1
• download the fabric api jar for extra mod compatibility
• download the voice chat mod version 1.21.1-2.5.24 for fabric
• place those in your mods folder in .minecraft
• (Optional) install iris + sodium and BSL Shaders for a more godly experience

Config

• Get a free gemini api key from aistudio.google.com/
• Get a free speechify api key from console.sws.speechify.com/tts
• configure primary model to be model-name: gemini-1.5-pro for smarter role-play output at slower speeds. Both models are fun, so give them both a try
• configure primary model to be model-name: gemini-1.5-flash if you want fast model times such as rate: 30 or below.
  • NOTE: Do not go below 30-32 on the free tier pro model or you will hit your 2 requests per minute and 50 requests per day fast
  • NOTE: if you set your primary model to gemini-1.5-flash then set secondary to gemini-1.5-flash-8b as free-tier rate limits are per-model name
  • do not use the 1.0 models or other models which are not multimodal for secondary model. This program relies on the audio and visual processing of the latest Gemini 1.5 models.
  • the flash model can go below 20 and performs quite nicely with the rapid feedback
  • for a fast-feedback experience try setting both models to gemini-1.5-flash and try a rate of about rate: 20 to rate: 30
  • do NOT use gemini-1.5-pro as the secondary model

Building

• use the shadowjar task to build
• the jar will appear in build/libs
• place this jar in the plugins folder of the server

Development
development requires jdk 21 and gradle version 7.4

Workspace has been setup for VSCode as well.

plugin jar releases show up under <project_dir>\build\libs

Windows
A release build may be generated with the included bat file for convenience.

I:\DEVELOPER\PROJECTS\minecraft-gpt-god-plugin>gradlew shadowJar
Starting a Gradle Daemon, 2 incompatible and 1 stopped Daemons could not be reused, use --status for details

BUILD SUCCESSFUL in 3s
3 actionable tasks: 3 up-to-date
I:\DEVELOPER\PROJECTS\minecraft-gpt-god-plugin>
gradlew shadowJar Starting a Gradle Daemon, 2 incompatible and 1 stopped Daemons could not be reused, use --status for details BUILD SUCCESSFUL in 3s 3 actionable tasks: 3 up-to-date I:\DEVELOPER\PROJECTS\minecraft-gpt-god-plugin>" tabindex="0" role="button" style="box-sizing: border-box; position: relative; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; text-wrap-mode: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border: 0px; border-radius: 6px; appearance: none; color: var(--fgColor-accent, var(--color-accent-fg)); background-color: transparent; box-shadow: none; transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1), background-color, box-shadow, border-color; width: var(--control-small-size, 28px); height: var(--control-small-size, 28px); display: flex !important; padding: 0px !important; justify-content: center !important; align-items: center !important; margin: var(--base-size-8, 8px) !important;">
*Nix
install gradle 7.4, and jdk 21 then:

~> gradle shadowJar
gradle shadowJar" tabindex="0" role="button" style="box-sizing: border-box; position: relative; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; text-wrap-mode: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border: 0px; border-radius: 6px; appearance: none; color: var(--fgColor-accent, var(--color-accent-fg)); background-color: transparent; box-shadow: none; transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1), background-color, box-shadow, border-color; width: var(--control-small-size, 28px); height: var(--control-small-size, 28px); display: flex !important; padding: 0px !important; justify-content: center !important; align-items: center !important; margin: var(--base-size-8, 8px) !important;">
Running

• run the server once then go to plugins/gptgodmc/config.yml
• paste in your OpenAi API or Gemini key
• run the server again
• launch minecraft with fabric (make sure voice chat mod is installed)
• NOTE: on MacOS you need to use a launcher such as prisim to allow microphone access permission to for the plugin
  • more info here
• finally, connect to the server at localhost