Commands Reference
Comprehensive guide listing every player, party, arena, kit, and practice command in ShyamDuels, including arguments and permissions.
Command Tab Completion
Commands feature automatic tab-completion for player names, kit configurations, and arena names.
Player Commands
| Command | Aliases | Permissions | Description |
|---|---|---|---|
/duel <player> |
/1v1 |
shyamduels.use |
Challenges a player to a duel. Opens a kit selection GUI. The invite is blocked if the target player has duel invitations toggled off. |
/duel accept <player> |
- | shyamduels.use |
Accepts a pending duel invitation. |
/duel deny <player> |
- | shyamduels.use |
Rejects a pending duel invitation. |
/duel spectate <player> |
- | shyamduels.use |
Spectates the specified player if they are currently inside a match. |
/ffa |
/freeforall |
shyamduels.use |
Opens the Free For All (FFA) arena selection selector menu. |
/ffa join <arena> |
- | shyamduels.use |
Bypasses the GUI and immediately joins the specified FFA arena. |
/ffa leave |
- | shyamduels.use |
Leaves your current FFA match and teleports you back to the lobby spawn. |
/queue |
/play, /ranked |
shyamduels.use |
Opens the primary ranked and unranked matchmaking queue selection GUI. |
/queue [kit] |
- | shyamduels.use |
Queues you immediately for a ranked match using the specified kit. |
/queue leave |
- | shyamduels.use |
Removes you from the matchmaking queues. |
/kiteditor |
/editkit, /kitedit |
shyamduels.use |
Opens a GUI to select which kit layout you would like to customize. |
/kiteditor [kit] |
- | shyamduels.use |
Bypasses the selector and directly opens the editor layout for the specified kit. |
/kitcreator |
/customkit, /ckit |
shyamduels.use |
Opens the custom kit builder GUI, allowing players to build custom kit configurations. |
/customkits |
/ckits, /mykits |
shyamduels.use |
Opens the custom kits management GUI to play or edit saved layouts. |
/customkits play |
/ckits play |
shyamduels.use |
Opens the custom kits play selector directly. |
/customkits edit |
/ckits edit |
shyamduels.use |
Opens the custom kits editor directly. |
/deathmessages |
- | shyamduels.use |
Toggles custom practice death messages on or off. Requires modules.practice-death-messages. |
/practiceduel [player] |
/pduel, /roundsduel |
shyamduels.practice.duel |
Challenges a player to a round-based practice duel. See Practice Features. |
/practiceduel accept <player> |
- | shyamduels.practice.duel |
Accepts a pending practice duel request. |
/totempractice |
/totem |
shyamduels.practice.totempractice |
Opens the Totem Reaction practice minigame GUI. |
/leavefight |
/leave, /spawn, /lobby |
shyamduels.use |
Leaves a duel or FFA arena. Bypasses active combat timers if the player has bypass permissions. |
/spectate |
/spec, /watch |
shyamduels.use |
Opens a GUI listing all ongoing duels and matchmaking instances. |
/spectate <player> |
- | shyamduels.use |
Teleports you as a spectator to watch the match of the specified player. |
/spectate leave |
- | shyamduels.use |
Exits spectator mode and returns you to the lobby. |
/settings |
/preferences, /prefs |
shyamduels.use |
Opens the personal configuration menu to toggle visibility, auto-GG, sounds, scoreboard, time, and weather. |
/stats |
/stat |
shyamduels.use |
Prints your current wins, losses, ELO, and rank metrics in the chat. |
/stats view <player> |
- | shyamduels.use |
Displays match statistics for the specified player (supports offline targets). |
/friend |
/f, /friends |
shyamduels.use |
Displays list of subcommands for the friends module. |
/friend add <player> |
- | shyamduels.use |
Dispatches a friend request to an online player. |
/friend accept <player> |
- | shyamduels.use |
Accepts a pending friend request. |
/friend deny <player> |
- | shyamduels.use |
Declines a pending friend request. |
/friend remove <player> |
- | shyamduels.use |
Removes a player from your friend list. |
/friend list |
- | shyamduels.use |
Lists all your friends, indicating who is online or offline. |
/partychat |
/pc, /pchat |
shyamduels.use |
Toggles party-only chat. While active, your public chat messages are redirected to your party members. |
Party Subcommands
All party commands are invoked as subcommands under the primary command /party <subcommand> (aliases: /p, /team).
| Subcommand | Arguments | Leader Only? | Description |
|---|---|---|---|
create |
- | No | Creates a party, designating you as the leader. |
invite |
<player> |
Yes | Sends a party invitation to the specified player. |
accept |
- | No | Accepts an incoming party invite. |
deny |
- | No | Declines an incoming party invite. |
join |
<leader> |
No | Joins an open public or friend-restricted party by specifying the leader's name. |
leave |
- | No | Leaves your current party. Opens a confirmation UI before leaving. |
kick |
<player> |
Yes | Kicks the specified player from the party. |
disband |
- | Yes | Disbands the party. Opens a confirmation UI. |
promote |
<player> |
Yes | Transfers party leadership to another party member. |
public |
- | Yes | Sets the party join accessibility status to PUBLIC. |
private |
- | Yes | Sets the party join accessibility status to PRIVATE (Invite-only). |
friends |
- | Yes | Restricts party joining to players on your friend list. |
mode |
<queue|split|ffa|duel> |
Yes | Configures the party behavior when matchmaking actions are performed. |
announce |
<text> |
Yes | Sends a formatted broadcast notification to all party members. |
list |
- | No | Lists all current party members in chat. |
info |
- | No | Displays party state, current size constraints, leadership details, and active mode. |
chat |
- | No | Toggles party-only chat. Same functionality as /partychat. |
mute |
<player> |
Yes | Mutes the specified member from using the party chat channels. |
unmute |
<player> |
Yes | Unmutes the specified member in party chat. |
uninvite |
<player> |
Yes | Revokes a pending invitation before the target player accepts it. |
limit |
- | Yes | Opens a sign interface to configure a custom maximum capacity for the party. |
resetlimit |
- | Yes | Removes custom capacity limits, returning to default capacity sizes. |
refresh |
- | Yes | Refreshes party items for all members (hotbar queue items). |
inviteall |
- | Yes | Bulk invites all of your online friends to join the party. |
ffa |
- | Yes | Opens the party Free-For-All arena selection GUI, allowing members to fight each other. |
split |
- | Yes | Opens the team battle splitting GUI to partition members into two teams for internal duels. |
duel |
- | Yes | Opens a vs-party challenge selector GUI, allowing the leader to challenge another party. |
duel accept |
- | Yes | Accepts a pending vs-party challenge from another party. |
member / play |
- | No | Opens the party play menu. |
manage |
- | No | Opens the party member management dashboard GUI. |
settings |
- | Yes | Opens the party options GUI. |
forceowner |
- | No | Bypasses ownership and assigns you as the party leader. Requires shyamduels.admin. |
forcejoin |
<player> <leader> |
No | Forces a player directly into another leader's party. Requires shyamduels.admin. |
Arena Admin Commands
Admin commands are accessed under /arena <subcommand> (aliases: /arenas, /shyamarenas) and require shyamduels.admin.
| Subcommand | Arguments | Description |
|---|---|---|
help |
- | Lists all arena setup commands. |
create |
<name> |
Registers a new arena. Sets corner 1 coordinates to your current position. |
delete |
<name> |
Deletes the specified arena data and deletes the associated schematic file. |
list |
- | Lists all registered arenas, including setup checks, types, and linked kits. |
corner1 |
<name> |
Sets selection corner 1 to your position. Automatically saves the schematic if corner 2 is already set. Alias: pos1. |
corner2 |
<name> |
Sets selection corner 2 to your position. Automatically saves the schematic if corner 1 is already set. Alias: pos2. |
spawn1 |
<name> |
Sets spawn point 1 coordinates and player facing yaw/pitch to your location. Alias: p1. |
spawn2 |
<name> |
Sets spawn point 2 coordinates and player facing yaw/pitch to your location. Alias: p2. |
center |
<name> |
Sets the arena center location used for spectator boundaries and team battle layouts. |
teleport |
<name> |
Teleports your player directly to the center of the arena. Alias: tp. |
build |
<name> <true|false> |
Enables or disables block placing/breaking during matches in this arena. Must match the linked kit's build mode (see Kit Build Mode). |
ffa |
<name> <true|false> |
Sets the arena type to FFA, making it accessible through /ffa. |
addffaspawn |
<name> |
Registers your current position as an additional random FFA spawn point. |
clearffaspawns |
<name> |
Clears all custom FFA spawn points; players fall back to spawn1 / spawn2. |
copypaste |
<source> <newName> |
Pastes the source arena schematic at your location and registers a new arena. Copies kit links, build mode, DUEL/FFA type, spawns, center, FFA spawn points, FFA GUI settings, and door gates. |
addkit |
<name> <kit> |
Links a kit to the arena so matchmaking and queues can use it. |
removekit |
<name> <kit> |
Unlinks a kit from the arena. |
reset |
<name> |
Forces FAWE to immediately paste and reset the arena back to its saved schematic layout. |
setdisplayname |
<name> <display> |
Sets a custom display name used for this arena in the FFA menu. Alias: setname. |
seticon |
<name> |
Sets the FFA selector GUI icon to the item in your hand. |
Kit Admin Commands
Kit commands are accessed under /kit <subcommand> (aliases: /kits, /shyamkits). Modifying commands require shyamduels.admin.
| Subcommand | Arguments | Permissions | Description |
|---|---|---|---|
help |
- | shyamduels.admin |
Lists all kit commands. |
create |
<name> |
shyamduels.admin |
Saves your inventory, armor layout, offhand item, and active potion status as a new kit. |
delete |
<name> |
shyamduels.admin |
Deletes the specified kit and clears its saved data. |
list |
- | shyamduels.kit.list |
Lists all registered kits. |
info |
<name> |
shyamduels.kit.list |
Shows details about a kit, including item counts, effects, saturation values, and whitelists. |
setinv |
<name> |
shyamduels.admin |
Overwrites the items of a kit to match your current inventory contents. |
seticon |
<name> |
shyamduels.admin |
Sets the display icon of the kit in GUIs to the item in your main hand. |
setitem |
<name> |
shyamduels.admin |
Sets the GUI icon to your held item and applies its name as the kit's display name. |
setdisplayname |
<name> <display> |
shyamduels.admin |
Sets a custom display name. Use clear or reset to remove custom names. Alias: setname. |
load |
<name> |
shyamduels.admin |
Loads the kit items directly into your inventory. |
give |
<kit> <player> |
shyamduels.admin |
Gives the kit items to the specified player. |
allowblock |
<name> |
shyamduels.admin |
Adds the block in your hand to the build whitelist and enables build mode for this kit. Also sets build mode to true. |
removeblock |
<name> |
shyamduels.admin |
Removes the block in your hand from the build whitelist. Clears build mode when the whitelist becomes empty. |
build |
<name> <true|false> |
shyamduels.admin |
Enables or disables build mode for the kit. Must match the linked arena's build mode (see Arena Build Mode). Setting false also clears the block whitelist. |
kitroom |
<name> |
shyamduels.admin |
Toggles whether the Kit Room editor feature is active for this kit. |
deleteeditedkits |
<name> |
shyamduels.admin |
Clears all player-customized layouts for this kit, resetting everyone to the base configuration. |
queuerounds |
<kit> <amount> |
shyamduels.admin |
Configures the default match round count (e.g. Best of 3) for matchmaking queues. |
setsaturation |
<kit> <0-20> |
shyamduels.admin |
Sets the starting saturation level applied to players when entering matches with this kit. |
matchstartpots |
<kit> <enable|disable|scan> |
shyamduels.admin |
Manages start potion scanning. scan registers all splash potions. enable scans and auto-fires them on start. Alias: matchstartpotions. |
matchstartpots list |
- | shyamduels.admin |
Lists all kits that have automatic match-start potions active. |
Plugin & Practice Admin Commands
These core subcommands are run under the main command /shyamduels <subcommand> (aliases: /sd, /duels). In addition to system configurations, they cover practice utilities and feature set-ups.
| Subcommand | Arguments | Permissions | Description |
|---|---|---|---|
help |
[page] |
shyamduels.admin |
Displays in-game help logs (3 pages). |
guide |
[arena|kit|gate] |
shyamduels.admin |
Prints setup instructions in the chat. |
setlobby |
- | shyamduels.admin |
Configures the lobby location and yaw/pitch to your current position. |
edit-kitroom |
- | shyamduels.admin |
Opens the Kit Room editor GUI workspace. |
reload |
- | shyamduels.admin |
Reloads configs, layouts, tab formatting, scores, database pools, and sub-modules. |
migrate strikepractice |
- | shyamduels.admin |
Migrates kits, arenas, animations, and historical databases from StrikePractice/ShyamStrikeCore files. |
practiceduel |
[player] |
shyamduels.practice.duel |
Invites a player to a practice duel. Opens kit selection. |
practiceduel accept |
<player> |
shyamduels.practice.duel |
Accepts a pending practice duel invitation. |
totem-practice |
- | shyamduels.practice.totempractice |
Opens the Totem Reaction practice game GUI. Alias: totempractice. |
totem-practice help |
- | shyamduels.admin |
Displays setup details for Totem Practice. |
armor-trimmer |
- | shyamduels.practice.armortrimmer.use |
Opens the Armor Trimmer GUI to customize patterns for the armor piece in your hand. Alias: armortrimmer. |
armor-trimmer help |
- | shyamduels.admin |
Displays help for the Armor Trimmer module. |
shield-customizer |
- | shyamduels.practice.shieldcustomizer.use |
Opens the Shield Customizer GUI to apply pattern layers to the shield in your hand. Alias: shieldcustomizer. |
shield-customizer help |
- | shyamduels.admin |
Displays help for the Shield Customizer. |
Complex Door Gates (/shyamduels gate)
Configure animated start gates on duel arenas. Full setup steps, video tutorial, and command reference: Gate Setup Guide.
| Subcommand | Arguments | Permissions | Description |
|---|---|---|---|
gate |
- | shyamduels.practice.gate.setup |
Displays gate command help. |
gate wand |
- | shyamduels.practice.gate.setup |
Gives the Gate Selection Wand. Left-click = Corner 1, right-click = Corner 2. |
gate addgate |
<arena> |
shyamduels.practice.gate.setup |
Saves wand selection as a gate on the arena. Stand on the arena floor side when running this. |
gate delete |
<arena> |
shyamduels.practice.gate.setup |
Deletes all gates for the arena. |
gate list |
- | shyamduels.practice.gate.setup |
Lists all arenas with gates and gate counts. |
gate reload |
- | shyamduels.practice.gate.setup |
Reloads gate YAML files from data/complex-door-data/. |
Golden Head & Custom Kits Commands
| Subcommand | Arguments | Permissions | Description |
|---|---|---|---|
golden-head |
- | shyamduels.practice.goldenhead |
Displays golden-head commands help. |
golden-head give |
<player> [amount] |
shyamduels.practice.goldenhead |
Gives the specified amount of Golden Heads to a player. |
customkits |
- | customkits.admin |
Displays custom kits admin command help. |
customkits edit-category |
- | customkits.admin |
Opens the Custom Kits GUI Editor to set item categories. |
customkits reload |
- | customkits.admin |
Reloads custom kits configuration files. |
StrikePractice Migration
Run /shyamduels migrate strikepractice to import kits, arenas, gates, and schematics. Full steps: Migration Guide.
Miscellaneous Admin Commands
| Command | Aliases | Permissions | Description |
|---|---|---|---|
/tab reload |
/tablist |
shyamduels.tab.admin |
Reloads tab list YAML files and refreshes headers/footers for online players. |
/tab update |
- | shyamduels.tab.admin |
Forces a tab list refresh for yourself (player-only). |
/tab test <message> |
- | shyamduels.tab.admin |
Preview MiniMessage formatting in chat (useful when editing tab/display.yml). |
/testcolor <message> |
/colortest, /testcolors |
shyamduels.admin.testcolor |
Parses color placeholders and outputs the formatted text in chat (useful for testing MiniMessage tags). |
/practice … |
/shyamduelspractice |
shyamduels.admin |
Legacy alias tree for admin practice commands. Use /shyamduels instead. See Practice Features. |