Shampoo's Weapons API
Shampoo's Weapons API is a Fabric library that lets programmers register custom weapons with their own crafting recipes and abilities.
What it does
Programmers use the API to define weapons with custom shaped and shapeless crafting recipes, a custom use method, and custom attack, throw, sneak and jump abilities. Entity interactions and item cooldowns can also be set for each weapon, so a mod can build a full set of items on top of it.
Installing the mod on the server side is all it takes; players do not need it in their own game folders. Clients need a resource pack that the server provides, which supplies textures, models and language entries for the weapons. Installation instructions are published on GitHub, and the source code and a wiki are linked from the project pages.
Files are published for Fabric only, for 1.20.4, with version 1.1.1 dated 2024-03-17 as the latest. The mod is released under the Creative Commons Attribution 4.0 license and is not open source.
Key features
Custom crafting recipes
Weapons can be given shaped and shapeless crafting recipes defined through the API.
Custom combat abilities
Attack, throw, sneak and jump behaviour can each be defined for a weapon, along with a custom use method.
Entity interactions and cooldowns
Weapons can react to entities and carry their own item cooldowns, which the API manages.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Building weapon mods
A mod author can register a new family of weapons and rely on the API for recipes, abilities and cooldowns instead of writing that logic from scratch.
Custom server content
Server owners who add weapon packs can install this library on the server and ship the matching resource pack to players.
Who it’s for: Programmers writing Fabric mods that add weapons, and server owners who run weapon content built on the API.
How it compares
Combat Crafts is a Fabric mod for 1.20.1 that is client and server and open source under the MIT License. NBT Recipes is a server-side only Fabric and Quilt mod for 1.20 – 1.20.1, released under the Apache License 2.0 and open source. CraftableChainmailArmor is server required with client optional, covers 1.20 – 26.1.1 on Fabric and Quilt, and is not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Shampoo's Weapons API | Fabric | 1.20.4 | Server-side only | 2024-03-17 |
| Combat Crafts | Fabric | 1.20.1 | Client and server | 2024-12-26 |
| NBT Recipes | Fabric and Quilt | 1.20 – 1.20.1 | Server-side only | 2023-11-14 |
| CraftableChainmailArmor | Fabric and Quilt | 1.20 – 26.1.1 | Server required, client optional | 2026-04-03 |
Questions
Does Shampoo's Weapons API need to be installed on the client?
Which loader does Shampoo's Weapons API support?
Where can a modder find installation details?
In the catalog
Shampoo's Weapons API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 13,907 mods support Minecraft 1.20.4.
Similar mods
What the author says
This mod allows other modders to create items that have custom crafting recipes, textures/models, abilities, stats, etc. This mod only needs to be installed on the server's side, however, if you want the custom lang file and textures to register on the client side, you need to give your players a resource pack or…
Official listing
- Modrinth page
- modrinth.com/mod/shampoos-weapons-api
- Owner
- MyShampooIsDrunk
- Published
- 2024-03-17
- Updated on Modrinth
- 2024-03-17
- Facts verified
- 2026-10-15