Skip to content

README.md

Latest commit

 

History

History
127 lines (94 loc) · 3.04 KB

README.md

File metadata and controls

127 lines (94 loc) · 3.04 KB

NPCForge

AI NPC Personality Engine for SentiencePro

& LlamaCraft Bridge

"Your AI NPC sounds like a customer service bot.
This repository changes that."

[![GitHub Pages] (https://img.shields.io/badge/Site-npcforge.github.io -gold?style=flat-square)] (https://npcforge.github.io) [![License: MIT] (https://img.shields.io/badge/License-MIT-green ?style=flat-square)] (LICENSE) [![Compatible] (https://img.shields.io/badge/Plugin-SentiencePro %20%7C%20LlamaCraft-blue?style=flat-square)] (https://npcforge.github.io)

What Is This?

SentiencePro and LlamaCraft Bridge are powerful AI plugin engines for Minecraft game servers.

The default configuration gives the language model almost no direction. The model falls back to generic assistant behavior. Your medieval guard sounds like a help desk. Your merchant sounds like a customer service rep. Immersion destroyed.

This repository provides:

Free (this repo):

  • A working Starter Guard personality pack
  • system_prompt.txt, memories.json, config.yml
  • 10 pre-built memories and basic configuration
  • Three-step installation guide

Paid (npcforge.github.io/store):

  • Full character packs with 600-word personality definitions
  • 25 hand-crafted memories per character
  • Advanced configuration with cost controls
  • Multiple characters with shared world lore
  • Personal support guarantee

Quick Start (Free Version)

```bash

Download the starter pack

Click "Code" → "Download ZIP" above

Or clone:

git clone https://github.com/ [yourusername]/SentiencePro-Starter-Personalities ```

Installation:

  1. Copy /starter-guard/ into /plugins/SentiencePro/personalities/
  2. Add your API key to config.yml
  3. Restart server and assign to your NPC

The Difference This Makes

Without a personality pack: Player: "Have you always been a guard?" NPC: "Yes. It is my job."

text

With the full Aldric pack: Player: "Have you always been a guard?" Aldric: "Thirty-one years on this gate. Started the year the East Tower burned. I was seventeen. Too young to know that some fires don't go out just because you stop seeing the smoke."

text

Compatible With

Plugin Status
SentiencePro ✅ All versions
LlamaCraft Bridge ✅ Full support
OpenAI API ✅ gpt-4o-mini recommended
Anthropic API ✅ Claude compatible

Available Characters

Character Type Where
Starter Guard Basic This repo (free)
Aldric Grizzled Guard npcforge.github.io
Dravek Corrupt Merchant npcforge.github.io
City Bundle Aldric + Dravek npcforge.github.io
Senna Broken Oracle Coming soon
Kingdom Bundle 5 characters Coming soon

License

MIT — Free starter pack files only.
Paid character packs are proprietary.

Built by NPCForge | npcforge.github.io ────────────────────────────────────────────────────