EMI Compendium reference
Mod version shipped with FlammiCraft: 0.13.0
Viewers
- Chest and trial chamber loot, block drops, mob drops, fishing and other gameplay loot, and archaeology. Displays include probabilities and parsed conditions.
- Enchantment information: supported items, maximum levels, curses, trading, descriptions when supplied by language resources, and incompatible enchantments.
- Ore generation: biome lists, height graphs, generation attempts, vein sizes, and associated block drops. Reads standard ore features in the underground ore and decoration stages, with optional Mekanism ore support.
- Searchable status effects with descriptions, effect categories, colors, and
sources such as potions, tipped arrows, foods, suspicious stew, and beacons.
Sources are grouped and paginated, with effect levels, durations and application
chances. Distinct suspicious-stew variants remain separate. Arrow and lingering
potion durations use their respective duration scaling.
Resource packs can add sources in
assets/<namespace>/emicompendium/extra_stacks. - Villager professions and their workstation blocks, including modded professions. Use the EMI uses key on an emerald or villager spawn egg to browse them.
- Trading sources for obtainable items: villager professions and levels, villager variants, wandering traders, and piglin bartering. No prices or payment items are displayed or indexed. A separate category shows the obtainable items from the currently open merchant menu.
- Pattern encoding from the current EMI crafting tree in AE2 or Refined Storage terminals. Existing patterns can be read from the corresponding access terminal or autocrafter manager to avoid duplicate outputs.
- Breeding, taming, trust, temper, allay duplication and animal transformations. Look up food uses or spawn-egg recipes/uses for the corresponding animals, additional requirements, variants and item results. These informational entries cannot craft items or spawn animals.
All addon code, categories, packet channels, and resources use emicompendium
and de.taker.emicompendium. The author shown in mod metadata is taker.
Runtime registrations use the shared identity in EMICompendium. The category
ordering file resides under assets/emi/category/properties because EMI requires
that namespace for its integration format; all category IDs inside it still use
emicompendium.
Direct-drop definitions use data/emicompendium/direct_drops/<path>.json. Each
definition requires an explicit target loot-table ID, such as
minecraft:entities/creeper. Referenced items, entities and loot tables retain
their owning mod's IDs. No previous resource layout, namespace aliases or
automatic migration is supported.
Requirements and data
EMI 1.1.29 or newer is required on the client. Configuration and loot synchronization use NeoForge directly; Fzzy Config is no longer required. Dependencies are separate mods and are never bundled. Mekanism is optional. AE2 19.28.0 or newer is optional for pattern encoding. Alternatively, use Refined Storage 2.0.1 or newer with its EMI integration 1.0.0 or newer. These encoding integrations use the storage mod's normal server-validated menu actions. An optional server component sends an opaque identity for the network of the player's already-open terminal; the addon introduces no serverbound encoding packets.
Install EMI Compendium on the server as well to receive its loot, world-generation information and trade catalogue. Enchantment information uses the current client's synced registries. Data packets only travel from server to client and do not grant items, permissions, or world access. Clients without the addon can connect to a server running it. Connections to servers without it have no loot, ore or trade-catalogue datasets. Disconnecting clears those datasets; information from a previous world is not retained as a substitute.
Empty viewers explain missing, incoming, empty, disabled or failed server data. Received datasets update EMI automatically after a short quiet interval. All addon interface and configuration text is available in English and German. Data already included in the current EMI build does not trigger another rebuild. Updates received during or after registration still refresh the viewers.
Trading
The Trading category reads the server's active trade rules, including NeoForge trade-event additions and the trade-rebalance feature flag for villagers and wandering traders. Look up an item's recipes to see who can supply it and the required profession level or villager variants. Payment items are not recipe inputs or category workstations. Equivalent sources across villager variants and price changes are grouped. A catalogue entry is a possible offer; individual merchants only carry a selection.
Enchanted-book previews enumerate the permitted enchantments and levels.
Randomized built-in providers show up to 16 deterministic examples per rule,
using the same samples across supported villager variants.
These examples do not enumerate every possible random enchantment, color or
potion. Exact NeoForge BasicItemListing providers are supported, including
modded items and professions. Arbitrary mod callbacks are not executed for
preview; unsupported rules show a diagnostic entry explaining how to view the
merchant's actual offers. Explorer maps are templates: generating the catalogue
does not search for structures, generate chunks, or create saved map data.
Piglin bartering reuses the server-supplied gameplay loot data, preserving loot conditions, selection estimates, quantity rules and incomplete-data warnings. Each result has its own source page, identifying adult piglins and the random selection of barter results. These entries move from Gameplay drops to Trading to avoid duplicate pages. Changes to the piglin barter loot table are included; unrelated custom mod barter systems require a dedicated integration.
To view Current merchant offers, open a merchant's standard trading menu and then EMI. This category uses the normal server-sent merchant offers and shows obtainable items and remaining trades. The displayed merchant level is its current level, not the original unlock level of each offer. It works without the addon on the server. Its snapshot clears when the merchant menu closes or the connection ends. The catalogue cannot open a trade, grant items or bypass a merchant menu.
Animals
The six animal categories include 124 vanilla definitions and 980 optional mod
definitions. Optional definitions load only when their owning mod is present.
Their entity, item and tag IDs retain the owning mod's namespace. The categories,
definition types, dataset IDs and translation keys belong to emicompendium.
Alex's Mobs food definitions match Continued 2.22.0, including its carnivore-food
tags and the Tasmanian Devil's howling-food exclusion. TDAnimals red pandas
(tdanimals:redpanda and tdanimals:himalayan_redpanda) use bamboo for
breeding and taming.
Install EMI Compendium on the server for animal information. Singleplayer uses
its integrated server automatically. Definitions use
data/emicompendium/animal_interactions/<category>/<mod>/<name>.json and the six
emicompendium definition types. Datapacks can override or add definitions, and
NeoForge conditions can disable them. Run /reload after changing definitions.
The server sends bounded catalogue batches only to clients supporting the
optional emicompendium:animals channel (protocol 1). Completed snapshots update
EMI automatically; disconnecting clears the catalogue. Loading failures appear
in the viewers and identify the affected definitions in the server log.
Clients without the addon retain access to the server. No additional animal
configuration file is used.
Definitions describe possible interactions; spawn eggs are lookup links rather
than obtainable interaction rewards. The viewers do not execute mob callbacks,
alter breeding rules or simulate the installed mods. Item alternatives, extra
requirements, entity NBT variants, tamed/trusting requirements and item results
are preserved. Allay duplication also identifies the jukebox and cooldown
requirements. Unsupported entity previews are logged without removing item
lookups. The imported definition data retains its MIT copyright and permission
notice in licenses/animal-definitions-license,
also packaged in META-INF/licenses.
Configuration
All settings use NeoForge TOML configuration and its standard mod configuration screen:
config/emicompendium-client.toml: loot appearance, ore dataset grouping and hidden block IDs, plus pattern encoding delays, sound and input behavior.<world>/serverconfig/emicompendium-server.toml: enabled loot categories, direct drops and hidden condition keys. The server owns these values and NeoForge synchronizes them to connected clients. On dedicated servers the world directory is selected bylevel-name; singleplayer worlds use their save folder.config/emicompendium-common.toml: local diagnostic logging, independently configured on each client and server.
Run /reload after changing server loot settings. Rebuild EMI or reconnect after
changing loot layout or world-generation display settings, since recipe datasets
are cached. The old Fzzy settings, emicompendium-client.json and
emicompendium-patterns-client.toml are no longer read or written. Existing files
are left untouched; transfer any custom values into the new TOML files manually.
No automatic migration or fallback to the previous configuration systems runs.
Loot and trading synchronization uses protocol version 3 and requires the current complete packet layout. Client and server must use matching protocols; older chest and archaeology packet layouts are rejected.
Pattern encoding
Select the desired recipe tree in EMI, enable its crafting mode, and open the storage mod's pattern encoding terminal with blank patterns available. Press N (rebindable in Controls) to start. Encode operations run sequentially and wait for the server output and successful pickup. Pressing a key, clicking, or switching screens cancels the batch. A failed fill, unavailable output, or full inventory stops it without marking uncollected patterns as completed. Refined Storage encoding currently handles item outputs. Start, successful completion, cancellation, rejected actions, and timeouts are reported in chat with a next step.
Access-terminal results are reused only when the server identifies both terminals as belonging to the same network. Changing networks or disconnecting clears the remembered outputs. On servers without this identity response, remembered outputs are limited to the current menu session and a message explains the limitation.
Height graphs cover constant, uniform, and trapezoid distributions. Unsupported height providers are skipped rather than rendered as empty graphs. Graphs show relative generation estimates, not a survey of existing chunks or exact ore yields. Each graph is scaled to its own maximum; the marked heights identify its highest estimated density. Heights use the server's generation bounds for each dimension, including when dimensions share biomes. Fractional attempts and combined count/rarity placements are preserved. Count-provider averages use the midpoint of their minimum and maximum; non-uniform count providers, terrain, air exposure and additional placement filters can limit precision.
Ore synchronization uses protocol version 2; client and server need matching world-generation protocols. Servers without this addon remain supported as described above.
Loot entries show an Incomplete loot data line when a condition or function is unsupported or its parser fails. Hover it for the affected rule IDs. These warnings also appear in plain display mode and on chest and archaeology pages. They identify known parsing gaps; they do not certify that all remaining loot probabilities are exact.
Effect sources and food workstations are indexed once per EMI reload. Each reload builds a fresh index from current potion, flower, food and beacon data; extra resource-defined sources are appended to each recipe as before.
Loot preparation reuses selection details, and synchronization encodes identical descriptions once per send pass. Completed table packets are reused for later players in the same parsed snapshot. Datapack reload and changes of server registry context invalidate the packet cache; server shutdown clears the snapshot and resource references. Initial parsing and encoding still run on their existing threads. These changes do not establish a measured loading-time reduction.
Loot tooltips distinguish model selection weights within a pool, pool draw distributions and variable item quantities. Empty entries contribute their weight. Inline/nested table previews retain the outer selection weight and inner rolls. Context-dependent conditions, luck, functions and nested pools can still make these values estimates. A guaranteed result is marked only for a single, unconditional, fixed-roll output. Large condition sets use a compact final icon with every remaining condition in its tooltip. Row splitting is iterative, so large data cannot recurse indefinitely.
Entry, pool and table functions share one ordered preview path. Conditional mutations keep independent stack variants; later functions see both branches. Predicate descriptions combine simultaneous constraints. Ore drop previews merge all pools and apply sequential count rules; unresolved quantity bounds are labelled as context-dependent. Expected selections per loot generation are labelled as estimates and can exceed one; they are not a final drop probability. Representative stack counts are not quantity bounds. Very small positive numbers use a less-than indication instead of being rounded to zero or inflated to a fixed minimum.
Enchantment descriptions and larger supported-item lists use separate pages.
Looking up a book's recipes also finds loot sources using enchant_randomly,
including explicit modded enchantments, tag-restricted choices and all permitted
levels. Chest and archaeology pages retain their compact random-book display;
the recipe index includes the possible enchanted books. Entry selection values
apply to the whole random choice, not to each book variant. Level-based random
enchanting remains a generic preview.
Page counters, arrow tooltips, and the Left/Right arrow keys help navigate them.
Long names retain their full text in hover tooltips, and incompatible
enchantments are sorted by name.
Biome search supports full biome IDs, multiple terms and @mod filters. Search
results are rebuilt only when the query changes. Page Up/Page Down navigate the
results; resizing preserves the search and clamps the current page. Empty
results show a message, and small layouts do not divide by zero.