Mob Properties Mod Wiki

The Mob Properties Mod, developed by Father Toast, is a comprehensive configuration tool designed to give players total control over mob spawning and attributes. Unlike traditional mods that add new creatures, this mod acts as a framework to modify existing ones—whether they are from vanilla Minecraft or other mods.

By using a JSON-based scripting system (in 1.10.2) or a custom property format (in 1.7.10), users can adjust health, speed, attack damage, equipment, and loot tables. This makes it an essential tool for creating themed modpacks, increasing difficulty, or balancing gameplay mechanics.

The mod operates by reading configuration files located in the .minecraft/config/MobProperties directory. The files are organized by Mod ID and Entity Name.

Directory Structure

• config/MobProperties/: The root folder.
• /: A subfolder for each mod (e.g., minecraft, specialmobs).
• .json: The specific configuration file for a mob (e.g., zombie.json).

Scripting Logic

The mod uses a hierarchical logic system consisting of Conditions and Functions.

1. Conditions: Determine when a change should occur (e.g., if the mob is in a specific biome or at a certain height).
2. Functions: Determine what changes occur (e.g., setting health to 100 or giving the mob a diamond sword).

Conditions allow for precise targeting of mob modifications. You can nest conditions to create complex requirements.

Logical Operators

• all_of: Returns true only if every nested condition is met.
• any_of: Returns true if at least one nested condition is met.
• none_of: Returns true only if none of the nested conditions are met.

Functions are the actions applied to the mob once conditions are met. These can modify the mob's physical stats, inventory, or metadata.

Attribute Modification

You can modify the base attributes of any mob using the stats function. These values override the default Minecraft settings.

Potion Effects

The potion function applies status effects to the mob upon spawning. You can set the effect ID, duration, and amplifier (strength).

NBT Modification

For advanced users, the nbt function allows direct editing of the mob's NBT tags. This can be used to set specific Creeper fuse times, Sheep wool colors, or Villager professions.

Mob Properties allows for complete control over what a mob drops upon death, including rare drops and experience points.

• add: Adds a new item to the mob's loot table. You can specify the item ID, metadata, stack size, and drop weight.
• remove: Removes a specific item from the mob's default loot table.
• clear: Removes all default drops from the mob, allowing for a completely custom loot table.
• xp: Sets the amount of experience points dropped on death.

Drop Example (JSON)

{
 "drops": {
 "clear": true,
 "add": [
 {
 "item": "minecraft:emerald",
 "weight": 0.1,
 "count": "1-3"
 }
 ]
 }
} 

You can force mobs to spawn with specific armor and weapons. This applies to any mob, even those that do not normally wear equipment (though they may not render it visually).

Equipment Slots

• mainhand: The item held in the right hand.
• offhand: The item held in the left hand (1.10.2+).
• head: Helmet slot.
• chest: Chestplate slot.
• legs: Leggings slot.
• feet: Boots slot.

Each slot can be assigned a drop_chance, determining if the player can loot the item after killing the mob.

The mod includes administrative commands to help test and apply changes without restarting the Minecraft client or server.

• /mobprop reload: Reloads all configuration files from the disk. This is extremely useful for iterative testing of drop rates or stat balances.
• /mobprop debug: Toggles debug mode, which prints detailed information to the console whenever a mob spawns, showing which conditions were met and which functions were applied.

The 'Choose' Function

The choose function allows for randomized variety. You can define a list of different function blocks, and the mod will pick one based on assigned weights. This can be used to create "Elite" or "Boss" versions of standard mobs that only spawn occasionally.

Command Execution

The command function allows the mod to execute a console command when a mob spawns. This can be used to trigger world events, send messages to players, or interact with other mods' systems (e.g., giving a player a quest update when a specific mob spawns nearby).