BuildersWand
介绍 BuildersWand!这是一款免费、开源的解决方案,赋予你和你的玩家快速建造的能力,无需费力。
相关命令:
/builderswand (别名: /bw) » 插件的主命令,不带参数运行时显示有效用法。
/builderswand reload (别名: /bw reload) » 从配置文件中重新加载法杖到内存中。
/builderswand list (别名: /bw list) » 列出插件中当前配置的所有法杖。
/builderswand give <wand> <player> (别名: /bw give) » 将指定的法杖给予指定的玩家。
相关权限:
builderswand.admin » 授予所有管理命令和权限的访问权限。
builderswand.use.<wand> » 允许玩家使用指定的法杖。支持通配符(例如,builderswand.use.* 以允许所有法杖)。
builderswand.give » 允许玩家将法杖给予其他玩家。
builderswand.reload » 允许玩家重新加载插件配置。
builderswand.list » 允许玩家列出所有已配置的法杖。
builderswand.notify.update » 允许玩家接收更新通知。
如果你有任何问题、功能请求或遇到问题,请随时通过我的支持 Discord 联系我:
此外,欢迎通过 GitHub 仓库做出贡献(如果可能,请先问我,以便我们可以先为你的实现制定一个良好的计划)。
外部插件集成
BuildersWand 原生支持以下插件:
- SuperiorSkyblock
- Lands
- WorldGuard
- BentoBox
如果你有关于要添加的插件集成/支持的建议,请通过上面的 Discord 服务器与我联系。我们可以讨论你的用例以及你希望添加的内容。
API
BuildersWand 确实提供了一个 API,但目前没有文档也没有可依赖的主机 API jar。如果你是插件作者并正在寻找可实现的 API,请通过上面的支持 Discord 联系我,并告知我存在一定的兴趣程度。
指标
如果你对 BuildersWand 的指标感兴趣,你可以在这里找到:Metrics
默认配置文件
# BuildersWand 主配置文件
# 不要编辑此行!!!
# 它用于检查文件是否过时且需要更新
config_version: 1.5.0
# 这对于建造法杖的工作不是必需的,但它确实减少了通过法杖放置方块时触发的数量
# 如果你想自己处理方块放置事件取消并且不想触发额外事件,则设置为 false
# 如果你想允许其他插件处理方块放置事件取消(如 WorldGuard 或 SuperiorSkyblock),则设置为 true
fireWandBlockPlaceEvent: true
# 这对于建造法杖的工作不是必需的,但它确实减少了使用法杖时触发的数量
# 如果你不想为法杖使用添加额外逻辑,则设置为 false,这非常适合拥有大量玩家的服务器
fireWandPreviewEvent: true
# 如果你想让方块立即放置,可以禁用此选项。
# 如果你注意到性能影响,请务必启用此选项并调整 maxBlocksPerTick 值。
placementQueue:
enabled: true
maxBlocksPerTick: 20 # 每刻最多放置的方块数
# 是否自动从玩家库存中移除无效的法杖
# 无效的法杖是指已从配置中删除或以其他方式变得无效的法杖
# 在你确定法杖配置正确之前,应保持禁用状态
destroyInvalidWands:
enabled: false
updater:
enabled: true
checkIntervalMinutes: 60
notify:
console: true
ingame: true
# 仅建议在排查问题时启用,因为它会产生大量日志垃圾。默认为 false
debug: false
wands:
my_special_wand:
name: "&3建造者法杖"
material: "BLAZE_ROD"
lore:
- "&7一把强大的<blue>建造用法杖!"
- "&7请<green>明智地使用它。"
wandType: STANDARD # 默认为 STANDARD。有效类型:STANDARD 和 STATIC
staticLength: 5 # 仅在 wandType 为 STATIC 时使用,否则被忽略
staticWidth: 5 # 仅在 wandType 为 STATIC 时使用,否则被忽略
maxSize: 8 # 最大方块搜索与放置尺寸
maxSizeText: "&3最大尺寸: {maxSize}"
maxRayTraceDistance: 16 # 插件在给定方向上搜索方块的最大距离
consumeItems: true # 是否在放置方块时从玩家背包中消耗物品
generatePreviewOnMove: false # 是否在玩家移动时生成方块放置位置的预览(白色小粒子)
undoHistorySize: 10 # 为该法杖存储每位玩家的撤销次数,默认为 10。Shift+左键可撤销放置操作,输入 -1 表示无限次,输入 0 以禁用撤销功能。
canBreakBlocksWhileCrouched: true # 是否可以在蹲下时破坏方块。默认为 false,以防止意外破坏敏感方块。
durability:
amount: 100
enabled: true
text: "&3耐久度: {durability}"
breakSound: # 是否在法杖损坏时播放声音
enabled: false
sound: ENTITY_ITEM_BREAK # 有效音效可在以下网址找到:https://jd.papermc.io/paper/1.21.11/org/bukkit/Sound.html
message: "&4你的法杖损坏了!"
previewParticle: # 仅限 Paper 服务器
particle: "DUST" # 有效粒子名称可在以下网址找到:https://jd.papermc.io/paper/1.21.11/org/bukkit/Particle.html
options: # 仅某些粒子需要此选项
color:
red: 0
green: 0
blue: 0
size: 1.0
count: 1 # 预览中每个方块生成的粒子数量
offset:
x: 0
y: 0
z: 0
speed: 0 # 粒子速度
cooldown: 2 # 单位为秒
craftable: false # 该法杖是否可以作为材料用于合成配方
blockedMaterials:
- BEDROCK
- BARRIER
craftingRecipe:
enabled: false
shape: # 如果大于 3x3,将抛出错误
- " E "
- " S "
- " S "
ingredients: # 确保此处列出的材料是有效的
E: EMERALD
S: STICK
# BuildersWand 消息配置
# 所有由 BuildersWand 发送给玩家的消息均在此定义。
# 您可以通过编辑下方的值来自定义任何消息。
# 支持颜色代码 (&c, &a 等) 和 MiniMessage 格式
# 请勿编辑此行!!!
# 它用于检查文件是否已过时并需要更新
config-version: 1.5.0
prefix: "&7[&bBuildersWand&7] &r"
command:
usage: "&c用法: /builderswand <reload|list|give> <id> [player]" # <-- id 和 player 仅在 give 命令时需要
reload:
success: "&a配置已重新加载。"
no-wands: "&c未找到任何法杖。"
wand-not-found: "&c未找到 ID 为 {id} 的法杖。"
wand-received: "&a你获得了 {id} 法杖!"
wand-given: "&a已将 {id} 给予 {player_name}。"
only-players: "&c只有玩家才能给自己发放法杖。"
wand-list: "&e法杖列表: "
wand:
placing-blocks: "&7正在放置方块... &e剩余 {remaining} &7个"
placement-complete: "&a方块放置完成!"
misconfigured: "&4你持有的法杖配置错误,已被移除。请立即联系管理员。"
no-permission: "&4你没有权限使用此法杖。"
still-placing: "&4法杖仍在放置方块,请稍候..."
cooldown-active: "&4请等待 &c{seconds} &4秒后再使用该法杖。"
insufficient-blocks: "&4你需要更多的 &c{material} &4方块,还差 &c{needed} &4个。"
placement-disallowed: "&4不允许放置。"
nothing-to-undo: "&c没有可撤销的操作!"
action-undone: "&a操作已撤销!&c剩余 &a{remaining} &a次撤销机会。"
updater:
available: "&aBuildersWand 有可用更新!请查看控制台获取更多信息。"
BuildersWand
Introducing BuildersWand! A free, open-source solution that gives you, and your players, the power to build quickly without breaking a sweat.
Relevant commands:
/builderswand (Aliases: /bw) » Main command for the plugin, shows valid usage if run without arguments.
/builderswand reload (Alias: /bw reload) » Reloads wands from the configuration file into memory.
/builderswand list (Alias: /bw list) » Lists all wands currently configured in the plugin.
/builderswand give <wand> <player> (Alias: /bw give) » Gives the specified player the specified wand.
Relevant permissions:
builderswand.admin » Grants access to all admin commands and permissions.
builderswand.use.<wand> » Allows the player to use the specified wand. Has wildcard support (e.g., builderswand.use.* to allow all wands).
builderswand.give » Allows the player to give wands to other players.
builderswand.reload » Allows the player to reload the plugin configuration.
builderswand.list » Allows the player to list all configured wands.
builderswand.notify.update » Allows the player to receive update notifications.
If you have any questions, feature requests, or issues, please don't hesitate to contact me through my support Discord:
Additionally, feel free to contribute through the GitHub repository (if possible, please ask me first so that we can hash out a good plan for your implementation first).
External Plugin Integrations
BuildersWand natively supports the following plugins:
- SuperiorSkyblock
- Lands
- WorldGuard
- BentoBox
If you have any suggestions for plugin integrations/support to add, please reach out to me through my Discord server above. We can discuss your use case and what you’re looking to have added.
API
BuildersWand does feature an API, but currently there is no documentation nor hosted API jar that can be depended on. If you are a plugin author and looking for an implementable API, please contact me via my support Discord above and let me know that there is some level of interest.
Metrics
If you're interested in the metrics for BuildersWand, you can find it here: Metrics
Default Configuration Files
# BuildersWand Main Configuration File
# DO NOT EDIT THIS LINE!!!
# IT IS USED TO CHECK IF THE FILE IS OUTDATED AND NEEDS TO BE UPDATED
config_version: 1.5.0
# this isn't required for the build wand to work, but it does reduce the amount of fired events when placing blocks through the wand
# set to false if you want to handle block place event cancellations yourself and don't want extra events fired
# set to true if you want to allow other plugins to handle block place event cancellations (like WorldGuard or SuperiorSkyblock)
fireWandBlockPlaceEvent: true
# this isn't required for the build wand to work, but it does reduce the amount of fired events when using the wand
# set to false if you don't want to add extra logic to wand usage, ideal for servers with a lot of players
fireWandPreviewEvent: true
# This can be disabled if you want blocks to be placed instantly.
# If you notice a performance impact definitely enable this and adjust the maxBlocksPerTick value.
placementQueue:
enabled: true
maxBlocksPerTick: 20 # max blocks to place per tick
# Whether to automatically remove invalid wands from players' inventories
# An invalid wand is one that has been removed from the config or has otherwise become invalid
# this should be kept disabled until you are sure your wands are configured correctly
destroyInvalidWands:
enabled: false
updater:
enabled: true
checkIntervalMinutes: 60
notify:
console: true
ingame: true
# Only recommended when troubleshooting issues since it can generate a lot of log spam. defaults to false
debug: false
wands:
my_special_wand:
name: "&3Builders Wand"
material: "BLAZE_ROD"
lore:
- "&7A powerful wand for <blue>building!"
- "&7Use it <green>wisely."
wandType: STANDARD # defaults to STANDARD. valid types: STANDARD & STATIC
staticLength: 5 # only used if wandType is STATIC, otherwise ignored
staticWidth: 5 # only used if wandType is STATIC, otherwise ignored
maxSize: 8 # max block search & placement size
maxSizeText: "&3Max Size: {maxSize}"
maxRayTraceDistance: 16 # max distance that the plugin will search for a block in a given direction
consumeItems: true # whether the wand should consume items from the player's inventory when placing blocks
generatePreviewOnMove: false # whether to generate a preview (small white particles) of where blocks will be placed when the player moves
undoHistorySize: 10 # number of undoes to store per player for this wand, defaults to 10. shift left click to undo a placement, input - 1 for unlimited and 0 to disable undoing.
canBreakBlocksWhileCrouched: true # whether you break blocks while crouching. defaults to false, preventing accidental sensitive block breaking.
durability:
amount: 100
enabled: true
text: "&3Durability: {durability}"
breakSound: # whether to play a sound when the wand breaks
enabled: false
sound: ENTITY_ITEM_BREAK # valid sounds can be found here: https://jd.papermc.io/paper/1.21.11/org/bukkit/Sound.html
message: "&4Your wand broke!"
previewParticle: # paper-only
particle: "DUST" # valid particle names can be found here: https://jd.papermc.io/paper/1.21.11/org/bukkit/Particle.html
options: # only required for certain particles
color:
red: 0
green: 0
blue: 0
size: 1.0
count: 1 # number of particles to spawn per block in the preview
offset:
x: 0
y: 0
z: 0
speed: 0 # speed of the particles
cooldown: 2 # in seconds
craftable: false # whether this wand can be used in crafting recipes as an ingredient
blockedMaterials:
- BEDROCK
- BARRIER
craftingRecipe:
enabled: false
shape: # if this is larger than 3x3, an error will be thrown
- " E "
- " S "
- " S "
ingredients: # ensure the ingredients listed here are valid materials
E: EMERALD
S: STICK
# BuildersWand Messages Configuration
# All messages sent to players by BuildersWand are defined here.
# You can customize any message by editing the values below.
# Supports color codes (&c, &a, etc.) and MiniMessage formatting
# DO NOT EDIT THIS LINE!!!
# IT IS USED TO CHECK IF THE FILE IS OUTDATED AND NEEDS TO BE UPDATED
config-version: 1.5.0
prefix: "&7[&bBuildersWand&7] &r"
command:
usage: "&cUsage: /builderswand <reload|list|give> <id> [player]" # <-- id and player are only needed for the give command
reload:
success: "&aConfiguration has been reloaded."
no-wands: "&cNo wands found."
wand-not-found: "&cNo wand found with ID: {id}."
wand-received: "&aYou received a {id} wand!"
wand-given: "&aGave {id} to {player_name}."
only-players: "&cOnly players can give wands to themselves."
wand-list: "&eWands: "
wand:
placing-blocks: "&7Placing blocks... &e{remaining} &7left"
placement-complete: "&aBlock placement complete!"
misconfigured: "&4The wand you had was misconfigured and has been removed. Please contact an administrator immediately."
no-permission: "&4You do not have permission to use this wand."
still-placing: "&4Wand is still placing blocks, please wait..."
cooldown-active: "&4Please wait &c{seconds} &4seconds before using the wand again."
insufficient-blocks: "&4You need &c{needed} &4more &c{material} &4blocks."
placement-disallowed: "&4Disallowed."
nothing-to-undo: "&cNothing to undo!"
action-undone: "&aAction undone! &c{remaining} &aundoes remaining."
updater:
available: "&aAn update for BuildersWand is available! Check console for more info."
评论 0
登录后参与评分
还没有评论,来抢沙发吧