HomeJavaModsAiServerAssistant
AiServerAssistant
ModsJava

AiServerAssistant

by ArcticDev · on Modrinth

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 1.20–1.20.4 · Bukkit⬇ Download for 1.18.2–1.20.4 · Paper⬇ Download for 1.18.2–1.20.4 · Purpur⬇ Download for 1.18.2–1.20.4 · Spigot
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
AiServerAssistant — screenshot 1AiServerAssistant — screenshot 2AiServerAssistant — screenshot 3

About

This is a plugin that allows you to integrate ChatGPT into your server as a form of player assistant. You can configure a personality and your basic server features and players can ask it all sorts of questions.

Dependencies

AiCore is REQUIRED! https://modrinth.com/plugin/aicore

Commands

/aisa reload reloads the plugin and defaults aisa.admin permission required

/aisa force_encrypt forces the plugin to update the encryption manually. only use this if you have to update your API Key. This can technically be done by setting the API Key in config and setting Encrypted to false. Its actually never recommended to use this command because its likely you'll get something wrong. aisa.admin permission required

/ask <question> This the main command! The plugin will attempt to answer any question that follows and should hopefully ignore anything that isn’t minecraft or server related.

aisa.chat permission is required for players to use the in-chat feature! To speak to the bot, use "hey botname" at the start of a message.

Intial Setup

STEP 1: If you do not have an OpenAI account, create one. https://platform.openai.com/docs/quickstart/account-setup

STEP 2: Create an API Key https://platform.openai.com/account/api-keys

STEP 3: Update the "keys.yml" file with your API Key and set "encrypted" to "false"

STEP 4: Start the server! It will AUTOMATICALLY ENCRYPT THE API KEY!

STEP 5: Verify your prompt.txt file. It should work well enough, but tweak it to your liking.

You only need to follow these steps if you need to change your api key.

API KEY SECURITY NOTICE

By default, the plugin is designed to use an encryption algorithm to mask your tokens and orgs. Its not entirely fool proof, and you should monitor your usage closely. If you see that your usage includes models you normally aren’t using - change keys immediately and remove the old one.

I do not include an encryption class for self compiling users. You will need to implement your own logic here. I would recommend hosting your own webservice and making authenticated calls to that instead of storing them anywhere staff/players might have access to them.

Support or Suggestions?

Please use "Issues" on Github or My Support Discord!

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more