由于不同模组的设置界面风格各异
导致玩家在游玩模组时常常找不到设置入口
增加了游玩的负担和学习成本

为统一模组设置体验、降低玩家使用门槛
“通用设置接口”现已上线
开发者可通过接口“快速注册标准化”的设置选项
让玩家在统一的入口中轻松管理所有模组设置

通用设置接口规范与教程：
https://g.126.fm/00nB8wF

功能介绍
一、功能简介
1、官方提供标准化模组设置接口，开发者通过简单的 API 调用即可为模组注册设置页面。
2、设置页面统一集束在 暂停菜单 - 模组 中，玩家无需学习每个模组的设置入口。
3、无需更改引擎内容，补全库更新后即可使用。
二、支持控件类型

三、核心特性
1、链式调用：所有控件注册方法均支持链式调用，一行代码注册多个控件，代码简洁优雅。
2、优先级排序：通过 priority 参数自由控制控件的显示顺序，不设置则按添加顺序自动排列。
3、控件锁定：支持通过 SetLockSettingComp 动态锁定/解锁控件，实现设置项之间的联动逻辑。
4、实时读写：通过 Get/Set 系列方法随时读取和修改控件的默认值，响应用户操作。
5、灵活兼容：不强制开发者必须使用通用设置界面做全部设置。开发者可以只注册一个按钮，点击后跳转到自定义的设置页面。

使用方法
一、快速上手
1、注册通用设置实例

comp = clientApi.GetEngineCompFactory().CreateNeteaseWindow(playerId)
settingInst = comp.RegisterSettingInst("itemId", "模组名称", "textures/ui/icon")

· 第一个参数为 ItemID，需先在开发者平台上传模组获取；
· 后两个参数仅用于 ModPC 开发环境测试，正式服中无作用；
· 建议在 UiInitFinished 事件触发时注册，避免过早注册返回 None。
2、注册控件

if settingInst:
    (settingInst
        .AddText("text_01", "欢迎使用本模组", 1)
        .AddToggle("toggle_01", "启用特效", callbackFunc, 2, False)
        .AddSlider("slider_01", "音量", 100, callbackFunc, 3, 50)
        .AddDropDown("drop_01", "难度", ["简单","普通","困难"], callbackFunc, 4, "普通")
        .AddInput("input_01", "自定义名称", callbackFunc, 5, "冒险家")
        .AddButton("btn_01", "更多设置", "点击打开", openMySettingPage, 6))

3、处理回调

def callbackFunc(*args):
    # args[0]: 控件ID (key)
    # args[1]: 控件当前值 (value)
    pass

二、设置入口与使用规则
· 入口：位于游戏内 暂停菜单 - 模组 页面中。
· 每个模组仅能注册一个通用设置实例，重复注册会返回同一实例。
· 界面内置滚动功能，无需翻页。
三、接口速查

通用设置接口已就绪
开发者们快来为你的模组注册标准化设置页面
让玩家轻松找到并管理模组设置！
如果各位开发者有任何疑问或反馈
欢迎通过官方社群与志愿者沟通
或通过 开发者平台 - 问题与反馈中心 进行反馈
期待你的创意更新！
更多讯息请关注《我的世界》官网动态