Skip to main content
Get your Hubbly Minecraft hub plugin configured and running in just a few minutes. This guide will walk you through the essential setup steps to create a fully functional hub server.
1

Install and Generate Configuration

  1. Place the Hubbly.jar file in your server’s plugins folder
  2. Start your server to generate the default configuration files
  3. Stop the server to edit the configuration files
You’ll find two main configuration files in plugins/Hubbly/:
  • config.yml - Main plugin configuration
  • items.yml - Custom item definitions
2

Configure Spawn Location

The spawn point is where players teleport when using /spawn or the anti-void feature.Option 1: In-game (Recommended)
# Stand at your desired spawn location and run:
/hubbly setspawn
Option 2: Manual ConfigurationEdit config.yml:
config.yml
spawn:
  world: "world"
  x: 0
  y: 200
  z: 0
  yaw: 0
  pitch: 0
  timer: 2  # Seconds before teleport
  sound: entity.firework_rocket.blast
Yaw and pitch values will automatically round to standard angles (-135, -90, -45, 0, 45, 90, 135) when using /setspawn
3

Enable Movement Features

Hubbly includes several movement enhancement features. Configure them in config.yml:Launchpads
config.yml
launchpad:
  enabled: true
  type: "SLIME_BLOCK"  # Block type that acts as launchpad
  power: 2             # Horizontal velocity multiplier
  power_y: 0.5         # Vertical velocity multiplier
  cooldown: 2          # Cooldown in seconds
  sound: entity.firework_rocket.blast
Double Jump
config.yml
double_jump:
  enabled: true
  power: 1.5     # Horizontal boost
  power_y: 0.5   # Vertical boost
  cooldown: 2    # Cooldown in seconds
Anti-Void Teleport
config.yml
antivoid:
  enabled: true  # Teleports players to spawn when they fall into void
Make sure to test movement features in a controlled area to ensure power values work well with your hub design
4

Setup Custom Items

Create custom items that players receive on join or can obtain via commands.Add items to items.yml:
items:
  compass:
    name: "&cCompass"
    material: COMPASS
    glow: true
    lore:
      - "&7Right click me to open"
      - "&7the server selector!"
    actions:
      - "[MENU] selector"
Give items to players:
/hubbly give <player> <item>
# Example: /hubbly give Steve compass
Auto-give items on join:
config.yml
actions_on_join:
  - '[ITEM] socials;1'   # Item name;slot number
  - '[ITEM] compass;5'
  - '[ITEM] shop;9'
5

Configure Movement Items

Enable special movement items like grappling hooks and teleportation swords:
config.yml
movementitems:
  grappling_hook:
    material: FISHING_ROD
    enabled: true
    name: "<#FFFF00>Grappling Hook"
    cooldown: 3
  
  aote:
    material: DIAMOND_SWORD
    enabled: true
    name: "<#2d0043>Aspect of the End"
    cooldown: 1
  
  trident:
    material: TRIDENT
    enabled: true
    name: "<#40E0D0>Trident"
    cooldown: 3
For enderbow and trident, do not change the material type as they rely on specific item mechanics
6

Configure Player Settings

Customize the player experience with these essential settings:
config.yml
player:
  forceinventory: true  # Prevent inventory changes
  
  experience:
    enabled: true
    level: 2025
    progress: 1.0  # 0.0 to 1.0 or "YEAR" for time-based
  
  fly:
    enabled: true  # Allow flight in hub
  
  join_message:
    enabled: true
    message: "%name% joined"
  
  leave_message:
    enabled: true
    message: "%name% left"
  
  bossbar:
    enabled: true
    color: "PURPLE"
    animation:
      change-interval: 40  # Ticks between text changes
      texts:
        - '&6&lWelcome'
        - '<#69b320>&lHello!'
Join Actions - Execute actions when players join:
config.yml
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'
7

Configure World Protection

Protect your hub world from unwanted modifications:
config.yml
cancel_events:
  block_place: true
  block_break: true
  interact: true       # Prevent interactions (buttons, etc.)
  damage: true         # Disable player damage
  weather: true        # Keep weather constant
  item_drop: true
  item_pickup: true
  hunger: true         # Disable hunger
  mob_spawn: true      # Prevent mob spawning
  death_messages: true
  projectiles: false   # Allow projectiles for movement items
Keep projectiles: false if you’re using movement items like the Enderbow or Trident
8

Reload and Test

After making your configuration changes:
# Reload the plugin
/hubbly reload
Testing Checklist:
  • Spawn point teleportation works (/spawn)
  • Players receive items on join
  • Movement features work (double jump, launchpads)
  • Movement items function correctly
  • Players cannot break/place blocks
  • Flight is enabled
  • Boss bar displays correctly
  • Anti-void teleports players to spawn
  • Custom items give correct actions

​
Common Use Cases

​
Setup Player Visibility Toggle

Configure the player visibility item:
config.yml
playervisibility:
  enabled: true
  visible:
    item: 'LIME_DYE'
    text: '&rPlayers: &aVisible'
  hidden:
    item: 'GRAY_DYE'
    text: '&rPlayers: &cHidden'

​
Database Configuration

Enable database storage for persistent data:
config.yml
database:
  enabled: true
  host: localhost
  port: 3306
  database: minecraft
  username: hubbly
  password: your_secure_password
Never commit your database credentials to version control. Use environment variables or secure configuration management

​
Disable Plugin in Specific Worlds

Prevent Hubbly from running in certain worlds:
config.yml
disabled-worlds:
  - 'world_nether'
  - 'world_the_end'

invert: false  # Set to true to make it a whitelist instead

​
Block Commands

Prevent players from using specific commands:
config.yml
blocked_commands:
  - 'pl'
  - 'plugins'
  - 'op'
  - 'stop'
  - 'reload'

​
Setup Announcements

Configure automatic announcements with RGB colors:
config.yml
announcements:
  enabled: true
  interval: 30  # Seconds between announcements
  global: true  # Send even in disabled-worlds
  messages:
    message1:
      - '<center><#084CFB>W<#1F63FB>e<#3D81FC>l<#5BA0FC>c<#79BEFC>o<#97DCFD>m<#ADF3FD>e</center>'
      - ''
      - '<center>&7Visit our store at &estore.example.com</center>'

​
Next Steps

Configuration Reference

Explore all available configuration options

Commands & Permissions

Learn about all available commands

Custom Items

Create advanced custom items

Menus

Build interactive GUI menus

Build docs developers (and LLMs) love

Get started for freeTalk to us