EpicAINpc - AI NPCs with Memory v1.1.1

EpicAINpc — AI-Powered NPCs With Real Memory


Bring your server to life with NPCs that actually talk back — and remember. EpicAINpc turns ordinary villagers into intelligent characters powered by Claude AI. Each NPC has its own personality, speaks in the player's own language, and remembers past conversations with every individual player — even after they log out and come back days later.





Features

• Persistent per-player memory — every NPC remembers what each player told them, stored safely on disk. Log out, come back tomorrow, and the NPC still knows you.
• Unique personalities — give each NPC its own character, role, and zone through a simple config file.
• Speaks the player's language — the NPC automatically detects and replies in the language the player is writing in.
• AI-generated quests — players can ask an NPC for a quest and receive a unique objective on the spot.
• Smart teleportation — players can ask an NPC to take them to a zone, and they're teleported to the right location in the right world.
• Built-in safety — content filter and a per-player rate limiter to keep conversations clean and API usage under control.
• Fully configurable — model, response length, rate limits, chat prefix, filter, and teleport coordinates are all editable in the config.

Requirements

• Paper 1.21+ (tested on 1.21.11, Java 21)
• Your own Anthropic API key (see below)

Important — You Need Your Own API Key


This plugin connects to Claude AI through Anthropic. It does not include an API key. You provide your own, so all usage runs on your account — never on the developer's.

1. Create a free account at console.anthropic.com
2. Generate an API key
3. Paste it into config.yml under anthropic-api-key, or set the ANTHROPIC_API_KEY environment variable

API usage is paid directly to Anthropic and is separate from the price of this plugin. EpicAINpc uses Claude Haiku 4.5 by default — Anthropic's most cost-efficient model — so each NPC conversation is very cheap (roughly $0.001 or less per message). Total cost depends entirely on how much your players chat. You can set a spending limit in your Anthropic console to stay in control. Always check current rates at anthropic.com/pricing.


🛟 Support


Found a bug or have a question? Message me on BuiltByBit and I'll help you out.

EpicAINpc — AI-NPC's Met Échte Herinnering


Breng je server tot leven met NPC's die echt antwoorden — en onthouden. EpicAINpc verandert gewone dorpelingen in intelligente personages, aangedreven door Claude AI. Elke NPC heeft zijn eigen persoonlijkheid, praat in de taal van de speler, en onthoudt eerdere gesprekken met elke speler apart — zelfs nadat ze uitloggen en dagen later terugkomen.





Functies

• Blijvend geheugen per speler — elke NPC onthoudt wat elke speler hem verteld heeft, veilig opgeslagen op schijf. Log uit, kom morgen terug, en de NPC kent je nog.
• Unieke persoonlijkheden — geef elke NPC zijn eigen karakter, rol en zone via een eenvoudig configuratiebestand.
• Praat de taal van de speler — de NPC herkent automatisch de taal waarin de speler schrijft en antwoordt in diezelfde taal.
• AI-gegenereerde quests — spelers kunnen een NPC om een opdracht vragen en krijgen meteen een uniek doel.
• Slimme teleportatie — spelers kunnen een NPC vragen hen naar een zone te brengen, en worden naar de juiste locatie in de juiste wereld geteleporteerd.
• Ingebouwde veiligheid — contentfilter en een rate limiter per speler om gesprekken netjes en het API-gebruik beheersbaar te houden.
• Volledig instelbaar — model, antwoordlengte, rate limits, chat-prefix, filter en teleportcoördinaten zijn allemaal aanpasbaar in de config.

Vereisten

• Paper 1.21+ (getest op 1.21.11, Java 21)
• Je eigen Anthropic API-key (zie hieronder)

Belangrijk — Je Hebt Je Eigen API-Key Nodig


Deze plugin maakt verbinding met Claude AI via Anthropic. Er zit geen API-key in de plugin. Je vult je eigen key in, zodat al het gebruik op jouw account loopt — nooit op dat van de ontwikkelaar.

1. Maak een gratis account op console.anthropic.com
2. Genereer een API-key
3. Plak hem in config.yml bij anthropic-api-key, of stel de omgevingsvariabele ANTHROPIC_API_KEY in

Het API-gebruik betaal je rechtstreeks aan Anthropic en staat los van de prijs van deze plugin. EpicAINpc gebruikt standaard Claude Haiku 4.5 — het goedkoopste model van Anthropic — dus elk NPC-gesprek is heel goedkoop (grofweg $0,001 of minder per bericht). De totale kosten hangen volledig af van hoeveel je spelers chatten. Je kunt een uitgavenlimiet instellen in je Anthropic-console om de controle te houden. Bekijk de actuele tarieven altijd op anthropic.com/pricing.


🛟 Ondersteuning


Een bug gevonden of een vraag? Stuur me een bericht op BuiltByBit en ik help je verder.