Integrations

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

Team PluginsCopier le lien vers ce titre

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

Supported Team PluginsCopier le lien vers ce titre

How Team Integration WorksCopier le lien vers ce titre

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 PlaceholdersCopier le lien vers ce titre

Team CommandsCopier le lien vers ce titre

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 BlacklistCopier le lien vers ce titre

Block certain teams from participating:

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

Scoreboard PluginsCopier le lien vers ce titre

zKoth can integrate with external scoreboard plugins for better compatibility.

Supported Scoreboard PluginsCopier le lien vers ce titre

How Scoreboard Integration WorksCopier le lien vers ce titre

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 PlaceholderAPICopier le lien vers ce titre

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 PluginsCopier le lien vers ce titre

Display KOTH information with floating holograms.

Supported Hologram PluginsCopier le lien vers ce titre

Hologram ConfigurationCopier le lien vers ce titre

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 PlaceholdersCopier le lien vers ce titre

All standard zKoth placeholders work in hologram lines.

PlaceholderAPICopier le lien vers ce titre

PlaceholderAPI enables zKoth placeholders in other plugins.

InstallationCopier le lien vers ce titre

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

Available PlaceholdersCopier le lien vers ce titre

See Placeholders for the complete list.

Example UsesCopier le lien vers ce titre

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%"

zSchedulerCopier le lien vers ce titre

zScheduler enables automatic KOTH scheduling.

FeaturesCopier le lien vers ce titre

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

Example ScheduleCopier le lien vers ce titre

# 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 TipsCopier le lien vers ce titre

Best PracticesCopier le lien vers ce titre

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 IssuesCopier le lien vers ce titre

Team Not DetectedCopier le lien vers ce titre

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 ConflictsCopier le lien vers ce titre

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

Placeholders Not WorkingCopier le lien vers ce titre

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%