Skip to main content

Overview

The /hubbly command is the main command for the Hubbly plugin, providing access to administrative functions, configuration management, and custom item distribution.

Syntax

/hubbly [subcommand] [arguments]

Aliases

  • /hb

Base Command

/hubbly
command
Running /hubbly without arguments displays usage information.Permission: hubbly.hubbly (default: true)

Subcommands

help

Displays a list of all available commands and their usage.
/hubbly help
subcommand
Shows all main commands and subcommands with their descriptions.Permission: hubbly.command.help
Example:
/hubbly help

version

Displays the current plugin version and API information.
/hubbly version
subcommand
Shows the plugin version, API version, and website URL.Permission: hubbly.command.version
Example:
/hubbly version

reload

Reloads the plugin’s configuration files.
/hubbly reload
subcommand
Reloads all configuration files and reinitializes boss bars.Permission: hubbly.command.reload (default: op)
Example:
/hubbly reload
This command will temporarily remove and re-add all boss bars during the reload process.

give

Gives a custom Hubbly item to a player.
/hubbly give <player> <item> [amount] [slot]
subcommand
Distributes custom items defined in the plugin configuration.Permission: hubbly.command.give (default: op)
player
string
required
The target player’s username.
item
string
required
The internal name of the custom item to give (e.g., compass, launchpad, trident).
amount
integer
The number of items to give (default: 1). Must be between 1 and the item’s max stack size.
slot
integer
The inventory slot to place the item in (1-36). If not specified, the item is added to the first available slot.
Examples:
/hubbly give Steve compass
/hubbly give Alex launchpad 5
/hubbly give Notch trident 1 9
The item name must match exactly with items defined in items.yml.

Opens a custom menu for a player.
/hubbly menu <menu>
subcommand
Opens a menu defined in the menus/ folder.Permission: hubbly.command.menu
menu
string
required
The name of the menu file (without .yml extension) located in the menus/ folder.
Examples:
/hubbly menu socials
/hubbly menu selector
Players can only execute this command. The menu must exist in the plugins/Hubbly/menus/ directory.

nextannouncement

Skips to the next scheduled announcement in the queue.
/hubbly nextannouncement
subcommand
Immediately broadcasts the next announcement without waiting for the timer.Permission: hubbly.command.nextannouncement (default: op)
Example:
/hubbly nextannouncement
This command respects disabled worlds and will not send announcements to players in those worlds.

convert

Converts legacy configuration files to the new menu format.
/hubbly convert <type>
subcommand
Converts old menu formats (v2.x) to the new v3.0 format.Permission: hubbly.command.convert
type
string
required
The type of file to convert. Valid options:
  • selector - Converts server selector configuration
  • socials - Converts socials menu configuration
Examples:
/hubbly convert selector
/hubbly convert socials
This command is deprecated as of v3.0.0 and is only intended for one-time migration from older versions.

worlds

Manages the disabled worlds list dynamically.
/hubbly worlds <subcommand>
subcommand
Control which worlds have Hubbly features enabled or disabled.Permission: hubbly.command.worlds
Subcommands:
  • add <world> - Add a world to the disabled worlds list
  • remove <world> - Remove a world from the disabled worlds list
  • check <world> - Check if a world is in the disabled worlds list
  • list - List all disabled worlds
Examples:
/hubbly worlds add world_nether
/hubbly worlds remove lobby
/hubbly worlds check world
/hubbly worlds list
Changes made with this command are temporary and will be lost on server restart. Edit config.yml for permanent changes.

pv

Manages player visibility (show/hide players).
/hubbly pv <show|hide>
subcommand
Toggle player visibility for the command sender.Permission: hubbly.command.playervisibility
Subcommands:
  • show - Show all players
  • hide - Hide all players
Examples:
/hubbly pv show
/hubbly pv hide
This is a player-only command and cannot be executed from console. Changes are saved to the database if enabled.

movement

Sets the player’s movement mode (fly, double jump, or none).
/hubbly movement <mode>
subcommand
Change the player’s active movement enhancement mode.Permission: hubbly.command.movement
Subcommands:
  • fly - Enable flight mode
  • doublejump - Enable double jump mode
  • none - Disable all movement enhancements
Examples:
/hubbly movement fly
/hubbly movement doublejump
/hubbly movement none
Only one movement mode can be active at a time. Setting a new mode will disable the previous one.

debug

Enables debug mode for troubleshooting.
/hubbly debug
subcommand
Toggle debug mode to see detailed plugin information in console.Permission: hubbly.command.debug
Example:
/hubbly debug
Debug mode can also be enabled in config.yml by setting debug: true.

Permissions

PermissionDescriptionDefault
hubbly.hubblyUse the base /hubbly commandtrue
hubbly.command.*Access to all subcommandsop
hubbly.command.helpUse /hubbly help-
hubbly.command.versionUse /hubbly version-
hubbly.command.reloadUse /hubbly reloadop
hubbly.command.giveUse /hubbly giveop
hubbly.command.menuUse /hubbly menu-
hubbly.command.nextannouncementUse /hubbly nextannouncementop
hubbly.command.convertUse /hubbly convert-
hubbly.command.worldsUse /hubbly worlds and subcommandsop
hubbly.command.playervisibilityUse /hubbly pv subcommands-
hubbly.command.movementUse /hubbly movement subcommands-
hubbly.command.debugUse /hubbly debugop

Tab Completion

The command provides tab completion for:
  • Subcommand names
  • Player names (for the give subcommand)
  • Item names (for the give subcommand)
  • Menu names (for the menu subcommand)

Source Reference

Implemented in:
  • HubblyCommand.java:59 - Main command handler
  • SubCommandManager.java - Subcommand registration and management

Build docs developers (and LLMs) love