PeepsNPC

English · Français

Simple, lightweight NPCs for Paper: floating text, NPCs that look at players, click actions, shops with a GUI editor, and player skins. No packets, no dependencies. Messages in English and French.

Features


Floating text above every NPC, with a configurable view distance


Looks at players who come close


Click actions: run a command as the player or from the console, send messages


Shops: buy and sell items through a GUI editor, no config file needed (sneak + right-click the NPC)


Skins: any Minecraft username, or a custom texture from mineskin.org


Any living mob as an NPC: villager (with profession), iron golem, fox, zombie, piglin, human mannequin...


Equipment: the NPC wears your armor and held items


Templates in config.yml to create ready-made NPCs in one command


English & French built in, and you can add your own language


NPCs are invulnerable, silent, don't move, and can't be targeted by mobs

Requirements


Paper 1.21.9+ (for human/mannequin NPCs)


Java 21


Optional: Vault + an economy plugin (EssentialsX, CMI...) for shops

Commands

Main command:
/npc
(aliases:
/pnj
,
/peepsnpc
)

Command
Description
/npc create <id> [template]
Create an NPC at your position
/npc list
List all NPCs
/npc info <id>
Show an NPC's details
/npc text <id> <line 1 | line 2>
Set the floating text (
none
to remove)
/npc distance <id> <blocks>
Distance at which the text disappears
/npc look <id> <blocks|no>
Look at nearby players
/npc action <id> <command>
Add a click command (
console: ...
to run it from the console,
none
to clear)
/npc message <id> <text>
Add a click message (
none
to clear)
/npc shop <id>
Open the shop editor
/npc shop <id> add <buy> [sell]
Add the item in your hand to the shop
/npc shop <id> list | remove <n> | clear | title <text>
Manage the shop
/npc skin <id> <username>
Use a player's skin (
texture <value> [signature]
for a custom one,
none
to remove)
/npc equipment <id>
The NPC wears what you're wearing (
none
to remove)
/npc type <id> <mob>
Change the appearance
/npc profession <id> <profession>
Villager profession
/npc baby <id>
Toggle baby / adult
/npc template <id> <template>
Apply a template
/npc templates
List the templates
/npc move <id>
Move the NPC to your position
/npc tp <id>
Teleport to the NPC
/npc delete <id>
Delete the NPC
/npc reload
Reload the config and messages

Tip: sneak + right-click an NPC to open its shop editor.

Placeholders in actions and messages:
%player%

Permissions

Permission
Description
Default
peepsnpc.admin
Use every
/npc
command and edit shops
OP

Players don't need any permission to click NPCs or use shops.

English

In
config.yml
:

language: en # en or fr

Every message is in
plugins/PeepsNPC/lang/
. Edit them freely, or copy
en.yml
to
de.yml
(for example) and set
language: de
. Commands work in both languages (
/npc create
=
/pnj creer
).


Français

Des PNJ simples et légers pour Paper : texte flottant, PNJ qui suivent les joueurs du regard, actions au clic, boutiques avec éditeur en menu, et skins de joueurs. Pas de packets, aucune dépendance. Messages en français et en anglais.

Fonctionnalités


Texte flottant au-dessus de chaque PNJ, avec une distance d'affichage réglable


Suit du regard les joueurs qui s'approchent


Actions au clic : lance une commande (par le joueur ou la console), envoie des messages


Boutiques : achat et revente d'objets avec un éditeur en menu, sans toucher à la config (accroupi + clic droit sur le PNJ)


Skins : n'importe quel pseudo Minecraft, ou une texture perso de mineskin.org


N'importe quel mob vivant comme PNJ : villageois (avec métier), golem de fer, renard, zombie, piglin, humain (mannequin)...


Équipement : le PNJ porte ton armure et tes objets en main


Modèles dans config.yml pour créer des PNJ tout prêts en une commande


Français et anglais inclus, et tu peux ajouter ta propre langue


Les PNJ sont invincibles, silencieux, immobiles et ignorés par les monstres

Prérequis


Paper 1.21.9+ (pour les PNJ humains/mannequins)


Java 21


Optionnel : Vault + un plugin d'économie (EssentialsX, CMI...) pour les boutiques

Commandes

Commande principale :
/pnj
(alias :
/npc
,
/peepsnpc
)

Commande
Description
/pnj creer <id> [modele]
Crée un PNJ à ta position
/pnj liste
Liste des PNJ
/pnj info <id>
Détails d'un PNJ
/pnj texte <id> <ligne 1 | ligne 2>
Texte flottant (
aucun
pour l'enlever)
/pnj distance <id> <blocs>
Distance où le texte disparaît
/pnj regard <id> <blocs|non>
Suivre les joueurs du regard
/pnj action <id> <commande>
Ajoute une commande au clic (
console: ...
pour la lancer par la console,
aucune
pour tout retirer)
/pnj message <id> <texte>
Ajoute un message au clic (
aucun
pour tout retirer)
/pnj boutique <id>
Ouvre l'éditeur de boutique
/pnj boutique <id> ajouter <achat> [revente]
Ajoute l'objet en main à la boutique
/pnj boutique <id> liste | retirer <n> | vider | titre <texte>
Gérer la boutique
/pnj skin <id> <pseudo>
Skin d'un joueur (
texture <value> [signature]
pour un skin perso,
aucun
pour l'enlever)
/pnj equipement <id>
Le PNJ porte ce que tu portes (
aucun
pour l'enlever)
/pnj type <id> <mob>
Change l'apparence
/pnj metier <id> <metier>
Métier du villageois
/pnj bebe <id>
Bébé / adulte
/pnj modele <id> <modele>
Applique un modèle
/pnj modeles
Liste des modèles
/pnj deplacer <id>
Déplace le PNJ à ta position
/pnj tp <id>
Se téléporter au PNJ
/pnj supprimer <id>
Supprime le PNJ
/pnj reload
Recharge la config et les messages

Astuce : accroupi + clic droit sur un PNJ pour ouvrir l'éditeur de sa boutique.

Variable dans les actions et messages :
%joueur%
(ou
%player%
)

Permissions

Permission
Description
Par défaut
peepsnpc.admin
Toutes les commandes
/pnj
et l'édition des boutiques
OP

Les joueurs n'ont besoin d'aucune permission pour cliquer sur les PNJ ou utiliser les boutiques.

Langue

Dans
config.yml
:

language: fr # fr ou en

Tous les messages sont dans
plugins/PeepsNPC/lang/
. Tu peux les modifier, ou copier
en.yml
en
de.yml
(par exemple) et mettre
language: de
. Les commandes marchent dans les deux langues (
/pnj creer
=
/npc create
).