Skip to main content

TBGeneral Usage

Practical tutorials and workflows for using TBGeneral effectively.

Portal Setup Workflows​

Basic Hub Portal System​

Goal: Create a hub with portals to different worlds

Steps:

  1. Create Hub World:
/tbg world create hub FLAT
/tbg world tp hub

  1. Build Portal Frames (in hub):

    • Create visual portal frames (nether portal blocks, etc.)
    • Note coordinates for each portal

  2. Create Portal Waypoints:

# Stand in first portal frame
/tbg portal create hub_to_survival

# Stand in second portal
/tbg portal create hub_to_creative

# Stand in third portal
/tbg portal create hub_to_minigames
  1. Link Portals to Destinations:
/tbg portal link hub_to_survival world,spawn
/tbg portal link hub_to_creative creative,spawn
/tbg portal link hub_to_minigames minigames,0,64,0
  1. Create Return Portals (in each world):
# In survival world
/tp world 0 64 0
/tbg portal create survival_to_hub
/tbg portal link survival_to_hub hub,spawn

# Repeat  for other worlds
  1. Test:
    • Walk through each portal
    • Verify teleportation works
    • Check return portals

Network of Connected Worlds​

Goal: Multiple worlds with bidirectional portals

# Create worlds
/tbg world create world1 NORMAL
/tbg world create world2 NORMAL
/tbg world create world3 NORMAL

# Create portal in world1 → world2
/tp world1 100 64 100
/tbg portal create w1_to_w2
/tbg portal link w1_to_w2 world2,100,64,100

# Create return portal world2 → world1
/tp world2 100 64 100
/tbg portal create w2_to_w1
/tbg portal link w2_to_w1 world1,100,64,100

# Create portal world2 → world3
/tp world2 200 64 200
/tbg portal create w2_to_w3
/tbg portal link w2_to_w3 world3,100,64,100

# Continue pattern...

World Management Workflows​

Resource World Reset System​

Goal: Monthly resource world reset

Setup:

  1. Create Initial Resource World:
/tbg world create resource NORMAL
  1. Configure Auto-Save: Edit worlds.yml:
worlds:
  resource:
    type: NORMAL
    auto-load: true
    border:
      enabled: true
      size: 5000
  1. Monthly Reset Procedure:
# 1. Announce reset
# "Resource world resetting in 5 minutes!"

# 2. Teleport players out
/minecraft:tp @a[world=resource] world 0 64 0

# 3. Unload world
/tbg world unload resource --save

# 4. Delete old world
/tbg world delete resource --confirm

# 5. Create new world
/tbg world create resource NORMAL

# 6. Update portals (if needed)
/tbg portal link hub_to_resource resource,spawn

Multiple Minigame Worlds​

Goal: Separate world for each minigame

# Create minigame worlds
/tbg world create mg_spleef FLAT
/tbg world create mg_parkour FLAT
/tbg world create mg_pvp NORMAL

# Set gamemodes
# (Configure in worlds.yml)

# Create selection portals in lobby
/tp lobby 10 64 10
/tbg portal create lobby_to_spleef
/tbg portal link lobby_to_spleef mg_spleef,spawn

/tp lobby 20 64 10
/tbg portal create lobby_to_parkour
/tbg portal link lobby_to_parkour mg_parkour,spawn

Texture Pack Workflows​

Server-Wide Resource Pack​

Goal: Apply custom pack to all players

Setup:

  1. Upload Pack:

    • Host pack on web server
    • Get direct download URL
    • Generate SHA-1 hash:
    # On Linux/Mac
    shasum -a 1 pack.zip

    # On Windows PowerShell
    Get-FileHash -Algorithm SHA1 pack.zip

  2. Configure in textures.yml:

textures:
  server_pack:
    url: "https://example.com/packs/server.zip"
    hash: "abc123def456..."  # Your hash
    required: false
    prompt: "&aDownload our custom textures?"
    force-on-join: true
    apply-to-groups:
      - default
  1. Apply to Online Players:
/tbg texture apply server_pack @a
  1. Test:
    • Join server with new account
    • Pack should auto-download
    • Verify textures show correctly

Rank-Specific Resource Packs​

Goal: Different packs for different ranks

Setup textures.yml:

textures:
  default_pack:
    url: "https://example.com/default.zip"
    hash: "hash1..."
    force-on-join: true
    apply-to-groups:
      - default
  
  vip_pack:
    url: "https://example.com/vip.zip"
    hash: "hash2..."
    force-on-join: true
    apply-to-groups:
      - vip
      - mvp
  
  staff_pack:
    url: "https://example.com/staff.zip"
    hash: "hash3..."
    force-on-join: true
    apply-to-groups:
      - mod
      - admin

Permissions:

# VIPs get vip pack
/lp group vip permission set tbgeneral.texture.use true

# Staff can bypass and choose
/lp group staff permission set tbgeneral.texture.bypass true

Common Use Cases​

Lobby Server Setup​

# 1. Create lobby
/tbg world create lobby FLAT

# 2. Create game worlds
/tbg world create survival NORMAL
/tbg world create creative FLAT
/tbg world create minigames FLAT

# 3. Set lobby as main world
# (Edit server.properties: level-name=lobby)

# 4. Create portals in lobby
# Walk to each portal location and:
/tbg portal create lobby_to_survival
/tbg portal create lobby_to_creative
/tbg portal create lobby_to_minigames

# 5. Link portals
/tbg portal link lobby_to_survival survival,spawn
/tbg portal link lobby_to_creative creative,spawn
/tbg portal link lobby_to_minigames minigames,spawn

# 6. Create return portals
# In each world, create portal back to lobby

VIP World Access​

# 1. Create VIP world
/tbg world create vip_world NORMAL

# 2. Create VIP portal
/tp hub 50 64 50
/tbg portal create hub_to_vip

# 3. Link with permission
# Edit portals.yml:
permission: tbgeneral.portal.use.vip

# 4. Grant to VIPs
/lp group vip permission set tbgeneral.portal.use.vip true

Event World​

# 1. Create event world
/tbg world create event NORMAL

# 2. Don't auto-load
# Edit worlds.yml:
auto-load: false

# 3. Load for event
/tbg world load event

# 4. Create temporary portal
/tbg portal create event_portal
/tbg portal link event_portal event,spawn

# 5. After event
/tbg portal delete event_portal
/tbg world unload event --save

Tips & Tricks​

Portal Design​

  • Build visual portal frames with nether portal blocks
  • Add signs with destination names
  • Use particle effects from config
  • Add title messages for immersion

World Organization​

  • Prefix worlds by type: mg_spleef, res_resource, hub_main
  • Keep spawn points organized and documented
  • Use world borders to prevent players going too far
  • Regular backups before resets

Performance Optimization​

  • Unload unused worlds
  • Use async world loading
  • Limit max portals per world
  • Set reasonable cooldowns

Common Pitfalls​

❌ Don't: Create portals without testing return paths
✅ Do: Always create bidirectional portals

❌ Don't: Delete worlds without backing up
✅ Do: Backup before any destructive operations

❌ Don't: Force required packs without testing
✅ Do: Test packs as optional first

Troubleshooting Usage​

Portals Not Teleporting​

  1. Check portal is enabled in portals.yml
  2. Verify player has permission
  3. Check cooldown hasn't triggered
  4. Ensure destination world is loaded

Resource Pack Not Applying​

  1. Verify URL is direct download link
  2. Check SHA-1 hash is correct
  3. Ensure player has tbgeneral.texture.use
  4. Try removing and reapplying

World Won't Load​

  1. Check world files exist
  2. Verify world type is correct
  3. Check console for errors
  4. Try manual load: /tbg world load <name>

Next: Portals | Worlds | Textures - Detailed feature guides