These documents explain how an addon can build weapons that behave like Simply Swords' built-in unique weapons. They target Minecraft 1.21.1 and Java 21.
Start here:
- Set up the dependency.
- Follow the complete unique weapon walkthrough.
- Use the API reference when adding more advanced behavior.
- Finish with the testing checklist.
The primary API lives in:
net.sweenus.simplyswords.apinet.sweenus.simplyswords.client.api
The following classes are also intended for addon use:
UniqueSwordItemUniqueWeaponActiveAbilityGemPower,RunicGemPower,RunefusedGemPower, andNetherGemPowerGemPowerRegistry
Classes under world, mixin, and most of util are implementation details.
The reference occasionally mentions a utility when it is the only practical way
to match built-in behavior. Treat those utilities as less stable than the API
package.
Register addon items normally, then register their Simply Swords integrations during common initialization. Client model properties and other rendering hooks belong in the addon's client initializer.
Simply Swords must be a required dependency so its registries and components exist before addon content is used.