Commands & permissions
Every BetterMultiThreaded command, what it does and the permission it needs.
Start with /tps. It shows what every region is doing and has a button for the most common action.
Every admin command lives under /bmt, the short form of /bettermultithreaded. Both names take the same sub commands, and /bmt on its own opens the help menu.
Everyday commands
| Command | What it does |
|---|---|
/tps | Region list with each region’s mode, live speed-up and one-click [Split ⚡], [Undo] and [Menu] buttons. |
/bmt folia | Menu of every manual split, zone and world level. |
/bmt foliaworld | World levels 0–4 (0 = plain Folia, 1 = 64-chunk shards … 4 = 8-chunk shards). |
/bmt foliawand | Selection wand. Pick two corners, then choose automatic, a shard count or a shard size. |
/bmt shard scan | Finds lagging regions and turns them into permanent sharded zones. |
/bmt shard info | The region you stand in: mode, shards, timings and the sharding engine’s live counters. |
/bmt folia
Run as a player, it opens the menu. From the console, or with an argument, it takes these actions.
| Command | What it does |
|---|---|
/bmt folia list | Every manual operation: zones, world levels and live overrides. |
/bmt folia disable <zone> | Switch a zone off. It stays in the file. |
/bmt folia enable <zone> | Switch a zone back on. |
/bmt folia delete <zone> | Remove a zone for good. |
/bmt folia replan <zone> | Recompute the zone’s shard size from the players inside it now. |
/bmt folia panic | Emergency: every zone off, every world level 0, every override cleared. |
/bmt folia reload | Reload canvas-bolge-zones.json. |
/bmt foliaworld
| Command | What it does |
|---|---|
/bmt foliaworld | As a player: the world-levels menu. |
/bmt foliaworld list | Every world with its level. |
/bmt foliaworld <world> <0-4> | Set a world’s level. 0 restores plain Folia; 1–4 shard every region of the world with 64, 32, 16 or 8-chunk pieces. |
/bmt foliaworld <world> default | Same as level 0. |
/bmt foliaworld <world> max | Same as level 4. |
/bmt foliawand
| Command | What it does |
|---|---|
/bmt foliawand | Gives the split wand. Left click sets the first corner, right click the second and opens the split menu. |
/bmt foliawand menu | Reopen the split menu for the current selection. |
/bmt foliawand clear | Clear the selection. |
/bmt foliafix
The command behind the [Split ⚡] and [Undo] buttons in /tps. You can also type it.
| Command | What it does |
|---|---|
/bmt foliafix <world> <x> <z> [auto] | Look at the region that owns that block, pick a shard size from where its players stand, and save it as a zone. |
/bmt foliafix <world> <x> <z> <pieces> | Same, but aim for that many shards. |
/bmt foliafix <world> <x> <z> off | Undo: disable the zone that covers the region and clear a live override. |
/bmt shard
The full sharding tree. With no arguments a player gets the menu and the console gets the status.
| Command | What it does |
|---|---|
/bmt shard menu | Open the menu. |
/bmt shard on [world|zone] [size] | Shard a whole world (default: the world you stand in), or enable a zone by name. |
/bmt shard off [world|zone] | Back to Folia for that world, or disable that zone. |
/bmt shard scan | Check the region you stand in and convert it to a permanent zone if it is lagging. |
/bmt shard scan all | Check every region on the server. This is what the console runs. |
/bmt shard scan report | Report only; nothing is converted. Combine with all. |
/bmt shard size [world|zone] <n> | Shard size in chunks: 8 to 64, a power of two. Regions re-shard on the next tick. |
/bmt shard worlds | Worlds with their mode and shard size. |
/bmt shard wand | Selection wand: left click first corner, right click second. |
/bmt shard create <name> [size] | Create a zone from the selection. |
/bmt shard persist | Make the region you stand in a permanent zone. |
/bmt shard delete <name> | Delete a zone. |
/bmt shard list | List the zones. |
/bmt shard info | The region you stand in: mode, shards and timings. |
/bmt shard status | Every sharded region on the server. |
/bmt shard force <on|off|auto> [size] | Override the mode of one region. |
/bmt shard reload | Reload the zone and world file. |
Hopper mode
| Command | What it does |
|---|---|
/hoppervanilla | The hopper you are looking at goes back to vanilla behaviour: one item per transfer, checked every tick. |
/hopperperformance | The hopper you are looking at uses the hopper-amount and hopper-check values from spigot.yml again. |
Both only work for players, and only on the one hopper in view. The mode is stored on the hopper and survives restarts.
Permissions
| Permission | Covers |
|---|---|
bettermultithreaded.command.folia | /bmt folia |
bettermultithreaded.command.foliaworld | /bmt foliaworld |
bettermultithreaded.command.foliawand | /bmt foliawand |
bettermultithreaded.command.foliafix | /bmt foliafix and the split button in /tps |
bettermultithreaded.command.shard | /bmt shard |
bettermultithreaded.command.reload | /bmt reload |
bettermultithreaded.command.help | /bmt and /bmt help |
Operators have all of them. Anyone with one of the sub command permissions can open /bmt too, and the help menu only lists the commands they may use. /hoppervanilla and /hopperperformance need no permission: any player may switch a hopper they are looking at.
Reloading
/bmt reload re-reads config/canvas-server.yml without a restart. That is how the kill switch works: set sharded-regions.enabled: false, then reload. Some options are only read at startup; the comment above each option in the file says so.