Skip to main content
These optional integrations provide displays and entry points. The base market does not depend on them. A missing plugin or incompatible API makes its integration unavailable while the vanilla GUI, wallets and trading retain their normal rules.

​
Installation and activation

  1. Install builds of PlaceholderAPI, Citizens or LuckPerms that match your server. Choose only the integrations you need.
  2. For Citizens, register the permitted NPC IDs in config.yml.
  3. Restart normally, confirm the corresponding plugins are enabled and check the display or entry point.
integrations configuration is read at startup. Changes require a normal restart; /km reload does not update it. See compatibility for specific builds and verified combinations. Successful installation does not certify every version combination.

​
PlaceholderAPI scoreboard displays

KiteMarket registers the kitemarket expansion when PlaceholderAPI is available. Add these placeholders to a scoreboard, hologram or other display plugin that supports PlaceholderAPI: Replace coins in wallet placeholders with your currency ID. For example, points uses %kitemarket_wallet_points_available%. Balances use the currency’s actual precision without appending its display name; add a label in the display plugin. Wallet values come from an asynchronously refreshed read-only cache with a 15-second lifetime, without blocking the placeholder thread. Unready services, expired caches and failed queries return an empty value instead of a fabricated zero balance. An unloaded LuckPerms user or unavailable LuckPerms provider also returns an empty group.
Placeholders are for display. Do not use cached values to authorize a debit, grant permissions or prove a trade succeeded. Wallet records and trade receipts contain the actual result.

​
Citizens NPC market entry

Register specific NPC IDs in config.yml:
Replace 12 and 27 with actual NPC IDs on your server. The default empty list enables no NPC entry points. IDs must be non-negative integers. Right-clicking a registered NPC opens the same market home as /km. Other NPCs do not trigger the market, and clicks already cancelled by another plugin are ignored. KiteMarket still checks player permissions, sessions, quotes and final trade confirmation. NPCs only open the interface; they never automatically deposit funds, buy, supply or bid.

​
LuckPerms primary groups and trading permissions

The LuckPerms integration reads the primary group of an already-loaded user through its public API, for displays such as %kitemarket_luckperms_primary_group%. It does not load offline users or grant permissions. Trading modes, quantities, prices, fees and publication limits use effective Bukkit permissions rather than the displayed primary-group name. Configure the relevant permission nodes in LuckPerms, then verify the result against commands and permissions and fees and restrictions.

​
Unavailable displays or entry points

Interface themes and item identity are separate capabilities. See ItemsAdder integration for interfaces and items and containers for real business IDs and advanced conditions.