Information

Abyss Playtime takes a different approach, when compared to other traditional playtime plugins. One of the unique features it offers is playtime rewards for reaching certain milestones. Another cool feature is a leaderboard GUI, which adds the possibility for friendly competitions among the players.

Dependencies

  • AbyssLib (required)

  • PlaceholderAPI (required)

Commands

  • /playtime help - shows the list of available commands

  • /playtime - opens the main GUI

  • /playtime takecredits <player> <amount> - Take the specified amount of playtime credits from the player

  • /playtime givecredits <player> <amount> - Give the specified amount of playtime credits from the player

  • /playtime setcredits <player> <amount> - Set the specified playeer's playtime credits to the specified amount

  • /playtime givereward <player> <reward> - Give the player the specified reward

  • /playtime shop - Open the playtime credits shop

Note: Admins need the abyssplaytime.admin permission

Placeholders

  • %abyssplaytime% - Displays the player's formatted playtime

Showcase

Short Showcase Video

Playtime Gifts Addon

Commands:

  • /gifts

  • /gifts reset <player>

Configuration Files

config.yml
base-command: "gifts"
aliases:
    - "abyssgifts"
    - "abyssplaytimegifts"
    - "abyssgift"
    - "gift"
    - "playtimegifts"
    - "playtimegift"
    - "abyssplaytimegift"

settings:
    reset-time: 43200 #Seconds

menus:
    "gift-menu":
        title: "&8&lGIFTS"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        temp-items:
            "gift-locked":
                duration: 40 #ticks
                material: "BARRIER"
                name: "&c&lGIFT LOCKED!"
                lore:
                    - "&7&oYou cannot claim this gift for &f&o%time%&7&o."
        items:
            "clock":
                slot: 4
                material: "CLOCK"
                name: "&6&l[&e&l!&6&l] &eGifts &7(Read)"
                lore:
                    - " "
                    - "&eInformation"
                    - "&e- &7Time until reset: &f%time%"
                    - " "
                    - "&eDescription"
                    - "&7As you play you will unlock gifts, these gifts give many random"
                    - "&7rewards. After claiming all your gifts they will reset again"
                    - "&7in &f12 hours&7."
                    - " "
                    - "&7&o(( You can claim your &f&ogifts&7&o below! ))"
        gifts:
            "one":
                slot: 10
                settings:
                    time: 60 #seconds
                    min: 1
                    max: 2
                    rewards:
                        "diamond":
                            chance: 50
                            commands:
                                - "give %player% diamond 1"
                unlocked:
                    material: "PLAYER_HEAD"
                    skull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMjhkYzNjODQ0OTFjNGZmMTAzZGU2ZWEwMTg4MGUyZDgzNDMyY2Q0ODc4Yjg0ZDZiNDMyNTNjYzUxZmQ5NzhlNyJ9fX0="
                    name: "&2&l[&a&l!&2&l] &aGift #1 &7(Click to claim)"
                    lore:
                        - " "
                        - "&aInformation"
                        - "&a- &7Status: &fUnlocked"
                        - "&a- &7Tier: &fCommon"
                        - " "
                        - "&7&o(( Click me to claim your gift! ))"
                claimed:
                    material: "PLAYER_HEAD"
                    skull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTcyNmQ5ZDA2MzJlNDBiZGE1YmNmNjU4MzliYTJjYzk4YTg3YmQ2MTljNTNhZGYwMDMxMGQ2ZmM3MWYwNDJiNSJ9fX0="
                    name: "&2&l[&a&l!&2&l] &aGift #1 &7(Claimed)"
                    lore:
                        - " "
                        - "&aInformation"
                        - "&a- &7Status: &fClaimed"
                        - "&a- &7Tier: &fCommon"
                        - " "
                        - "&7&o(( This gift has already been claimed! ))"
                locked:
                    material: "PLAYER_HEAD"
                    skull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTcyNmQ5ZDA2MzJlNDBiZGE1YmNmNjU4MzliYTJjYzk4YTg3YmQ2MTljNTNhZGYwMDMxMGQ2ZmM3MWYwNDJiNSJ9fX0="
                    name: "&4&l[&c&l!&4&l] &cGift #1 &7(Locked)"
                    lore:
                        - " "
                        - "&cInformation"
                        - "&c- &7Time: &f%time%"
                        - "&c- &7Tier: &fCommon"
                        - " "
                        - "&7&o(( This gift is locked for another &f&o%time%&7&o! ))"
lang.yml
messages:
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cYou do not have &4permission&c for this!"
    "invalid-player":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cThe player &4%player%&c does not exist."
    "reset-player":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have reset &3%player%'s&b gift data."
    "gift-reached":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have reached the &3%name%&b Gift by playing for &3%time%&b."
    "gift-claimed":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have claimed the &3%name%&b Gift."
    "gift-locked":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cYou cannot claim this gift for another &4%time%&c."
    "admin-help":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&m-------------------------------------"
                - " "
                - "&b&lPlaytime Gifts &3&lAddon &8&l┃ &bAdmin Help"
                - "&7&oCoded and configured by &f&oRelocation#0001&7&o."
                - " "
                - "&3&lCOMMANDS:"
                - "&3&l» &b/gifts"
                - "&3&l» &b/gifts reset <player>"
                - " "
                - "&3&m-------------------------------------"
    "player-help":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&m-------------------------------------"
                - " "
                - "&b&lPlaytime Gifts &3&lAddon &8&l┃ &bPlayer Help"
                - "&7&oCoded and configured by &f&oRelocation#0001&7&o."
                - " "
                - "&3&lCOMMANDS:"
                - "&3&l» &b/gifts"
                - " "
                - "&3&m-------------------------------------"

Showcase Video

Frequently Asked Questions

How can i create playtime reward milestones?

It is very simple to create a reward milestone! Scroll all the way down to the rewards section in the settings.yml file. There, you can specify how many rewards should be given and when they should be given. Instead of having to create multiple milestones with the same time milestone, you can add as many commands as you want to the reward milestone.

Default Configuration Files

Main Configuration File
settings:
    time-until-afk: 10 #in seconds
    top-update-interval: 60 #in seconds
    afk-commands:
        - "say %player% has gone AFK."
    no-longer-afk-commands:
        - "say %player% is no longer AFK."
Messages Configuration File
messages:
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cYou do not have &4permission&c for this!"
    "you-are-afk":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cYou have now been marked as &4afk&c."
    "invalid-arguments":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cInvalid arguments!"
    "no-longer-afk":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&2&l[!] &aYou have &2moved&a and have now been taken out of &2afk mode&a."
    "reward-available":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&2&l[!] &aYou have earned the &2%type%&a reward! &7(/playtime)"
    "simulated-claim":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&2&l[!] &aYou have simulated a reward claim for &2%player%&a."
    "no-available-rewards":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cYou do not have any &4available&c rewards."
    "top-update-starting":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&6&l[!] &ePlaytime top is now starting to update! &7(/playtime)"
    "top-update-done":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&6&l[!] &ePlaytime top has finished updating! &7(/playtime)"
    "admin-help":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&m-------------------------------------"
                - " "
                - "&b&lAbyss&3&lPlaytime &8&l┃ &bAdmin Help"
                - "&7&oCoded and configured by &f&oRelocation#0001&7&o."
                - " "
                - "&3&lCOMMANDS:"
                - "&3&l» &b/playtime"
                - "&3&l» &b/playtime shop"
                - "&3&l» &b/playtime help"
                - "&3&l» &b/playtime givereward <player> <type>"
                - "&3&l» &b/playtime givecredits <player> <amount>"
                - "&3&l» &b/playtime takecredits <player> <amount>"
                - "&3&l» &b/playtime setcredits <player> <amount>"
                - " "
                - "&3&m-------------------------------------"
    "player-help":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&m-------------------------------------"
                - " "
                - "&b&lAbyss&3&lPlaytime &8&l┃ &bPlayer Help"
                - "&7&oCoded and configured by &f&oRelocation#0001&7&o."
                - " "
                - "&3&lCOMMANDS:"
                - "&3&l» &b/playtime"
                - "&3&l» &b/playtime shop"
                - "&3&l» &b/playtime help"
                - " "
                - "&3&m-------------------------------------"
    "saved":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&2&l[!] &aYou have &2saved&a all playtime data."
    "not-enough":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&4&l[!] &cYou don't have enough &4playtime credits&c to buy this!"
    "purchased":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have purchased &3%item%&b for &3%price%&b."
    "rotated":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bThe &3%shop%&b shop has &3rotated&b."
    "credits-gained":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have just gained &3%amount%x&b playtime credits for playing!"
    "given-credits":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have given &3%player% %amount%x&b playtime credits."
    "received-credits":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have received &3%amount%x&b playtime credits."
    "taken-credits":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have taken &3%amount%x&b playtime credits from &3%player%&b."
    "credits-took":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have had &3%amount%x&b playtime credits taken."
    "set-credits":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYou have set &3%player%'s&b playtime credits to &3%amount%x&b."
    "credits-set":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&l[!] &bYour playtime credits have been set to &3%amount%x&b."
Menus Configuration File
menus:
    "playtime-menu":
        title: "&8&lPLAYTIME MENU"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        info:
            material: "WATCH"
            name: "&6&l[&e&l!&6&l] &e%player%'s Statistics"
            lore:
                - " "
                - "&eInformation"
                - "&e&l▎ &7Name: &f%player%"
                - "&e&l▎ &7Playtime Credits: &f%credits%x"
                - "&e&l▎ &7Time Played: &f%time-played%"
                - "&e&l▎ &7Unclaimed Rewards: &f%unclaimed%"
                - " "
                - "&7&o(( You are viewing your &f&oplaytime&7&o stats! ))"
            slot: 11
        top:
            material: "PLAYER_HEAD"
            skull: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODQ3N2RhZmM4YzllYTA3OTk2MzMzODE3OTM4NjZkMTQ2YzlhMzlmYWQ0YzY2ODRlNzExN2Q5N2U5YjZjMyJ9fX0="
            name: "&6&l[&e&l!&6&l] &ePlaytime Top &7(Click)"
            lore:
                - " "
                - "&eInformation"
                - "&e&l▎ &7Action: &fOpen Playtime Top"
                - "&e&l▎ &7Usage: &fLeft-Click"
                - " "
                - "&7&o(( Click me to open &f&oplaytime&7&o top! ))"
            slot: 15
        claim:
            "unavailable":
                material: "ENDER_CHEST"
                name: "&4&l[&c&l!&4&l] &cNone Available"
                lore:
                    - " "
                    - "&cInformation"
                    - "&c&l▎ &7Unclaimed Rewards: &f%unclaimed%"
                    - "&c&l▎ &7Usage: &fLeft-Click"
                    - " "
                    - "&7&o(( You have no &f&oavailable&7&o rewards! ))"
            "available":
                material: "CHEST"
                name: "&2&l[&a&l!&2&l] &aClaim Rewards &7(Click)"
                lore:
                    - " "
                    - "&aInformation"
                    - "&a&l▎ &7Unclaimed Rewards: &f%unclaimed%"
                    - "&a&l▎ &7Usage: &fLeft-Click"
                    - " "
                    - "&7&o(( You have &f&o%unclaimed%&7&o available rewards! ))"
            slot: 13
    "top-menu":
        title: "&8&lPLAYTIME TOP"
        rows: 3
        top-slots: [ 10,11,12,13,14,15,16 ]
        top-update-interval: 60 #seconds
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        invalid-item:
            material: "PLAYER_HEAD"
            skull: "MHF_Question"
            name: "&c???"
            lore: [ ]
        valid-item:
            material: "PLAYER_HEAD"
            skull: "%player%"
            name: "&3&l[&b&l!&3&l] &b%player% &7(#%rank%)"
            lore:
                - "&7&o(( &f&o%player%&7&o has played for &f&o%amount%&7&o. ))"
        stats-item:
            slot: 26
            material: "PLAYER_HEAD"
            skull: "%player%"
            name: "&3&l[&b&l!&3&l] &b%player% &7(#%rank%)"
            lore:
                - "&7&o(( You have played for &f&o%amount%&7&o. ))"
    "main-shop-menu":
        title: "&8&lCATEGORIES"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        categories:
            "static":
                slot: 12
                open:
                    material: "LIME_DYE"
                    name: "&aStatic Shop &7(Open)"
                    lore: [ ]
                closed:
                    material: "RED_DYE"
                    name: "&cStatic Shop &7(Closed)"
                    lore: [ ]
            "rotating":
                slot: 14
                open:
                    material: "LIME_DYE"
                    name: "&aRotating Shop &7(Open)"
                    lore: [ ]
                closed:
                    material: "RED_DYE"
                    name: "&cRotating Shop &7(Closed)"
                    lore: [ ]
Rewards Configuration File
credit-settings:
    give-every: 60 # Seconds
    amount: 1

rewards:
    "default":
        seconds-needed: 20
        commands:
            - "eco give %player% 1000"
        claim-message:
            sound:
                enabled: true
                value: "LEVEL_UP"
                volume: 1
                pitch: 1
            message:
                enabled: true
                value:
                    - "&2&l[!] &aYou have claimed your &2Default&a reward."
    "default-2":
        seconds-needed: 30
        commands:
            - "eco give %player% 10000"
        claim-message:
            sound:
                enabled: true
                value: "LEVEL_UP"
                volume: 1
                pitch: 1
            message:
                enabled: true
                value:
                    - "&2&l[!] &aYou have claimed your &2Default 2&a reward."
Shops Configuration File
shops:
    "static":
        title: "&8&lSTATIC"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        open-time: "1/28/2022 17:30:00"
        rotating: false
        items:
            "diamond":
                slot: 13
                price: 10
                material: "DIAMOND"
                name: "&bDiamond &7(10 credits)"
                lore: []
                commands:
                    - "give %player% diamond 1"
    "rotating":
        title: "&8&lROTATING"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
            "light_gray":
                material: "LIGHT_GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "10-16"
        open-time: "1/28/2022 17:30:00"
        rotating: true
        rotating-time: 30 #In Seconds
        item-slots: [10,11,12,13,14,15,16]
        items:
            "diamond":
                price: 10
                material: "DIAMOND"
                name: "&bDiamond &7(10 credits)"
                lore: []
                commands:
                    - "give %player% diamond 1"
            "emerald":
                price: 10
                material: "EMERALD"
                name: "&aEmerald &7(10 credits)"
                lore: []
                commands:
                    - "give %player% emerald 1"
        rotating-item:
            slot: 18
            material: "CLOCK"
            name: "&eRotating in &f%time%&e."
            lore: []
PreviousInformationNextInformation

Last updated