https://github.com/nightwielder23/apothic-compat
Adds Apotheosis loot category compat for Spartan Weaponry, Epic Knights, Simply Swords, L'Ender's Cataclysm, Marium's Soulslike Weaponry, Alex's Mobs, Enigmatic Legacy, and more. Server side only.
https://github.com/nightwielder23/apothic-compat
apotheosis compatability forge java minecraft minecraft-1-20-1 minecraft-mod
Last synced: about 1 month ago
JSON representation
Adds Apotheosis loot category compat for Spartan Weaponry, Epic Knights, Simply Swords, L'Ender's Cataclysm, Marium's Soulslike Weaponry, Alex's Mobs, Enigmatic Legacy, and more. Server side only.
- Host: GitHub
- URL: https://github.com/nightwielder23/apothic-compat
- Owner: Nightwielder23
- License: mit
- Created: 2026-04-16T23:06:21.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T07:30:32.000Z (about 2 months ago)
- Last Synced: 2026-04-22T09:37:26.375Z (about 2 months ago)
- Topics: apotheosis, compatability, forge, java, minecraft, minecraft-1-20-1, minecraft-mod
- Language: Java
- Homepage:
- Size: 187 KB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 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. This mod 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
- **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:
```toml
[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.
## Items already handled by Apotheosis
Apotheosis hardcodes defaults in `config/apotheosis/adventure.cfg` under the `Equipment Type Overrides` list. These take precedence over both this mod'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