TophersTools

TophersTools

TophersTools is a 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.
• Load Macro
• Usage: /{Command} load {macroname}
• Permission: topherstools.bt.macro.load
• 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 confirm completes the deletion. Confirm does not tab-complete for this.

• Help / Info
• Usage: /{Command} (No sub-command)
• Permission: topherstools.bt.macro

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.
• 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.

• 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.

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 & OR topherstools.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–35 prior 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.

• HikariCP
• Google Gson
• Cloud

*For full license texts and copyright notices of bundled dependencies, please refer to the

bundled THIRD-PARTY-LICENSES.md file, also available on GitHub.*

Compile-Only Dependencies - Credits

• Paper API
• FastAsyncWorldEdit
• WorldEdit