Goety: Spell Source API
by mc_xiaoming
Goety: Spell Source API is a Forge library that lets items provide spells to the Goety spell system without needing a separate spell source block.
What it does
Items can house a spell focus, or provide a spell directly, through hooks this API adds to Goety. The library detects which item sits in the main hand, the offhand, an armor slot or a Curios slot, and the spell it carries is read from that position. A set of utility classes handles the common steps of wiring an item into the spell system, so an addon author does not have to write that plumbing from scratch.
The API also exposes a renderer for special spell items. A focus ring can be drawn with a custom renderer or with the default one, and the renderer can be used on its own. The author states that no vanilla classes are modified.
The mod needs Goety as its base and runs on Forge. Files are released under the MIT License and the source code is public. Files are published for 1.20.1 – 1.20.6, and the latest is 1.0.0-fix for 1.20.6.
Key features
Spell focus housing
Items can hold a spell focus, so a single item acts as the source of a spell without a dedicated block.
Slot detection
The API checks the main hand, offhand, armor slots and Curios slots to find spell-providing items.
Custom focus renderer
Special spell items can use a focus ring rendered by a custom renderer, or the default renderer as it stands.
Integration utilities
Helper classes wrap the common steps for connecting an item to the spell system.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Addon development
Developers building Goety addons can attach spells to new items through the provided hooks and utility classes.
Custom spell items
Item authors can supply a custom focus ring for their spell items instead of the default look.
Who it’s for: Mod developers who extend Goety with new spell-carrying items, and players who run such addons on Forge.
How it compares
Goety Focus is a Forge addon for 1.20.1 with All rights reserved licensing, and it is not open source. AirStaff (Goety Addon) is also a Forge addon for 1.20.1, released under the MIT License, but its source is not public. Goety Integration is for 1.20.1 on Forge under All rights reserved. This library targets a broader set of 1.20.x builds and offers an API rather than a single item set.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Goety: Spell Source API | Forge | 1.20.1 – 1.20.6 | Client and server | 2026-09-06 |
| Goety Focus | Forge | 1.20.1 | Client and server | 2026-07-14 |
| AirStaff (Goety Addon) | Forge | 1.20.1 | Client and server | 2026-09-14 |
| Goety Integration | Forge | 1.20.1 | Client and server | 2026-06-02 |
Questions
Does Goety: Spell Source API need Goety installed?
Does the API have to be installed on the server?
Is a NeoForge version available?
In the catalog
Goety: Spell Source API is one of 7,216 Magic mods on ModsFinder, and one of 3,927 Magic mods for Forge. 11,154 mods support Minecraft 1.20.6.
More from mc_xiaoming
Similar mods
Official listing
- Modrinth page
- modrinth.com/mod/goety-spell-source-api
- Owner
- mc_xiaoming
- Published
- 2026-08-12
- Updated on Modrinth
- 2026-09-06
- Facts verified
- 2026-10-15