
Shampoo's Weapons API
An API that allows programmers to add custom weapons with custom crafting recipes, uses, etc.
About this Mod
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 have the server install a resource pack when they join it.
Current custom features:
- Custom Shaped and Shapeless Crafting Recipes
- Custom Use Method
- Custom Attack Ability
- Custom Throw Ability
- Custom Sneak Ability
- Custom Entity Interactions
- Custom Jump Ability
- Custom Item Cooldowns
- Custom Item Model/Texture Support
Installation instructions can be found on my GitHub
For additional support, join our Discord!
Available Versions
How to Install Shampoo's Weapons API on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.4).
Install Mod
Open the mod browser in the dashboard and search for "Shampoo's Weapons API". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.4
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Shampoo's Weapons API server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.4). You can switch loaders with one click in the panel.
Is Shampoo's Weapons API compatible with fabric?
Shampoo's Weapons API officially supports fabric for Minecraft 1.20.4. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Shampoo's Weapons API – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Shampoo's Weapons API consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Shampoo's Weapons API with just one click on your server.