Entity Configurations

Relique does not limit equipment slots exclusively to players. Using Entity Configurations, you can assign relic slots to any living entity. This includes standard vanilla mobs as well as custom entities registered through the AbyssalLib CustomEntity API.

This allows mobs to actually equip relics, benefit from their attribute modifiers, and potentially drop them upon death depending on the slot's drop rules.

File Structure

Entity configurations are loaded based on their namespace. Where you place these files depends on whether you are configuring a live server or developing an add-on.

For Server Owners: To create an entity configuration, place a JSON file in your server's plugin directory: plugins/Relique/relic/<namespace>/entities/<config_id>.json

For example, to give zombies a ring slot, you might create: plugins/Relique/relic/relique/entities/zombie_slots.json

For Developers: To bundle entity configurations inside your own plugin jar, place the JSON files inside your project's src/main/resources folder: src/main/resources/relic/<your_plugin_id>/entities/<config_id>.json

JSON Format

Below is an example of an entity configuration file. It maps a list of entity types to a list of slot IDs.

{
  "entities": [
    "minecraft:zombie",
    "minecraft:skeleton",
    "my_addon:custom_boss"
  ],
  "slots": [
    "ring",
    "charm"
  ]
}

Configuration Fields

The JSON file requires two arrays to function correctly.

Field	Type	Description
`entities`	List<String>	A list of entity type IDs that will receive these slots. This strictly accepts standard vanilla namespaced keys (e.g., `minecraft:zombie`) as well as custom entity IDs registered natively through AbyssalLib's `CustomEntity` API.
`slots`	List<String>	A list of registered slot IDs (e.g., `ring`, `charm`, or your own custom slots) to grant to the specified entities.

07 May 2026