DG Talismans

# DGtalismans (https://discord.gg/ZZhVKUtSNS) Create custom **Talismans**, **Armor**, **Weapons**, and **Tools** with 40+ configurable effects — all managed through in-game GUIs. No config files to edit. ## How It Works Create an item, assign effects through the GUI, give it to players. Effects activate based on item type: | Type | Activation | Materials | |------|-----------|-----------| | **Talisman** | Anywhere in inventory | 50+ gems & mystical items | | **Armor** | Equipped in armor slot | All 27 armor pieces | | **Weapon** | Held in main hand | All swords, bow, crossbow, trident | | **Tool** | Main hand or offhand | All pickaxes, axes, shovels, hoes + more | Effects apply instantly when equipped and are removed the moment the item leaves its slot. ## Effects (40+) **Attributes** - Extra Hearts, Attack Damage, Speed, Armor, Armor Toughness, Luck, KB Resistance, Attack Speed, Block Reach **Potion Effects** - 27 effects (Speed, Haste, Strength, Regeneration, Night Vision, etc.) with levels I–X **Combat** - Damage Reduction %, Crit Chance %, Crit Multiplier, Life Steal %, Thorns % + 7 immunities (Fire, Explosion, Fall, Drowning, Projectile, Poison/Wither, Void) **Passive** - Auto Smelt, Auto Pickup, Night Vision, Water Breathing, No Hunger, Keep Inventory, Double XP, Double Drops, Magnetic Pickup (8 blocks), Instant Crop Growth **Movement** - Double Jump, No Fall Damage, Sneak Launch, Jump Height Boost (+500%) **Particles** - 14 trails (Flame, Heart, Portal, Enchant, End Rod, Soul, Cherry, and more) **Misc** - XP Multiplier (1–10x), Food Replenish ## Rarity System 6 tiers with colored item labels: Common · Uncommon · Rare · Epic · Legendary · Mythic ## GUI System Everything is configured through in-game menus. Open `/talismans` to access the category selector, create items, and configure all effects with click controls. No YAML editing needed. ``` /talismans → Category Selector (Talismans / Armor / Weapons / Tools) └─ Edit Item → Attributes, Potions, Combat, Passive, Movement, Particles, Misc, Material, Rarity ``` ## Commands | Command | Description | |---------|-------------| | `/talismans` | Open admin GUI | | `/talismans give <id> ` | Give items (1–64) | | `/talismans list` | List all items | | `/talismans reload` | Reload config & data | **Aliases:** `/talisman`, `/dgt` ## Permissions | Permission | Default | Description | |------------|---------|-------------| | `dgtalismans.admin` | OP | Admin GUI & commands | | `dgtalismans.use` | Everyone | Enables effects for player | ## Configuration ```yaml prefix: "&8 " max-talismans-per-player: -1 blacklisted-worlds: protection: prevent-craft: true prevent-anvil-rename: true prevent-drop: false prevent-container-move: false particles: enabled: true interval: 5 ``` ## Technical Details - Items identified by **PersistentDataContainer** (NBT), not lore - Effects use native **AttributeModifier** system - Equipment changes detected **instantly** (held item, swap hand, armor click) - All effects **clean up** on quit, world change, and plugin disable - Items are **unstackable** (max stack size 1) - Anti-exploit: blocked crafting, anvil rename, GUI drag - Blacklisted worlds enforced on **every** effect handler - **Zero TPS impact** ## Compatibility - **Minecraft:** 1.21.x — 26.1 - **Server:** Spigot & Paper - **Java:** 21+