📚Information

Highly optimized, feature-packed, and unique Suits plugin

Transform your server’s gameplay with the AbyssSuits plugin, a powerful tool that introduces a wide range of customizable armor sets with unique boosts and effects. Players can unlock and equip these suits to gain special abilities, enhancing their performance and adding new dimensions to gameplay. The plugin supports extensive integration with currency systems, potion effects, and other plugins, making it a versatile addition to any server.

Highlights

• Full-Set Bonuses: Gain significant advantages with powerful bonuses for equipping complete armor sets.

• Per-Piece Boosts: Enjoy individual boosts for each piece of armor for tailored playstyles.

• Comprehensive Currency and Boost Support: Seamlessly integrate with various currencies and boost systems.

• Potion Effect Enhancements: Access enhanced potion effects through suit configurations.

• Dedicated Suit Currencies and Shops: Manage suit pieces using a specialized currency and in-game shop.

• Permission-Based Events: Trigger natural events for earning suit currencies through gameplay.

• Unlimited Suit Configurations: Create and customize an unlimited number of suits to suit your server’s needs.

Short Showcase Video

Interested in purchasing the plugin? Visit https://blockm.art or join our Discord server and open a ticket!

Commands

Arguments wrapped in diamonds <arg> are required for the command to run properly. Arguments wrapped in square braces[arg] are treated as optional

Admin Commands (Permission: abysssuits.admin)

• /suits give <player> <type>

  • Gives all of the specified suit type's armor pieces to the specified player

• /suits givepiece <player> <suit-type> <armor-type> <amount>

  • Gives the specified amount of the specified armor type from the suit-type being given to the target player

• /suits givefragment <player> <suit-type> <amount>

  • Gives a specified amount of the suit currency from the suit specified to the target player

• /suits shop

  • Opens the suit shop menu. This is sorted under admin commands because players are able to open the suit shop directly without sub-commands.

• /suits reload

  • Reloads the TideSuits plugin and configuration files

Player Commands (Permission: None unless specified)

• /suits

  • Opens the suit shop menu

Default Configuration Files

Default Suit Config File

suits/default.yml

boosts:
    - "experience;0.5"

effects:
    - "SPEED;1"

full-suit-bonus:
    boosts:
        - "experience;1"
    effects:
        - "SPEED;2"

currency-item:
    enchanted: true
    material: "LIGHT_BLUE_DYE"
    name: "&f&lFRAGMENT: &bDefault Suit &7(Right-Click)"
    lore:
        - " "
        - "&bInformation"
        - "&b&l→ &7Suit: &fDefault"
        - "&b&l→ &7Usage: &fRight-Click"
        - " "
        - "&bDescription"
        - "&7Collect suit fragments and trade them in once you have enough"
        - "&7to convert them into a &bsuit piece&7. Collect all of the &b4&7"
        - "&7pieces and equip them to receive a special &bset bonus&7."
        - " "
        - "&7&o(( Right-Click to open the &f&ofragment conversion&7&o menu! ))"
    flags:
        - "HIDE_ENCHANTS"

currency:
    event-activation-permission: "tidesuits.default"
    events:
        "block-break-example":
            type: "BLOCK_BREAK"
            region-only:
                enabled: false
                regions:
                    - "example"
            blacklisted-worlds:
                - "example"
            values:
                "coal-ore":
                    value: "COAL_ORE"
                    chance: 20
                    min-fragments: 1
                    max-fragments: 3
        "kill-mob-example":
            type: "KILL_MOB"
            blacklisted-worlds:
                - "example"
            values:
                "zombie":
                    value: "ZOMBIE"
                    chance: 50
                    min-fragments: 1
                    max-fragments: 3
        "kill-player-example":
            type: "KILL_PLAYER"
            blacklisted-worlds:
                - "example"
            chance: 100
            min-fragments: 1
            max-fragments: 10

suit:
    "helmet":
        cost-in-fragments: 250
        item:
            material: "PLAYER_HEAD"
            skull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmZjMTExOWIyNTQ2ZWUxYWJhZWI2ZWNiZWEzNmVkMTc3ZmJhZTQyODI3NGVlNTNkNmViNzU0NzdlOWIyMGFhZCJ9fX0="
            name: "&3&l[&b&l!&3&l] &bDefault Helmet &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fHelmet"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
        shop-item:
            material: "PLAYER_HEAD"
            skull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmZjMTExOWIyNTQ2ZWUxYWJhZWI2ZWNiZWEzNmVkMTc3ZmJhZTQyODI3NGVlNTNkNmViNzU0NzdlOWIyMGFhZCJ9fX0="
            name: "&3&l[&b&l!&3&l] &bDefault Helmet &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fHelmet"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&f&lCOST: &b&l250x DEFAULT FRAGMENTS"
                - "&f&lYOU HAVE: &b&l%balance%x"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
    "chestplate":
        cost-in-fragments: 325
        item:
            material: "LEATHER_CHESTPLATE"
            color: 3949738
            name: "&3&l[&b&l!&3&l] &bDefault Chestplate &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fChestplate"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&bEnchants"
                - "&b&l→ &7Protection V"
                - "&b&l→ &7Unbreaking 100"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
            enchants:
                - "PROTECTION_ENVIRONMENTAL;4"
                - "DURABILITY;100"
            flags:
                - "HIDE_ENCHANTS"
        shop-item:
            material: "LEATHER_CHESTPLATE"
            color: 3949738
            name: "&3&l[&b&l!&3&l] &bDefault Chestplate &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fChestplate"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&bEnchants"
                - "&b&l→ &7Protection V"
                - "&b&l→ &7Unbreaking 100"
                - " "
                - "&f&lCOST: &b&l325x DEFAULT FRAGMENTS"
                - "&f&lYOU HAVE: &b&l%balance%x"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
            enchants:
                - "PROTECTION_ENVIRONMENTAL;4"
                - "DURABILITY;100"
            flags:
                - "HIDE_ENCHANTS"
    "leggings":
        cost-in-fragments: 300
        item:
            material: "LEATHER_LEGGINGS"
            color: 3949738
            name: "&3&l[&b&l!&3&l] &bDefault Leggings &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fLeggings"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&bEnchants"
                - "&b&l→ &7Protection V"
                - "&b&l→ &7Unbreaking 100"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
            enchants:
                - "PROTECTION_ENVIRONMENTAL;4"
                - "DURABILITY;100"
            flags:
                - "HIDE_ENCHANTS"
        shop-item:
            material: "LEATHER_LEGGINGS"
            color: 3949738
            name: "&3&l[&b&l!&3&l] &bDefault Leggings &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fLeggings"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&bEnchants"
                - "&b&l→ &7Protection V"
                - "&b&l→ &7Unbreaking 100"
                - " "
                - "&f&lCOST: &b&l300x DEFAULT FRAGMENTS"
                - "&f&lYOU HAVE: &b&l%balance%x"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
            enchants:
                - "PROTECTION_ENVIRONMENTAL;4"
                - "DURABILITY;100"
            flags:
                - "HIDE_ENCHANTS"
    "boots":
        cost-in-fragments: 200
        item:
            material: "LEATHER_BOOTS"
            color: 3949738
            name: "&3&l[&b&l!&3&l] &bDefault Boots &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fBoots"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&bEnchants"
                - "&b&l→ &7Protection V"
                - "&b&l→ &7Unbreaking 100"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
            enchants:
                - "PROTECTION_ENVIRONMENTAL;4"
                - "DURABILITY;100"
            flags:
                - "HIDE_ENCHANTS"
        shop-item:
            material: "LEATHER_BOOTS"
            color: 3949738
            name: "&3&l[&b&l!&3&l] &bDefault Boots &7(Suit Piece)"
            lore:
                - " "
                - "&bInformation"
                - "&b&l→ &7Suit: &fDefault"
                - "&b&l→ &7Type: &fBoots"
                - " "
                - "&bBoosts"
                - "&b&l→ &7+50% EXP/piece"
                - "&b&l→ &7Permanent Speed 1/piece"
                - " "
                - "&bFull Suit Bonus"
                - "&b&l→ &7+100% EXP Multi"
                - "&b&l→ &7Speed 2"
                - " "
                - "&bEnchants"
                - "&b&l→ &7Protection V"
                - "&b&l→ &7Unbreaking 100"
                - " "
                - "&f&lCOST: &b&l200x DEFAULT FRAGMENTS"
                - "&f&lYOU HAVE: &b&l%balance%x"
                - " "
                - "&7&o(( This is an exclusive &f&osuit piece&7&o! ))"
            enchants:
                - "PROTECTION_ENVIRONMENTAL;4"
                - "DURABILITY;100"
            flags:
                - "HIDE_ENCHANTS"
category-item:
    "unselected-item":
        material: "LIGHT_BLUE_STAINED_GLASS_PANE"
        name: "&3&l[&b&l!&3&l] &bDefault Suit Category &7(Left-Click)"
        lore: []
    "selected-item":
        enchanted: true
        material: "LIGHT_BLUE_STAINED_GLASS_PANE"
        name: "&3&l[&b&l!&3&l] &bDefault Suit Category &7(Selected)"
        lore: []
        flags:
            - "HIDE_ENCHANTS"

menus:
    "shop-menu":
        title: "&8&lSUITS SHOP"
        rows: 4
        category-slots: [27, 28, 29, 30, 31, 32, 33, 34, 35]
        armor-slots:
            helmet: 10
            chestplate: 12
            leggings: 14
            boots: 16
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: []
                slots:
                    - "0-26"
            "white":
                material: "WHITE_STAINED_GLASS_PANE"
                name: " "
                lore: []
                slots:
                    - "27-35"
        temp-items:
            "not-enough-fragments":
                material: "BARRIER"
                name: "&c&lYOU DON'T HAVE ENOUGH FRAGMENTS!"
                lore: []

messages:
    "experience-boost":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&a&l+%amount% EXP &7(&f%multiplier%x&7 Default Suit Multi)"
    "purchased-suit-piece":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have just purchased a(n) &bDefault %type%&7 for &b%cost%x&7 fragments. &7You have &f%remaining%x&7 &bDefault&7 fragments left."
    "equipped-piece":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have just equipped a(n) &bDefault %type%&7."
    "unequipped-piece":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have just unequipped a(n) &cDefault %type%&7."
    "full-suit-activated":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have equipped &ball&7 suit pieces for the &bDefault Suit&7."
    "full-suit-deactivated":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You are no longer receiving the full-suit boost for the &bDefault Suit&7."

Settiings Config File

settings.yml

command:
    base-command-name: "suits"
    aliases:
        - "suit"
        - "ts"
        - "tidesuits"
        - "tsuits"
        - "tsuit"
        - "tidesuit"
    sub-commands:
        "give":
            base-alias: "give"
            aliases: []
        "givepiece":
            base-alias: "givepiece"
            aliases: []
        "givefragment":
            base-alias: "givefragment"
            aliases: []
        "shop":
            base-alias: "shop"
            aliases: []
        "reload":
            base-alias: "reload"
            aliases: []

default-suit-shop-category: "default"

Messages Config File

lang.yml

messages:
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You do not have &cpermission&7 to perform this action."
    "reloaded":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have successfully reloaded &bTideSuits&7 in &b%time%ms&7."
    "invalid-player":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid player&7."
    "invalid-suit":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid suit&7."
    "invalid-armor-type":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid armor type&7."
    "invalid-amount":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid amount&7."
    "given-suit-to-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have given &b%player%&7 a(n) &b%suit%&7 Suit."
    "received-suit":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have been given a(n) &b%suit%&7 suit by &b%player%&7."
    "given-suit-piece-to-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have given &b%player% %amount%x &b%suit% %type%&7(s)."
    "received-suit-piece":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have been given &b%amount%x %suit% %type%&7(s) by &b%player%&7."
    "given-suit-fragment-to-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have given &b%player% %amount%x &b%suit% &7fragment(s)."
    "received-suit-fragment":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have been given &b%amount%x %suit% &7fragment(s) by &b%player%&7."
    "admin-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bSuits Admin Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/ts give <player> <suit>"
                - "&b&l→ &7/ts givepiece <player> <suit> <type> <amount>"
                - "&b&l→ &7/ts givefragment <player> <suit> <amount>"
                - "&b&l→ &7/ts reload"
                - "&b&l→ &7/ts shop"
                - " "
                - "&f&m----------------------------------"
    "player-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bSuits Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/suits"
                - " "
                - "&f&m----------------------------------"