SimpleNoBeamBeacon
SimpleNoBeamBeacon 是一个轻量级的服务端插件,主要面向 Paper 26.3。它允许使用真实的着色玻璃(tinted glass)遮挡信标光束,同时不禁用信标的效果。
玩家无需安装任何模组或资源包。
文档
安装、配置、命令、信标行为、兼容性、故障排除和构建说明请参阅 SimpleNoBeamBeacon Documentation。
功能
- 使用真实的着色玻璃来隐藏信标光束
- 在隐藏光束的同时保持信标效果激活
- 支持所有四种信标金字塔层级
- 保留原版的效果范围、持续时间和放大器倍数
- 支持主效果等级 II、再生以及其他有效的副效果
- 在 Paper 上尊重自定义的信标效果范围
- 支持在同一信标列中使用多个着色玻璃方块
- 继续检查着色玻璃上方的真实光束阻挡物
- 正确允许屏障、基岩、染色玻璃、玻璃板及其他兼容光束的方块
- 处理方块放置与移除、活塞、爆炸、区块及世界生命周期事件
- 包含配置文件和仅限管理员使用的管理命令
- 不需要客户端模组、资源包或其他插件
使用方法
- 正常建造并激活信标。
- 选择其主要效果和可选的副效果。
- 在覆盖之前先让信标激活,特别是在其他兼容服务器版本上。
- 在信标垂直光束列中的着色玻璃上方任意位置放置着色玻璃。
原生光束消失,而符合条件的玩家继续获得所选效果。原本会阻碍信标的方块即使放置在着色玻璃上方,仍会停止替代效果的传递。移除最后一个着色玻璃方块将恢复正常的原版信标行为。
配置
插件会自动创建 plugins/SimpleNoBeamBeacon/config.yml:
enabled: true
将 enabled 设置为 false 以停止隐藏信标的处理,同时保持插件及其管理命令加载状态。直接对文件所做的更改在重启服务器或使用重载命令后生效。
在禁用功能之前已经施加的效果会自然过期。这避免了移除由药水或其他信标提供的匹配效果。
命令
| 命令 |
描述 |
/simplenobeambeacon reload |
验证并重载配置及信标服务 |
/simplenobeambeacon set enabled |
启用功能,保存配置并自动重载 |
/simplenobeambeacon set disabled |
禁用功能,保存配置并自动重载 |
/simplenobeambeacon enable |
启用功能的快捷方式 |
/simplenobeambeacon disable |
禁用功能的快捷方式 |
/snbb 是所有命令的短别名。运行不带有效参数的命令将显示当前状态和使用信息。
命令和 Tab 补全仅限于服务器操作员和服务器控制台。simplenobeambeacon.admin 权限默认授予操作员。无效 YAML 或非布尔值的 enabled 值在重载时会被拒绝,且不会改变当前运行状态。
兼容性
| 制品 |
平台 |
Minecraft 版本 |
状态 |
SimpleNoBeamBeacon-Paper-1.2.0.jar |
Paper |
26.3 |
主要目标 |
| 相同的 JAR |
Paper, Spigot, Purpur, CraftBukkit 及兼容的 Bukkit 分支 |
1.17.1 及以上 |
额外兼容性 |
Paper 制品名称并不代表硬性的 Paper 依赖。该 JAR 使用 Java 16 字节码,声明了 Bukkit API 版本 1.17,并避免直接链接到特定版本的 Paper 类。每个服务器仍需使用该服务器所需的适当 Java 版本;Paper 26.3 需要 Java 25。
在识别出的服务器布局上,插件动态读取内部信标数据。否则,它将回退到公共 Bukkit API,并对重要方块(如屏障、基岩、 slime blocks 和着色玻璃)进行显式修正。当服务器的内部布局未被识别时,非常规技术方块状态的行为可能与原版不同。
不支持 Folia,因为信标列和金字塔扫描不能保证始终保持在单个 Folia 区域内。
历史性的 SpongeVanilla 26.2 构建仍可在 1.0.0 版本中找到,但已不再维护。1.1.0 及更高版本仅提供 Paper/Bukkit 兼容的服务端插件。
安装
- 停止服务器,并从其
plugins/ 目录中删除任何先前的 SimpleNoBeamBeacon JAR 文件。
- 下载
SimpleNoBeamBeacon-Paper-1.2.0.jar,而不是 -sources.jar 文件。
- 将 JAR 放入
plugins/ 并重启服务器。
- 在用着色玻璃覆盖之前,配置并激活信标。
无需其他依赖项。
技术细节
原版 Minecraft 在有着色玻璃存在时会隐藏原生信标光束,但服务器也将玻璃视为障碍物并禁用信标的效果。
SimpleNoBeamBeacon 跟踪被覆盖的信标,并使用计算出的金字塔层级、选定力量、范围、持续时间和放大器重新应用效果。它动态尝试读取服务器的光线衰减、信标选择和自定义范围数据。其产生效果的扫描将着色玻璃视为透明,但仍尊重列中任何地方的真实原版光束阻挡物。
视觉限制
仅在服务端运行的插件无法在未修改的客户端上实现下方可见原生信标光束而在玻璃上方隐藏的效果。当客户端遇到着色玻璃时,它会清除整个原生光束。精确的部分光束需要客户端模组;此插件不添加粒子或显示实体模拟。
已知限制
- 重新施加的效果会被报告为源自插件,而非直接来自信标。
- 重新施加的效果不会触发 Paper 的
BeaconEffectEvent。
- 在内部信标选择布局未被识别的服务器上,重启后可能需要暂时移除并重新激活信标,以恢复生命再生或主效果 II 级。
- 对于不受支持服务器版本上罕见的技术方块状态,兼容性回退机制可能与原版存在差异。
- 当前 1.2.0 版本不支持 Folia 和 Sponge。
许可证
SimpleNoBeamBeacon 采用 MIT 许可证授权。
SimpleNoBeamBeacon
SimpleNoBeamBeacon is a lightweight server-side plugin built primarily for Paper 26.3. It allows real tinted glass to hide a beacon beam without disabling the beacon's effects.
Players do not need to install any mods or resource packs.
Documentation
Installation, configuration, commands, beacon behavior, compatibility, troubleshooting, and build instructions are available in the SimpleNoBeamBeacon Documentation.
Features
- Uses real tinted glass to hide beacon beams
- Keeps beacon effects active while the beam is hidden
- Supports all four beacon pyramid levels
- Preserves vanilla effect ranges, durations, and amplifiers
- Supports primary effect level II, regeneration, and other valid secondary effects
- Respects custom beacon effect ranges on Paper
- Supports multiple tinted-glass blocks in the same beacon column
- Continues checking for real beam blockers above tinted glass
- Correctly allows barrier, bedrock, stained glass, panes, and other beam-compatible blocks
- Handles block placement and removal, pistons, explosions, chunks, and world lifecycle events
- Includes configuration and operator-only administrative commands
- Requires no client mods, resource packs, or other plugins
How to use
- Build and activate a beacon normally.
- Select its primary and optional secondary effects.
- Allow the beacon to activate before covering it, especially on an additional compatibility server version.
- Place tinted glass anywhere above the beacon in its vertical beam column.
The native beam disappears while eligible players continue receiving the selected effects. A block that would normally obstruct a beacon still stops the replacement effects, even when placed above the tinted glass. Removing the final tinted-glass block restores normal vanilla beacon behavior.
Configuration
The plugin creates plugins/SimpleNoBeamBeacon/config.yml automatically:
enabled: true
Set enabled to false to stop hidden-beacon handling while keeping the plugin and its administrative commands loaded. Changes made directly to the file take effect after restarting the server or using the reload command.
Effects already applied before disabling the feature expire naturally. This avoids removing matching effects supplied by potions or other beacons.
Commands
| Command |
Description |
/simplenobeambeacon reload |
Validates and reloads the configuration and beacon service |
/simplenobeambeacon set enabled |
Enables the feature, saves the configuration, and reloads automatically |
/simplenobeambeacon set disabled |
Disables the feature, saves the configuration, and reloads automatically |
/simplenobeambeacon enable |
Shortcut for enabling the feature |
/simplenobeambeacon disable |
Shortcut for disabling the feature |
/snbb is a short alias for all commands. Running a command without valid arguments displays the current state and usage information.
Commands and tab completion are restricted to server operators and the server console. The simplenobeambeacon.admin permission defaults to operators. Invalid YAML or a non-boolean enabled value is rejected during reload without changing the current running state.
Compatibility
| Artifact |
Platforms |
Minecraft versions |
Status |
SimpleNoBeamBeacon-Paper-1.2.0.jar |
Paper |
26.3 |
Primary target |
| The same JAR |
Paper, Spigot, Purpur, CraftBukkit, and compatible Bukkit-based forks |
1.17.1 and newer |
Additional compatibility |
The Paper artifact name does not represent a hard Paper dependency. The JAR uses Java 16 bytecode, declares Bukkit API version 1.17, and avoids direct links to version-specific Paper classes. Each server still requires the Java version appropriate for that server; Paper 26.3 requires Java 25.
On recognized server layouts, the plugin reads internal beacon data dynamically. Otherwise, it falls back to the public Bukkit API with explicit corrections for important blocks such as barrier, bedrock, slime blocks, and tinted glass. Behavior on unusual technical block states may differ from vanilla when the server's internal layout is not recognized.
Folia is not supported because beacon-column and pyramid scans cannot always be guaranteed to stay within one Folia region.
The historical SpongeVanilla 26.2 build remains available in version 1.0.0 but is no longer maintained. Version 1.1.0 and newer only provide the Paper/Bukkit-compatible server plugin.
Installation
- Stop the server and remove any previous SimpleNoBeamBeacon JAR from its
plugins/ directory.
- Download
SimpleNoBeamBeacon-Paper-1.2.0.jar, not the -sources.jar file.
- Place the JAR in
plugins/ and restart the server.
- Configure and activate a beacon before covering it with tinted glass.
No additional dependencies are required.
Technical details
Vanilla Minecraft hides the native beacon beam when tinted glass is present, but the server also treats the glass as an obstruction and disables the beacon's effects.
SimpleNoBeamBeacon tracks covered beacons and reapplies effects using the calculated pyramid level, selected powers, range, duration, and amplifier. It dynamically attempts to read the server's light-dampening, beacon-selection, and custom-range data. Its effect-producing scan treats tinted glass as transparent while still respecting real vanilla beam blockers anywhere in the column.
Visual limitation
A server-only plugin cannot keep the native beacon beam visible below tinted glass while hiding it above the glass on an unmodified client. The client clears the entire native beam when it encounters tinted glass. An exact partial beam would require a client mod; this plugin does not add a particle or display-entity imitation.
Known limitations
- Reapplied effects are reported as originating from the plugin rather than directly from a beacon.
- Reapplied effects do not trigger Paper's
BeaconEffectEvent.
- On a server whose internal beacon-selection layout is not recognized, temporarily uncovering and reactivating a beacon may be necessary after a restart to recover regeneration or primary level II.
- Compatibility fallbacks may differ from vanilla for unusual technical block states on unrecognized server versions.
- Folia and Sponge are not supported by the current 1.2.0 release.
License
SimpleNoBeamBeacon is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧