RegionTimedBox 1.0.1

Allow players to stay in defined regions for a specific amount of time!

  1. Swiftlicious
    Native Minecraft Version:
    1.16
    Tested Minecraft Versions:
    • 1.16
    Contributors:
    Swiftlicious
    Information:
    This plugin allows you to create regions in your world that players that have a time value saved in their player data file are allowed to access only unless given the bypass permission. After the player's time runs out to be in this area they are teleported to your set spawnpoint and not allowed back in unless they get more time. Time can be given in many ways possibly by purchasing it in a shop or voting, it's up to you! This can be useful for mob arenas or areas you don't want players to be in for a long period of time!

    Permissions:

    "regiontimedbox.admin" (op) - Gets access to all of the admin commands.
    "regiontimedbox.bypass" (op) - Bypass needing time to be in a region.
    "regiontimedbox.time" (default) - See your time for a region.
    "regiontimedbox.access" (default) - Access the command to teleport to a region.

    Commands:

    /regiontimedbox - Shows all admin command pages that you have access to use.
    /arenas [region] - To view all active unlocked arenas/regions that you can teleport to or if one is defined then it'll directly teleport you!
    /arenatimes [region] - To view all of your time left in every region that is unlocked or if one is defined then it'll directly tell you for just that region!

    Default Config:
    Code (YAML):
    # REGION TIMED BOX CONFIG #
     
    Data
    :
      spawn-location
    :
       # The world that your spawn is located in.
        world
    : world
        # The X coordinate that your spawn block is on.
        x
    : 0
        # The Y coordinate that your spawn block is on.
        y
    : 70
        # The Z coordinate that your spawn block is on.
        z
    : 0
        # The yaw that you're facing on the spawn block.
        yaw
    : 90
      # Titles enabled when out of time and when teleported to region?
      titles-enabled
    : true
      # Action bar enabled as a countdown tool while in a region?
      actionbar-enabled
    : true
      # Sounds enabled when teleported to a region, back to spawn and counting down?
      sounds-enabled
    : true
      # Messages enabled when teleported to a region?
      messages-enabled
    : true
      # The sound that plays when you have 5 seconds left before being kicked from a region.
      # Sounds List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
      countdown-sound
    : "ENTITY_EXPERIENCE_ORB_PICKUP"
      # The sound that plays when you get teleported back to spawn.
      # Sounds List: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
      back-to-spawn-sound
    : "ENTITY_WITHER_DEATH"
     
    Messages
    :
     ############################################################################################################################################################
      ## YOU CAN CUSTOMIZE THE HOVER AND CLICK EVENTS YOURSELF ##
      ## - [json|*options*]chat text[/json] - ##
      ## Option    Action    Description ##
      ## suggest=<suggestion>    Click    <suggestion> will appear in the player chat text field ##
      ## run=<text>    Click    Player will send <text>, commands are possible too ##
      ## link=<url>   Click    Player will be asked if they want to open <url> in a browser ##
      ## hover=<text> Hover    <text> will appear above the cursor if hovered by the mouse ##
      ## You can add multiple hover events within the same message just write in the above format! ##
      ## To add multiple options for chat text use |json| as deliminter. Please note that you can of course just add one possible option per action. ##
      ## To make multiple lines in a hover event you can use the placeholder %n, NOTE: This only works inside hover= events! ##
      ## Here are some example Json Messages: ##
      ## &awowow ['json|suggest=test']&brandom text[/json] ##
      ## ['json|hover=runs /list|json|run=/list']&erun &c/list[/json] ##
      ## ['json|hover=opens google|json|link=http://www.google.com']google &blink[/json] ##
      ## If you wish to center messages in chat type the phrase <center> in front of the message. This works for all chat type messages. ##
      ## You can't mix the <center> tag and also use hover events in the same message, if you want to center them you'll have to calculate the spaces yourself! ##
      ############################################################################################################################################################
      # Variables: %prefix% %cmd-label% %time% %point% %x% %y% %z% %yaw% %world% %user% %x1% %y1% %z1% %x2% %y2% %z2% %total-page% %total-line%
      # Variables: %centerx% %centery% %centerz% %centeryaw% %id% %total-id% %name% %status% %sound% %message% %subtitle% %title% %line%
      prefix
    : "&7[&dRegion&aTimed&bBox&7]"
      list-arenas-header
    : "%prefix% &eArena List:"
      list-arenas-format
    : "&6%id%&7. &b%name% ['json|hover=&aTeleport to &6%name%&a!|json|run=/arena %name%']&a&l[CLICK TO TELEPORT][/json]"
      no-arenas-found
    : "&cNo arenas were found!"
      invalid-arena
    : "%prefix% &cThe arena you provided doesn't exist!"
      list-time-header
    : "%prefix% &cArena Times:"
      list-time-format
    : "&6%id%&7. &b%name% &7(&e%time% &6left&7)"
      time-left-in-region
    : "%prefix% &aYou have &e%time% &aleft in arena &6%name%&a!"
      no-permission-to-see-time
    : "%prefix% &cYou don't have permission to see times!"
      no-permission-to-see-region
    : "%prefix% &cYou don't have permission to see regions!"
      no-time-remaining
    : "%prefix% &cYou don't have any time remaining for arena &e%name%&c!"
      no-permission-to-access-region
    : "%prefix% &cYou can't access this region!"
      teleported-to-region
    : "%prefix% &aYou've teleported to arena &6%name%&a! Starting timer now!"
      back-to-spawn-title
    : "&4&lTIME'S UP!"
      back-to-spawn-subtitle
    : "&cYou've ran out of time to be here!"
      countdown-actionbar
    : "&bYou have &6%time% &bleft to be here!"
      teleported-to-spawn
    : "%prefix% &aYou've been teleported to spawn since your time has ran out!"
      set-time
    : "%prefix% &aYou've had your time adjusted to &e%time% &afor arena &6%name%&a!"
      get-time
    : "%prefix% &e%user% &ahas a current time total of &6%time% &afor region #&e%id%&a!"
      reloaded-config
    : "%prefix% &aThe config.yml and regions.yml has been reloaded!"
      missing-ID
    : "%prefix% &cYou're missing a valid region ID!"
      invalid-ID
    : "%prefix% &cThe ID you've provided is invalid! There are a total of &6%total-id%&c!"
      set-point
    : "%prefix% &aYou've set region #&e%id%&a's point &e%point% &aat &6%x%&a, &6%y%&a, &6%z%&a!"
      same-point
    : "%prefix% &cThe location you're at is already the same as point &e%point% &cfor this region!"
      wrong-world
    : "%prefix% &cYou're not in the world region #&4%id% &cis set in!"
      invalid-point
    : "%prefix% &cThe point you tried to set is invalid! &7/%cmd-label% setpoint [ID] [1/2]"
      set-spawn
    : "%prefix% &aYou've set the spawn at &6%x%&a, &6%y%&a, &6%z% &awith a Yaw of &6%yaw% &ain the world &6%world%&a!"
      same-spawn
    : "%prefix% &cThe location you're at is already the same spawn in the config!"
      missing-time
    : "%prefix% &cYou need to provide a valid time to add/remove!"
      added-time
    : "%prefix% &aYou've added &6%time% &ato &e%user%&a's total time for region #&e%id%&a!"
      removed-time
    : "%prefix% &aYou've removed &6%time% &afrom &e%user%&a's total time for region #&e%id%&a!"
      no-time-to-remove
    : "%prefix% &cThe user &e%user% &chas no time to remove for region #&4%id%&c!"
      not-enough-time
    : "%prefix% &cThe user &e%user% &ccan only have &6%time% &cremoved for region #&4%id%&c!"
      missing-arguments
    : "%prefix% &cYou need to provide a valid region ID, username and time to add/remove!"
      missing-username
    : "%prefix% &cYou need to provide a valid username to modify/retrieve their time for region #&4%id%&c!"
      no-user-found
    : "%prefix% &cThe user with the name &e%user% &cwas not found!"
      invalid-number
    : "%prefix% &cThe number you've provided is invalid!"
      invalid-world
    : "%prefix% &cThe world you've provided is invalid!"
      same-world
    : "%prefix% &cThe world &6%world% &cis already the same world for this region!"
      set-world
    : "%prefix% &aYou've set the world as &6%world% &afor region #&e%id%&a!"
      missing-name
    : "%prefix% &cYou need to provide a valid name to set for this region!"
      same-name
    : "%prefix% &cThe name &6%name% &cis already the same name for this region!"
      set-name
    : "%prefix% &aYou've set the name as &6%name% &afor region #&e%id%&a!"
      created-region
    : "%prefix% &aYou've created region #&e%id% &7(&6%name%&7)&a!"
      region-already-exists
    : "%prefix% &cThe name &6%name% &calready exists for a region!"
      deleted-region
    : "%prefix% &aYou've deleted region #&e%id% &7(&6%name%&7)&a!"
      region-list-header
    : "%prefix% &eRegions List:"
      regions-list-empty
    : "&cThere are currently no regions available!"
      regions-list-teleport
    : "&bRegion &6#%id%&b. &e%name% ['json|hover=&aTeleport to &6%name%&a!|json|run=/arena %name%']&a&l[TELEPORT][/json]"
      regions-list-invalid
    : "&bRegion &6#%id%&b. &e%name% ['json|hover=&cInvalid Region Setup']&c&l[NOT SETUP][/json]"
      regions-list-console
    : "&bRegion &6#%id%&b. &e%name% &a&l[SETUP]"
      regions-list-console-invalid
    : "&bRegion &6#%id%&b. &e%name% &c&l[NOT SETUP]"
      not-inside-region
    : "%prefix% &cYou're not inside region #&4%id%&c's boundaries to set the center for it!"
      same-center
    : "%prefix% &cThe location you're at is already the same as the center for this region!"
      set-center
    : "%prefix% &aYou've set region #&e%id%&a's center at &6%x%&a, &6%y%&a, &6%z%&a!"
      not-ready-to-unlock
    : "%prefix% &cThe region #&4%id% &ccan't be unlocked until it's fully setup!"
      locked-region
    : "%prefix% &aYou've set region #&e%id%&a's status to &c&lLOCKED&a!"
      unlocked-region
    : "%prefix% &aYou've set region #&e%id%&a's status to &a&lUNLOCKED&a!"
      already-locked
    : "%prefix% &cThe region #&4%id% &cis already locked!"
      already-unlocked
    : "%prefix% &cThe region #&4%id% &cis already unlocked!"
      set-sound
    : "%prefix% &aYou've set the sound as &6%sound% &afor region #&e%id%&a!"
      same-sound
    : "%prefix% &cThe sound &6%sound% &cis already the same sound for this region!"
      missing-sound
    : "%prefix% &cYou need to provide a valid sound to set for this region!"
      invalid-sound
    : "%prefix% &cThe sound you've provided is invalid!"
      set-title
    : "%prefix% &aYou've set the title as '&6%title%&a' for region #&e%id%&a!"
      same-title
    : "%prefix% &cThe title '&6%title%&c' is already the same title for this region!"
      missing-title
    : "%prefix% &cYou need to provide a valid title to set for this region!"
      title-too-long
    : "%prefix% &cThe title you've provided is too long! Max &648 &ccharacters!"
      set-subtitle
    : "%prefix% &aYou've set the subtitle as '&6%subtitle%&a' for region #&e%id%&a!"
      same-subtitle
    : "%prefix% &cThe subtitle '&6%subtitle%&c' is already the same subtitle for this region!"
      missing-subtitle
    : "%prefix% &cYou need to provide a valid subtitle to set for this region!"
      subtitle-too-long
    : "%prefix% &cThe subtitle you've provided is too long! Max &648 &ccharacters!"
      added-message
    : "%prefix% &aYou've added the message '&6%message%&a' for region #&e%id%&a!"
      removed-message
    : "%prefix% &aYou've removed the message '&6%message%&a' on line &6%line% &afrom region #&e%id%&a!"
      missing-line
    : "%prefix% &cYou need to provide a valid line to remove the message from!"
      invalid-line
    : "%prefix% &cThe line you've provided is invalid! There are a total of &6%total-line%&c!"
      missing-message
    : "%prefix% &cYou need to provide a valid message to add for this region!"
      message-too-long
    : "%prefix% &cThe message you've provided is too long! Max &664 &ccharacters!"
      reached-max-lines
    : "%prefix% &cYou've reached the maximum &610 &clines you can have!"
      invalid-page
    : "%prefix% &cThe page you've provided is invalid! There are a total of &6%total-page%&c!"
      gain-time-info
    :
       - "<center>&6&m+&e&m--------------------------------------------------&6&m+"
        - "<center>&bHow to gain Time!"
        - "<center>&aYou must purchase time from &d/shop&a!"
        - "<center>&6&m+&e&m--------------------------------------------------&6&m+"
      region-header
    : "%prefix% &cRegion #&4%id% &cInformation:"
      region-info
    :
       - " "
        - "&bName
    : &e%name%"
        - "&bWorld
    : &e%world%"
        - "&bLocked
    : &e%status%"
        - "&bSound
    : &e%sound%"
        - "&bTitle
    : &e%title%"
        - "&bSubtitle
    : &e%subtitle%"
        - "&bMessage:"
        - "&7- &e%message%"
        - "&aCenter
    : &dX &8- &6%centerx% &7| &dY &8- &6%centery% &7| &dZ &8- &6%centerz% &7| &dYaw &8- &6%centeryaw%"
        - "&aPoint 1
    : &dX &8- &6%x1% &7| &dY &8- &6%y1% &7| &dZ &8- &6%z1%"
        - "&aPoint 2
    : &dX &8- &6%x2% &7| &dY &8- &6%y2% &7| &dZ &8- &6%z2%"
        - " "
      console-help-header
    : "%prefix% &aConsole Commands:"
      console-help-pages
    :
        '1'
    :
         - " "
          - "&6/%cmd-label% reload &7- &eReload the config.yml!"
          - "&6/%cmd-label% listregions &7- &eLists off all of your regions!"
          - "&6/%cmd-label% createregion [name] &7- &eCreate a new region!"
          - "&6/%cmd-label% removeregion [ID] &7- &eRemove a region!"
          - "&6/%cmd-label% lock/unlock [ID] &7- &eSet if the region is locked or not from public access!"
          - "&6/%cmd-label% getregion [ID] &7- &eGet the region ID's information like the world, center and points!"
          - "&6/%cmd-label% setname [ID] [name] &7- &eSet the name of this region!"
          - " "
          - "&7To see the next page use &a/%cmd-label% help 2&7!"
        '2'
    :
         - " "
          - "&6/%cmd-label% gettime [ID] [player] &7- &eGet the current total time a specific player has left in a region!"
          - "&6/%cmd-label% addtime [ID] [player] [number] &7- &eAdd time to a specific player for a region!"
          - "&6/%cmd-label% removetime [ID] [player] [number] &7- &eRemove time from a specific player for a region!"
          - "&6/%cmd-label% setsound [ID] [sound] &7- &eSet the sound for this region!"
          - "&6/%cmd-label% addmessage [ID] [message] &7- &eAdd a message for this region! (Use '_' as spaces!)"
          - "&6/%cmd-label% removemessage [ID] [line] &7- &eRemove a message from this region at the defined line!"
          - "&6/%cmd-label% settitle/setsubtitle [ID] [message] &7- &eSet the title or subtitle for this region! (Use '_' as spaces!)"
          - " "
      admin-help-header
    : "%prefix% &cAdmin Help Commands:"
      admin-help-pages
    :
        '1'
    :
         - " "
          - "&6/%cmd-label% reload &7- &eReload the config.yml!"
          - "&6/%cmd-label% setspawn &7- &eSet the location players get teleported to when out of time!"
          - "&6/%cmd-label% createregion [name] &7- &eCreate a new region!"
          - "&6/%cmd-label% removeregion [ID] &7- &eRemove a region!"
          - "&6/%cmd-label% listregions &7- &eLists off all of your regions!"
          - "&6/%cmd-label% setcenter [ID] &7- &eSet the center of this region!"
          - "&6/%cmd-label% setname [ID] [name] &7- &eSet the name of this region!"
          - " "
          - "&7To see the next page use ['json|hover=&bClick to go to Page &e2&b!|json|run=/%cmd-label% help 2']&a/%cmd-label% help 2[/json]&7!"
        '2'
    :
         - " "
          - "&6/%cmd-label% setworld [ID] &7- &eSet the world that this region is in!"
          - "&6/%cmd-label% setpoint [ID] [1/2] &7- &eSet the two locations at which this region will be created for!"
          - "&6/%cmd-label% lock/unlock [ID] &7- &eSet if the region is locked or not from public access!"
          - "&6/%cmd-label% getregion [ID] &7- &eGet the region ID's information like the world, center and points!"
          - "&6/%cmd-label% gettime [ID] [player] &7- &eGet the current total time a specific player has left in a region!"
          - "&6/%cmd-label% addtime [ID] [player] [number] &7- &eAdd time to a specific player for a region!"
          - "&6/%cmd-label% removetime [ID] [player] [number] &7- &eRemove time from a specific player for a region!"
          - " "
          - "&7To see the next page use ['json|hover=&bClick to go to Page &e3&b!|json|run=/%cmd-label% help 3']&a/%cmd-label% help 3[/json]&7!"
        '3'
    :
         - " "
          - "&6/%cmd-label% setsound [ID] [sound] &7- &eSet the sound for this region!"
          - "&6/%cmd-label% addmessage [ID] [message] &7- &eAdd a message for this region! (Use '_' as spaces!)"
          - "&6/%cmd-label% removemessage [ID] [line] &7- &eRemove a message from this region at the defined line!"
          - "&6/%cmd-label% settitle/setsubtitle [ID] [message] &7- &eSet the title or subtitle for this region! (Use '_' as spaces!)"
          - " "
    Suggestions are welcome to make the plugin more unique and fun :)!​

Recent Updates

  1. Fixed resource update tag