Configuration

Configuration

Files

File	Used by	What it holds
config/loyalcompanions-server.properties	Dedicated servers	All gameplay settings below.
config/loyalcompanions-singleplayer.properties	Single player and LAN worlds	The same settings for your own worlds.
config/loyalcompanions-client.json	Every player	Personal HUD and theme settings, changed in game under HUD & Theme. Every setting is listed on the HUD page.
config/loyalcompanions-update.json	Servers and single player	The update check: whether players are told about a new version when they join.

The properties files are created with all defaults on the first start. Every setting is explained in the file itself, grouped like on this page, with its range and default. Changes need a restart. Chances are written from 0.0 (never) to 1.0 (always). Invalid values fall back to the default, values outside the range are clamped.

The JSON files (loyalcompanions-client.json, loyalcompanions-update.json) cannot hold comments; each starts with a _help entry that explains its settings.

Team and archive

Setting	Default	What it does
max_companions_per_player	3	Team slots per player, 1 to 6.
max_active_companions	1	How many team companions may be out at the same time, 1 to 6 (never more than the team slots).
archive_size	12	Places in each player's archive, 0 to 54. 0 switches the archive off.

Leveling

Setting	Default	What it does
max_companion_level	50	Highest companion level, 1 to 999.
enhanced_companion_chance	0.1	Chance that a bound companion is Enhanced.
rarity_rare_chance	0.1	Chance for Rare.
rarity_epic_chance	0.04	Chance for Epic.
rarity_legendary_chance	0.01	Chance for Legendary.
species_abilities_enabled	true	Switches the species abilities on or off.
ability_unlock_level	10	Level at which the species ability unlocks.
respec_item	minecraft:diamond	Item that resetting skill points costs. Leave empty to make it free.
respec_item_count	1	How many of that item. 0 makes it free.

Candies

Setting	Default	What it does
companion_candy_enabled	true	Switches Companion Candies on or off.
max_candy_bonus_points	100	Most skill points one companion can get from candies.
dragon_companion_candy_drop_chance	1.0	Chance that the Ender Dragon drops a Companion Candy.
dragon_greater_candy_drop_chance	0.35	Chance for a Greater Companion Candy.
dragon_legendary_candy_drop_chance	0.1	Chance for a Legendary Companion Candy.
dungeon_candy_loot_enabled	true	Candies, Crimson Labyrinth Gems and Wayfinder Amulets in dungeon, mineshaft, jungle and desert temple chests.
deep_dark_candy_loot_enabled	true	Candies in Ancient City chests.

Fighting and revival

Setting	Default	What it does
protect_mode_radius	10	Blocks around you in which Protect attacks monsters, 4 to 64.
aggressive_mode_radius	16	Blocks around the companion in which the hunt behaviors look for targets, 4 to 64.
companion_revive_enabled	true	A companion that falls leaves a Companion Totem. false: it is lost.
companion_heart_drop_chance	0.4	Chance that an Iron Golem drops a Companion Heart.
item_pickup_enabled	true	Allows companions to collect items.

Which mobs can be bound

By default every mob that is not a monster can become a companion.

Setting	Default	What it does
companion_entity_whitelist	empty	Comma separated mob ids that can always be bound, even monsters, e.g. minecraft:zombie_horse,minecraft:skeleton.
companion_entity_blacklist	empty	Comma separated mob ids that can never be bound, e.g. minecraft:villager.

Food overrides

companion_food_overrides sets the food of any mob, separated by ;. Each entry is the mob id, =, and the food items separated by |. A first part without : is used as the text shown in the menu.

companion_food_overrides=minecraft:wolf=minecraft:bone|minecraft:cooked_beef;examplemod:deer=Apples and carrots|minecraft:apple|minecraft:carrot