
🔥 FireBallWand
高级管理、审核与自定义物品
一个插件。多种可能。完全掌控。
📖 简介
FireBallWand 是一款模块化的 Minecraft 插件,旨在将管理工具、审核功能、玩家常用指令和自定义物品整合到一个多功能解决方案中。
无论你是运营生存服务器、私人 SMP 还是基于活动的社区,FireBallWand 都提供了管理玩家、低调审核以及定制游戏体验所需的工具。
从先进的 隐身(Vanish)系统 和 员工模式(Staff Mode) 到 家(Homes)、出生点、传送请求、私聊和强大的自定义物品,每项功能都经过精心设计,既易于使用又具备高度可配置性。
✨ 主要亮点
- 🛡️ 完整的员工模式,配备安全存储的背包和全套审核工具包。
- 👻 先进的分层隐身系统,在命令和 Tab 补全中不留痕迹。
- ⭐ 神模式和飞行指令,行为可配置。
- 🏠 带有菜单的家系统,以及可配置的出生点。
- 💥 自定义武器、护甲和趣味物品。
- 💬 聊天格式化、私聊以及自定义加入/离开消息。
- 🧭 交互式传送请求系统。
- 🎒 自动且可配置的新手礼包。
- 📂 每个模块拥有独立的 YAML 配置文件。
- 🔌 可选集成流行的插件。
🛡️ 员工功能
员工模式 — /staff
一套专用的审核工具包,允许员工在不切换到创造模式的情况下审核玩家。
工作原理:
- 使用
/staff 切换员工模式。
- 你的真实背包会被保存,然后替换为你的审核物品。
- 再次执行
/staff 即可退出员工模式并恢复所有物品。
- 每种物品仅在拥有相应权限时才会提供。
可用工具:
| 物品 |
功能 |
| 👻 隐身物品 |
切换你的隐身状态 |
| ❄️ 冻结法杖 |
冻结或解冻目标玩家 |
| ⭐ 神模式物品 |
切换神模式 |
| 🧭 传送罗盘 |
传送到下一个在线玩家 |
| 🪶 飞行羽毛 |
切换飞行 |
背包安全:
- 你的背包(物品、护甲、副手以及可选的经验值)会在清空之前写入磁盘。如果失败,员工模式将不会启动。
- 当你退出员工模式、断开连接、死亡(重生时)或服务器停止时,背包会自动恢复。
- 服务器崩溃后,当你重新连接时会自动恢复。
- 员工物品无法被丢弃、存入箱子或移动到副手,死亡时也永远不会掉落。
员工模式下的保护(每项均可切换):
- 无法破坏或放置方块。
- 无法拾取或丢弃物品。
- 无法攻击玩家(冻结法杖仍然有效)。
检查工具:
- 🔍 背包查看器: 右键点击玩家即可查看其实时背包。默认为只读,编辑需要单独的权限。
- 🤫 静默容器: 隐身状态下,打开箱子、 barrel、漏斗、熔炉、潜影盒等容器时不会产生任何声音或动画(只读)。你会短暂进入观察者模式,并在关闭容器后恢复之前的游戏模式。
物品名称、材质、槽位和消息均可配置,整个模块可以通过 Staff.yml 禁用。
⭐ 神模式
指令: /godmod, /ungodmod
为管理员和员工提供的无敌系统。
- 激活期间取消受到的伤害和饥饿消耗。
- 虚空和
/kill 仍然会对玩家生效。
- 也可以通过员工模式中的物品激活。
- 包含简短别名:
/gm 和 /ugm。
🪶 飞行
指令: /fly [player], /fly speed <1-10> [player]
- 为自己或其他玩家切换飞行。
- 可调节飞行速度,最大值可配置。
- 在半空中关闭飞行时,忽略随后的摔落伤害。
👻 高级分层隐身
一款专为低调员工审核设计的先进隐身系统。
等级层级:
- 高等级员工可以看到低等级隐身的玩家。
- 低等级员工无法看到高等级隐身的玩家。
- 可见性通过基于权限的级别进行管理。
隐蔽性:
- 切换隐身时会发送一条与普通断开或连接相同的消息(原版、自定义或隐藏,遵循你的加入/离开消息设置),但仅对看不到该员工的玩家显示。
- 隐身期间的加入和离开消息会被隐藏。
- 隐身玩家的名称会从所有命令的自动补全中移除,包括其他插件的命令。
- 对于你无权看到的隐身玩家,
/tpa、/tpahere、/msg、/starterkit 和 /fly 会回答“未找到玩家”。
- 隐身玩家被排除在服务器列表的玩家计数和悬停玩家列表之外。
- TAB 集成会将隐身玩家从未经授权查看者的列表中隐藏。
- 持久的 ActionBar 提醒。
持久性和额外功能:
- 重新连接后保留隐身状态。
- 隐身玩家无法拾取物品,KickArmor 也不会踢出他们。
- 双击潜行切换到观察者模式,并返回之前的游戏模式。
/vanish list 显示你有权看到的隐身玩家列表。
- 聊天保护防止消息发送,除非消息以
/ 结尾。
所有 Vanish 的设置、权限级别和消息均可在 Vanish.yml 中自定义。
🏠 Essentials
家 — /home, /sethome, /delhome
一个带有简洁游戏内菜单的家系统。
- 每位玩家最多 5 个家,受权限控制。
/home 或 /home list 打开菜单:左键点击传送,右键点击删除。
- 支持家的名称 Tab 补全,名称仅允许使用字母、数字、
- 和 _。
- 可配置传送延迟(移动或受到伤害时取消),可选冷却时间及绕过权限。
- 家在玩家加入前加载,并仅在内容发生变化时异步保存。
- 传送目标区块的加载不会阻塞服务器。
- 旧版 Home 插件的家会在首次启动时自动导入(原始文件将作为备份保留)。
所有设置和消息均通过 Home.yml 管理。
出生点 — /spawn, /setspawn
- 使用
/setspawn 设置服务器出生点。
- 可配置延迟和冷却时间,并提供绕过权限。
- 可选择在玩家首次加入、每次加入或从不时将玩家传送至出生点。
- 可选择让玩家死亡后在出生点重生(有效的床或重生锚具有优先级)。
- 旧版 NewSpawn 插件的出生点会自动导入。
所有设置和消息均通过 Spawn.yml 管理。
💬 Chat & Communication
聊天格式化
- 基于权限的颜色访问。
- 使用
& 的标准 Minecraft 颜色代码。
- 使用
&#RRGGBB 的十六进制颜色。
- 通过 LuckPerms 实现等级前缀和后缀。
- 支持 ItemsAdder 字形以自定义等级图标。
- 聊天格式和欢迎消息中支持 PlaceholderAPI。
私聊
/msg — 发送私聊消息。
/reply — 回复上一次私聊对话。
欢迎及加入/离开消息
- 可配置的首次加入欢迎消息。
- 自定义加入和离开消息:保留原版、使用自定义文本(含前缀和后缀占位符)或隐藏它们。
- 专为全新玩家设计的消息。
🧭 Teleportation Request System
一个可配置的 TPA 系统,带有交互式聊天控件。
命令:
/tpa — 请求传送到另一位玩家处。
/tpahere — 请求另一位玩家传送到你这里。
/tpaccept — 接受传送请求。
/tpdeny — 拒绝传送请求。
/tpacancel — 取消待处理的请求。
功能:
- 聊天中直接显示可点击的“接受”和“拒绝”按钮。
- 可配置传送预热时间。
- 移动会取消传送倒计时。
- 受到伤害会取消传送倒计时。
- 传送后的无敌保护。
- ActionBar 倒计时及保护消息。
- 可配置的冷却时间管理。
冷却数据使用异步文件操作以减少不必要的同步磁盘活动。
所有设置均通过 Tpa.yml 管理。
🎒 Starter Kit
命令: /starterkit
为新玩家提供开始冒险所需的一切。
默认套件包含:
功能:
- 在玩家首次加入时自动发放。
- 通过
/starterkit 手动领取。
- 可配置的领取冷却时间。
- 专用的冷却时间绕过权限。
- 可通过
StartKit.yml 自定义套件配置。
💥 Custom Items & Admin Arsenal
FireBallWand 还包含一系列专为管理、测试和趣味事件设计的强大自定义物品。
| 物品 |
描述 |
| 🔥 FireWand |
发射爆炸火球。 |
| 👢 KickArmor |
自动击退靠得太近的玩家。 |
| ❄️ FreezeWand |
将目标玩家冻结在原地。 |
| ⚡ WinCharge Boosted |
一种威力强大的爆炸物,增强 x3 倍功率。 |
| ☠️ Potion of Death |
一种致命的溅射药水,可忽略创造模式并处理保留物品的设置。 |
| ❄️ Cursed Snowball |
对被击中的玩家施加负面效果(默认为缓慢、失明、恶心)。 |
| ⬆️ Sword Up |
被击中的玩家获得漂浮效果。 |
| 🧊 Ice Boots |
穿戴者可在任何完整方块上滑行,如同在冰面上一样。 |
| ⚔️ Cheat Sword |
一把超强力量的自定义剑。 |
| 🔨 Cheat Mace |
一把增强的自定义锤。 |
| 💎 Diamond Cheat Armor |
一套具有极端属性和附魔的钻石盔甲。 |
| 🛡️ Netherite Cheat Armor |
一套具有极端属性和附魔的下界合金盔甲。 |
- 每个趣味物品都有各自的专属发放权限。
- OP 玩家以及拥有相应绕过权限的玩家对诅咒雪球和 Sword Up 免疫(可配置)。
- Ice Boots 仅向穿戴者发送假冰块视觉效果:世界不会被修改,其他玩家也看不到任何异常。
- 某些装备包含 255+ 级附魔和自定义属性。
所有自定义物品设置均通过 CustomCheat.yml 管理。
⚙️ Configuration System
FireBallWand 采用模块化 YAML 配置架构。
每个功能都有其专用的配置文件,使自定义和维护更加轻松。
| 配置文件 |
用途 |
config.yml |
常规设置、聊天、私聊及加入/离开消息 |
Staff.yml |
员工模式、防护、管理物品、上帝模式和飞行 |
Vanish.yml |
隐身层级、可见性及消息 |
Home.yml |
家:限制、延迟、冷却时间和消息 |
Spawn.yml |
出生点:加入和重生行为、延迟、冷却时间和消息 |
CustomCheat.yml |
自定义武器、盔甲和特殊物品 |
StartKit.yml |
新手套件内容及冷却时间 |
Tpa.yml |
传送请求及保护设置 |
Home.yml 和 Spawn.yml 中的消息同时支持 MiniMessage 和 & 颜色代码。
重载所有配置文件:
/fw reload
权限:fireballwand.admin
🔌 Optional Integrations
FireBallWand 无需额外插件即可运行。
以下集成可以解锁更多功能:
所有集成功能均为可选。
📥 安装
要求
- Minecraft Java Edition 1.21 或更高版本,具体取决于该版本的兼容性。
- Paper 或 Purpur 服务器端。
- 你的 Minecraft 服务器所需的 Java 版本。
安装步骤
- 下载最新的 FireBallWand 发布版。
- 停止你的 Minecraft 服务器。
- 将
FireBallWand.jar 放入 plugins/ 目录中。
- 启动服务器。
- 插件会自动生成其配置文件。
- 根据你的需求自定义 YAML 文件。
可选: 安装 LuckPerms、ItemsAdder、PlaceholderAPI 和/或 TAB 以启用相应的集成功能。
使用 TAB? 为需要能够在标签页列表中看到隐身玩家的管理人员分配 tab.seevanished 权限。
从旧的 Home 或 NewSpawn 插件迁移? 你的家园和出生点会在首次启动时自动导入。之后请移除旧插件以避免命令重复。
📋 命令与权限
管理与Moderation(管理员)
| 命令 |
描述 |
权限 |
/staff |
切换员工模式 |
fireballwand.staff |
/godmod / /gm |
开启上帝模式 |
fireballwand.god |
/ungodmod / /ugm |
关闭上帝模式 |
fireballwand.god |
/fly [player] |
切换飞行 |
fireballwand.fly (对其他玩家使用 .fly.others) |
/fly speed <1-10> [player] |
设置飞行速度 |
fireballwand.fly.speed |
/vanish / /fv |
切换自己的隐身状态 |
fireballwand.vanish.level.1 |
/vanish <player> |
切换其他玩家的隐身状态 |
fireballwand.vanish.others |
/vanish list |
显示隐身玩家列表 |
fireballwand.vanish.list |
家园与出生点
| 命令 |
描述 |
权限 |
/home [name|list] |
传送至家园或打开菜单 |
fireballwand.home.use |
/sethome [name] |
在你当前位置设置一个家园 |
fireballwand.home.set |
/delhome [name] |
删除你的一个家园 |
fireballwand.home.delete |
/spawn |
传送至出生点 |
fireballwand.spawn.use |
/setspawn |
在你当前位置设置出生点 |
fireballwand.spawn.set |
默认情况下所有人都可以使用这些命令。家园数量由 fireballwand.home.max.1 到 fireballwand.home.max.5 控制。
实用工具与通信
| 命令 |
描述 |
权限 |
/starterkit |
领取新手包 |
fireballwand.starterkit |
/tpa <player> |
请求传送 |
fireballwand.tpa |
/tpahere <player> |
邀请玩家传送到你身边 |
fireballwand.tpahere |
/tpaccept |
接受请求 |
fireballwand.tpa |
/tpdeny |
拒绝请求 |
fireballwand.tpa |
/tpacancel |
取消请求 |
fireballwand.tpa |
/msg <player> |
发送私聊消息 |
fireballwand.msg |
/reply |
回复私聊消息 |
fireballwand.reply |
自定义物品
| 命令 |
描述 |
权限 |
/firewand |
获取 FireWand |
fireballwand.firewand |
/kickarmor |
获取 KickArmor |
fireballwand.kickarmor |
/freezewand |
获取 FreezeWand |
fireballwand.freezewand |
/wincharge_boosted |
获取强化版 WinCharge |
fireballwand.wincharge_boosted |
/potionofdeath / /pod |
获取死亡药水 |
fireballwand.potion-of-death |
/negativesnowball / /nsnow |
获取诅咒雪球 |
fireballwand.negativesnowball |
/swordup |
获取 Sword Up |
fireballwand.swordup |
/iceboots |
获取冰靴 |
fireballwand.iceboots |
/cheatsword |
获取作弊剑 |
fireballwand.cheatsword |
/cheatmace |
获取作弊重锤 |
fireballwand.cheatmace |
/diamond_armorcheat |
获取钻石作弊护甲 |
fireballwand.diamond_armorcheat |
/netherite_armorcheat |
获取下界合金作弊护甲 |
fireballwand.netherite_armorcheat |
插件管理
| 命令 |
描述 |
权限 |
/fw reload |
重新加载所有配置文件 |
fireballwand.admin |
/tpareload |
重新加载传送请求设置 |
fireballwand.tpa.admin |
其他权限
| 权限 |
描述 |
fireballwand.staff.teleport |
在员工模式下提供传送指南针 |
fireballwand.staff.invsee |
在员工模式下查看玩家背包 |
fireballwand.staff.invsee.edit |
通过查看器编辑玩家背包 |
fireballwand.vanish.level.1 至 .4 |
隐身等级(较高等级可以看到较低等级) |
fireballwand.home.bypass.warmup / .cooldown |
跳过家园延迟 / 冷却时间 |
fireballwand.spawn.bypass.warmup / .cooldown |
跳过出生点延迟 / 冷却时间 |
fireballwand.negativesnowball.bypass |
免疫诅咒雪球 |
fireballwand.swordup.bypass |
免疫 Sword Up |
fireballwand.chat.color / .chat.color.hex |
在聊天中使用 & 颜色代码 / 十六进制颜色 |
🧩 兼容性
FireBallWand 专为 Paper 和 Purpur 服务器开发。
兼容性可能取决于 Minecraft 版本以及各个 API 的变化。在生产服务器更新之前,请检查每个版本的发行说明。
🐛 错误报告与建议
发现了错误或有新功能的想法?
请通过项目的问题跟踪器进行报告。
报告问题时,请包含:
- Minecraft 版本。
- 服务器软件及版本。
- FireBallWand 版本。
- 相关的控制台日志。
- 重现问题的步骤。
清晰的报告有助于更轻松地排查问题。
📄 许可证
保留所有权利 © Zyumie
版权所有。未经作者事先许可,禁止复制、修改、重新分发或使用本软件。
由 Zyumie 用 ❤️ 开发
🔥 FireBallWand — 管理、审核与自定义游戏内容。

🔥 FireBallWand
Advanced Administration, Moderation & Custom Items
One plugin. Multiple possibilities. Complete control.
📖 About
FireBallWand is a modular Minecraft plugin designed to bring administration tools, moderation features, essential player commands and custom items together in one versatile solution.
Whether you're managing a Survival server, a private SMP or an event-based community, FireBallWand provides the tools needed to manage your players, moderate discreetly and customize your gameplay experience.
From an advanced Vanish system and Staff Mode to homes, a spawn, teleportation requests, private messaging and powerful custom items, every feature is designed to be configurable and easy to use.
✨ Main Highlights
- 🛡️ Complete Staff Mode with a safely stored inventory and a full moderation toolkit.
- 👻 Advanced hierarchical Vanish system that leaves no trace in commands or tab-complete.
- ⭐ God Mode and flight commands with configurable behavior.
- 🏠 Home system with a menu, plus a configurable spawn.
- 💥 Custom weapons, armor and fun items.
- 💬 Chat formatting, private messaging and custom join/leave messages.
- 🧭 Interactive teleportation request system.
- 🎒 Automatic and configurable Starter Kit.
- 📂 Separate YAML configuration files for each module.
- 🔌 Optional integrations with popular plugins.
🛡️ Staff Features
Staff Mode — /staff
A dedicated moderation toolkit that allows staff members to moderate players without switching to Creative Mode.
How it works:
- Toggle Staff Mode with
/staff.
- Your real inventory is saved, then replaced by your moderation items.
- Execute
/staff again to leave Staff Mode and get everything back.
- Each item is only provided when the corresponding permission is available.
Available tools:
| Item |
Function |
| 👻 Vanish Item |
Toggle your Vanish status |
| ❄️ FreezeWand |
Freeze or unfreeze targeted players |
| ⭐ God Mode Item |
Toggle God Mode |
| 🧭 Teleport Compass |
Teleport to the next online player |
| 🪶 Fly Feather |
Toggle flight |
Inventory safety:
- Your inventory (items, armor, offhand and optionally XP) is written to disk before being cleared. If that fails, Staff Mode simply doesn't start.
- It is restored when you leave Staff Mode, disconnect, die (at respawn) or when the server stops.
- After a server crash, it is restored automatically when you reconnect.
- Staff items can't be dropped, stored in chests or moved to the offhand, and never drop on death.
Protections while in Staff Mode (each one can be toggled):
- No breaking or placing blocks.
- No picking up or dropping items.
- No hitting players (the FreezeWand still works).
Inspection tools:
- 🔍 Inventory viewer: right-click a player to see their inventory live. Read-only by default, editing needs a separate permission.
- 🤫 Silent containers: while vanished, open chests, barrels, hoppers, furnaces, shulker boxes and more without any sound or animation (read-only). You briefly enter Spectator Mode and get your previous game mode back when you close the container.
Item names, materials, slots and messages are configurable, and the entire module can be disabled through Staff.yml.
⭐ God Mode
Commands: /godmod, /ungodmod
An invulnerability system for administrators and staff members.
- Cancels incoming damage and hunger depletion while active.
- The void and
/kill can still affect players.
- Can also be activated through the Staff Mode item.
- Includes short aliases:
/gm and /ugm.
🪶 Fly
Commands: /fly [player], /fly speed <1-10> [player]
- Toggle flight for yourself or another player.
- Adjustable flight speed, with a configurable maximum.
- Turning flight off in mid-air ignores the fall damage that follows.
👻 Advanced Hierarchical Vanish
An advanced Vanish system designed for discreet staff moderation.
Rank hierarchy:
- Higher staff ranks can see lower-ranked vanished players.
- Lower staff ranks cannot see higher-ranked vanished players.
- Visibility is managed through permission-based levels.
Discretion:
- Toggling Vanish sends the same message a real disconnect or connect would (vanilla, custom or hidden, following your join/leave message settings), only to players who can't see that staff member.
- Join and quit messages are hidden while vanished.
- Vanished players' names are removed from the auto-complete of every command, including other plugins' commands.
/tpa, /tpahere, /msg, /starterkit and /fly answer "player not found" for a vanished player the sender isn't allowed to see.
- Vanished players are excluded from the server-list player count and hover player list.
- TAB integration hides vanished players from unauthorized viewers.
- Persistent ActionBar reminder.
Persistence and extras:
- Vanish status is preserved after reconnecting.
- Vanished players cannot pick up items, and KickArmor never kicks them.
- Double-sneak to switch to Spectator Mode and return to the previous game mode.
/vanish list displays the vanished players you are allowed to see.
- Chat protection prevents messages from being sent unless they end with
/.
All Vanish settings, permission levels and messages can be customized in Vanish.yml.
🏠 Essentials
Homes — /home, /sethome, /delhome
A home system with a clean in-game menu.
- Up to 5 homes per player, controlled by permissions.
/home or /home list opens a menu: left-click to teleport, right-click to delete.
- Tab-complete for home names, with safe names (letters, numbers,
- and _).
- Configurable teleport delay (cancelled on movement or damage), optional cooldown and bypass permissions.
- Homes are loaded before the player joins and saved asynchronously, only when something changed.
- Teleports load the destination chunk without blocking the server.
- Homes from the old Home plugin are imported automatically on first start (the original file is kept as a backup).
All settings and messages are managed through Home.yml.
Spawn — /spawn, /setspawn
- Set the server spawn with
/setspawn.
- Configurable delay and cooldown, with bypass permissions.
- Teleport players to spawn on their first join, on every join, or never.
- Optionally respawn players at spawn after death (a valid bed or respawn anchor keeps priority).
- The spawn of the old NewSpawn plugin is imported automatically.
All settings and messages are managed through Spawn.yml.
💬 Chat & Communication
Chat formatting
- Permission-based color access.
- Standard Minecraft color codes using
&.
- Hexadecimal colors using
&#RRGGBB.
- Rank prefixes and suffixes through LuckPerms.
- ItemsAdder glyph support for custom rank icons.
- PlaceholderAPI support in chat formats and welcome messages.
Private messaging
/msg — Send a private message.
/reply — Reply to the last private conversation.
Welcome & join/leave messages
- Configurable first-join welcome message.
- Customizable join and leave messages: keep the vanilla ones, use your own text (with prefix and suffix placeholders) or hide them.
- A dedicated message for brand-new players.
🧭 Teleportation Request System
A configurable TPA system with interactive chat controls.
Commands:
/tpa — Request to teleport to another player.
/tpahere — Request another player to teleport to you.
/tpaccept — Accept a teleport request.
/tpdeny — Deny a teleport request.
/tpacancel — Cancel your pending request.
Features:
- Clickable Accept and Deny buttons directly in chat.
- Configurable teleportation warmup.
- Movement cancels the teleportation countdown.
- Damage cancels the teleportation countdown.
- Post-teleport invincibility protection.
- ActionBar countdown and protection messages.
- Configurable cooldown management.
Cooldown data uses asynchronous file operations to reduce unnecessary synchronous disk activity.
All settings are managed through Tpa.yml.
🎒 Starter Kit
Command: /starterkit
Give new players everything they need to start their adventure.
Default kit includes:
- Enchanted iron armor.
- Diamond tools.
- Food and survival consumables.
Features:
- Automatically granted on a player's first join.
- Manual claiming through
/starterkit.
- Configurable claim cooldowns.
- Dedicated cooldown bypass permissions.
- Customizable kit configuration through
StartKit.yml.
💥 Custom Items & Admin Arsenal
FireBallWand also includes a collection of powerful custom items designed for administration, testing and fun events.
| Item |
Description |
| 🔥 FireWand |
Launches explosive fireballs. |
| 👢 KickArmor |
Automatically knocks back nearby players who get too close. |
| ❄️ FreezeWand |
Freezes targeted players in place. |
| ⚡ WinCharge Boosted |
A powerful explosive charge with x3 boosted power. |
| ☠️ Potion of Death |
A deadly splash potion that bypasses Creative Mode and handles Keep Inventory. |
| ❄️ Cursed Snowball |
Applies negative effects (slowness, blindness, nausea by default) to the player it hits. |
| ⬆️ Sword Up |
The player you hit gets Levitation. |
| 🧊 Ice Boots |
The wearer slides on any full block as if it were ice. |
| ⚔️ Cheat Sword |
An overpowered custom sword. |
| 🔨 Cheat Mace |
An enhanced custom mace. |
| 💎 Diamond Cheat Armor |
A complete diamond armor set with extreme attributes and enchantments. |
| 🛡️ Netherite Cheat Armor |
A complete netherite armor set with extreme attributes and enchantments. |
- Each fun item has its own dedicated give permission.
- OPs and players with the matching bypass permission are immune to the Cursed Snowball and the Sword Up (configurable).
- Ice Boots only send fake ice to the wearer: the world is never modified and nobody else sees anything.
- Certain equipment includes level 255+ enchantments and custom attributes.
All custom item settings are managed through CustomCheat.yml.
⚙️ Configuration System
FireBallWand uses a modular YAML configuration architecture.
Each feature has its own dedicated configuration file, making customization and maintenance easier.
| Configuration file |
Purpose |
config.yml |
General settings, chat, private messages and join/leave messages |
Staff.yml |
Staff Mode, protections, moderation items, God Mode and Fly |
Vanish.yml |
Vanish hierarchy, visibility and messages |
Home.yml |
Homes: limits, delay, cooldown and messages |
Spawn.yml |
Spawn: join and respawn behavior, delay, cooldown and messages |
CustomCheat.yml |
Custom weapons, armor and special items |
StartKit.yml |
Starter Kit contents and cooldowns |
Tpa.yml |
Teleportation requests and protection settings |
Messages in Home.yml and Spawn.yml accept both MiniMessage and & color codes.
Reload every configuration file:
/fw reload
Permission: fireballwand.admin
🔌 Optional Integrations
FireBallWand works without additional plugins.
The following integrations can unlock additional functionality:
All integrations are optional.
📥 Installation
Requirements
- Minecraft Java Edition 1.21 or newer, subject to the release's compatibility.
- Paper or Purpur server.
- Java version required by your Minecraft server.
Installation steps
- Download the latest FireBallWand release.
- Stop your Minecraft server.
- Place
FireBallWand.jar inside the plugins/ directory.
- Start your server.
- The plugin will generate its configuration files automatically.
- Customize the YAML files according to your needs.
Optional: Install LuckPerms, ItemsAdder, PlaceholderAPI and/or TAB to enable their respective integrations.
Using TAB? Assign the tab.seevanished permission to staff members who should be able to see vanished players in the tab list.
Coming from the old Home or NewSpawn plugins? Your homes and spawn are imported on the first start. Remove the old plugins afterwards to avoid duplicate commands.
📋 Commands & Permissions
Administration & Moderation
| Command |
Description |
Permission |
/staff |
Toggle Staff Mode |
fireballwand.staff |
/godmod / /gm |
Enable God Mode |
fireballwand.god |
/ungodmod / /ugm |
Disable God Mode |
fireballwand.god |
/fly [player] |
Toggle flight |
fireballwand.fly (.fly.others for other players) |
/fly speed <1-10> [player] |
Set the flight speed |
fireballwand.fly.speed |
/vanish / /fv |
Toggle your Vanish status |
fireballwand.vanish.level.1 |
/vanish <player> |
Toggle another player's Vanish |
fireballwand.vanish.others |
/vanish list |
Display vanished players |
fireballwand.vanish.list |
Homes & Spawn
| Command |
Description |
Permission |
/home [name|list] |
Teleport to a home or open the menu |
fireballwand.home.use |
/sethome [name] |
Set a home at your position |
fireballwand.home.set |
/delhome [name] |
Delete one of your homes |
fireballwand.home.delete |
/spawn |
Teleport to the spawn |
fireballwand.spawn.use |
/setspawn |
Set the spawn at your position |
fireballwand.spawn.set |
Everyone can use these commands by default. The number of homes is controlled by fireballwand.home.max.1 to fireballwand.home.max.5.
Utility & Communication
| Command |
Description |
Permission |
/starterkit |
Claim the Starter Kit |
fireballwand.starterkit |
/tpa <player> |
Request teleportation |
fireballwand.tpa |
/tpahere <player> |
Invite a player to teleport to you |
fireballwand.tpahere |
/tpaccept |
Accept a request |
fireballwand.tpa |
/tpdeny |
Deny a request |
fireballwand.tpa |
/tpacancel |
Cancel a request |
fireballwand.tpa |
/msg <player> |
Send a private message |
fireballwand.msg |
/reply |
Reply to a private message |
fireballwand.reply |
Custom Items
| Command |
Description |
Permission |
/firewand |
Get the FireWand |
fireballwand.firewand |
/kickarmor |
Get the KickArmor |
fireballwand.kickarmor |
/freezewand |
Get the FreezeWand |
fireballwand.freezewand |
/wincharge_boosted |
Get the boosted WinCharge |
fireballwand.wincharge_boosted |
/potionofdeath / /pod |
Get the Potion of Death |
fireballwand.potion-of-death |
/negativesnowball / /nsnow |
Get the Cursed Snowballs |
fireballwand.negativesnowball |
/swordup |
Get the Sword Up |
fireballwand.swordup |
/iceboots |
Get the Ice Boots |
fireballwand.iceboots |
/cheatsword |
Get the Cheat Sword |
fireballwand.cheatsword |
/cheatmace |
Get the Cheat Mace |
fireballwand.cheatmace |
/diamond_armorcheat |
Get the Diamond Cheat Armor |
fireballwand.diamond_armorcheat |
/netherite_armorcheat |
Get the Netherite Cheat Armor |
fireballwand.netherite_armorcheat |
Plugin Management
| Command |
Description |
Permission |
/fw reload |
Reload every configuration file |
fireballwand.admin |
/tpareload |
Reload the teleportation request settings |
fireballwand.tpa.admin |
Additional permissions
| Permission |
Description |
fireballwand.staff.teleport |
Gives the teleport compass in Staff Mode |
fireballwand.staff.invsee |
View a player's inventory in Staff Mode |
fireballwand.staff.invsee.edit |
Edit a player's inventory through the viewer |
fireballwand.vanish.level.1 to .4 |
Vanish levels (a higher level sees the lower ones) |
fireballwand.home.bypass.warmup / .cooldown |
Skip the home delay / cooldown |
fireballwand.spawn.bypass.warmup / .cooldown |
Skip the spawn delay / cooldown |
fireballwand.negativesnowball.bypass |
Immunity to the Cursed Snowball |
fireballwand.swordup.bypass |
Immunity to the Sword Up |
fireballwand.chat.color / .chat.color.hex |
Use & colors / hex colors in chat |
🧩 Compatibility
FireBallWand is developed for Paper and Purpur servers.
Compatibility can depend on the Minecraft version and individual API changes. Check the release notes of each version before updating your production server.
🐛 Bug Reports & Suggestions
Found a bug or have an idea for a new feature?
Please report it through the project's issue tracker.
When reporting an issue, include:
- Minecraft version.
- Server software and version.
- FireBallWand version.
- Relevant console logs.
- Steps to reproduce the issue.
Clear reports make troubleshooting easier.
📄 License
All Rights Reserved © Zyumie
All rights reserved. Unauthorized copying, modification, redistribution or use of this software is prohibited without prior permission from the author.
Developed with ❤️ by Zyumie
🔥 FireBallWand — Administration, Moderation & Custom Gameplay.
评论 0
登录后参与评分
还没有评论,来抢沙发吧