TophersTools 是一款配合 FastAsyncWorldEdit (FAWE) 使用的实用插件,旨在 帮助你管理、保存、分享和恢复你的画笔和工具。
我最喜爱的功能是 /BM(可分享的画笔宏,以 YAML 文件格式),这些文件大多具有人类可读性,你可以与同一服务器上的朋友分享,或将文件共享到其他服务器以使用。FAWE 中画笔/工具可以设置的任何内容都可以保留。这些宏可以存储原始物品堆栈详情,包括自定义名称和元数据,每个宏最多支持 36 个物品,并且会保留其在背包中的位置。
默认情况下,画笔详情存储在插件目录内的本地 SQLite 数据库文件中。如果偏好使用,配置中也提供了 MySQL/MariaDB 连接选项。
命令与功能
1. 画笔 / 工具宏 (BM)
- 描述: 允许创建、加载和删除一组 1–36 个 FAWE 画笔/工具,保留自定义物品详情,并存储为可分享的 YAML 文件。它保留原始物品详情、自定义名称和背包槽位。宏名经过特定字符清理后,长度限制为最多 48 个字符。
- 命令:
/brushmacro, /bm, /toolmacro, /tm
- 子命令:
save, load, delete
- 冷却时间: 5 秒,按子命令分开计算。可在配置中修改。
- 缓存最大存储量: 5。可在配置中修改。
子命令详情与用法:
- 保存宏
- 用法:
/{Command} save {macroname} [--override|-o]
- 权限:
topherstools.bt.macro.save
- 注意:
--override(或 -o)标志用于覆盖已存在的宏。
- 加载宏
- 用法:
/{Command} load {macroname}
- 权限:
topherstools.bt.macro.load
- 删除宏
- 用法:
/{Command} delete {macroname} [confirm]
- 权限:
topherstools.bt.macro.delete
- 注意: 需要两步确认过程,窗口期为 15 秒。首次运行删除命令会注册待处理请求;追加
confirm 完成删除。此操作不支持自动补全 confirm。
- 帮助 / 信息
- 用法:
/{Command}(无子命令)
- 权限:
topherstools.bt.macro
2. 获取画笔 / 工具 (GB)
-
描述: 检索当前活动或之前绑定(登出或服务器重启后未绑定)的画笔/工具详情,并为自身、指定在线玩家及/或特定材质提供加载提示。(即使目标玩家离线也适用)。提供可点击的聊天消息以重新应用命令。支持用户名和存储材质的自动补全,无需猜测谁拥有什么。
-
命令: /getbrush, /gb, /gettool, /gt
-
冷却时间: 2 秒。可在配置中修改。
-
自身查询
- 用法:
/{Command}
- 权限:
topherstools.bt.get.self
- 行为: 检查主手当前持有的物品,并输出其绑定的画笔/工具详情。
-
指定玩家查询
- 用法:
/{Command} {player}
- 权限:
topherstools.bt.get.specified.player
- 行为: 检查指定在线玩家的主手物品,并输出绑定的画笔/工具详情。支持自动补全。
-
指定玩家与材质查询
- 用法:
/{Command} {player} {material}
- 权限:
topherstools.bt.get.specified.player.specified.material
- 行为: 从目标玩家处获取特定材质的详情,并输出绑定的画笔/工具详情。(即使他们离线也有效)。
支持自动补全。
3. 分享 / 广播 - 画笔 / 工具 (SB)
- 描述: 将您当前主手持有的画笔/工具详情广播给服务器上所有在线玩家,同时在自己的聊天中与相同的画笔/工具详情进行提示。
- 命令:
/shoutbrush, /shouttool, /sharebrush, /sharetool, /sb, /st
- 用法:
/{Command}
- 权限:
topherstools.bt.shout 或 topherstools.bt.share
- 冷却时间: 5 秒。可在配置中修改。
4. 返回所有画笔 / 工具 (RAT)
- 描述: 为请求玩家获取最多 36 个已保存的画笔/工具加载项,并将其重新绑定/返回到背包槽位 0–35。(比较混乱,其实应该直接用画笔宏 lol,但如果能用……那就行吧)。
- 命令:
/returnallbrushes, /rab, /returnalltools, /rat
- 用法:
/{Command}
- 权限:
topherstools.bt.returnall
- ⚠️ 警告: 这将清除槽位
0–35 后再应用加载项。
- 冷却时间: 8 秒。可在配置中修改。
5. 清除所有画笔 / 工具 (CAT)
- 描述: 清除数据库中请求玩家的所有活跃画笔/工具加载项,并从 FastAsyncWorldEdit 中完全移除工具绑定。
- 命令:
/clearallbrushes, /cab, /clearalltools, /cat
- 用法:
/{Command}
- 权限:
topherstools.bt.clearall
- 冷却时间: 8 秒。可在配置中修改。
6. 重载配置
- 描述: 重载所有配置设置(SQL 设置除外,这些在重启时重载)以及插件画笔/工具实用程序的冷却配置。
- 命令:
/topherstools reload btutils, /tt r btu
- 用法:
/{Command}
- 权限:
topherstools.reloadconfig.fawebtutils
- 冷却时间: 无冷却。
我对与此项目相关的任何建议或需求听取持开放态度,欢迎随时联系我。 :)
如果我遗漏了这些预期功能应保留的内容,请在 GitHub 上将其标记为问题/错误,或直接联系我。
个人致谢
- 由 KhristopherE 创建。
- 感谢 TheWither_MAN 在整个过程中提供的多个想法和测试!
- 感谢 Hunterspal 进行测试!
依赖项与致谢
阴影/嵌入库 - 鸣谢
以下库已直接打包在 TophersTools 内部。
如需查看打包依赖项的完整许可证文本和版权声明,请参阅随附的 THIRD-PARTY-LICENSES.md 文件,该文件也可在 GitHub 上获取。
仅编译依赖项 - 鸣谢
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.
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧