Skip to content

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 accept permanent.
  • Silent actions. Moderation commands accept -s to 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

NotationMeaning
<value>Required argument
[value]Optional argument
a|bChoose one of the options
...The rest of the line (free text)

Command index

CommandPermissionDescription
/sofycore modulesofycore.module.reloadReloads the configuration and lifecycle of a single module. The other modules keep their state. There is no global reload.
/sofycore settingssofycore.settings.preferences.announcementsShows or changes whether you receive announcements. Forced announcements are always delivered. Players only.
/playtime [player]sofycore.playtimeShows your network playtime. Another player's playtime needs sofycore.playtime.others.
/mentions [on|off|toggle]sofycore.settings.mentionsTurns the mention sound on or off. Saved for every server.
/rankdisplay [global|local|toggle]sofycore.settings.rankdisplayChooses 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 ownerConsole onlyGrants the permanent owner rank. Only the console can do it; being OP or having * is never enough.
access uuidConsole onlyShows the UUID this network has registered for a name. Does not create identities.
/access ranksofycore.ranks.viewLists ranks, ten per page.
/access ranksofycore.ranks.viewType, authority, weight, inheritance and appearance of a rank.
/access ranksofycore.ranks.viewCombined permissions, marking direct and inherited/default ones.
/access ranksofycore.ranks.manageCreates a global rank. IDs: 1–32 lowercase characters starting with a letter.
/access ranksofycore.ranks.manageEdits a rank: visible label, type, authority (STAFF/ADMIN, STAFF ranks only), weight, prefix, suffix or name color. `clear` empties styles.
/access ranksofycore.ranks.manageGrants, denies or removes one or more permission nodes of a rank. Trailing wildcards such as sofycore.chat.* are accepted.
/access ranksofycore.ranks.manageAdds or removes inheritance. Circular inheritance is rejected.
/access ranksofycore.ranks.manageConditional permissions and inheritance with duration and conditions (server, world, gamemode, WorldGuard region/flags). `global` means no condition.
/access ranksofycore.ranks.manageDeletes a rank. Its grants become RANK_DELETED and the ID is retired forever.
/access usersofycore.ranks.grantAdds an independent grant. Rejected if an equal active grant exists (use extend).
/access usersofycore.ranks.grantGrants a rank only under certain conditions.
/access usersofycore.ranks.grantRemoves exactly one grant.
/access usersofycore.ranks.grantExtends a grant or makes it permanent. Adds from the expiry if still active, or from now if expired.
/access usersofycore.ranks.viewUUID, authority and revision; grants with IDs, state and expiry; individual exceptions.
/access usersofycore.ranks.manageIndividual permission exceptions. Applicable individual rules take priority over rank rules.
/access usersofycore.ranks.viewExplains where a permission comes from. DEFAULT means no explicit rule.
/color [0-f|#rrggbb|reset]sofycore.ranks.colorShows or changes your personal name color. Shortcut of /access color; opens a menu when the menus module is on.
access migrationConsole onlyAnalyzes a LuckPerms 5.x export and creates a plan. Then: report, status, apply <plan> confirm, resume <plan> confirm.
access migrationConsole onlyAnalyzes 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.banGlobal account ban. -c clears the target's inventory first (same server, sofycore.sanctions.clear).
/ipban <ip|player>sofycore.sanctions.ipbanBans that exact IP. A player resolves to their last registered IP.
/mute <player|uuid>sofycore.sanctions.muteGlobal mute for chat and private messages.
/warn <player|uuid>sofycore.sanctions.warnExpiring warning. Active warnings can trigger automatic consequences (by default 3 → 10 min mute, 5 → 1 h ban).
/kick <online-player>sofycore.sanctions.kickKicks that confirmed connection.
/unban |sofycore.sanctions.unbanRemoves 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.unwarnRemoves one active warning.
/blacklist <add|remove|list>sofycore.sanctions.blacklistPermanent literal name or IP blacklist. /unblacklist is the same removal action.
/history <player|uuid|ip|name:nick>sofycore.sanctions.historyFull 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.historyActions issued by a staff member.
/ips <player|uuid>sofycore.sanctions.ipsUp to 16 recent distinct IPs of an account, and accounts seen on an IP. Does not sanction them.
/punish configsofycore.moderation.configurePersisted, network-wide moderation settings: language, command labels, warn duration, thresholds and report types.
/report <online-player>sofycore.reports.useFiles 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.manageOpen report queue: inspect, take, release, resolve or dismiss.
/helpop <message...>sofycore.helpop.useSends a message to the staff of every server (30 s cooldown).
/chat <mute|unmute>sofycore.chat.muteLocks or unlocks the local public chat of this server.
/chat slowsofycore.chat.slowMinimum time between public messages.
/staffchat [message]sofycore.chat.staffNetwork staff channel through Redis. Messages starting with ! go there too. Without text, toggles the channel (sofycore.chat.channel.toggle).
/adminchat [message]sofycore.chat.adminNetwork administrator channel. Messages starting with @ go there too.
/chat channelsofycore.chat.channel.toggleSelects your chat channel for this session.
/message <player>sofycore.messagePrivate message, also across servers when cross-server is enabled.
/reply <text...>sofycore.messageReplies to your last confirmed conversation.
/ignore <player>sofycore.message.ignorePersistent ignore list for private messages. sofycore.message.ignore.bypass skips it.
/tags [listsofycore.tags.useLists, selects or clears your tag.
/tags <create|edit|delete|reload>sofycore.tags.manageManages the shared tag catalog.
/tagsimportssofycore.tags.importMerges the local tags.yml file into the shared catalog.
/sout <interval|once>sofycore.announcements.global.createRecurring network announcement through Redis (s/m/h, up to 365 days), or a one-time announcement with once (sofycore.announcements.global.once).
/sout <listsofycore.announcements.global.listLists recurring announcements or deletes one by its 4-character ID (delete: sofycore.announcements.global.delete).
/freeze <player>sofycore.staff.freezeFreezes a player on any server of the network. The freeze survives server changes and reconnections.
/unfreeze <player>sofycore.staff.unfreezeUnfreezes, even if the player is offline.
/vanishsofycore.staff.vanishInvisible to lower ranks across the network; equal or higher ranks still see you.
/staffmodesofycore.staff.modeSaves 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.runRuns a console command on one server or on every server.
/servermanager <listserverssofycore.staff.servermanager.listNetwork servers with players, slots and TPS, details of one server, and connecting to it (connect: sofycore.staff.servermanager.connect).
/staffonlinesofycore.staff.listStaff online across the network. Clicking a name needs sofycore.staff.list.goto.
/gamemode <mode>sofycore.essentials.gamemodesurvival/s/0, creative/c/1, adventure/a/2, spectator/sp/3. Others need .others and a higher rank.
/heal [player]sofycore.essentials.healMax health, full hunger and fire off; or hunger and saturation (sofycore.essentials.feed).
/fly [player]sofycore.essentials.flyToggles flight, or god mode (sofycore.essentials.god; lost on disconnect).
/more sofycore.essentials.moreItem in hand: fill the stack, rename (&-colors, &#RRGGBB on 1.16+), edit lore, wear as hat.
/skull [player]sofycore.essentials.skullYour head, or another player's head (.others).
/broadcast <message>sofycore.essentials.broadcastChat message on this server; /alert adds an on-screen title and sound (sofycore.essentials.alert).
/sudo <player>sofycore.essentials.sudoForces a lower-ranked player to run a command or chat.
/invsee [player]sofycore.essentials.invseeLive 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.tpTeleports with rank hierarchy checks. /back returns to the location before your last teleport or death.
/spawn [player]sofycore.essentials.spawnServer spawn (stored in essentials-spawn.yml) and other worlds' spawns.
/clear [player]sofycore.essentials.clearClears inventory, armor, off hand and cursor; gives items up to give-limit (sofycore.essentials.give).
/speed <1-10|reset>sofycore.essentials.speedWalk or fly speed; 1 is normal and 10 is the maximum.
/vippointssofycore.vippoints.balanceShows your global VIP points balance.
/vipshop [listsofycore.vippoints.shopLists 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.viewAdministers 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.templatesCreates and edits shop templates (rank, duration, price, label) and the global maximum balance.
/bossbars [on|off|toggle]sofycore.bossbar.toggleShows 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 onsofycore.maintenance.manageNetwork-wide maintenance: kicks players without bypass, blocks new joins and, by default, freezes the rank clock.
/maintenance offsofycore.maintenance.manageReopens the network; an optional bonus keeps the rank clock stopped for longer.
/maintenance statussofycore.maintenance.statusState, reason, who and since when, and the rank clock state.
/settingssofycore.menus.settingsPreferences menu (announcements, private messages, boss bar, mentions...).
/profilesofycore.menus.profileYour profile menu.
/player <player>sofycore.staff.panelStaff panel of a player: profile, sanctions, ranks and, with sofycore.staff.panel.address, last IP.
/players sofycore.menus.playersPlayers 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.