Features

Skins

Set skin using player name or supported URL:

/menpc setskin shopkeeper Notch

Remote skin resolution can take time. Check logs for SocketTimeoutException when fetch fails. Retry after network recovery. Successful skin data is cached and reused on later spawn.

Animations

Animation names must exist in referenced ModelEngine model data. Configure default idle and interaction animations, then play one manually:

/menpc play guard idle

Use state configuration for idle or interaction behavior. If animation does not play, verify model animation name and inspect console output.

LookClose

Toggle LookClose for an NPC:

/menpc lookclose guard
/menpc lookclose guard 12

Check behavior with a player inside and outside configured radius. Final runtime compatibility remains under review until v2.0.1 evidence is available.

Interactions

Add action to click interaction:

/menpc interaction guard right add [message] Welcome

Left, right, or both click targets are supported. Default interaction cooldown and click enablement come from configuration.

Interaction Actions

Replace all actions with set, or remove them with clear:

/menpc interaction guard right set [message] Welcome
/menpc interaction guard right clear

Normal actions such as [message], [player], and [broadcast] should be preferred.

Interaction Security

Use least privilege for interaction authors. Do not treat user-controlled placeholders as trusted server command input. Test action with a non-privileged account before production use.

Holograms

Holograms require optional FancyHolograms dependency. Without it, core NPC functions continue but hologram features are unavailable.

/menpc hologram guard enable
/menpc hologram guard text Welcome
/menpc hologram guard addline Shop

Disable or remove lines when no longer needed. Verify dependency load status before troubleshooting command behavior.