Apothic Compat

A small server-side 1.20.1 Forge mod that fills in Apotheosis loot-category assignments for weapon/armor mods that don't set them. Uses the Apotheosis IMC override API, so nothing is patched or mixin'd.

What it does

Apotheosis uses loot categories to decide which affixes and gem sockets an item can roll. A lot of modded weapons either don't have a category at all or get the wrong one, so affixes never appear on them. Apothic Compat sends the right categories at load time.

Supported mods

Every module is a soft dep. A module only runs when both Apotheosis and the target mod are loaded.

• L'Ender's Cataclysm: full weapon, shield, and armor coverage
• Iron's Spellbooks: melee weapons only (staves, scythes, blades). Defers to Fallen Gems & Affixes when loaded.
• Tetra: fixes miscategorized bows, crossbows, and stabilizer-upgraded weapons
• Alex's Mobs: Blood Sprayer as bow
• Alex's Caves: spears, dagger, staves, ortholance, and gauntlet as swords. Primitive Club as heavy. Dreadbow and Raygun as bows.
• Spartan Weaponry: suffix-matched for all material variants
• Simply Swords: claymores, longswords, rapiers, katanas, cutlasses, twinblades, scythes, sai, warglaives, spears, and chakrams as swords. Glaives, halberds, greataxes, and greathammers as heavy weapons.
• Integrated Simply Swords: matches the Simply Swords mapping across cross-mod material variants. Alex's Caves Polarizer integration as heavy weapon.
• Enigmatic Legacy: Voracious Pan as sword, Axe of Executioner and Astral Breaker as heavy weapons
• Mowzie's Mobs: weapons and armor
• Bosses of Mass Destruction: Earthdive Spear as sword (older Obsidian Spear and Nether Staff entries retained for back-compat)
• Forbidden and Arcanus: Draco Arcanus axe as heavy, rest as swords
• Born in Chaos: scythes/axes/hammers as heavy, swords and daggers as swords
• Deeper and Darker: suffix-matched swords and knives
• Spartan Shields: all shields
• Knight Quest: supports both GPL (knightquest) and Count Grimhart (knight_quest) variants. Paladin Sword as heavy, other weapons as swords
• Aquamirae: weapons and armor
• Epic Knights: polearms and mauls as heavy weapons, shield overrides
• Spartan and Fire: Spartan-style additions handled via Spartan Weaponry compat
• Meet Your Fight: Dusk Greatsword as heavy, rest as swords, Bell Crossbow as crossbow
• Samurai Dynasty: katanas, kama, and spears as swords
• Dread Steel: scythe as heavy weapon, shield as shield
• Marium's Soulslike Weaponry: greatswords/scythes/glaives as heavy, spears/swordspears as swords, named legendaries pinned
• Dungeons and Combat: hammers as heavy weapons, pyromancer/sanguine/fairy/scepter of compensation as staffs when FG&A and Iron's Spellbooks are both loaded (otherwise sword)
• Weapons of Miracles: overrides for named weapons and armor
• Epic Fight: greatswords as heavy weapons; longswords, daggers, spears, tachis, bokken, uchigatana, and glove as swords
• EpicFight-Resurrection: greatswords and great tachi as heavy weapons, longswords as swords
• EpicFight-Nightfall: Ruins Greatsword and Ghiza's Wheel as heavy weapons
• Celestisynth: nine named weapons, mostly swords with Poltergeist as heavy and Rainfall Serenity as bow. Defers to Fallen Gems & Affixes when loaded.
• T.O Magic 'n Extras: boss weapons across all four upgrade tiers. Most as swords, Galenic Polarizer as heavy weapon, Trident of the Eternal Maelstrom as trident. Staffs as swords unless Fallen Gems & Affixes is loaded.
• RPG Style More Weapons: battle axes and greatswords as heavy weapons, knives as swords
• Malum: scythes (crude, soul stained steel, edge of deliverance, weight of worlds) as heavy weapons, tyrving and sundering anchor as swords. Scythes defer to Fallen Gems & Affixes' staffs category when it and Iron's Spellbooks are both loaded.
• Twilight Forest: Block and Chain as heavy weapon, the lifedrain/fortification/twilight/zombie scepters as swords, Mazebreaker Pickaxe as pickaxe, Ice Bomb as none. Standard swords, bows, axes, and pickaxes go through the universal fallback.
• The Undergarden: cloggrum, forgotten, froststeel, and utherium battleaxes as heavy weapons (they extend SwordItem, so the fallback alone would call them swords), spear as sword, slingshot as bow. Standard swords, axes, and pickaxes go through the universal fallback.
• Fallen Gems & Affixes: when present, Iron's Spellbooks, T.O Magic 'n Extras staffs, and Celestisynth skip our overrides so FG&A's Staffs and Celestial Melee/Ranged categories apply.

Handled by universal fallback

These mods extend the right vanilla classes (SwordItem, AxeItem, BowItem, etc.) so the universal fallback categorizes them correctly without needing an explicit module:

• Farmer's Delight: knives as swords
• Dungeons Delight: knives and cleavers as swords
• dacxirons: staves as swords
• Cataclysm Weaponry: ignitium tools and sword
• Immersive Armors: armor pieces
• Armageddon: most items
• Anything else with vanilla-class weapons/armor

Config

A config file shows up at config/apothic_compat.toml on first launch. Per-item and per-tag overrides go there:

[item_overrides]
"ruins:greatsword" = "heavy_weapon"

[tag_overrides]
"simplyswords:greathammers" = "heavy_weapon"

Valid category names: sword, heavy_weapon, trident, bow, crossbow, shield, helmet, chestplate, leggings, boots, pickaxe, shovel, none. Set an item to none to fully blacklist it from rolling any affixes. Categories registered by other mods (such as staffs from Fallen Gems & Affixes) are also accepted.

Affix Blacklist

Stops specific affixes from rolling on newly generated gear (loot drops, reforging, trades, and gem application) without editing datapacks. List the affix ids in the affix_blacklist array in apothic_compat.toml:

affix_blacklist = ["apotheosis:berserking", "apotheosis:telepathic"]

To find an affix id, hover an affixed item with JEI or REI open, or read the affix files under data/<namespace>/affixes/ inside a mod's jar (Apotheosis's own affixes live in data/apotheosis/affixes/).

Notes:

• This blocks future rolls only. Items that already carry a blacklisted affix keep it.
• Apotheosis's own datapack affix overrides still take precedence.
• The blacklist re-applies automatically on server start and after /reload. Edit the list and run /ac reload (or /apothiccompat reload) to apply it without a restart.

Items already handled by Apotheosis

Apotheosis hardcodes defaults in config/apotheosis/adventure.cfg under the Equipment Type Overrides list. These take precedence over both Apothic Compat's config and built-in compat modules. As of Apotheosis 7.4.8 the hardcoded defaults are:

• minecraft:iron_sword set to sword
• minecraft:shulker_shell set to none

Setting these items in apothic_compat.toml will not work. To override them, edit adventure.cfg directly.

Reload command

/apothiccompat reload or /ac reload (op level 2) re-applies the config without a restart. It's a no-op if the file hasn't changed.

Requirements

Minecraft 1.20.1, Forge 47.x, Apotheosis 7.4.x. Everything else is optional.

Installation

Drop the jar in mods/. Server-side only (clients don't need it).

License

MIT, Copyright 2026 Nightwielder23. https://github.com/Nightwielder23/apothic-compat/blob/main/LICENSE

Source

https://github.com/Nightwielder23/apothic-compat

Author

Nightwielder23, https://github.com/Nightwielder23