Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
TophersTools is a powerful utility plugin for usage with FastAsyncWorldEdit (FAWE), designed to help you manage, save, share, and recover your brushes and tools.
My Favorite Feature, /BM, Sharable Brush Macros (as a YAML file), these are mostly human readable files that you can share with your friends on the same server or share the file to another server to utilize. Anything a brush/tool can be set to in FAWE it can retain. These macros can store the original Item Stack details including custom names and meta data, up to 36 items per macro, it will retain the location in the inventory as well.
Brush Details are stored by default within a local SQLite Database File within the plugins directory. The config does provide an option for MySQL/MariaDB connections if preferred.
Commands & Features
1. Brush / Tool Macro (BM)
- Description: Allows creation, loading, and deleting of a set of 1–36 FAWE brush/tools retaining custom item details, stored as a shareable YAML file. It retains original item details, custom names, and inventory slots. Macro names are sanitized for specific characters then limited to a maximum length of 48 characters.
- Commands:
/brushmacro,/bm,/toolmacro,/tm - Sub-Commands:
save,load,delete - Cooldown: 5 Seconds, seperated by sub command. Can be modified in the Config.
- Maximum stored in Cache: 5. Can be modified in the Config.
Sub-Command Details & Usages:
- Save Macro
- Usage:
/{Command} save {macroname} [--override|-o] - Permission:
topherstools.bt.macro.save - Note: The
--override(or-o) flag is used to overwrite a macro if it already exists.
- Usage:
- Load Macro
- Usage:
/{Command} load {macroname} - Permission:
topherstools.bt.macro.load
- Usage:
- Delete Macro
- Usage:
/{Command} delete {macroname} [confirm] - Permission:
topherstools.bt.macro.delete - Note: Requires a two-step confirmation process with a 15-second window. Running the delete command initially
registers a pending request; appending
confirmcompletes the deletion. Confirm does not tab-complete for this.
- Usage:
- Help / Info
- Usage:
/{Command}(No sub-command) - Permission:
topherstools.bt.macro
- Usage:
2. Get Brush / Tool (GB)
-
Description: Retrieves active or previously bound (after logout or server restart unbound) brush/tool details and loadout prompts for yourself, a specified online player & or a specific material (even if the target player is offline). Provides clickable chat messages to reapply commands. Supports auto-completion for usernames and stored materials so you don't have to guess who has what.
-
Commands:
/getbrush,/gb,/gettool,/gt -
Cooldown: 2 Seconds. Can be modified in the Config.
-
Self Lookup
- Usage:
/{Command} - Permission:
topherstools.bt.get.self - Behavior: Inspects the item currently held in your main hand and outputs its bound brush/tool details.
- Usage:
-
Specified Player Lookup
- Usage:
/{Command} {player} - Permission:
topherstools.bt.get.specified.player - Behavior: Inspects the main-hand item of the specified online player and outputs the bound brush/tool details. Supports tab-completions.
- Usage:
-
Specified Player & Material Lookup
- Usage:
/{Command} {player} {material} - Permission:
topherstools.bt.get.specified.player.specified.material - Behavior: Fetches details for a specific material from the target player and outputs the bound brush/tool details. (Works even if they are offline). Supports tab-completions.
- Usage:
3. Share / Shout - Brush / Tool (SB)
- Description: Broadcasts your currently held main-hand brush/tool details to all online players on the server, while prompting your own chat with the same brush/tool details.
- Commands:
/shoutbrush,/shouttool,/sharebrush,/sharetool,/sb,/st - Usage:
/{Command} - Permissions:
topherstools.bt.shout& ORtopherstools.bt.share - Cooldown: 5 Seconds. Can be modified in the Config.
4. Return All Brush / Tools (RAT)
- Description: Fetches up to 36 saved brush/tool loadouts for the requesting player and rebinds/returns them to inventory slots 0–35. (Messy, should really just use the Brush Macro lol, but if it works... it works).
- Commands:
/returnallbrushes,/rab,/returnalltools,/rat - Usage:
/{Command} - Permission:
topherstools.bt.returnall - ⚠️ Warning: This will clears inventory slots
0–35prior to applying loadouts. - Cooldown: 8 Seconds. Can be modified in the Config.
5. Clear All Brush / Tools (CAT)
- Description: Clears and unbinds all active brush/tool loadouts from the database for the requesting player and strips the tool bindings from FastAsyncWorldEdit entirely.
- Commands:
/clearallbrushes,/cab,/clearalltools,/cat - Usage:
/{Command} - Permission:
topherstools.bt.clearall - Cooldown: 8 Seconds. Can be modified in the Config.
6. Reload Configuration
- Description: Reloads all configuration settings (except SQL Settings, these reload on restart) and cooldown configurations for the plugin's brush-tool utilities.
- Commands:
/topherstools reload btutils,/tt r btu - Usage:
/{Command} - Permission:
topherstools.reloadconfig.fawebtutils - Cooldown: No cooldown.
I'm open to any suggestions or hearing out requests related to this project, feel free to reach out. :)
If I missed something that should be retained for these intended functionalities please mark it as an issue / bug on the GitHub or contact me.
Personal Credits
- Created by KhristopherE.
- Credit to TheWither_MAN for several ideas throughout & testing!
- Credit to Hunterspal for testing!
Dependencies & Acknowledgments
Shaded / Embedded Libraries - Credits
The following libraries are bundled directly inside TophersTools.
For full license texts and copyright notices of bundled dependencies, please refer to the bundled THIRD-PARTY-LICENSES.md file, also available on GitHub.