Disguise Mod — Guide

Mechanics

The core mechanic of the mod revolves around the player's inventory. By holding or wearing an item defined in the disguise.cfg file, the player's model is replaced by the model of the target entity.

Transformation Rules

• Item Trigger: Transformations are active as long as the player is holding or wearing the designated item.
• Stealth Mechanic: Disguising as a hostile mob (e.g., a Skeleton) will prevent other Skeletons from attacking the player unless the player initiates combat first.
• Hitbox and Perspective: While the visual model changes, the player's physical hitbox and camera height generally remain consistent with the standard player model to ensure gameplay stability.
• Multiplayer Sync: All players on a server will see the disguised player as the entity specified, making it ideal for roleplay and stealth missions.

Data Watcher Specification

The extraData section allows for precise control over entity variants (such as baby animals, colored sheep, or Wither Skeletons) by checking the entity's Data Watcher values.

Data Types

Each bit of extra data requires a type, an id, and a value. The id must be an integer between 0 and 31.

Special Formats

• ItemStack (Type 5): Requires the full mod ID and metadata. Example: "minecraft:wool:14" for Red Wool.
• BlockPos & Rotations (Type 6 & 7): Coordinates or rotation values must be enclosed in quotes and separated by semicolons (;).