Sigils | Socket Passive Power v1.0.0

Sigils
Sigils adds a socket system to your server. Add sockets to any item, then slot in sigils for passive effects that stack while the item is equipped or held. Potion buffs, attribute boosts, fall damage reduction, and loot luck, all tunable from config.

Built for: Survival, SMP, Skyblock, Factions.



How it works
An admin holds an item and runs /sigils addsocket to give it sockets. Once an item has sockets, its owner opens /sigils socket while holding it to see the socket layout next to every sigil in their inventory. Clicking a sigil slots it into the first free socket; clicking a filled socket pulls the sigil back out. Every socketed sigil applies its effect on a timer while the item stays equipped or in hand, and removing or swapping the item clears the effect right away.

Fifteen sigils across five rarities

• Potion sigils - Swift (Speed), Surge (Haste II), Nightsight (Night Vision), Tidewalker (Water Breathing), Leap (Jump Boost II).
• Attribute sigils - Vitality (extra max health), Bulwark (extra armor), Ferocity (extra attack damage), Fleetfoot (movement speed), Reach and Grasp (extra block and entity interaction range).
• Fall reduction sigils - Feather and Cushion, at two different reduction levels.
• Loot luck sigils - Windfall and Fortune, each with a chance to double a slain mob's drops.

Every rarity, effect, and number above is set in config.yml and can be changed, and you can add your own sigils the same way.



Shop and mob drops
Sigils can be bought from an in-game shop GUI through Vault, sold back for a set price, or sold straight from your hand with /sigils sell. They can also drop from specific mobs at a chance you set per sigil, so players can hunt for them instead of only buying them. Buying, selling, and drop chances are all optional per sigil.



Features

• Socket system that works on any item, added and removed through a single admin command.
• Live effects that reapply on a timer while gear is equipped or held, and clear the moment it is not.
• Two clean inventory GUIs: the socket menu and the sigil shop, both click-safe with no duplication risk.
• Fifteen sigils shipped across four effect types and five rarities, fully editable in config.yml.
• Vault-based shop, hand sell, and configurable per-sigil buy and sell prices.
• Mob drop tables per sigil, with a require-player-kill option.
• Config caps for max potion amplifier, fall reduction, and loot luck, so effects never stack past what you allow.
• Configurable insert and remove costs, and a toggle for whether removing a sigil returns it or destroys it.
• Sound feedback for insert, remove, buy, and denied actions, each configurable.
• Config auto-migration keeps your settings when the plugin updates.

Commands

• /sigils socket - open the socket menu for the item in your hand.
• /sigils shop - open the sigil shop.
• /sigils sell - sell the sigil in your hand.
• /sigils list - list every sigil with its rarity and effect.
• /sigils info <sigil> - show details for one sigil.
• /sigils give <player> <sigil> [amount] - give a sigil.
• /sigils addsocket [amount] - add sockets to the item in your hand.
• /sigils clearsockets confirm - clear every sigil from the item in your hand.
• /sigils reload - reload the config and messages.

Aliases: /sigil, /sg

Permissions

• sigils.use - socket menu, shop, sell, list, and info. Default: everyone.
• sigils.admin - give, addsocket, clearsockets, and reload. Default: operators.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.
• Vault is optional, for the shop and hand sell. Without it, socketing is free and the shop stays closed.

Installation

1. Drop Sigils-1.0.0.jar into your plugins folder.
2. Start the server once to generate the config.
3. Edit config.yml to taste, then run /sigils reload.

Try it first
Sigils is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to connect and try the socket menu and shop yourself.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.