GroupeZ Docs

Integrations

Team and scoreboard plugin integrations

zKoth integrates with various team, scoreboard, and utility plugins for enhanced functionality.

Team Plugins

Team integrations allow KOTH to be captured as a team rather than individually.

Supported Team Plugins

PluginDescription
LandsLand claiming and nations
HuskTownsTowns and nations
SuperiorSkyblock2Skyblock islands
BetterTeamsSimple teams
SaberFactionsFactions
FactionsUUIDFactions
SimpleClansClans
GangsPlusGangs
UltimateClansClans

How Team Integration Works

  1. Auto-Detection: zKoth automatically detects installed team plugins
  2. Team Assignment: Players are assigned to their team when entering KOTH
  3. Team Capture: Points/time are tracked per team
  4. Team Rewards: Commands can target all team members

Team Placeholders

PlaceholderDescription
%teamName%Team display name
%teamId%Internal team ID
%teamLeader%Team leader name
%online-player%All online team members

Team Commands

Use %online-player% to run commands for all team members:

endCommands:
  # Give all online team members a reward
  - "give %online-player% diamond 5"

  # Announce to all team members
  - "msg %online-player% &aYour team won the KOTH!"

Team Blacklist

Block certain teams from participating:

blacklistTeamId:
  - "0"      # No team (solo players)
  - "-1"     # System teams
  - "admin"  # Admin team

Scoreboard Plugins

zKoth can integrate with external scoreboard plugins for better compatibility.

Supported Scoreboard Plugins

PluginDescription
FeatherBoardAdvanced scoreboards
SternalBoardLightweight
TABTab and scoreboard
TitleManagerTitles and boards

How Scoreboard Integration Works

  1. Auto-Detection: zKoth detects installed scoreboard plugins
  2. Fallback: Uses built-in FastBoard if none detected
  3. Configuration: Use the scoreboard plugin's config for styling
  4. Placeholders: All zKoth placeholders work in external plugins

Using PlaceholderAPI

With a scoreboard plugin that supports PlaceholderAPI:

# Example FeatherBoard config
lines:
  - "&6&lKOTH"
  - ""
  - "&7Name: &f%zkoth_name%"
  - "&7Status: &f%zkoth_active_castle%"
  - "&7Player: &f%zkoth_player_name%"
  - "&7Time: &f%zkoth_capture_format%"

Hologram Plugins

Display KOTH information with floating holograms.

Supported Hologram Plugins

PluginDescription
DecentHologramsModern holograms

Hologram Configuration

In your KOTH configuration file:

hologram:
  enable: true
  lines:
    - "&6&lKOTH: &f%name%"
    - ""
    - "&7Status: &aActive"
    - "&7Player: &f%playerName%"
    - "&7Time: &e%captureFormat%"
  world: world
  x: 100.5
  y: 70.0
  z: 200.5

Hologram Placeholders

All standard zKoth placeholders work in hologram lines.

PlaceholderAPI

PlaceholderAPI enables zKoth placeholders in other plugins.

Installation

  1. Install PlaceholderAPI
  2. zKoth registers its expansion automatically
  3. Use %zkoth_...% placeholders anywhere

Available Placeholders

See Placeholders for the complete list.

Example Uses

In a scoreboard plugin:

lines:
  - "%zkoth_name%"
  - "%zkoth_player_name%"
  - "%zkoth_capture_format%"

In a chat plugin:

format: "&7[%zkoth_team_name%] &f%player%: %message%"

In a hologram:

lines:
  - "KOTH: %zkoth_name%"
  - "Capturing: %zkoth_player_name%"

zScheduler

zScheduler enables automatic KOTH scheduling.

Features

  • Schedule KOTHs at specific times
  • Recurring events (daily, weekly)
  • Multiple KOTH rotation
  • Announcement system

Example Schedule

# In zScheduler configuration
schedules:
  koth_morning:
    time: "10:00"
    days:
      - MONDAY
      - WEDNESDAY
      - FRIDAY
    commands:
      - "zkoth spawn castle"

  koth_evening:
    time: "20:00"
    days:
      - SATURDAY
      - SUNDAY
    commands:
      - "zkoth now arena"

Integration Tips

Best Practices

  1. Test integrations - Verify plugins work together
  2. Check versions - Ensure compatibility
  3. Use PlaceholderAPI - For maximum flexibility
  4. Monitor performance - Some integrations may impact TPS

Common Issues

Team Not Detected

  1. Verify team plugin is installed
  2. Check console for integration messages
  3. Ensure player is in a team
  4. Restart server after installing plugins

Scoreboard Conflicts

  1. Disable zKoth's built-in scoreboard
  2. Use external plugin with placeholders
  3. Check scoreboard radius settings

Placeholders Not Working

  1. Verify PlaceholderAPI is installed
  2. Check placeholder syntax
  3. Run /papi ecloud download zkoth if needed
  4. Test with /papi parse me %zkoth_name%

Placeholders

Available placeholders in zKoth

On this page

Team PluginsSupported Team PluginsHow Team Integration WorksTeam PlaceholdersTeam CommandsTeam BlacklistScoreboard PluginsSupported Scoreboard PluginsHow Scoreboard Integration WorksUsing PlaceholderAPIHologram PluginsSupported Hologram PluginsHologram ConfigurationHologram PlaceholdersPlaceholderAPIInstallationAvailable PlaceholdersExample UseszSchedulerFeaturesExample ScheduleIntegration TipsBest PracticesCommon IssuesTeam Not DetectedScoreboard ConflictsPlaceholders Not Working
GroupeZ MCP

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.