Kit Sharing & Profiles
Right-click any player to open their profile, browse their public edited kits, preview the exact layout, and import it with a single click or a share code.
Player Profile
Right-clicking another player opens the Player Profile GUI instead of opening the duel menu directly. The profile is the new hub for inspecting players and starting matches.
- Player Statistics - full PvP, match, and kit stats.
- Public Edited Kits - browse and import the player's shared kits.
- Send Duel - opens the existing duel menu (no duel behaviour changed).
- Close.
The profile, statistics, public-kits and preview menus are all fully configurable from
menus/profile.yml, menus/public-kits.yml and
menus/kit-preview.yml (plus dialog-menus/profile-stats.yml for dialog mode). The right-click behaviour can be switched in config:
right-click:
enabled: true
# What right-clicking another player does:
# profile -> open the player profile GUI (stats, public kits, send duel) [default]
# command -> run the commands listed below (legacy behaviour)
action: profile
commands:
- "duel %clicked_player%"
Enabling Kit Sharing
Kit sharing is an opt-in player setting. It is OFF by default.
/settings -> Share Edited Kits -> ON / OFF
| State | Behaviour |
|---|---|
ON | All of the player's edited kits become visible and importable by others. Each edited kit gets a unique share code. |
OFF | Nobody can view or import the player's kits. Existing share codes immediately stop resolving. |
Share Codes
Every edited kit (and every player-built custom kit) carries its own unique, hard-to-guess
8-character code, not one code per player. Example: 38RBJQ7P.
- Generated automatically when kits load or are saved.
- Persisted with the kit, so they remain stable between sessions.
- Can be regenerated on demand:
/kit regencode <kit>
/kit regencode offers tab-completion of your own edited kit names and also works for
player-built custom kits (matched by name or ID). If nothing matches, the command reports
No kit found by that name or ID.
Importing a Kit
Players can import a shared kit in two ways:
# From the Public Edited Kits menu:
Shift-Click a kit to import it
# Or directly by code:
/kit load <ShareCode>
A kit can only be imported when all of the following are true:
- The share code exists.
- The owner is currently online (codes resolve against online owners only).
- The owner has kit sharing enabled.
- The edited kit still exists.
- You are not importing your own kit.
On success the full layout (inventory, hotbar, armor and offhand) is copied and saved as your own edited kit under the original kit name, and the owner's import counter increases.
Imports are rate-limited by kit-sharing.import-cooldown-seconds (default 30s,
0 disables it) to prevent shift-click spam.
kit-sharing.strip-cosmetics-on-import: true, any
trims, banners or other rank-gated cosmetic items are stripped from imported kits when the importer
lacks the cosmetics.strip-without-permission.permission permission. This stops
unranked players from inheriting paid cosmetics through a shared kit.
Import Messages
| Situation | Message key (messages.yml) |
|---|---|
| Success | kit-sharing.import-success |
| Unknown / invalid code | kit-sharing.import-invalid-code |
| Owner offline | kit-sharing.import-owner-offline |
| Sharing disabled | kit-sharing.import-sharing-disabled |
| Kit no longer exists | kit-sharing.import-kit-removed |
| Importing your own kit | kit-sharing.import-self |
| Import on cooldown | kit-sharing.import-cooldown |
| No free custom-kit slot (custom kit import) | kit-sharing.import-no-slot |
| Nothing matched (regencode) | kit-sharing.no-kit-found |
| No edited kit by that name (regencode) | kit-sharing.no-edited-kit |