Commands
Command overview
How sofyCore commands are organized, the shared syntax for players, durations and silent actions, and the full command index.
Conventions
- Default labels. This documentation uses the default command names. Most labels and aliases can be changed in each module's YAML (
commands,command,aliases) or, for moderation, with/punish config. If another plugin already owns a label, sofyCore keeps the other plugin's command and logs a warning. - Root command. Core commands use
identity.command-alias(default/sofycore). - Players.
<player>accepts a known name or a UUID. sofyCore never invents a UUID from a name: the player must have joined the network at least once. - Durations. Positive integers with a unit:
30s,10m,2h,7d. Many commands also acceptpermanent. - Silent actions. Moderation commands accept
-sto limit the announcement to permitted staff. - Hierarchy. Acting on another player requires a strictly higher rank. Console can always act.
- Console only. Some operations, such as granting the owner rank or migrating from LuckPerms or PermissionsEx, are accepted only from the real console.
Syntax notation
| Notation | Meaning |
|---|---|
<value> | Required argument |
[value] | Optional argument |
a|b | Choose one of the options |
... | The rest of the line (free text) |
Command index
| Command | Permission | Description |
|---|---|---|
| /sofycore module | sofycore.module.reload | Reloads the configuration and lifecycle of a single module. The other modules keep their state. There is no global reload. |
| /sofycore settings | sofycore.settings.preferences.announcements | Shows or changes whether you receive announcements. Forced announcements are always delivered. Players only. |
| /playtime [player] | sofycore.playtime | Shows your network playtime. Another player's playtime needs sofycore.playtime.others. |
| /mentions [on|off|toggle] | sofycore.settings.mentions | Turns the mention sound on or off. Saved for every server. |
| /rankdisplay [global|local|toggle] | sofycore.settings.rankdisplay | Chooses whether your prefix shows your global rank or the local rank of the current server. |
| /access status | — | Availability (READY, or SUSPENDED while LuckPerms or PermissionsEx is installed), scope GLOBAL/LOCAL_SQLITE and revision. |
| /access help | — | Summary of every branch and its main syntax. |
| /access setup | — | Installs the optional template: vip, helper, moderator and admin with basic inheritance. Rejected completely if any of those IDs exists. |
| access owner | Console only | Grants the permanent owner rank. Only the console can do it; being OP or having * is never enough. |
| access uuid | Console only | Shows the UUID this network has registered for a name. Does not create identities. |
| /access rank | sofycore.ranks.view | Lists ranks, ten per page. |
| /access rank | sofycore.ranks.view | Type, authority, weight, inheritance and appearance of a rank. |
| /access rank | sofycore.ranks.view | Combined permissions, marking direct and inherited/default ones. |
| /access rank | sofycore.ranks.manage | Creates a global rank. IDs: 1–32 lowercase characters starting with a letter. |
| /access rank | sofycore.ranks.manage | Edits a rank: visible label, type, authority (STAFF/ADMIN, STAFF ranks only), weight, prefix, suffix or name color. `clear` empties styles. |
| /access rank | sofycore.ranks.manage | Grants, denies or removes one or more permission nodes of a rank. Trailing wildcards such as sofycore.chat.* are accepted. |
| /access rank | sofycore.ranks.manage | Adds or removes inheritance. Circular inheritance is rejected. |
| /access rank | sofycore.ranks.manage | Conditional permissions and inheritance with duration and conditions (server, world, gamemode, WorldGuard region/flags). `global` means no condition. |
| /access rank | sofycore.ranks.manage | Deletes a rank. Its grants become RANK_DELETED and the ID is retired forever. |
| /access user | sofycore.ranks.grant | Adds an independent grant. Rejected if an equal active grant exists (use extend). |
| /access user | sofycore.ranks.grant | Grants a rank only under certain conditions. |
| /access user | sofycore.ranks.grant | Removes exactly one grant. |
| /access user | sofycore.ranks.grant | Extends a grant or makes it permanent. Adds from the expiry if still active, or from now if expired. |
| /access user | sofycore.ranks.view | UUID, authority and revision; grants with IDs, state and expiry; individual exceptions. |
| /access user | sofycore.ranks.manage | Individual permission exceptions. Applicable individual rules take priority over rank rules. |
| /access user | sofycore.ranks.view | Explains where a permission comes from. DEFAULT means no explicit rule. |
| /color [0-f|#rrggbb|reset] | sofycore.ranks.color | Shows or changes your personal name color. Shortcut of /access color; opens a menu when the menus module is on. |
| access migration | Console only | Analyzes a LuckPerms 5.x export and creates a plan. Then: report, status, apply <plan> confirm, resume <plan> confirm. |
| access migration | Console only | Analyzes a PermissionsEx permissions.yml from plugins/sofyCore/migrations/pex/ and creates a plan. Then: report, status, apply <plan> confirm, resume <plan> confirm. |
| /ban <player|uuid> | sofycore.sanctions.ban | Global account ban. -c clears the target's inventory first (same server, sofycore.sanctions.clear). |
| /ipban <ip|player> | sofycore.sanctions.ipban | Bans that exact IP. A player resolves to their last registered IP. |
| /mute <player|uuid> | sofycore.sanctions.mute | Global mute for chat and private messages. |
| /warn <player|uuid> | sofycore.sanctions.warn | Expiring warning. Active warnings can trigger automatic consequences (by default 3 → 10 min mute, 5 → 1 h ban). |
| /kick <online-player> | sofycore.sanctions.kick | Kicks that confirmed connection. |
| /unban | | sofycore.sanctions.unban | Removes the active sanction (permissions sofycore.sanctions.unban, .unipban, .unmute). Removing a sanction issued by someone else requires a higher rank than its issuer. |
| /unwarn <player|uuid> | sofycore.sanctions.unwarn | Removes one active warning. |
| /blacklist <add|remove|list> | sofycore.sanctions.blacklist | Permanent literal name or IP blacklist. /unblacklist is the same removal action. |
| /history <player|uuid|ip|name:nick> | sofycore.sanctions.history | Full history including expired, replaced and removed sanctions. Without arguments (or /punishinfo) shows your own, with sofycore.sanctions.history.own. |
| /staffhistory <player|uuid|console> | sofycore.sanctions.history | Actions issued by a staff member. |
| /ips <player|uuid> | sofycore.sanctions.ips | Up to 16 recent distinct IPs of an account, and accounts seen on an IP. Does not sanction them. |
| /punish config | sofycore.moderation.configure | Persisted, network-wide moderation settings: language, command labels, warn duration, thresholds and report types. |
| /report <online-player> | sofycore.reports.use | Files a report (60 s cooldown). Default types: killaura, reach, fly, speed, antiknockback, xray, autoclicker, other. Opens a menu when used with only the player and menus are enabled. |
| /reports <list|inspect|take|release|resolve|dismiss> | sofycore.reports.manage | Open report queue: inspect, take, release, resolve or dismiss. |
| /helpop <message...> | sofycore.helpop.use | Sends a message to the staff of every server (30 s cooldown). |
| /chat <mute|unmute> | sofycore.chat.mute | Locks or unlocks the local public chat of this server. |
| /chat slow | sofycore.chat.slow | Minimum time between public messages. |
| /staffchat [message] | sofycore.chat.staff | Network staff channel through Redis. Messages starting with ! go there too. Without text, toggles the channel (sofycore.chat.channel.toggle). |
| /adminchat [message] | sofycore.chat.admin | Network administrator channel. Messages starting with @ go there too. |
| /chat channel | sofycore.chat.channel.toggle | Selects your chat channel for this session. |
| /message <player> | sofycore.message | Private message, also across servers when cross-server is enabled. |
| /reply <text...> | sofycore.message | Replies to your last confirmed conversation. |
| /ignore <player> | sofycore.message.ignore | Persistent ignore list for private messages. sofycore.message.ignore.bypass skips it. |
| /tags [list | sofycore.tags.use | Lists, selects or clears your tag. |
| /tags <create|edit|delete|reload> | sofycore.tags.manage | Manages the shared tag catalog. |
| /tagsimports | sofycore.tags.import | Merges the local tags.yml file into the shared catalog. |
| /sout <interval|once> | sofycore.announcements.global.create | Recurring network announcement through Redis (s/m/h, up to 365 days), or a one-time announcement with once (sofycore.announcements.global.once). |
| /sout <list | sofycore.announcements.global.list | Lists recurring announcements or deletes one by its 4-character ID (delete: sofycore.announcements.global.delete). |
| /freeze <player> | sofycore.staff.freeze | Freezes a player on any server of the network. The freeze survives server changes and reconnections. |
| /unfreeze <player> | sofycore.staff.unfreeze | Unfreezes, even if the player is offline. |
| /vanish | sofycore.staff.vanish | Invisible to lower ranks across the network; equal or higher ranks still see you. |
| /staffmode | sofycore.staff.mode | Saves your inventory and state, gives the protected staff hotbar and enables vanish. Running it again restores everything. |
| /follow <player> | — | Staff mode only: rides on top of a player and follows them across servers. |
| /servermanager <server|*> | sofycore.staff.servermanager.run | Runs a console command on one server or on every server. |
| /servermanager <listservers | sofycore.staff.servermanager.list | Network servers with players, slots and TPS, details of one server, and connecting to it (connect: sofycore.staff.servermanager.connect). |
| /staffonline | sofycore.staff.list | Staff online across the network. Clicking a name needs sofycore.staff.list.goto. |
| /gamemode <mode> | sofycore.essentials.gamemode | survival/s/0, creative/c/1, adventure/a/2, spectator/sp/3. Others need .others and a higher rank. |
| /heal [player] | sofycore.essentials.heal | Max health, full hunger and fire off; or hunger and saturation (sofycore.essentials.feed). |
| /fly [player] | sofycore.essentials.fly | Toggles flight, or god mode (sofycore.essentials.god; lost on disconnect). |
| /more | sofycore.essentials.more | Item in hand: fill the stack, rename (&-colors, &#RRGGBB on 1.16+), edit lore, wear as hat. |
| /skull [player] | sofycore.essentials.skull | Your head, or another player's head (.others). |
| /broadcast <message> | sofycore.essentials.broadcast | Chat message on this server; /alert adds an on-screen title and sound (sofycore.essentials.alert). |
| /sudo <player> | sofycore.essentials.sudo | Forces a lower-ranked player to run a command or chat. |
| /invsee [player] | sofycore.essentials.invsee | Live inventory or ender chest of an online lower-ranked player (.modify to edit). Without a player, opens the container you look at (.containers). |
| /tp <player> | sofycore.essentials.tp | Teleports with rank hierarchy checks. /back returns to the location before your last teleport or death. |
| /spawn [player] | sofycore.essentials.spawn | Server spawn (stored in essentials-spawn.yml) and other worlds' spawns. |
| /clear [player] | sofycore.essentials.clear | Clears inventory, armor, off hand and cursor; gives items up to give-limit (sofycore.essentials.give). |
| /speed <1-10|reset> | sofycore.essentials.speed | Walk or fly speed; 1 is normal and 10 is the maximum. |
| /vippoints | sofycore.vippoints.balance | Shows your global VIP points balance. |
| /vipshop [list | sofycore.vippoints.shop | Lists templates, previews a purchase and its price, and confirms or cancels it. Without arguments opens the shop menu when menus are enabled. |
| /vpadmin <balance|give|take|set|history|recover> | sofycore.vippoints.admin.view | Administers balances, also offline (give/take/set/history/recover have their own nodes). take never goes below zero. |
| /vptemplate <list|create|set|delete|max> | sofycore.vippoints.templates | Creates and edits shop templates (rank, duration, price, label) and the global maximum balance. |
| /bossbars [on|off|toggle] | sofycore.bossbar.toggle | Shows or hides the network boss bar for you, on every server. |
| /bossbaradmin <list|info|create|edit|delete|toggle|group|refresh> | sofycore.bossbar.admin.* | Manages network boss bars: texts, color, style, duration, order, animation, scope (global, server:<name>, group:<group>) and server groups. |
| /maintenance on | sofycore.maintenance.manage | Network-wide maintenance: kicks players without bypass, blocks new joins and, by default, freezes the rank clock. |
| /maintenance off | sofycore.maintenance.manage | Reopens the network; an optional bonus keeps the rank clock stopped for longer. |
| /maintenance status | sofycore.maintenance.status | State, reason, who and since when, and the rank clock state. |
| /settings | sofycore.menus.settings | Preferences menu (announcements, private messages, boss bar, mentions...). |
| /profile | sofycore.menus.profile | Your profile menu. |
| /player <player> | sofycore.staff.panel | Staff panel of a player: profile, sanctions, ranks and, with sofycore.staff.panel.address, last IP. |
| /players | sofycore.menus.players | Players or staff online in the network (sofycore.menus.stafflist for the staff list). |
| /menu <id> | sofycore.menus.open.<id> | Opens a custom menu defined in menus.yml. |