EasySettings

插件

· 作者 X3vro

一款简洁现代的 GUI 设置插件,支持游戏内可视化编辑器与丰富的开发者 API。

0 本站下载 0 关注 更新于 2 周前

最新 1.1.0 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

⚙️ EasySettings

EasySettings 是一款专为现代服务器设计的、美观且完全模块化的 Minecraft GUI 设置插件,适用于 Spigot / Paper (1.20+)。它提供了一个精致的游戏内玩家设置菜单、完整的交互式游戏内 GUI 编辑器、流畅的 Unicode 小型大写字母排版,以及可扩展的 Developer API,使其他插件能够轻松注入自定义设置和回调函数。


✨ Features

  • ? Aesthetic Player GUI (/settings):

    • 采用现代柔和色与赛博朋克十六进制颜色(&#66FCF1, &#51CF66, &#FF6B6B)的简洁卡片式描述文本布局。
    • 原生支持 Unicode Small Caps 排版(<sc>text</sc>)。
    • 支持 TOGGLE 设置(具有持久开/关状态及 %status% 占位符)和 ACTION 设置(一键按钮)。
    • 响应式单槽更新 —— 无库存闪烁或卡顿。
  • ?️ Visual In-Game Editor (/settings editor):

    • 实时镜像你的设置库存布局。
    • 点击任意绿色空槽位(+ Add Setting)即可在该确切位置创建设置。
    • 左键点击设置以打开 Inspector Menu(更改名称、图标、类型、光泽、权限、描述文本、动作)。
    • Shift+左键点击以拾取并将设置移动到其他任意槽位。
    • 支持实时聊天输入捕获及 cancel 功能。
  • ⚡ Powerful Action Engine:

    • [player] <command> — 以玩家身份运行命令
    • [console] <command> — 从服务器控制台运行命令(支持 %player%)
    • [message] <text> — 向玩家发送带颜色的消息
    • [broadcast] <text> — 向全服广播
    • [sound] <SOUND:VOL:PITCH> — 播放音效
    • [close] & [refresh] — 控制 GUI 流程
    • [api] <tag> — 触发自定义插件挂钩
  • ? Comprehensive Developer API:

    • 使用流畅构建器在代码中注册设置(Setting.builder("auto_pickup")...build())。
    • 仅需 3 行代码即可附加 Java 回调(.onToggle(...) 和 .onClick(...))。
    • 注册自定义动作标签([myplugin] doSomething)。
    • 以编程方式查询或设置玩家设置(EasySettingsAPI.isSettingEnabled(...))。
  • ? Plugman / PlugmanX Safe:

    • 强化的重载与卸载例程。
    • 自动关闭打开的菜单、刷新持久化存储、取消计划任务、注销监听器并清除静态引用,以防止内存泄漏。
    • 内置实时重载命令:/settings reload 可实时更新活跃玩家的菜单。
  • ? PlaceholderAPI Ready:

    • 原生软依赖集成,支持标题、显示名称和描述文本。

? Commands & Permissions

Command Permission Description
/settings easysettings.use 打开玩家设置 GUI
/settings editor easysettings.admin 打开交互式视觉 GUI 编辑器
/settings edit <id> easysettings.admin 打开特定设置的 Inspector GUI
/settings add <id> easysettings.admin 在下一个可用槽位添加新设置
/settings delete <id> easysettings.admin 永久删除设置
/settings list easysettings.admin 列出所有已注册设置、槽位和来源
/settings reload easysettings.admin 重载 config.yml 和 settings.yml

(别名: /setting, /settings, /esettings, /easysettings)


? Quick Developer API Example

只需几秒钟即可从你的插件中添加自定义设置:

import com.easysettings.api.EasySettingsAPI;
import com.easysettings.api.Setting;
import com.easysettings.api.SettingType;
import org.bukkit.Material;
import java.util.List;

Setting mySetting = Setting.builder("auto_pickup")
    .displayName("&#66FCF1&l<sc>Auto Pickup</sc>")
    .slot(13)
    .type(SettingType.TOGGLE)
    .item(Material.HOPPER)
    .defaultState(false)
    .description(List.of(
        "&#868E96Automatically collect mined items directly",
        "&#868E96into your inventory.",
        "",
        "&#495057│ &#868E96Status: %status%",
        "",
        "&#66FCF1▸ Click to toggle"
    ))
    .onToggle((player, setting, newState) -> {
        player.sendMessage("Auto Pickup: " + (newState ? "ON" : "OFF"));
    })
    .build();

EasySettingsAPI.registerSetting(mySetting);

有关涵盖 Maven/Gradle、现成插件(EssentialsX, Vault, PvP plugins)、自定义动作标签和事件的完整集成指南,请查看我们的 Integration Guide on GitHub!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源