Gizmo - 自定义欢迎界面

Gizmo 是一个由资源包驱动的 Minecraft 服务器屏幕系统。它可以创建欢迎页、规则页、指引页和信息页，支持自定义布局、可点击物品、导航、条件、消息、命令、音效和淡入淡出，而且不会清空或修改玩家真实背包。

💡概览

• Gizmo 需要 ProtocolLib，以及一个包含 Gizmo 资源的服务器资源包。
• PlaceholderAPI、Nexo、ItemsAdder 和 Oraxen 为可选集成。
• 玩家加载所需资源包后，会显示完全可自定义的屏幕。
• 支持可选的全屏淡入淡出，并可为每个屏幕单独设置背景色。
• 每个屏幕都可配置关闭消息，支持多行文本和十六进制颜色。
• 每个屏幕都能单独设置背景颜色，无需重新构建资源包即可调整。
• 每个屏幕最多可放置 54 个屏幕物品，支持自定义模型数据、Lore、动作、导航和条件。

⭐安装

• 安装 ProtocolLib。
• 将 Gizmo.jar 放入服务器的 plugins 文件夹。
• 应用或合并随附的 Gizmo 资源包。
• 启动服务器一次，以生成 Gizmo 的配置文件。
• 配置 screens.yml，然后重启服务器，或运行 /gizmo reload。

重要

• Gizmo 的资源必须包含在玩家实际收到的那个资源包里。即使检测到了 Nexo、ItemsAdder 或 Oraxen，也不会自动把 Gizmo 资源合并进它们的包。
• 对于 Nexo / ItemsAdder / Oraxen：请将 Gizmo 资源合并到提供方生成的资源包中，重新生成，并确保该资源包会发送给加入服务器的玩家。

🎮功能

• 命名且可复用的屏幕：按需定义任意数量的屏幕，并分配给事件。
• 加入与首次加入事件：首次进入的玩家可以收到专属屏幕、布局、颜色、动作和物品。
• 屏幕导航：使用物品打开另一个已配置屏幕，不会触发上一个屏幕的关闭动作。
• 条件：可按权限和世界限制事件、屏幕或物品。
• 54 个安全屏幕槽位：Gizmo 不会清空、保存、恢复或写入玩家的实际背包。
• ProtocolLib 背包遮罩：屏幕打开时，玩家背包槽位会在客户端被隐藏。
• 自定义物品：支持材质、槽位、显示名、Lore、自定义模型数据和隐藏物品标志。
• 物品动作：可运行玩家命令、控制台命令，或发送物品点击消息。
• 每屏关闭动作：屏幕关闭时可运行命令、发送消息、播放音效并显示淡出。
• 十六进制与传统颜色支持：支持 & 和 &#RRGGBB 颜色格式。
• 资源包保护：资源包提示激活期间可选给予失明和无敌效果。
• 拒绝处理：可在玩家拒绝或下载必需资源包失败时将其踢出，并支持可配置的多行文本。
• 提供方检测：支持原版服务器资源包，并检测 Nexo、ItemsAdder 和 Oraxen。
• 加入/退出消息控制：可选择隐藏标准服务器加入与退出公告。
• 配置校验：启动和重载时会验证屏幕映射、布局、物品槽位、材质、命令、导航目标、音效和条件。
• 每次重启仅显示一次的屏幕：可选择在一个服务器会话中对每位玩家只显示一次事件屏幕。
• 调试模式：提供资源包状态诊断，便于排查问题。

❓屏幕示例

Events:
  join:
    enabled: true
    screen: welcome

Screens:
  welcome:
    background: background
    layout: welcome-screen
    background-color: '&0'
    conditions:
      worlds:
        - lobby
    on-close:
      messages:
        - '&#55ff55Welcome to the server!'
    items:
      rules:
        material: BOOK
        slot: 22
        name: '&#ffd54aRules'
        lore:
          - '&7Click to view the rules.'
        open-screen: rules

支持的条件

• permission — 玩家必须拥有一个权限。
• permissions — 玩家必须拥有列表中的每一个权限。
• worlds — 玩家必须位于配置的世界之一。

支持的动作前缀

- '[console] give %player% diamond 1'
- '[player] warp spawn'
- '[message] &#55ff55Welcome!'

✨命令与权限

• /gizmo help — 显示命令帮助。别名：/g help
• /gizmo reload — 重载 Gizmo 配置并验证 screens.yml。权限：gizmo.reload。别名：/g rl
• /gizmo show — 向自己显示已配置的加入屏幕。权限：gizmo.show
• /gizmo show <player> — 向指定玩家显示已配置的加入屏幕。权限：gizmo.show
• /gizmo show <screen> — 向自己显示一个命名屏幕。权限：gizmo.show
• /gizmo show <screen> <player> — 向指定玩家显示一个命名屏幕。权限：gizmo.show
• /gizmo fade <in> <stay> <out> — 向自己显示淡入淡出。时间单位为 ticks。权限：gizmo.fade
• /gizmo fade <in> <stay> <out> <player> — 向指定玩家显示淡入淡出。权限：gizmo.fade
• 所有 Gizmo 命令都可以从控制台运行。
• 在控制台执行时，原本作用于自己的命令需要提供玩家目标。

🔧兼容性

• Spigot/Paper 1.18–26.1+
• 需要安装与服务器 Minecraft 版本兼容的 ProtocolLib。

故障排查

• 如果没有显示屏幕，请先确认玩家已被接受并成功加载了资源包。
• 如果在打开 Gizmo 屏幕时玩家背包物品仍然可见，请确认 ProtocolLib 已安装、已启用，并且与服务器版本兼容。

💡Gizmo

Gizmo 是一个轻量级的 Minecraft 插件，旨在为服务器管理员提供一系列实用工具，以简化日常管理和维护任务。它专注于提供核心功能，如物品管理、玩家控制和服务器操作，而无需复杂的配置。

🎮功能

• 物品管理：生成物品、修复物品耐久、重命名物品等。
• 玩家控制：踢出、封禁、传送玩家，以及管理游戏模式。
• 服务器操作：执行控制台命令、重新加载配置、管理世界。
• 实用工具：查看玩家信息、检查方块信息、管理时间与天气。
• 权限支持：所有命令都集成了权限节点，便于精细化管理。

🔧命令与权限

以下是 Gizmo 提供的主要命令及其对应的权限节点：

物品工具

• /gizmo give <物品> [数量] [数据] - 给予自己或指定玩家物品。

- 权限：`gizmo.command.give`

• /gizmo repair [玩家] - 修复手中或指定玩家物品的耐久。

- 权限：`gizmo.command.repair`

• /gizmo rename <新名称> - 重命名手中的物品。

- 权限：`gizmo.command.rename`

玩家管理

• /gizmo kick <玩家> [原因] - 将玩家踢出服务器。

- 权限：`gizmo.command.kick`

• /gizmo ban <玩家> [原因] - 封禁玩家。

- 权限：`gizmo.command.ban`

• /gizmo tp <玩家> - 传送到指定玩家。

- 权限：`gizmo.command.tp`

• /gizmo gamemode <模式> [玩家] - 更改自己或指定玩家的游戏模式。

- 权限：`gizmo.command.gamemode`

服务器操作

• /gizmo console <命令> - 以控制台身份执行命令。

- 权限：`gizmo.command.console`

• /gizmo reload - 重新加载插件的配置文件。

- 权限：`gizmo.command.reload`

• /gizmo world <世界名称> - 传送到指定世界。

- 权限：`gizmo.command.world`

信息与工具

• /gizmo whois <玩家> - 查看玩家的详细信息（IP、位置、游戏模式等）。

- 权限：`gizmo.command.whois`

• /gizmo time set <时间|day|night> - 设置世界时间。

- 权限：`gizmo.command.time`

• /gizmo weather <clear|rain|storm> - 更改天气。

- 权限：`gizmo.command.weather`

✨安装与使用

安装步骤

• 确保服务器运行的是 Spigot、Paper 或兼容的衍生服务端（版本 1.13+ 推荐）。
• 从官方页面下载最新版本的 Gizmo.jar 文件。
• 将 Gizmo.jar 文件放入服务器的 plugins 文件夹中。
• 重启或使用 /reload 命令重载服务器。
• 插件首次运行后，会在 plugins/Gizmo 目录下生成配置文件。

基本使用

• 使用 /gizmo help 可以查看所有可用命令的列表和简要说明。
• 大多数命令都支持通过 [玩家] 参数来对其他玩家进行操作。
• 使用 Tab 键可以自动补全命令和玩家名称。

❓常见问题

• Gizmo 支持哪些 Minecraft 版本？

- Gizmo 主要支持 1.13 及以上的版本。对于更早的版本，可能需要寻找特定的历史构建版本。

• 如何更新插件？

- 下载新的 `Gizmo.jar` 文件，替换掉 `plugins` 文件夹中的旧文件，然后重启服务器。

• 配置文件在哪里？

- 配置文件位于 `plugins/Gizmo/config.yml`。你可以在其中调整一些基础设置，如默认语言。

• 命令没有权限怎么办？

- 你需要让服务器管理员为你分配相应的权限节点（例如 `gizmo.command.give`），或者将你添加到拥有 `gizmo.*` 权限的组中。

⭐注意事项

• 使用 /gizmo console 命令需要极高的权限，请仅授予受信任的管理员。
• 在进行重大操作（如封禁、世界传送）前，建议先确认目标玩家。
• 定期备份你的服务器和插件配置文件总是一个好习惯。
• 如需更多帮助或报告问题，请访问插件的官方页面或支持论坛。