MobHat Guide

This page introduces MobHat from a public server-docs point of view. It focuses on what the feature does in-game, how to get started when you have access, and which commands are useful.

What It Does

MobHat lets players wear a small whitelisted mob as a temporary cosmetic. It does not replace server’s normal /hat item feature. Instead, it owns /mobhat and can optionally bridge only the specific /hat mob … pattern into MobHat.

How Players Use It

Start with /mobhat. The sections below explain what MobHat is for, which commands players can try, and what to expect when your account has access.

Available features include:

• Cosmetic hats made from a safe whitelist of supported mob appearances.
• Direct selection, target-based selection, and optional /hat mob alias support.
• Baby variants and modern entity scale handling where the mob supports them.
• World restrictions and optional empty-inventory-slot requirements.
• Experimental shoulder and back offsets for controlled testing when enabled.
• Automatic cleanup on quit, death, world change, dismount, plugin disable, or stale state.

Quick Start

1. Start with /mobhat to open or view MobHat.
2. Use /mobhat status to check your current progress, settings, or state.
3. Use /mobhat help when you want the in-game help or a short explanation.
4. Try /mobhat info when you are ready to use one of the feature actions.

Commands

Command	What it does	Example
/mobhat	Opens or shows the main MobHat player view.	/mobhat
/mobhat help	Shows the MobHat commands available to you.	/mobhat help
/mobhat info	Shows a friendly explanation of what MobHat does.	/mobhat info
/mobhat status	Shows your current MobHat status.	/mobhat status
/mobhat list [page]	Lists available MobHat entries.	/mobhat list
/mobhat preview <type>	Previews a MobHat choice before applying it.	/mobhat preview oneblock
/mobhat mob <type>	Runs the MobHat mob action.	/mobhat mob oneblock
/mobhat target	Runs the MobHat target action.	/mobhat target
/mobhat position	Runs the MobHat position action.	/mobhat position
/mobhat position <head|back|shoulder-left|shoulder-right|reset>	Runs the MobHat position action.	/mobhat position head
/mobhat remove	Manages one of your MobHat entries.	/mobhat remove
/hat mob <type>	Runs the MobHat mob action.	/hat mob oneblock
/hat mob	Runs the MobHat mob action.	/hat mob

Examples

• /mobhat info
• /mobhat help
• /mobhat list
• /mobhat mob rabbit
• /mobhat mob armadillo
• /mobhat mob frog
• /mobhat mob turtle
• /mobhat position
• /mobhat position reset
• /mobhat target
• /mobhat remove
• /hat mob rabbit
• /hat mob
• /mobhat preview frog
• /mobhat preview turtle

Player FAQ

How do I wear or remove a mob hat?

Use /mobhat list to browse supported mobs, then /mobhat mob <type> or /mobhat target while looking at an allowed mob. /mobhat remove takes it off.

Does using a pet as a hat take the real pet?

No. The hat is a cosmetic copy. The targeted mob remains in the world unchanged.

Why did my hat disappear?

Mob hats are temporary. Quitting, dying, changing worlds, dismounting, or the feature being disabled can remove them. You can apply another hat when eligible.

Why can I not select a particular mob?

Only allowed mob types work, and some require extra access or an allowed world. The default safety settings also require an empty inventory slot. Check /mobhat status and the message shown.

Good To Know

• Some commands may be hidden until your group, event progress, or unlocks allow them.
• If a command opens a menu, follow the buttons in-game; the website is only the learning guide.
• Settings commands only change your own player preferences unless the page says otherwise.

Full Reference

The full synced MobHat reference is available for exact technical details.