Config

This page covers the configuration of the plugin

Sectionless

debug: true
prefix: '&e&lHubbly &7&l>&r'
check_for_update: true
# Send message if no update?
notify_on_no_update: false
default_language: en

• debug : Either true / false, setting this to true will send additional messages to console, useful for debugging and when contacting the developer.

• prefix: This is the prefix the plugin will use when sending messages.

• check_for_update: Enabling this will check for updates from SpigotMC

• notify_on_no_update: Disabling this will prevent the "Hubbly is up to date" message from being sent on join.

• default_language : When a player uses a language that isnt used, or simply for console, this defaults the language to a filename in Hubbly/languages

Disabled Worlds

disabled-worlds:
  - 'world_nether'

invert: false

• disabled-worlds: The list of which worlds to disable hubbly working in

• invert: Setting this to true will enable hubbly in the worlds in the list above.

Movement

Launchpad

launchpad:
  enabled: true
  type: "SLIME_BLOCK"
  power: 2
  power_y: 0.5
  # INTEGERS ONLY
  cooldown: 2

• type: This field will represents the block type.

• power: power on the X axis.

• power_y: power on the Y axis.

• cooldown: cooldown in seconds

Doublejump

double_jump:
  enabled: true
  power: 1.5
  power_y: 0.5
  # INTEGERS ONLY
  cooldown: 2

• power: power on the X axis.

• power_y: power on the Y axis.

• cooldown: cooldown in seconds

Items

Player Visibility

playervisibility:
  enabled: true
  visible:
    item: 'LIME_DYE'
    text: '&rPlayers: &aVisible'
  hidden:
    item: 'GRAY_DYE'
    text: '&rPlayers: &cHidden'

• visible: the item to show when players are set to visible

  • item: the item to use

  • text: Item name, supports hex color codes

• hidden: the item to show when players are set to hidden

  • item: the item to use

  • text: Item name, supports hex color codes

Movement Items

movementitems:
  enderbow:
    enabled: true
    name: "<#A020F0>Enderbow"
    cooldown: 3
  trident:
    enabled: true
    name: "<#40E0D0>Trident"
    cooldown: 3
  grappling_hook:
    enabled: true
    name: "<#FFFF00>Grappling Hook"
    cooldown: 3
  aote:
    enabled: true
    name: "<#2d0043>Aspect of the End"
    cooldown: 1

• item

  • name: the name of the item

  • cooldown: the cooldown of the item in seconds

• The enderbow will teleport you where the arrow lands

• The trident will teleport you where the trident lands

• The grappling hook works similar to hypixel's grappling hook, sending you flying forwards.

• The AOTE works similar to hypixel's Aspect of the End

Teleportation

antivoid:
  enabled: true

Enabling this teleports the player to spawn when they are falling in the void.

spawn:
  world: "world"
  x: 0
  y: 200
  z: 0
  #YAW AND PITCH WILL ROUND TO {-135, -90, -45, 0, 45, 90, 135} WHEN YOU USE /SETSPAWN, YOU CAN MANUALLY OVERRIDE THIS HERE
  yaw: 0
  pitch: 0

The spawn defined by the user, through config or /setspawn. Yaw and Pitch will round to the angles above when using setspawn. If you wish to override this, you can change it in config.

Player Settings

player:
    forceinventory: true    

Enabling this makes it so users without the hubbly.bypass.forceinventory permission are unable to edit their inventories.

  experience:
    enabled: true
    level: 2025
    # Takes a float 0.0 - 1.0
    # Set progress to "YEAR", If you want the progress to be based on time elapsed in the year.
    progress: 1.0

• level: Sets the user's EXP level.

• progress:

  • "YEAR": sets the users progress to the amount of time elapsed in the year.

  • 0.0 to 1.0: sets the users progress.

  fly:
    enabled: true

This allows the players to use /fly to fly if they have the permission.

  join_message:
    enabled: true
    message: "%name% joined"
  leave_message:
    enabled: true
    message: "%name% left"

Edits the join and leave message of the player (if enabled)

The %name% placeholder displays the player's name.

  bossbar:
    enabled: true
    color: "PURPLE"
    # ANIMATIONS IN TICKS
    animation:
      change-interval: 40
      texts:
        - '&6&lWelcome'
        - '<#69b320>&lHello!'

• color: The color of the bossbar. A list of colors can be found here.

• animation:

  • change-interval: How often the animation cycles in ticks.

  • texts: A list of texts to cycle through.

actions_on_join:
  - '[TITLE] <#FFDF00>Hubbly;configure me;20;70;20'
  - '[SOUND] block.note_block.chime'
  - '[FIREWORK] BALL;255;0;255;2'
  - '[ITEM] socials;1'
  - '[ITEM] compass;5'
  - '[ITEM] shop;9'

A list of actions to execute when the player joins. A list of actions can be found here.

World Event Manager

cancel_events:
  block_place: true
  block_break: true
  interact: true
  damage: true
  weather: true
  item_drop: true
  item_pickup: true
  item_throw: true
  hunger: true
  mob_spawn: true
  block_burn: true
  death_messages: true
  leaf_decay: true
  projectiles: false

Enabling each component cancels each event if the player does not have the required permission. A list of permissions can be found here.

anti_world_download:
  enabled: true
  notify_admin: true

Cancels basic world download mods. notify_adminnotifies players with the permission hubbly.notify.wdlthat someone has tried to use WDL.

Chat Management

lock_chat: false

blocked_words:
  enabled: false
  method: '' # Method can be STAR (for ****) or CANCEL, to cancel message
  words:
    - 'Crap'

• lock_chat: If enabled, people without the permission hubbly.bypass.chatlockwill be unable to chat

• blocked_words:

  • Enabling this will not let words in the list be allowed unless they have the permission hubbly.bypass.antiswear

  • method: Method to deal with the message, either STAR it (****) or CANCEL it.

blocked_commands:
  - 'pl'
  - 'plugins'
  - 'op'
  - 'stop'
  - 'reload'

Commands to block, and send the unknown command message.

announcements:
  enabled: true
  interval: 30 # In Seconds
  # Will send the message even if the player is in a disabled-world if true
  global: true
  messages:
    message1:
      - '<#FAEDCB>+<#F9E6C9>-<#F8DEC7>-<#F7D7C4>-<#F6CFC2>-<#F5C8C0>-<#F5C0BE>-<#F4B9BC>-<#F3B1B9>-<#F2AAB7>-<#F1A2B5>-<#F09BB3>-<#EF94B1>-<#EE8CAE>-<#ED85AC>-<#EC7DAA>-<#EB76A8>-<#EA6EA5>-<#EA67A3>-<#E95FA1>-<#E8589F>-<#E7509D>-<#E6499A>-<#E54198>-<#E43A96>-<#E54098>-<#E6479A>-<#E64D9C>-<#E7549E>-<#E85A9F>-<#E960A1>-<#EA67A3>-<#EA6DA5>-<#EB74A7>-<#EC7AA9>-<#ED80AB>-<#ED87AD>-<#EE8DAF>-<#EF94B1>-<#F09AB2>-<#F1A0B4>-<#F1A7B6>-<#F2ADB8>-<#F3B3BA>-<#F4BABC>-<#F5C0BE>-<#F5C7C0>-<#F6CDC2>-<#F7D3C3>-<#F8DAC5>-<#F8E0C7>-<#F9E7C9>-<#FAEDCB>+'
      - '<#FF00FF><center> Test</center>'
      - '<center><#084CFB>T<#1054FB>h<#175BFB>i<#1F63FB>s<#266AFB> <#2E72FB>i<#357AFC>s<#3D81FC> <#4489FC>a<#4C90FC>n<#5398FC> <#5BA0FC>a<#62A7FC>n<#6AAFFC>n<#71B6FC>o<#79BEFC>u<#80C5FC>n<#88CDFD>c<#8FD5FD>e<#97DCFD>m<#9EE4FD>e<#A6EBFD>n<#ADF3FD>t</center>'
      - ''
      - '<center><#00FFFF>Hello</center>'
      - '<#FAEDCB>+<#F9E6C9>-<#F8DEC7>-<#F7D7C4>-<#F6CFC2>-<#F5C8C0>-<#F5C0BE>-<#F4B9BC>-<#F3B1B9>-<#F2AAB7>-<#F1A2B5>-<#F09BB3>-<#EF94B1>-<#EE8CAE>-<#ED85AC>-<#EC7DAA>-<#EB76A8>-<#EA6EA5>-<#EA67A3>-<#E95FA1>-<#E8589F>-<#E7509D>-<#E6499A>-<#E54198>-<#E43A96>-<#E54098>-<#E6479A>-<#E64D9C>-<#E7549E>-<#E85A9F>-<#E960A1>-<#EA67A3>-<#EA6DA5>-<#EB74A7>-<#EC7AA9>-<#ED80AB>-<#ED87AD>-<#EE8DAF>-<#EF94B1>-<#F09AB2>-<#F1A0B4>-<#F1A7B6>-<#F2ADB8>-<#F3B3BA>-<#F4BABC>-<#F5C0BE>-<#F5C7C0>-<#F6CDC2>-<#F7D3C3>-<#F8DAC5>-<#F8E0C7>-<#F9E7C9>-<#FAEDCB>+'
    message2:
      - 'Test2'
      - 'This is a second announcement'
      - 'Goodbye'

• interval: Interval in which messages are sent, in seconds.

• global: When enabled, players in disabled worlds will also receive announcements.

Messages

messages:
  no_console: "Only players can use this command!"
  no_permission_command: "You do not have permission to use this command!"
  no_permission_use: "You do not have permission to use this!"
  reload: "Reloaded Hubbly plugin"
  fly:
    enable: "Flight mode enabled."
    disable: "Flight mode disabled."
  no_fly_enabled: "Flight is disabled in config"
  blocked_command: 'Unknown command. Type "/help" for help'
  blocked_message: 'Please do not use that word!'
  success: "Success!"

  # No PAPI support, only %player% placeholder to get the person who locked the chat.
  chat_locked: "Chat has been locked by %player%"
  chat_unlocked: "Chat has been unlocked by %player%"

update:
  new_update: "An update is available! Hubbly %new% can be downloaded on SpigotMC, you are on %current%"
  no_update: "Hubbly %current% is up to date"
  error: "Could not check for a new version..."