跳转至

🔖 PlaceholderAPI

KaGuilds fully supports PlaceholderAPI (PAPI). You can use KaGuilds placeholders anywhere that supports PAPI, including chat, scoreboards, BossBars, and Tab lists.

📋 Basic Information

Variable Prefix

All KaGuilds placeholders use kaguilds as the prefix:

%kaguilds_xxx%

Installation Steps

  1. Download and install PlaceholderAPI
  2. Place KaGuilds.jar and PlaceholderAPI.jar in the plugins folder
  3. Restart the server — PlaceholderAPI will automatically load the KaGuilds expansion
  4. Use /papi parse player %kaguilds_name% to test the placeholder

🎯 Placeholder List

📌 Guild Information

Placeholder Description Example
%kaguilds_name% Guild name My Guild
%kaguilds_id% Guild ID 5
%kaguilds_level% Guild level 3
%kaguilds_balance% Guild balance 1500.0
%kaguilds_announcement% Guild announcement Welcome!
%kaguilds_owner% Owner's name Player1
%kaguilds_create_time% Creation time 2024-01-15 10:30:00
%kaguilds_exp% Current experience 1500
%kaguilds_need_exp% Experience needed for next level 2000

👥 Member Information

Placeholder Description Example
%kaguilds_member_count% Current member count 15
%kaguilds_max_members% Maximum members 20
%kaguilds_member_list% Member list Player1, Player2, Player3
%kaguilds_contribution% Personal contribution 500

🔐 Rank Permissions

Placeholder Description Example
%kaguilds_role_name% Rank name Admin
%kaguilds_is_owner% Is owner Yes/No
%kaguilds_is_admin% Is admin Yes/No
%kaguilds_is_staff% Is staff member Yes/No

⚔️ PvP Data

Placeholder Description Example
%kaguilds_pvp_wins% Win count 10
%kaguilds_pvp_losses% Loss count 3
%kaguilds_pvp_draws% Draw count 2
%kaguilds_pvp_total% Total matches 15

📝 Other Information

Placeholder Description Example
%kaguilds_pending_requests% Pending join requests 3
%kaguilds_has_guild% Player has a guild Yes/No
%kaguilds_reset_countdown% Daily task reset countdown (HH:MM:SS) 5h 30m 20s