Storytime ships with two built-in trait types. Set the type field in a race's traits entry to one of these resource locations.

A race can have any number of traits, including multiple traits of the same type.


storytime:scare_entities

Makes the listed entity types flee from the player.

Parameters

Name Type Required Default Description
entities array of strings yes โ€” Entity type resource locations to scare
radius number no 16.0 Detection radius in blocks
flee_distance number no 6.0 Distance entities try to flee to
flee_speed number no 1.5 Speed multiplier applied to fleeing entities

Behaviour

Storytime attaches a flee AI goal to matching entities when they come within radius blocks of the player. The entity attempts to move to at least flee_distance blocks away. The flee speed is applied as a multiplier on top of the entity's normal movement speed.

Entities that are in combat or otherwise prevented from fleeing by their own AI may not respond consistently.

Example

{
  "type": "storytime:scare_entities",
  "parameters": {
    "entities": ["minecraft:creeper", "minecraft:phantom", "minecraft:spider"],
    "radius": 20.0,
    "flee_distance": 8.0,
    "flee_speed": 2.0
  }
}

storytime:reduced_saturation

Reduces the saturation restored when the player eats food.

Parameters

Name Type Required Default Description
multiplier number yes โ€” Fraction of normal saturation restored (e.g. 0.5 = half)

Behaviour

When the player consumes food, Storytime intercepts the saturation gain and multiplies it by multiplier. Setting multiplier to 0.0 removes all saturation gain. Values above 1.0 increase saturation gain.

This trait only affects saturation, not the hunger (food level) restored.

Example

{
  "type": "storytime:reduced_saturation",
  "parameters": {
    "multiplier": 0.3
  }
}

See also