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

Plugin	Description
Lands	Land claiming and nations
HuskTowns	Towns and nations
SuperiorSkyblock2	Skyblock islands
BetterTeams	Simple teams
SaberFactions	Factions
FactionsUUID	Factions
SimpleClans	Clans
GangsPlus	Gangs
UltimateClans	Clans

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

Placeholder	Description
%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

Plugin	Description
FeatherBoard	Advanced scoreboards
SternalBoard	Lightweight
TAB	Tab and scoreboard
TitleManager	Titles 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

Plugin	Description
DecentHolograms	Modern 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%