DiscoFloor - 炫彩舞池插件

DiscoFloor 是一款能够创建动态变色舞池地板的插件。所有方块变化都只在客户端显示，不会实际改变服务器中的任何方块，因此安装 ProtocolLib 后几乎不会造成服务器卡顿。

💡功能特色

• 可创建任意数量的舞池地板
• 舞池大小完全自定义
• 可通过配置文件调整旋转颜色与变换速度
• 可随时开启或关闭舞池效果，无需删除舞池
• 正确配置后几乎不会造成卡顿（详见下方“性能说明”）
• 不会实际改变世界——创建舞池不会造成任何破坏（玩家可能需要重新加入游戏以恢复方块元数据）

🎮安装与设置

• 将本插件放入服务器的 plugins 文件夹
• （可选但推荐）将最新版 ProtocolLib 插件放入 plugins 文件夹，可消除服务器端卡顿
• 重启/重载服务器以激活插件
• 配置相关权限
• 输入 /discofloor wand 获取选区工具，像 WorldEdit 一样选择舞池区域
• 输入 /discofloor create <名称> 创建舞池
• （可选）创建更多舞池以组合形状
• （可选）在配置中添加信标、调低速度（取决于 MC 版本），并在舞池下方放置钻石块，或直接在舞池下放置信标与钻石块来打造灯光秀
• 查看下方的性能提示
• 派对时间到！

🔧命令与权限

• /discofloor create <名称> – 创建舞池 | 权限：discofloor.setup
• /discofloor delete <名称> – 删除舞池 | 权限：discofloor.setup
• /discofloor <on|off> <名称> – 切换舞池开关 | 权限：discofloor.toggle
• /discofloor list – 列出所有舞池 | 权限：discofloor.list
• /discofloor wand – 获取选区工具 | 权限：discofloor.setup

⭐配置文件

配置文件内容基本自解释，以下为默认的 config.yml：

# DiscoFloor v1.4.3 - 配置
#
# 舞池颜色重新计算的间隔时间（单位：刻；1 秒 = 20 刻）
# 数值过小可能导致卡顿
ColorSwitchTime: 5

# 启用后可消除服务器端卡顿，需要安装 ProtocolLib 插件
UseProtocolLibPackets: true

# 舞池中使用的方块列表
# 所有材料列表可在此查看：
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# 可添加信标并在舞池下方放置钻石块来创建光束效果
Blocks:
- 'WHITE_STAINED_GLASS'
- 'ORANGE_STAINED_GLASS'
- 'MAGENTA_STAINED_GLASS'
- 'LIGHT_BLUE_STAINED_GLASS'
- 'YELLOW_STAINED_GLASS'
- 'LIME_STAINED_GLASS'
- 'PINK_STAINED_GLASS'
- 'GRAY_STAINED_GLASS'
- 'LIGHT_GRAY_STAINED_GLASS'
- 'CYAN_STAINED_GLASS'
- 'PURPLE_STAINED_GLASS'
- 'BLUE_STAINED_GLASS'
- 'BROWN_STAINED_GLASS'
- 'GREEN_STAINED_GLASS'
- 'RED_STAINED_GLASS'
- 'BLACK_STAINED_GLASS'

> 注意：如需支持 1.16.4，请将 UseProtocolLibPackets 配置项设为 false。

✨性能优化提示

本插件会快速改变大量方块，可能引起卡顿，但已进行大量优化。以下建议可帮助提升性能：

服务器性能（TPS）

• 重要：安装 ProtocolLib！可将大量卡顿降至几乎无卡顿

客户端性能（FPS）

• 不要创建过多或变换过快的舞池
• 重要：避免舞池更新光照！例如：若舞池包含信标，请确保舞池位于光照充足区域，以免每若干刻更新一次光照
• 最好只让舞池替换已有方块，而非创建新方块，否则服务器可能因玩家站在实际不存在的方块上而将其以“飞行”为由踢出

❓支持与源码

• 如有问题、错误或疑问，请通过私信或在讨论区留言，请勿在评论区域请求帮助或报告错误
• DiscoFloor 为开源插件，源码位于 GitHub
• 插件基于开源许可证发布