Custom Talismans

Custom Talismans
Custom Talismans is a powerful Spigot plugin that allows server administrators to create unique, custom items with special powers. These "talismans" can grant players potion effects or modify their attributes, providing a dynamic and engaging gameplay experience. The plugin features a secure system for managing active talismans, preventing duplication and ensuring fair play.

✨ Features
Customizable Items: Transform any in-game item into a powerful talisman with custom names, lore, potion effects (like Strength, Speed), and player attributes (like Max Health, Movement Speed).

Official Talisman System: A dedicated admin command is required to "sign" an item, officially marking it as a legitimate talisman, ensuring only approved items can grant powers.

Reusable Templates: Save your custom talismans as templates, allowing you to easily distribute copies to all players or specific individuals.

Secure Activation & Deactivation: Players use simple commands to activate a talisman (it leaves their inventory and applies powers) and deactivate it (powers are removed, and the item returns), preventing common duplication exploits.

Intuitive Bag GUI: A dedicated GUI provides a clear visual overview of a player's currently active talisman.

Admin Invsee & Trade: Admins can view and manage player talisman bags, and players can safely trade items using a secure trading interface.

🎮 Commands
Player Commands (Accessible to all players)
/talisman info

Displays a comprehensive list of all available commands and plugin information.

/talisman bag

Opens your personal Talisman Bag GUI, showing your currently active talisman. (This GUI is for display only; manage talismans via commands).

/talisman use

Usage: Hold an official talisman in your main hand, then type this command.

Effect: Activates the talisman, removing it from your inventory and applying its powers to you.

/talisman take

Usage: Type this command when you have an active talisman.

Effect: Deactivates your current talisman, removing its powers and returning the item to your inventory (if space is available).

/talisman trade

Usage: /talisman trade Notch

Effect: Sends a trade request to the specified player, initiating a secure trading GUI if accepted.

Admin Commands (Requires customtalismans.admin permission, or op)
/talisman effect add

Usage: Hold an item, then use this command.

Example: /talisman effect add STRENGTH 2 (Grants Strength II)

Example: /talisman effect add JUMP 5 (Grants Jump Boost V)

/talisman attribute add [operation]

Usage: Hold an item, then use this command. [operation] is optional (ADD_NUMBER or MULTIPLY_SCALAR_1).

Example (More Hearts): /talisman attribute add GENERIC_MAX_HEALTH 10.0 ADD_NUMBER (Adds 5 extra hearts)

Example (Faster Movement): /talisman attribute add GENERIC_MOVEMENT_SPEED 0.1 MULTIPLY_SCALAR_1 (Increases movement speed by 10%)

/talisman rname

Usage: Hold an item, then use this command.

Example: /talisman rname &6&lLegendary Talisman (Supports Minecraft color codes)

/talisman admin sign

Usage: Hold the item you've customized with effects/attributes, then type this command.

Effect: Crucial Step! Officially marks the item as a valid talisman. An item must be signed before it can be saved as a template or used by players.

/talisman save

Usage: Hold a signed and customized item, then use this command.

Example: /talisman save MySuperTalisman

Effect: Saves the item as a reusable template, allowing you to generate copies later.

/talisman giveall

Usage: /talisman giveall MySuperTalisman

Effect: Gives a copy of the specified saved talisman template to all online players.

/talisman clearall

Usage: Type this command.

Effect: Removes all active talismans from every player on the server and clears their associated effects.

/talisman invsee

Usage: /talisman invsee Steve

Effect: Opens the talisman bag GUI of the specified player, allowing admins to view or manage their active talisman.