Skip to main content

TBGeneral Installation

Complete installation guide for TBGeneral external plugin.

Prerequisites​

Required:

  • ✅ Bukkit 1.21.3+ (Paper recommended but not required)
  • ✅ Java 21+
  • ✅ LuckPerms (required dependency)

Optional:

  • WorldEdit (for advanced world features)

Installation Steps​

1. Install LuckPerms First​

TBGeneral requires LuckPerms to function:

# Download LuckPerms from
# https://luckperms.net/download

# Place in plugins/ folder
plugins/LuckPerms.jar

Start server once to generate LuckPerms config.

2. Install TBGeneral​

  1. Download TBGeneral.jar
  2. Place in plugins/ folder
  3. Restart server (reload may not work)
  4. Verify installation:
/plugins
# TBGeneral should be GREEN

/tbg help
# Should show command list

3. Initial Configuration​

Auto-generated files:

plugins/TBGeneral/
├── config.yml       # Main configuration
├── portals.yml      # Portal definitions
├── worlds.yml       # World settings
└── textures.yml     # Resource pack configs

4. Configure Permissions​

Grant admin access:

/lp user <name> permission set tbgeneral.admin true
# Or for a group
/lp group admin permission set tbgeneral.admin true

Post-Installation Setup​

Enable Features​

Edit config.yml:

features:
  portals: true
  worlds: true
  textures: true
  utilities: true

Test Installation​

# Test portals
/tbg portal list

# Test worlds
/tbg world list

# Test textures
/tbg texture list

Troubleshooting​

LuckPerms Not Found​

Error: TBGeneral requires LuckPerms!

Fix:

  1. Download LuckPerms
  2. Install before TBGeneral
  3. Restart server

Commands Not Working​

Issue: /tbg not recognized

Solutions:

  1. Check plugin is GREEN in /plugins
  2. Verify permissions: /lp user <name> permission check tbgeneral.admin
  3. Check console for errors
  4. Try /reload confirm

Portals Not Working​

Check:

  • Portal properly configured in portals.yml
  • Destination world exists and is loaded
  • Player has permission to use portal

Migration​

From Other Portal Plugins​

  1. Disable old portal plugin
  2. Recreate portals using /tbg portal create
  3. Test each portal
  4. Remove old plugin when confirmed working

Performance​

TBGeneral is lightweight:

  • CPU: < 0.5% usage
  • RAM: ~10-15MB
  • TPS Impact: Negligible

Next: Commands - Learn all TBGeneral commands