Appearance, skins, equipment, and portraits¶
Appearance settings control several separate pieces: the world model, its floating name, the physical hitbox, equipment, and the optional dialogue portrait. A change to one does not automatically configure the others.
Humanoid skin sources¶
Choose Skin Source before entering Skin:
| Source | Skin value | Notes |
|---|---|---|
player |
A Minecraft profile name, such as Notch |
Loads the profile's skin and original arm model |
url |
A direct http:// or https:// PNG URL |
Choose slim or default under URL Skin Model |
texturepack |
A skin name provided by a loaded NPC resource definition | Selects the matching skin-<name> variation |
For URL mode, use a link to the image itself, not a web page containing the image. The image and profile must be reachable from the environment that loads them. Use slim for narrow arms and default for wide arms; the URL model selection does not override the original model of a player-profile skin.
For example, set Skin Source to player and Skin to Notch, save, and wait for the profile skin to load. For your own hosted skin, switch the source to url and replace the Skin value with your actual direct PNG URL.
Resource-pack mode is variation-based. GreatNPC derives the variation name from the final filename/name, strips .png, lowercases it, and keeps letters, digits, _, and -. A value ending in shopkeeper.png therefore selects skin-shopkeeper. The loaded NPC model/resolver must define that variation. Dropping an arbitrary PNG into a guessed texture folder does not register a new variation.
Name, scale, brightness, and hitbox¶
| Setting | Meaning |
|---|---|
| Name | Floating name; supports the mod's text formatting |
| Hide Name | Hides the floating name |
| Transparent Name Background | Removes its dark backing |
| Shadow | Enables/disables the entity's rendered shadow |
| Visual Scale | Render size multiplier; 1 is the normal size |
| Light Level | -1 uses ambient light; 0–15 fixes visual brightness |
| Show Level Above Name | Adds a separate level label |
| Level Label | 1–100, or X, XX, XXX to conceal the value |
A fixed Light Level changes how the NPC is rendered; it does not illuminate surrounding blocks.
Hitbox width and height are in blocks. Editor values are 0–4, where 0 requests the model/default behavior. Humanoids can use Fit Hitbox to Pose for dimensions left at zero. A nonzero explicit width or height takes priority over pose fitting. Pokémon have their own width/height fields.
Allow Blocks Inside Hitbox changes block-placement handling without removing interactions or changing the configured hitbox dimensions.
Humanoid body poses¶
The built-in Pose values are:
Open the 3D pose editor for per-part adjustments. Humanoid parts include the whole model/root, body, torso, head, left/right arms, and left/right legs. The editor provides move/rotate/scale controls, standard camera views, frame-to-selection, visibility, symmetry, mirroring, copy/paste, reset, and undo/redo.
Position adjustments are measured in pixels (16 px = 1 block), rotation is in degrees, and scale 1 means unchanged. Save/apply the pose editor and then save the NPC editor to persist the result. Copying a pose through the clipboard does not copy the NPC's battle history, identity, or team.
Breathing Animation and Blinking are independent humanoid options. For locked facing and head movement, see Movement.
Pose editor controls¶
These shortcuts act on the model when you are not typing in a text field:
| Control | Action |
|---|---|
| Left-drag an axis/rotation handle | Edit the selected transform |
| Left-drag empty preview space | Orbit the camera |
| Right-drag or middle-drag preview space | Pan the camera |
| Mouse wheel over preview | Zoom |
W, E, R |
Move, rotate, scale |
F |
Frame the selected part |
H |
Toggle part visibility |
N |
Toggle snapping |
S |
Toggle symmetry |
Delete |
Reset selected part |
Ctrl+Z |
Undo |
Ctrl+Y or Ctrl+Shift+Z |
Redo |
Ctrl+C, Ctrl+V |
Copy/paste the selected part |
1–8 |
Select an entry in the currently visible part list |
Use the buttons for Copy All/Paste All when transferring a full pose. The numeric fields also support mouse-wheel adjustments; Ctrl makes the step finer and Shift makes it larger. These wheel modifiers are distinct from dragging a transform handle, where Shift enables fine control.
Triggered animations¶
The Animations section is separate from the base pose. Set an animation supported by the active model for each event:
| Field | Trigger |
|---|---|
| Interaction Animation | A player interacts with the NPC |
| Battle Start Animation | Its trainer battle starts |
| NPC Victory Animation | The NPC wins the battle |
| NPC Defeat Animation | The NPC loses the battle |
| Idle Animation | Periodically outside battle |
| Idle Animation Interval | Delay between idle-animation plays; default 30 seconds |
Victory/defeat labels refer to the NPC's result. Leave the event animation blank when no explicit animation is wanted; the victory/defeat fields permit the normal Cobblemon behavior. Animation names are model-specific. A suggested name is safer than inventing one, and a humanoid animation name need not exist on a Pokémon species model.
Equipment editor¶
Open Equipment Editor to copy items from your inventory onto the NPC. The six equipment slots are head, chest, legs, feet, main hand, and off hand.
- Click an occupied equipment slot to clear it.
- Drag an inventory item onto the target equipment slot.
- Click/release an inventory item on its original cell to send it to its natural equipment slot.
- Right-click or Shift-click an inventory item to copy it to the off hand.
- Use Copy My Equipment, Undo Changes, or Clear All as needed.
These operations configure the NPC; they do not transfer inventory items out of your player inventory. The editor copies one item into an equipment slot. Components such as color, name, and enchantments are preserved by item-spec serialization.
Some object editors, including trade costs/rewards, use a separate Choose from Inventory screen. It shows the inventory, hotbar, armor, and offhand. Select a nonempty cell to copy the item and its components, or use Back/Escape to cancel. Configure the trade quantity separately. Shift-clicking the picker field in the object form clears its saved item data.
Dialogue portraits¶
Dialogue Portrait chooses what appears in the dialogue box:
| Value | Portrait |
|---|---|
npc |
The NPC itself |
off |
No portrait |
pokemon |
A separately selected species/aspect/Shiny appearance |
human |
A separately selected humanoid skin |
Position can be top_right, top_left, bottom_right, or bottom_left; the default is top_right.
Pokémon portrait mode has its own species, aspects, and Shiny controls. Human portrait mode has its own skin source, skin value, and arm model. The portrait settings do not change the NPC in the world.
The shopkeeper inside the trading GUI is another preview path. Posed-NPC trade preview issues remain a known limitation; changing the dialogue portrait is not a fix for that rendering path.