RealSize

Scales Minecraft mobs to configurable real-world proportions.

RealSize is a server-side Fabric mod that applies the native scale attribute to mobs, keeps small mobs visible by raising tracking distance when needed, and boosts step height for large scaled mobs.

Builds in this repo

This branch now builds two Fabric jars from shared configurable logic:

Both platform jars include the shared common classes in the final mod jar.

Features

• JSON config at config/realsize.json
• Shared data-driven entity scale table keyed by registry ID
• Small-mob tracking range boost driven by config thresholds
• Large-mob step-height boost driven by config thresholds
• 1.21.11-only mob compatibility on the 1.21 build via registry-ID lookup (minecraft:nautilus, minecraft:zombie_nautilus) instead of compile-time entity constants

Configuration

RealSize writes config/realsize.json on first launch.

How to use the config

1. Start the game or server once with the mod installed.
2. Open config/realsize.json.
3. Change the global limits or add/edit entries in entityScales.
4. Restart the game or server to apply the new values.

What each field does

• floor — minimum allowed scale after config values are read. Anything lower gets clamped up to this value.
• cap — maximum allowed scale. Anything higher gets clamped down to this value.
• trackingRangeThreshold — if a mob ends up below this scale, RealSize boosts tracking so it stays visible from farther away.
• minTrackingRangeChunks — minimum chunk-based tracking range used for tiny mobs.
• minTrackingDistanceBlocks — hard minimum block distance used for tiny-mob tracking.
• stepHeightBoostThreshold — if a mob is at or above this scale, RealSize adds extra step height.
• stepHeightBoostAmount — how much extra step height large mobs get.
• entityScales — per-entity scale overrides keyed by registry ID such as minecraft:bee.

Example

{
  "floor": 0.22,
  "cap": 1.45,
  "trackingRangeThreshold": 0.6,
  "minTrackingRangeChunks": 10,
  "minTrackingDistanceBlocks": 128,
  "stepHeightBoostThreshold": 1.1,
  "stepHeightBoostAmount": 0.5,
  "entityScales": {
    "minecraft:bee": 0.25,
    "minecraft:horse": 1.05,
    "minecraft:nautilus": 0.4,
    "minecraft:zombie_nautilus": 0.4
  }
}

Practical examples

• Make bees easier to see without changing anything else: lower only minecraft:bee in entityScales.
• Keep extremely small mobs from disappearing too early: raise minTrackingDistanceBlocks or minTrackingRangeChunks.
• Stop giant mobs from getting too large: lower cap.
• Help oversized mobs walk over terrain more naturally: lower stepHeightBoostThreshold or raise stepHeightBoostAmount.

Building

From the repository root:

./gradlew :common:test :mc121:build :mc2612:build

Artifacts:

• mc121/build/libs/realsize-mc121-<version>.jar
• mc2612/build/libs/realsize-mc2612-<version>.jar

Installation

1. Pick the jar for your Minecraft version:
   • realsize-mc121-<version>.jar for Minecraft 1.21.1 through 1.21.11
   • realsize-mc2612-<version>.jar for Minecraft 26.1.2 / 1.26.1.2
2. Drop that one jar into mods/ with the matching Fabric Loader and Fabric API modules.
3. Start once to generate config/realsize.json.
4. Edit config if desired and restart.