Skip to content

Commands ​

Every command of AppelTools, with its syntax and the permission it needs. The lists are split by the half of the plugin the command belongs to.

How to read the syntax

NotationMeaning
<name>a required argument
[name]an optional argument
<name>...the rest of the line, spaces included
[-s]an optional flag

The permission is written as the node that has to be present. Where a command asks for more than one node, all of them have to be present — they are written as a and b.


On the backend (Paper) ​

The commands of the backend run inside a game server. Which of them exist depends on the module toggles in config.yml.

Teleport ​

CommandPermissionWhat it does
/tp <player> [target]appeltools.command.teleportTeleport to a player. With a second name, teleport that player to the first.
/tphere <player>appeltools.command.teleport.hereBring a player to you.
/tppos <x> <y> <z> [yaw] [pitch] [world]appeltools.command.teleport.posTeleport to a position. ~ and 0 work as coordinates.
/backappeltools.command.teleport.backGo back to where you were before your last teleport.
/tpask <player> (alias tpa)appeltools.command.teleport.askAsk a player to teleport to you.
/tpahere <player>appeltools.command.teleport.ahereAsk a player to come to you.
/tpaccept <player>appeltools.command.teleport.acceptAccept a teleport request.
/tpdeny <player>appeltools.command.teleport.denyRefuse a teleport request.
/tpacancel [player]appeltools.command.teleport.acancelWithdraw your own requests, or one of a player.
/tpautoappeltools.command.teleport.autoAccept teleport requests automatically.
/tptoggle [player] [true/false]appeltools.command.teleport.toggleSwitch the teleport requests on or off.

The teleport requests have a timeout — see the teleport page.

Homes ​

CommandPermissionWhat it does
/home [name] (alias /homes)appeltools.command.home.homeWithout a name, list your homes. With a name, go there.
/sethome <name>appeltools.command.home.sethomeSave where you are as a home.
/delhome <name>appeltools.command.home.delhomeAsk to delete a home.
/delhomeconfirm <name>appeltools.command.home.delhomeconfirmConfirm the deletion.
/renamehome <old> <new>appeltools.command.home.renamehomeGive a home another name.

Comfort ​

CommandPermissionWhat it does
/speed [speed]appeltools.command.speedChange the walking or the flying speed, whichever applies to you.
/walkspeed [speed]appeltools.command.speedChange the walking speed.
/flyingspeed [speed]appeltools.command.speedChange the flying speed.
/fly (alias /togglefly)appeltools.command.speed.flySwitch flying on or off.
/gamemode adventure|creative|spectator|survival [player]appeltools.command.gamemode and the node of that gamemodeChange your gamemode, or the gamemode of another player.

Changing the gamemode of another player needs appeltools.command.gamemode.setother on top.

The gamemodes also have their own commands — /adventure, /creative, /spectator and /survival, with the shortcuts /gma, /gmc, /gmsp and /gms.

Economy ​

CommandPermissionWhat it does
/balance (aliases /bal, /money)appeltools.command.economy.balanceShow your balance.
/baltop [page] (alias /balancetop)appeltools.command.economy.baltopThe players with the highest balance.
/pay <player> <amount>appeltools.command.economy.payPay a player.
/togglepay [true/false]appeltools.command.economy.togglepayAllow or refuse payments.
/transactionhistory [page] (alias /th)appeltools.command.economy.transactionhistoryThe log of the changes of your balance.
/transactionhistory <player> [page]appeltools.command.economy.transactionhistory.otherThe log of the changes of someone else's balance.
/economy add|remove|set <player> <amount> (alias /eco)appeltools.command.economyChange the balance of a player.
/economy reset <player>appeltools.command.economySet the balance of a player back to zero.

Staff lookups and tools ​

CommandPermissionWhat it does
/seen <player>appeltools.command.staff.seenWhen the player was last online.
/alts <player>appeltools.command.staff.altsThe other accounts that share an address with the player.
/geoip <player>appeltools.command.staff.geoipWhere the player connects from.
/stats <player>appeltools.command.staff.statsThe statistics of the player.
/freeze <player>appeltools.command.staff.freezeFreeze a player in place.
/notesgui <player>appeltools.command.staff.notesguiOpen the notes of a player in a chest.

The module names of /atp modules and /atv modules are the names of the toggles in upper case, with the dashes turned into underscores: ROOT, ECONOMY, STAFF, GAMEMODE, SPEED, CHAT_MODIFIER, TELEPORT, HOME on the backend, and APPELTOOLS, BROADCAST, MAINTENANCE, MESSAGE_SYSTEM, PUNISHMENT_SYSTEM, REPORT_SYSTEM, PARTY, FRIENDS, RESTART_SERVER, RULES, SERVER_INFO, STAFF, PLUGIN_UPDATER and SERVERS on the proxy.

The plugin itself ​

CommandPermissionWhat it does
/atp help [page] (aliases /atp, /atpaper)—The list of the commands you may use.
/atp reloadappeltools.command.admin and appeltools.command.admin.reloadRead the configuration again.
/atp healthappeltools.command.admin and appeltools.command.admin.healthThe health of the plugin: the database, the tasks and the players.
/atp modules listappeltools.command.admin and appeltools.command.admin.modulesThe modules and whether they are on.
/atp modules enable <module>appeltools.command.admin and appeltools.command.admin.modulesSwitch a module on.
/atp modules disable <module>appeltools.command.admin and appeltools.command.admin.modulesSwitch a module off.
/atp 2fa reset <player>appeltools.command.admin and appeltools.command.twofactor.resetReset the two-factor of a player.
/atp updater listappeltools.command.admin and appeltools.command.admin.pluginupdaterThe plugins that are watched and their versions.
/atp updater get <plugin>appeltools.command.admin and appeltools.command.admin.pluginupdaterThe newest version of one plugin.
/atp updater update <plugin>appeltools.command.admin and appeltools.command.admin.pluginupdaterDownload and install the newest version.
/atp debug staffmode give <item>appeltools.command.admin and appeltools.command.admin.debugPut one item of the tool kit in your hand.
/atp debug event trigger join <player>appeltools.command.admin and appeltools.command.admin.debugFire the join event of a player.
/atp debug event trigger quit <player>appeltools.command.admin and appeltools.command.admin.debugFire the leave event of a player.
/atp debug event trigger pluginmessage <player> <channel> <message...>appeltools.command.admin and appeltools.command.admin.debugSend a plugin message to a player.

On the proxy (Velocity) ​

The commands of the proxy work on the whole network: they do not need the player to be on the same server as the target.

Social ​

CommandPermissionWhat it does
/friends add <player>appeltools.command.friends.addSend a friend request.
/friends accept <player>appeltools.command.friends.acceptAccept a friend request.
/friends deny <player>appeltools.command.friends.denyRefuse a friend request.
/friends remove <player>appeltools.command.friends.removeRemove a friend.
/friends list [page]appeltools.command.friends.listYour friends.
/friends requests [page]appeltools.command.friends.requestsThe requests you sent.
/friends pending [page]appeltools.command.friends.requestsThe requests you received.
/friends notificationsappeltools.command.friends.notificationsSwitch the friend notifications on or off.
/friends toggleappeltools.command.friends.toggleSwitch the friend requests on or off.
/party invite <player>appeltools.command.parties.inviteInvite a player into your party.
/party accept <player>appeltools.command.parties.acceptAccept a party invitation.
/party leaveappeltools.command.parties.leaveLeave the party.
/party listappeltools.command.parties.listThe members of your party.
/party promote <player>appeltools.command.parties.promoteMake a member a second leader.
/party demote <player>appeltools.command.parties.demoteTake the second leadership away.
/party transfer <player>appeltools.command.parties.transferHand the party over to a member.
/party remove <player> (alias /party kick)appeltools.command.parties.removeRemove a member from the party.
/party warpappeltools.command.parties.warpBring the party to the server you are on.
/party disbandappeltools.command.parties.disbandDisband the party.
/party chat <message...>appeltools.command.parties.chatWrite in the party chat.
/party muteappeltools.command.parties.muteSwitch the party chat off for the members.
/party allinviteappeltools.command.parties.allinviteAllow everybody in the party to invite others.
/party admin join <party> <player>appeltools.command.parties.admin.joinPut a player into a party.
/party admin listappeltools.command.parties.admin.listThe parties that are open.
/party admin disband <party>appeltools.command.parties.admin.disbandDisband a party.

/friends also answers to /friend and /f, /party to /p.

Messaging ​

CommandPermissionWhat it does
/message <player> <message...>—A private message. Aliases: /msg, /w, /m, /t, /pm, /emsg, /epm, /tell, /etell, /whisper, /ewhisper.
/reply <message...>—Answer the last private message. Aliases: /r, /er, /ereply.
/ignore <player>—Ignore a player. Alias: /eignore.
/unignore <player>—Stop ignoring a player. Aliases: /eunignore, /delignore, /edelignore, /remignore, /eremignore, /rmignore, /ermignore.
/messagetoggle <on/off>—Switch the private messages on or off. Alias: /msgtoggle.
/pchat <message...>—Write in the party chat. Alias: /pc.
/chat all|party|message—Choose the channel you write in. Alias: /c.
/chat staffappeltools.command.staff.staffchatWrite in the staff chat from now on.

Moderation ​

Every punishment command takes the target, an optional -s and a reason. The -s makes the punishment silent: it is not announced in chat.

CommandPermissionWhat it does
/ban <player> [-s] <reason...>appeltools.command.moderation.banBan the player for good.
/tempban <player> <duration> [-s] <reason...>appeltools.command.moderation.tempbanBan the player for a while.
/unban <player> [-s] <reason...>appeltools.command.moderation.unbanLift a ban.
/kick <player> [-s] <reason...>appeltools.command.moderation.kickKick the player.
/ipkick <player> [-s] <reason...>appeltools.command.moderation.ipkickKick every account on that address.
/mute <player> [-s] <reason...>appeltools.command.moderation.muteMute the player for good.
/tempmute <player> <duration> [-s] <reason...>appeltools.command.moderation.tempmuteMute the player for a while.
/unmute <player> [-s] <reason...>appeltools.command.moderation.unmuteLift a mute.
/ipmute <player> [-s] <reason...>appeltools.command.moderation.ipmuteMute every account on that address.
/tempipmute <player> <duration> [-s] <reason...>appeltools.command.moderation.tempipmuteMute every account on that address for a while.
/ipunmute <player> [-s] <reason...>appeltools.command.moderation.ipunmuteLift an address mute.
/ipban <player> [-s] <reason...>appeltools.command.moderation.ipbanBan every account on that address.
/tempipban <player> <duration> [-s] <reason...>appeltools.command.moderation.tempipbanBan every account on that address for a while.
/ipunban <player> [-s] <reason...>appeltools.command.moderation.ipunbanLift an address ban.
/history <player>appeltools.command.moderation.historyThe punishments of a player.

Reports ​

CommandPermissionWhat it does
/report <player> <reason...>appeltools.command.moderation.reportReport a player to the staff.
/reports list <player>appeltools.command.staff.reportsThe reports about a player.
/reports remove <player> <id>appeltools.command.staff.reportsRemove a report.

Staff ​

CommandPermissionWhat it does
/broadcast <message...>appeltools.command.staff.broadcastWrite a message to everybody. Aliases: /a, /alert, /bc.
/staffchat <message...>appeltools.command.staff.staffchatWrite to the other staff only. Alias: /sc.
/staffchattoggle [on/off]appeltools.command.staff.staffchatSwitch the staff chat on or off. Alias: /sctoggle.
/stafflistappeltools.command.staff.stafflistThe staff that are online. Alias: /slist.
/staffmodetoggle [on/off]appeltools.command.staffSwitch staff mode on or off. Aliases: /smtoggle, /staffmode, /sm, /h.
/staffnotificationstoggle [on/off]appeltools.command.staffSwitch the staff notifications on or off. Aliases: /sntoggle, /staffnotifications.
/staffspytoggle [on/off]appeltools.command.staff.staffspySwitch the staff chat spy on or off. Aliases: /sstoggle, /staffspy.
/notes add <player> <note...>appeltools.command.staff.staffnotesWrite a note about a player. Aliases: /sn, /snotes, /staffnotes.
/notes list <player>appeltools.command.staff.staffnotesThe notes about a player.
/notes remove <player> <id>appeltools.command.staff.staffnotesRemove a note.
/versionlistappeltools.command.staff.versionlistThe plugins of the server and their versions. Alias: /vlist.

Server management ​

CommandPermissionWhat it does
/maintenance <on/off>appeltools.command.admin.maintenanceSwitch the maintenance mode on or off. Alias: /mt.
/restartproxy <duration>appeltools.command.admin.restartRestart the proxy after the countdown. Alias: /rp.
/restartserver <server> <duration>appeltools.command.admin.restartRestart a backend after the countdown. Alias: /rs.
/servers register <name> <ip> <port>appeltools.command.admin.serversAdd a backend to the proxy.
/servers unregister <name>appeltools.command.admin.serversRemove a backend from the proxy.
/servers listappeltools.command.admin.serversThe backends of the proxy.
/rules—The rules of the network. Alias: /erules.

Two-factor authentication ​

CommandPermissionWhat it does
/2fasetupappeltools.command.twofactor and appeltools.command.twofactor.setupSet up the two-factor of your account. Aliases: /twofactorsetup, /enroll2fa.
/verify <code>appeltools.command.twofactor and appeltools.command.twofactor.verifyVerify yourself with the code of your authenticator app. Aliases: /2faverify, /twofactorverify.

The plugin itself ​

CommandPermissionWhat it does
/atv help [page] (aliases /atv, /atvelocity)—The list of the commands you may use.
/atv reloadappeltools.command.admin and appeltools.command.staff and appeltools.command.admin.reloadRead the configuration again.
/atv modules listappeltools.command.admin and appeltools.command.staff and appeltools.command.admin.modulesThe modules and whether they are on.
/atv modules enable <module>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.modulesSwitch a module on.
/atv modules disable <module>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.modulesSwitch a module off.
/atv updater listappeltools.command.admin and appeltools.command.staff and appeltools.command.admin.pluginupdaterThe plugins that are watched and their versions.
/atv updater get <plugin>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.pluginupdaterThe newest version of one plugin.
/atv updater update <plugin>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.pluginupdaterDownload and install the newest version.
/atv debug uuid [player]appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.debugThe UUID of a player.
/atv debug message <message...>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.debugSend a debug message.
/atv debug pluginmessage <player> <channel> <on/off>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.debugSend a plugin message to a player.
/atv debug event trigger pluginmessage <player> <channel> <message...>appeltools.command.admin and appeltools.command.staff and appeltools.command.admin.debugFire the plugin message event of a player.

On Discord ​

These are slash commands in Discord, not commands in Minecraft. They are guarded by the Discord roles of the bot, not by a Minecraft permission.

CommandWhat it does
/search <server> <query>Search the log of a server.
/serverstats <server>The statistics of a server.
/playerstats <player>The statistics of a player.
/playerserverstats <server> <player>The statistics of a player on one server.
/2fa-reset <player>Reset the two-factor of a player.

The roles that may run them are set with discord.admin-roles in config.yml. See the Discord page.

Built with VitePress.