gently holds

For non-client options, configuration should match between server and client to avoid visual glitches. Install McQoy for a config GUI.

| Option | TOML name | Description | Type | Default | Note |
| —— | ——— | ———– | —- | ——- | —- |
| Entity Restriction | entity_restriction | Determines what entities can be picked up and when | Enum (see below) | All Animals | |
| Maximum Width | max_width | Entities must be this wide or below to be picked up | Float | 2.0 | |
| Maximum Height | max_height | Entities must be this tall or below to be picked up | Float | 2.0 | |
| Empty Hands | empty_hands | If players must have both hands empty in order to pick up entities | Boolean | Yes | |
| Spawn Drop | spawn_drop | If dropping an entity item in any manner should spawn the entity | Boolean | Yes | |
| Can Wear Hat | can_wear_hat | If entity items can be equipped in the head slot | Boolean | Yes | Requires restart
| Creative Tab | creative_tab | If a creative mode tab (item group) of most entities as items should be added | Boolean | Yes | Client only, requires relog |
| Animated | animated | If entity items should be animated in GUI | Boolean | Yes | Client only |
| Entity Whitelist | entity_whitelist | Entities that can always be picked up regardless of above requirements | String List | Empty | Requires restart |
| Entity Blacklist | entity_blacklist | Entities that can never be picked up regardless of above requirements | String List | Empty | Requires restart |

Entity Restriction

Players can never be picked up.

| Value | Description |
| —– | ———– |
| ANY | Any targetable entity can be picked up, including armor stands, vehicles, and attackable projectiles |
| LIVING | Any mob can be picked up |
| NON_BOSS | Any mob that is not a boss mob can be picked up |
| NON_MONSTER | All mobs that are not considered monsters can be picked up |
| NOT_AGGROED | All mobs that are not currently attacking a target, e.g. zombies attacking villagrs or wolves attacking sheep, can be picked up |
| NOT_AGGROED_PLAYER | All mobs can be picked up if they are not attacking you |
| ANIMAL | All animal mobs can be picked up |
| OWNED | Tameable pets owned by you |