Skip to content

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:

default
sitting
crouching
sleeping
arms_forward
arms_up

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.