Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
AiServerAssistant

AiServerAssistant

Use OpenAI integration to help players understand your server and navigate its features.

226
6

Compatibility

Minecraft: Java Edition

1.20–1.20.4
1.19.x
1.18.2

Platforms

Bukkit
Paper
Purpur
Spigot

Supported environments

Server-side

75% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Report issues View source Join Discord server

Creators

ArcticDev
ArcticDev Member

Details

Licensed MIT
Published 8 months ago
Updated 7 months ago

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!