Apothic Category Compat

A small server-side mod for Forge and NeoForge that fills in Apotheosis loot category assignments for weapon and armor mods that don't set them or set them wrong. On Forge it sends categories over Apotheosis's IMC override API; on NeoForge 1.21.1 it adds them through an Apotheosis data map.

Versions

1.20.1 and 1.19.2 (Forge): universal attack speed and damage rule plus per-mod modules, sent over IMC. 1.19.2 has a shorter mod list. 1.21.1 (NeoForge): data map. Apotheosis 8.x sorts most gear itself and merged its categories (one melee weapon category, breaker for mining tools), so this build fills the gaps Apotheosis leaves.

What it does (Forge)

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

The universal rule splits melee weapons into sword or heavy_weapon by attack speed (1.0 or slower reads heavy, or 10.0+ damage bumps to heavy). Bows, crossbows, tridents, pickaxes, shovels, shields, and armor come from the vanilla class hierarchy. Stats are read live, so if mods change them at runtime, it still works. The read also falls back to stack-level attributes, so Epic Fight style weapons (Weapons of Miracles greataxes) are caught too.

A second pass runs after mod loading to catch weapons whose stats settle during deferred init.

Apotheosis hardcodes a couple of defaults that take precedence over the categories set here (minecraft:iron_sword as sword, minecraft:shulker_shell as none).

Per-mod modules

Routes items in these mods to the correct categories (sword, heavy weapon, bow, crossbow, trident, shield, none, and staffs or sword via Fallen Gems & Affixes when present): L'Ender's Cataclysm, Twilight Forest, Epic Fight (base, Nightfall, Resurrection), Weapons of Miracles, Tetra, Marium's Soulslike Weaponry, Meet Your Fight, Dungeons and Combat, Alex's Caves, Alex's Mobs, Aquamirae, Born in Chaos, Forbidden and Arcanus, Traveloptics, Celestisynth, The Undergarden.

1.19.2 covers a shorter list, with Epic Samurai included instead of some 1.20.1-only mods.

Handled by the universal rule

These mods extend the right vanilla classes or carry real attack stats: Simply Swords, Integrated Simply Swords, Spartan Weaponry, Spartan Shields, Epic Knights, Samurai Dynasty, Dread Steel, Iron's Spellbooks, Mowzie's Mobs, Bosses of Mass Destruction, Deeper and Darker, Knight Quest, Enigmatic Legacy, Malum, RPG Style More Weapons, Cataclysm's own melee weapons and shields, and anything else with vanilla class weapons or an attack damage attribute, plus armor.

Categorization settings

Two toggles in apothic_category_compat-common.toml. Edit and restart to apply.

name_based_heavy_override (default on as of v2.1.0): ids containing a heavy weapon name (greatsword, claymore, zweihander, warhammer, halberd, glaive, battleaxe, lance, scythe, etc.) go to heavy_weapon, and ids ending in "sword" go to sword. Existing configs keep their prior value, so set it to true or delete the config to pick up the new default. weapon_pickaxes_as_heavy (default on): Cataclysm Void Forge and Infernal Forge, the Forbidden and Arcanus blacksmith gavels of every tier, and Twilight Forest Cube of Annihilation go to heavy_weapon. Disable to categorize them as pickaxe.

Config

Config file at config/apothic_category_compat-common.toml. It moves over from the older apothic_compat-common.toml on first launch of v2.1.0 or later, so your settings carry over. Per-item and per-tag overrides:

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

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

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

1.21.1 NeoForge (Apotheosis 8.x)

Overrides through a NeoForge data map at data/apotheosis/data_maps/item/loot_category_overrides.json.

Routes items in these mods to the correct categories (ranged weapons to bow, bidents to trident, and staffs and scythes to Apothic Compats' staff and scythe categories, the last two only when both Apothic Compats and Malum are loaded): L'Ender's Cataclysm, Alex's Caves, Alex's Mobs, Born in Chaos, The Undergarden, Twilight Forest, Lands of Icaria, Iron's Spellbooks, Ice and Fire, Ice and Fire Spellbooks, Forbidden and Arcanus, Mahoutsukai, Deeper Darker, the Aether, and Traveloptics.

Dual-purpose pickaxes (Cataclysm forges and Forbidden Arcanus blacksmith gavels) go to melee weapon through the #apothic_category_compat:weapon_pickaxes item tag. The weapon_pickaxes_as_melee config toggle (default on) gates this through a data map condition; set it false to leave them as breaker. Extend the tag from your own datapack to cover more.

Affix blacklist

Stops specific affixes from rolling on newly generated gear. List affix ids in the affix_blacklist array:

affix_blacklist = ["apotheosis:sword/attribute/vampiric", "apotheosis:heavy_weapon/attribute/berserking"]

Affix ids match the JSON file path, for example data/apotheosis/affixes/sword/attribute/vampiric.json is apotheosis:sword/attribute/vampiric. On 1.21.1 the path order is attribute// instead, so the same affix is apotheosis:attribute/sword/vampiric there.

Blocks future rolls only; items already carrying a blacklisted affix keep it. Reapplies on server start, datapack reload, and /acc reload.

Reload command

/apothiccategorycompat reload or /acc reload (op level 2) rereads the config and reapplies it on Forge. On 1.21.1 it rereads the affix blacklist; the data map follows a normal datapack /reload.

Requirements

1.20.1: Forge 47.x, Apotheosis 7.4.x. 1.19.2: Forge 43.x, Apotheosis 6.5.x. 1.21.1: NeoForge 21.1.x, Apotheosis 8.5 or newer.

Install on both client and server for correct affix attribute display and gem socket bonuses on Forge. On 1.21.1 the data map and affix blacklist run server-side and Apotheosis syncs categories to clients.

License

MIT