NPCAlive | OpenAI NPCs — Relationships, Marriage, Children & Jobs -----
Transform your Minecraft server into a living world full of relationships.
NPCAlive
NPCAlive turns every NPC into a unique character with personality. Befriend them, fall in love, get married, raise children, and watch your family tree grow generation after generation — all inside the game, no mods required. Just Citizens and Vault.
Important Note
Every NPC that is part of NPCAlive will have access to the full plugin logic — relationships, hearts, marriage, children, jobs, studies, social interactions, and all other features described below. This applies exclusively to NPCs obtained through the NPCAlive Shop. Any NPC created externally or through other plugins will not be integrated into the NPCAlive system and will not have access to these features.
✨ Core Systems
Hearts & Relationships
Every interaction with an NPC adds or removes hearts. As hearts accumulate, your relationship evolves through distinct stages:
Hearts Relationship Level
0 Strangers
100 Acquaintances
500 Friends
2,000 Partners
4,000 Engaged
5,000 Married
Gifts affect the NPC's mood: a great gift triggers a joyful jump with particles and sound effects. A bad gift causes rejection with sad animations and particles.
Marriage & Divorce
- Requires 5,000 hearts and a special craftable wedding ring
- Marriage ceremony includes fireworks and a server-wide broadcast
- Divorce costs 5,000 coins and requires confirmation with /npcalive confirm
- Maximum 1 married NPC per player (configurable)
Build a legacy across generations:
- Married NPCs can have children through procreation
- 24-hour real-time pregnancy before birth
- The player names the baby by typing it in chat
- NPCs age 1 year per real day, stopping at age 70
- Full kinship recognition: son/daughter, grandchild, great-grandchild, brother/sister-in-law, niece/nephew
9 unique interaction types, each with a chance to gain or lose hearts based on the NPC's randomized response. Optional OpenAI (GPT-4o) integration enables AI-generated dynamic dialogue.
- Chat
- Tell a story
- Give a hug
- Tell a joke
- Give advice
- Flirt
- Kiss
- Play together (children only)
- Teach (children only)
5 job types with contracts lasting 6 to 10 hours. When the contract ends, the NPC automatically returns to the player with rewards.
Job Salary Rewards
Miner 2,500 – 8,500 Diamond, Iron, Gold, Redstone
Fisher 3,500 – 5,500 Golden Apple, Tropical Fish, Pufferfish
Hunter 3,000 – 8,500 Carrot, Apple, Rotten Flesh
Farmer 5,400 – 8,500 Carrot, Wheat, Potato
Carpenter 4,500 – 9,000 Wood, Logs, Bookshelves
- Requires at least 1,000 hearts to hire
- Firing costs 5,500 coins
- Children (descendants) cannot work
Education is available exclusively for NPC children aged 3 years or older.
- 10 sessions of 60 minutes each to graduate
- 5,000 coins per session (total: 50,000 coins)
- Upon graduation, the NPC receives a unique study certificate item
- Buy and sell NPCs configured by the admin
- Each NPC is delivered as a head with a special skin — place it on the ground to summon them
- Category system for easy browsing
- Maximum 20 NPCs per player (configurable)
- You cannot sell an NPC you are married to
A special craftable item that opens a GUI menu with options to:
- Summon the NPC to your current position
- Set their home location
- Send them home / hide them
A shared persistent inventory between the player and their family members (spouse and children). Only family members can access it.
Follow System
- Activates the NPC to follow you within a 64-block range at 1.1× speed
- Automatically cancels if the player disconnects
- Trail of hearts around the player (toggleable)
- Particles and sounds on gifts, weddings, and graduations
- Fireworks during the wedding ceremony
Command Description Permission
/npcalive help Show the command list npcalive.help
/npcalive find Locate all your NPCs in the current world npcalive.find
/npcalive shop Open the NPC shop npcalive.shop
/npcalive jobs Open the jobs menu npcalive.options.jobs
/npcalive studies Open the studies menu npcalive.options.studies
/npcalive guide Open the in-game guide with recipes and info npcalive.options.guide
/npcalive toggle Toggle the heart particle trail npcalive.particles.toggle
/npcalive confirm Confirm a pending action (divorce, sale) —
/npcalive cancel Cancel a pending action —
/npcalive setname <name> Name the NPC baby after procreation npcalive.procreate
/npcalive add <player> <npcId> <hearts> Admin: Add hearts to an NPC npcalive.admin.addhearts
/npcalive remove <player> <npcId> <hearts> Admin: Remove hearts from an NPC npcalive.admin.removehearts
/npcalive set <player> <npcId> <hearts> Admin: Set exact heart count npcalive.admin.sethearts
/npcalive shop <player> <npcId> Admin: Remove an NPC from a player's purchases npcalive.admin.shopremovenpc
/npcalive reload Reload all configuration files npcalive.reload
Permissions
Global Packages
Permission Description Default
npcalive.* All permissions (player + admin) OP
npcalive.admin.* All administrator permissions OP
Player Permissions
Permission Description Default
npcalive.interact Interact with NPCs (right-click) true
npcalive.follow Make the NPC follow you true
npcalive.unfollow Stop the NPC from following true
npcalive.gift Give gifts to NPCs true
npcalive.divorce Divorce an NPC true
npcalive.inventory View an NPC's inventory true
npcalive.getmarry Propose marriage to an NPC true
npcalive.procreate Procreate with a married NPC true
npcalive.skin Change an NPC's skin true
npcalive.find Use /npcalive find true
npcalive.help View the help menu true
npcalive.particles.toggle Toggle heart particles true
⚙️ Options Permissions (NPC Menu)
Permission Description Default
npcalive.options Open the NPC options menu true
npcalive.options.equip Equip items on the NPC true
npcalive.options.sethome Set the NPC's home true
npcalive.options.guide Access the guide true
npcalive.options.jobs Manage NPC jobs true
npcalive.options.hire Hire NPCs for jobs true
npcalive.options.studies Manage NPC studies true
Jobs & Studies Permissions
Permission Description Default
npcalive.jobs Access the jobs system true
npcalive.jobs.upgrade Upgrade an NPC's job level true
npcalive.jobs.<job> Enable specific job for a player dynamic
npcalive.studies Access the studies system true
npcalive.studies.start Start a study session true
npcalive.studies.<study> Enable specific study for a player dynamic
Shop Permissions
Permission Description Default
npcalive.shop Access the NPC shop true
npcalive.shop.sale Sell NPCs in the shop true
npcalive.shop.buy.<npcId> Buy a specific NPC from the shop dynamic
Whistle Permissions
Permission Description Default
npcalive.whistle Use the whistle item true
npcalive.whistle.tpnpc Teleport NPC to the player using the whistle true
npcalive.whistle.hide Hide/show NPC with the whistle true
Social Interaction Permissions
Permission Description Default
npcalive.chat Chat with an NPC true
npcalive.tellahistory Tell a story to an NPC true
npcalive.giveahug Give a hug to an NPC true
npcalive.tellajoke Tell a joke to an NPC true
npcalive.advice Give advice to an NPC true
npcalive.flirt Flirt with an NPC true
npcalive.kiss Kiss an NPC true
npcalive.playtogether Play with an NPC child true
npcalive.teach Teach an NPC child true
️ Administrator Permissions
Permission Description Default
npcalive.reload Reload the plugin configuration OP
npcalive.admin.addhearts Add hearts to an NPC OP
npcalive.admin.removehearts Remove hearts from an NPC OP
npcalive.admin.sethearts Set exact hearts OP
npcalive.admin.shopremovenpc Remove an NPC from a player's shop OP
Requirements
- Minecraft: Paper/Spigot 1.20 – 1.21.x
- Java: 17+
- Required Dependencies: Citizens 2.0, Vault
- Languages: Spanish · English
Code (YAML):
############################
# NpcAlive #
# Premium ${project.version} #
############################
# Check for updates on startup (true/false)
update-check : true
# Welcome message shown to players when they join.
# Edit the content in welcome.yml — reload with /npcalive reload
welcome-message:
enable : true
debug : false
# Set the locale for all messages.
# They are only available in Spanish and English
# es for spanish
# en for English
# don't rename these files
# If you don't see the changes in the translation of the plugin, you need to restart the server.
locale : "en"
# -------------------------------------
relationship:
unknown : 0
acquaintances : 100
friends : 500
partner : 2000
committed : 4000
married : 5000 # These are the amount of hearts needed to be able to marry
# The following lines are the names of the items that a player can craft to use.
ring-name : "Wedding ring" # This is the name of the item that will be the wedding ring to be able to marry the npc
whistle-name : "Whistle" # This is the name of the item that is used to call the npc that family.
studies-name : "Studies" # This is the name of the item that is used to access the studies of an npc.
jobs-name : "Jobs" # This is the name of the item that is used to access the jobs of an npc
# -----------------------------------------------------------------------------------------------------------------------------
# List of worlds where NPCAlive does not work
world-not-allowed:
enable : false
list :
- "world1"
- "world2"
# Enable or disable the broadcast message of when a player gets married
message-married-broadcast:
enable : true
# If true, the npc will be removed from the server by using the /npcalive release (namenpc) command.
# If it is false, only the information related to the npc with the player will be deleted, and the npc will be free.
npc-remove-command:
enable : false
# Enable or disable the broadcast message of when when a player has a child
message-son-broadcast:
enable : true
#---------------------------------------------------------------------------------------------------------------------
# Enable or disable interaction with npc
npc-interaction:
enable : false
# This feature includes that players can only interact with the npc that they create themselves, thus also preventing npc theft from happening.
# if it is false, it means the players will be able to interact with all the npc on the server, this mode is freer with the interaction of npc, rather a more realistic mode.
# --------------------------------------------------------------------------------------------------------------------
# Sets the number of children allowed per player
children-allowed-per-player : 2
npc-head-lore : "NPCAlive - Child/Daughter" # This description is very important for the correct functioning of the plugin, that is, it should not be blank.
# --------------------------------------------------------------------------------------------------------------------
# Child NPC gestation and aging
# child-gestation-minutes: real minutes the player must wait before placing the child head (1440 = 24h)
# child-age-interval-minutes: real minutes that must pass for an NPC to age one year (1440 = 1 real day per year)
# NPCs stop aging at 70 — this limit is fixed in code for realism.
child-gestation-minutes : 1440
child-age-interval-minutes : 1440
# study-min-age: minimum age (in years) a child NPC must have reached before they can be enrolled in a study.
study-min-age : 3
# --------------------------------------------------------------------------------------------------------------------
wife-allowed-per-player : 1
tax-divorce : 5000 # This value represents the value that the player will have to pay for divorcing an npc with whom he is married.
# -------------------------------------------------------------------------------------------------------------------
# Jobs section
# -------------------------------------------------------------------------------------------------------------------
# States of a study
job-in-progress : "&aIn progress"
job-not-assigned : "&cNot assigned"
# Set the number of hearts necessary that the player has to have with the npc, to visualize the option to hire him for a job
hire-hearts : 1000
# This value represents the money that the player will be charged for firing a npc from a job
severance-pay : 5500
# This value represents the level of each job
maxJobLevel : 3
# Name of the employment contract
# Do not delete the variable %number%
hire:
name : "&bJob contract: &6%number%"
description : "Right click on the npc you want to hire"
dismissal-days : 2 # This value represents the number of days the player must wait to fire an npc from a job.
name-job : "&7Job name: &b%jobname%"
job-hours : "&7Job hours: &b%jobhours%"
job-salary : "&7Job salary: &b%jobsalary%"
# List of commands that are executed when npc finishes a job
# The executed field means that only this number of commands will be executed, this is done randomly.
miner:
hours-salary : 6h;2500,8h;4000,10h;8500
amount : 3 # Number of items to give
items :
- DIAMOND;2
- IRON_INGOT;3
- GOLD_INGOT;4
- REDSTONE;10
XP : 10
fishing:
hours-salary : 6h;3500,8h;3800,10h;5500
amount : 3 # Number of items to give
items :
- ENCHANTED_GOLDEN_APPLE;2
- APPLE;5
- TROPICAL_FISH;8
- PUFFERFISH;3
XP : 8
hunter:
hours-salary : 6h;3000,8h;5800,10h;8500
amount : 3 # Number of items to give
items :
- CARROT;5
- APPLE;5
- POTATO;8
- ROTTEN_FLESH;30
XP : 12
farmer:
hours-salary : 6h;5400,8h;6800,10h;8500
amount : 3 # Number of items to give
items :
- CARROT;5
- APPLE;5
- POTATO;8
- ROTTEN_FLESH;30
- WHEAT_SEEDS;30
XP : 6
carpenter:
hours-salary : 6h;4500,8h;6000,10h;9000
amount : 3 # Number of items to give
items :
- OAK_PLANKS;16
- OAK_LOG;8
- STICK;20
- BOOKSHELF;2
XP : 9
# -------------------------------------------------------------------------------------------------------------------
# Moods NPC
# -------------------------------------------------------------------------------------------------------------------
list-moods:
angry : "Angry"
happy : "Happy"
fearfully : "Fearfully"
sex-npc:
male : "male"
female : "female"
# -------------------------------------------------------------------------------------------------------------------
# Study section
# -------------------------------------------------------------------------------------------------------------------
# study-session-minutes : real minutes each study session lasts (default 60 = 1 hour)
# study-session-cost : money charged each time the child is sent to study
# study-sessions-total : how many sessions are needed to reach 100% and graduate
# total cost = session-cost × sessions-total (e.g. 5000 × 10 = $50 000)
# If the player changes the study after having sent the child at least once, they pay the full
# tuition cost (session-cost × sessions-total) as a penalty, then the study resets.
study-session-minutes : 60
study-session-cost : 5000
study-sessions-total : 10
# Certificate of study
study-certificate:
name : "&6Certificate of study"
description :
- "&f%npcname% &bis certified to have"
- "&bcompleted the study process"
- "&bsuccessfully and is now ready to"
- "&bstart working like a professional"
# -------------------------------------------------------------------------------------------------------------------
# AI-generated NPC responses via OpenAI
# Set enabled: true and enter your API key to replace static YAML messages with dynamic AI responses.
# Falls back to interactions_XX.yml messages automatically if the API call fails or is disabled.
# model: recommended "gpt-4o-mini" (fast and cheap) or "gpt-4o" (higher quality)
# -------------------------------------------------------------------------------------------------------------------
openai:
enabled : false
api-key : "" # Insert your own OpenAI API key here: https://platform.openai.com/api-keys
model : "gpt-4o-mini"
Build families. Forge legacies. Live a life — one NPC at a time.
Resource Information
Author:
----------
Total Downloads: 2
First Release: Apr 24, 2026
Last Update: May 7, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings