v21.1 - Name Tags & Advanced Portraits

Pokémon Essentials Version: v21.1 ✅

Also compatible with

An advanced portrait and name tag system for Pokémon Essentials v21+

Originally by Mr. Gela | Updated by Swdfm for v1.0 | Updated by Aten2049 for v2.0

If you can't find the download link above: Github

Requirements

Pokémon Essentials v21 or v21.1
Swdfm's Modular Messages Plugin (v2025.04.25 or later)
Ensure that FaceWindowVX is not used in any other scripts or that it is compatible with this script

Features

Portrait System

Multiple Portrait Sources: Automatically searches Graphics/Faces/, Graphics/Pictures/, and Graphics/Trainers/
Smart Scaling: Default 192x192 pixel portraits with automatic scaling for smaller images
Portrait Flipping: Manual (append "_f" to filename) or automatic based on side
Portrait Silhouettes: Manual (append "_b" to filename).
Smooth Animations: Configurable sliding animations when portraits change

Name Tags

Flexible Positioning: Configurable offsets and alignment options
Custom Windowskins: Support for light and dark name tag themes
Automatic Sizing: Minimum width settings with dynamic resizing

Advanced Features

Dual Portraits: Display two portraits simultaneously
Portrait Memory: Remembers last used portraits and names for easy reuse
Animation Control: Enable/disable animations with customizable timing
Performance Optimized: Efficient bitmap processing and memory management

Commands

Basic Portraits

Code:

\ml[filename]             → Left portrait with specified file
\ml                       → Left portrait with previous file
\mr[filename]             → Right portrait with specified file
\mr                       → Right portrait with previous file

Name Tags

Code:

\xn[name]                 → Name tag with specified name
\xn                       → Name tag with previous name
\dxn[name]                → Dark name tag with specified name
\dxn                      → Dark name tag with previous name

Combined Name Tags and Portraits

Code:

\xpl[name,filename]       → Left portrait with name and specified file
\xpl[name]                → Left portrait shortcut (name = filename)
\xpl                      → Left portrait with previous file and name
\xpr[name,filename]       → Right portrait with name and specified file
\xpr[name]                → Right portrait shortcut (name = filename)
\xpr                      → Right portrait with previous file and name

Dual Portraits

Code:

# This does not create a nametag. You need to use the \xn command still.
\plr[left,right]          → Dual portraits with specified files
\plr                      → Dual portraits with previous files

System Control
This should be used at the very end of a conversation or between long pauses so the animations get reset properly.

Code:

\xpend                    → Reset portrait system for fresh conversations.

Example Script

Code:

\xpl[Corinthia]Tucker, have you gotten your team ready for your Gym Partnership entry battle yet?
\xpr[Tucker]I've got everything set. I filled out all the forms and...
\plr[Corinthia_f, Tucker]\xn[Corinthia]...and?
\plr\xn[Tucker]Well, I'm only missing one item for my team to be ready.
\plr\xnI need to get some Safety Goggles in order to make sure my Tyranitar is good to go.
\plr\xnThe problem is that the only pair I know is at the top of Mt. Aeren.
\xpl[Corinthia]A trecherous journey indeed.
\xpr[Tucker]Do you think you can buy me some time?
\xpr...
\xpl[Corinthia]...
\xpl...
\xplI can buy you a day at most. Get to it.
\plr\xn[Tucker]Thank you, Corinthia. You won't regret it! Me and my sand team will be unstoppable!
\xpl[Corinthia]I do hope he realizes that he's suposed to be a challenge to beat, not unbeatable.
\xplWe DO want trainers getting to the Elite Four after all...
\xpl[Corinthia]*sigh*\xpend

Portrait Guidelines

File Formats

Recommended Size: 192x192 pixels or multiples of 32 (128x128, 160x160)
Supported Formats: PNG recommended

File Locations (searched in order)
1. Graphics/Faces/
2. Graphics/Pictures/
3. Graphics/Trainers/

Naming Conventions

Flipped Portraits: Add _f suffix (e.g., portrait_f.png)
Portrait Silhouette: Add _b suffix (e.g., portrait_b.png or portrait_fb.png)
Face Grid Index: Use comma notation (e.g., faceset,0 for first face)

Dependencies & Installation

This add-on requires the Swdfm Modular Messages Plugin. Make sure to install it first:

Place the addon file inside of the Modular Messages/Add Ons folder.

Credits: Original Plugin by Mr. Grela
Addon v1.0 by Swdfm, Golisopod User, mej71, and battlelegendblue

Reactions: SirEnder2Me, Otorian, Bergium and 2 others

v21.1 Name Tags & Advanced Portraits 2.0

Ratings

Share this resource