Follow along with the video below to see how to install our site as a web app on your home screen.
请注意: 此功能在某些浏览器中可能不可用。
本版本更新建议 本次更新建议更新的人群：开发者、正在开发的服务器。 本次更新不建议更新的人群：不便经常更新客户端的服主/开发者，因为该版本是个过渡版本，新功能下次（明天）更新将面临调整。 本次更新进行了一些更加精细的优化，可能某些位置会出现一些显示错误，这是很正常的现象。目前，已修复所有已知的恶性BUG。 可能明天还有一次更新，我约的小白鼠今天有事，明晚才能和我测试某个问题。（非网易服不影响） 由于本次更新增加了两个大项功能以及更多的性能调整，相较上次更新拖延了很久，万分抱歉orz。 更新内容 修复全息不渲染 修复1.21.1无法屏蔽原版等级字体 新增选择框控件 新增选择组控件 修复物品控件深度测试问题 微量优化 增加了一些界面、控件语句 修复复制控件上下文问题 新增模特控件 新增界面编辑器（注 当前仅为预览版本，不好用是很正常的现象，功能有限且未进行工作流优化设计，会在后续我使用过程中进行优化调整） 当前支持的功能： 拖拽编辑、单个控件4点拖动编辑 实时预览，100%所见即所得 脚本热更，属性值为脚本时即刻编译及时预览 通讯测试，插件开发者在此可调试发包效果，以进行插件的预先设计 ***注，由于当前版本为过渡版本，该功能暂时关闭了实际功能和上传功能，该功能于下次（明天）开放 槽位Backpack类型的返回结构合并至容器类型，更正说明文档 修复槽位物品拖拽时的显示问题 修复槽位物品获取语句获取错误 纹理控件增加贴图路径填写PlayerSkin:UUID可获取玩家头像（需存在于服内的玩家，且其皮肤在世界可渲染） 修复天空盒贴图修改 修复axui在Fabric版本无法正常渲染自定义tips 修复某些版本模型粒子无法正常渲染 修复动作控制器设置的次序问题 修复动作控制器死亡后未更新实体对象导致状态卡在“die”上 修复槽位未考虑尺寸问题导致物品渲染偏移 增加点对点设置实体模型、动作API 修复TIP剪裁运算 新增文字替换图片 修复Forge由于视锥体导致的模型粒子渲染不全 名称匹配模型配置增加hideNameTag选项，让一些装饰品实体不显示名字 交互界面和hud增加create函数，支持以模板创建控件，位于这两个载体之下的控件也可调用create函数在自身节点下级创建新的控件 修复文字序列化问题 对UI启动平滑度进行微量优化 对动态创建控件上下文读取速度进行微量优化 移除文字替换图标，详情原因请看反馈板 修复bbmodel模型uv读取问题 微量优化ui的自定义字体文字渲染平滑度 增加世界贴图动画API 修复于世界渲染图像时的法线运算错误 场景相机改为允许在第一人称时使用（需开启自定义相机选项） 增加单步绝对坐标场景相机Shimmer语句，增加关闭场景相机Shimmer语句 修复模型变化时动作控制器未同步上下文导致多次变化后可能无法正常更新动作 槽位属性增加对AstraXHero的支持 修复加载调度器的异步时序问题 tip语句获取悬浮物品改为返回真实悬浮物品而不是复制出来用来显示的物品 修复模型读取时由于尝试处理utf8的bom导致的模型读取失败 修复额外模型动作上下文独立性受主模型影响 增加覆盖模型（时装） 槽位增加loadSubstitutionModel配置项，开启后以传统模式读取物品模型进行时装穿戴（需使用玩家模型功能，基础模型见资源中心） Forge版本构建降低至47.3.0（之前是47.4.2 然而网易的版本是47.3.0） 修复base64模式传输的图片无法显示。 修复示例脚本中的一处错误 Player工具集增加获取主手物品对象的方法 修复实体管理器内存泄漏问题 再次优化模型渲染效率，帧率提高大约20%. 修复线程池上下文错误导致的类不可见问题
修复1.21.1Tab玩家列表无法显示 修复槽位物品渲染深度测试问题 修复高版本方块模型部分新版API无法使用 修复物品冷却显示 槽位增加cooldown贴图属性 修复1.21.1以下版本方块模型同步问题 修复涉及原版资源包功能的错乱问题 伤害数字配置增加小数精度选项，当存在第11个纹理时候可渲染小数，当存在第12个纹理时候可渲染逗号 增加自定义字体渲染（之前文档中出现font的地方，现在开始变得有效，支持ttf文件，将ttf放入ArcartX/font文件夹，比如xxx.ttf,在配置中填写xxx即可（注意UI中是~xxx） isMouseEntityAdyeshach增加对于自定义相机指针的判断 修复场景相机相对模式回归镜头时间为0时仍然尝试计算 限制Shimmer动画对象最小过渡时间为1毫秒 mm语句增加uiPacket，用于让mm怪发起技能时，向目标玩家发送界面通讯，然后执行UI包处理器的内容（如技能预警，执行Shimmer语句等） 新增轮盘布局控件 修复鼠标指针
修复1.20.5+nms序列化物品
修复MM模型子弹不渲染 修复部分NMS兼容问题 增加了几个API 忘了是啥了 修复1.21以上版本物品序列化问题 方块模型改为全版本通用方案，且现在破坏模型方块后掉落的完全是您之前放置该方块使用的原本物品 本次改动老版本方块依旧有效 值得注意的是，如果您的服务端未来有计划升级至1.20.5以上，请清空现有的所有模型方块设置为新版模型方块 因为自1.20.5后大改nbt同时也对nbt中存储的头颅信息做了限制，无法写入过长消息以及特殊符号 正因如此，如果您未来有计划升级至高版本，但是地图或者背包有这类物品，可能会导致服务端地图解析失败而造成错误 修复裂地特效实体忘了删实体的问题 修复容器界面下tip无法获取指针物品实例 增加Player.respawn()函数 itemicon功能wiki订正 修复Fabric版的按键崩溃 本地资源添加预加载，涉及原版资源包的功能（物品图标、Shader、强制加载资源包）若在无变动时，不会触发mc资源包全量重载(若以上功能资源使用了加密资源，在进入服务器时候必定触发重载)。 注意，改改动请详情查看文档“关于Mod过多时资源重载加载时间过长” 修复gif针对透明帧的处置问题 物品增加url标签，当存在时，在GUI中渲染会显示url设定的文件路径，该方式支持gif和网链，但是仅在GUI有效，适用于某些方可梦服不想替换箱子菜单又想用自定义图标的情况 增加槽位ID调试指令 开启后点击槽位可以获得对于容器的SlotID 修正槽位点击函数
添加 界面覆盖的识别ID改为友好名称，【曾经的ID依然可用,但是仅限Forge版，建议尽快换为通用友好名称】，这是为了Fabric的兼容性，因为Fabric使用的是中介名，而Forge是反混淆名称，后续统一使用内置的友好名而不用两个加载器的ID 增加Fabric 1.20.1支持 增加Fabric 1.20.4支持 增加Fabric 1.21.1支持
修复 修复插件端和墨端的兼容性问题 修复tb版本陈旧导致的依赖下载不全 VStack HStack的maxSize判断将不再计算不可见控件 添加 物品tooltip解析时，会将!&!* !&!# !&!%替换为§* §# §% 增加Progress控件，用于直接创建带有缓动动画的条形视图，比如血条。值得注意的是它是通过剪裁而不是拉伸
修复 修复模型粒子渲染器id顺序问题 修复模型粒子贴图绑定 修复配置对于列表形式单行读取的兼容性问题 修复相机精度问题 修复模型发光效果渲染问题 修复模型音频帧播放问题 修复客户端实体获取问题 添加 ui增加defaultOpen属性，默认为true，当UI作为HUD时，是否加载后立刻打开，如果不自动打开则使用指令/a screen open 或者API进行启动/关闭 改动 observer控件限速改为100毫秒（之前是2500毫秒） 移除Adaptive、Canvas、VStack、HStack、HGrid、VGrid的所有鼠标判断相关事件以及逻辑（布局控件不需要和鼠标交互） 文档更新 以下内容和本身更新没啥关系，只是为了让之前看过文档的人知道哪里有改动。 ui增加defaultOpen属性
注，该版本跨度稍微有点大，如有必要请备份旧版本配置重新生成（旧版配置无改动，依然正常使用） 修复 修复路标显示指令可变参数问题[无文档更新] 修复Shimmer注释在语句块中解析问题[无文档更新] 修复Shimmer语句中一些异步问题[无文档更新] 修复原版文字取文字图标代码时候无法正常读取的问题[无文档更新] 修复配置一处配置拼写错误[文档已更新更新] 修复Shimmer动画对象无法作为数字取反[无文档更新] 修复UI删除控件的时序问题[无文档更新] 修复Shimmer字符串类型语句内部问题[无文档更新] 修复Stack类型控件取值函数运算错误[无文档更新] 修复Shimmer容器对象函数的类型错误[无文档更新] 修复隐藏HUD渲染：ALL类型未能生效[无文档更新] 修复文字渲染器透明度为0时渲染错误[无文档更新] 修复了一个逆天刷了19w行报错的问题[无文档更新] 修复模型读取时如果动画下是空动画导致的兼容性错误[无文档更新] 修复网格布局控件尺寸运算错误导致锚点运算误差[无文档更新] 修复按键存档文件创建成了文件夹[无文档更新] 修复实体名和实体血条的冲突[无文档更新] 修复实体模型渲染不发光（outline）[无文档更新] 修复客户端实体发光在非服务端设置场景下失效[无文档更新] 修复Shimmer在处理乘除法的错误[无文档更新] 将除数为0的报错删除 但是会返回0[无文档更新] 修复加载阶段尝试播放音频时 造成的同时加载错误[无文档更新] 修复HUD下LOAD触发器无效[无文档更新] 修复消息发送时，如果是空消息造成的报错[无文档更新] 修复动作控制器玩家进入时的同步问题[无文档更新] 修复物品模型当附带锚点时，在GUI中渲染导致崩溃[无文档更新] 修复头颅方块因命名导致无法渲染的问题[无文档更新] 修复Camera语句未能生效[无文档更新] 修复客户端试图发送一个没有数据的包的时候产生报错[无文档更新] 修复模型加载对空定位器的解析错误[无文档更新] 修复物品函数getText获取非最后匹配到的字符串[无文档更新] 优化bbmodel解析方式（更换为非反射序列化，减少能耗提高效率）[无文档更新] 修复模型加载对render_side值解析失败(该问题可能导致渲染不完全)[无文档更新] 优化插件NMS部分写法减少大量资源消耗[无文档更新] 修复服务端控制器同步[无文档更新] 修复bbmodel贝塞尔曲线解析错误[无文档更新] 优化Event模块实现，减少反射带来的频繁类型检查能耗[无文档更新] 优化GIF图解析，减少编码带来的大量损耗[无文档更新] 重写网链图片加载机制，优化线程切换的损耗[无文档更新] 优化资源获取速度[无文档更新] 优化资源读取分类写法，减少大量不必要的对象创建和非必要读取[无文档更新] 修复模型卸载后内存未能释放的问题[无文档更新] 优化按键绑定写法，不再在修改时读写文件保存按键[无文档更新] 优化整理全息渲染缓存机制，避免同名但是不同类实体冲突[无文档更新] 修复物品冷却效果潜在的内存溢出问题[无文档更新] 修复重载时未播放完成的音频未能停止导致缓存无法被清理的问题[无文档更新] 修复重载时候大量文件比对造成资源文件数量大时的长时间无响应[无文档更新] 修复Shimmer动作控制器条件检测返回错误[无文档更新] 修复自由相机在动态切换时，仍然进行动态调整的问题[无文档更新] 移除场景相机对第一人称的支持（该功能会导致后续内容难以兼容，且存在潜在问题导致视角无法切换）[无文档更新] 优化UI多线程写法减少在主线程的过多判断[无文档更新] 那么多条我偷偷加一条应该没人看见[无文档更新] 优化HUD渲染写法，移除过量循环检测[无文档更新] 修复UI控件删除、清除执行后仍有部分内容未能清除[无文档更新] 修复文字控件在被动排版时的乱飘问题[无文档更新] 优化大量封装对象创建，改为注入接口[无文档更新] 修复hex16颜色代码转换[无文档更新] 优化模型读取逻辑，优化模型数据结构加快渲染判断[无文档更新] 优化物品/方块模型大小写下频繁转换字符串大小写导致的能耗[无文档更新] 优化实体模型默认控制器频繁搜索动作地址造成的能耗[无文档更新] 优化自定义实体动作控制器数据结构[无文档更新] 修复设置自定义实体控制器后删除后无法回到默认控制器[无文档更新] 移除模型骨骼碰撞（这玩意着实让能耗变高，而且局限性太大，压根没啥存在感）[无文档更新] 不再缓存通过命名设置的模型，当名称变化模型也会变化[无文档更新] 完全重写模型渲染器，不再使用Geckolib自带的渲染器，改为扁平化渲染，消除GeckiLib递归式渲染导致的上下文开销[无文档更新] 优化刀光、拖尾特效渲染时候的过度判断[无文档更新] 修复Shimmer获取鼠标位置y时返回了x[无文档更新] 修复UI中Hex16颜色解析色差问题[无文档更新] 修复ChatComponent的反向解析[无文档更新] 修复模型UVSIZE判断错误导致模型渲染不完全[无文档更新] 修复控件渲染运算时某个脑残失误导致结果为NaN[无文档更新] 修复布局类控件内子控件在初始阶段以及渲染阶段偶尔乱飘的问题[无文档更新] 修复命名模式citizen2的npc无法匹配[无文档更新] 修复mm模型子弹空值判断问题[无文档更新] 修复TextBox设置内容后产生的指针不同步问题[无文档更新] 修复相机进入服务器初始化极小概率导致客户端崩溃[无文档更新] 修复部分文字渲染问题[无文档更新] 优化资源读取，除了文件加载部分，其余解析内容改为多线程异步加载（1GB混合资源加载测试，优化前主线程阻塞20+秒，优化后主线程阻塞4-秒）[无文档更新] 添加 新增伤害显示功能[文档已更新] 插件端增加基岩粒子mod联动MM语句[文档已更新] 插件端增加基岩粒子mod通讯API[文档已更新] 控件语句增加 isHovered()语句用于判断鼠标是否悬浮于控件之上[文档已更新] 增加滚动布局控件[文档已更新] 增加图片文件名尾缀为xxx_linear.png时，以平滑方式读取图片（适用于圆形三角形这种弧度较大且像素可能不连续的贴图）[文档已更新] Shimmer新增Fade动画对象(用于标题淡出淡入等)[文档已更新] 增加Slot的Icon类型，并通过setIconItem({物品json})来设置内容物品[文档已更新] Slot增加取相同物品总数语句[文档已更新] 增加启动时自动创建资源目录结构[无文档更新] 文字控件添加shadow属性[文档已更新] 初始化增加子事件"Done"该事件发起时说明客户端初始化加载时资源包读条完成[无文档更新] 增加对Adyeshach虚拟实体标签的支持 用于控制虚拟碰撞体积以及模型（以及模型尺寸）（具体请使用指令 /a adyeshach 查看使用福冈是）[无文档更新] Shimmer增加判断指针实体是否是Ady实体[文档已更新] Shimmer增加Blink（闪烁）动画对象[文档已更新] Shimmer增加TwoLerp（二段线性插值）动画对象[文档已更新] 实体血条类型匹配增加AdyeshachOnly | PlayerOnly | OtherEntity [文档已更新] 可隐藏HUD添加recipe_toast | system_toast | advancement_toast | tutorial_toast （这几个是右上角那个弹出消息）[文档已更新] Shimmer增加Player.isFallFlying [文档已更新] 增加状态相机[文档已更新] tip匹配条件增加检查NBTtype的值是否匹配[文档已更新] tip匹配条件改为支持多条[文档已更新] Shimmer增加 none 空值关键字[无文档更新] 模型axmeta文件增加item_scale配置项[文档已更新] 增加方块动作 可以使用命令测试，正式环境请使用API [无文档更新] 增加三种锤地特效（震击地面地形特效）[无文档更新] 增加对Velocity的支持[无文档更新] 模型特效帧增加锤地特效解析播放[文档已更新] ui增加Import控件（用于导入其它配置的节点）[文档已更新] ui增加Observer控件（用于订阅一个变量，自动创建/删除控件）[文档已更新] ui增加BossBars布局控件[文档已更新] ui控件vstack hstack 增加maxSize属性，当一级子控件数大于该值，则弹出顶层控件，直至小于等于该值[文档已更新] slot控件增加lock属性，默认false 设置为true不处理槽位自身点击事件（点击脚本仍然会执行，仅作用于客户端）[文档已更新] 增加多层boss血条支持[文档已更新] 增加ItemEffect（物品额外装饰）该功能作用于ax的ui中。[文档已更新] slot控件增加itemEffect属性，具体是啥请看上面这条。[文档已更新] 模型动作效果帧指令帧新增“arcartx:camera” 启用后开启相机跟随定位器模式（仅第三人称有效） 该状态会在动画结束后关闭[文档已更新] 玩家模型增加相机跟随[文档已更新] 玩家模型增加动态附加模型渲染API（可用于实现模型时装功能）[无文档更新] ui增加chatTextBox控件（聊天栏专用输入框，可加入子控件用于命令补全）[文档已更新] 新增Suggestion控件（聊天栏输入框命令补全器）[文档已更新] 新增Chat控件（聊天栏）[文档已更新] 新增聊天栏卡片消息（仅作用于自定义UI的chat控件中，是插入到chat控件中的可交互控件）[文档已更新] 输入性控件加入insert语句[文档已更新] 我不喜欢上面这个数字，这里直接快进加一条[无文档更新] 自定义Chat控件还原原版ChatComponent的hoverEvent和clickEvent[无文档更新] mm语句增加锤地特效语句[文档已更新] 输入性质控件增加setFocus语句[文档已更新] 文字控件增加right属性 开启将使用靠右对齐[文档已更新] bbmodel模型解析增加命令帧解析[无文档更新] 添加了一些玩家状态判断语句[文档已更新] 改动 TIP根布局控件以及其直接子控件不再允许设置锚点（该控件宽高根据子控件运算 若子控件以可变宽高为锚点可能导致无限递增）[无文档更新] 移除控制器持久化存储（该功能未开放，本次改动无影响）[文档已更新] 更改模型对玩家皮肤的支持（原先是根据axmeta，然而如果是通用模型该功能有些局限性，当axmeta的player_skin设置为开启时，将替换原模型命名为“player_skin”或"player_skin.png"的图片作为模型贴图[文档已更新] 移除textBox的textColor和uneditableTextColor属性（至于为什么，因为这俩属性压根没用到，我也懒得加进去了）[文档已更新] 自由相机开启时，当划船时，相机切换为锁定[无文档更新] 文档更新 以下内容和本身更新没啥关系，只是为了让之前看过文档的人知道哪里有改动。 同步Tooltips更改后写法 修正shader使用文档的错误 同步伤害显示使用方式 同步基岩粒子MOD使用方式 同步基岩粒子MOD联动ArcartX模型使用方式 同步ArcartX插件端联动基岩粒子MOD使用方式 纠正文档中mm语句的碰撞语句错误 纠正文档中实体模型文字的拼写错误 文档增加二阶过渡动画使用方式 增加闪烁动画使用方式 增加淡出淡入动画使用方式 修正控件结构说明 增加控件ishovered语句用法 增加图像平滑读取用法 同步setIconItem控件语句用法 同步getSameCount控件语句用法 同步text控件新属性 同步Shimmer isMouseEntityAdyeshach使用方式 同步生物血条匹配AdyeshachOnly | PlayerOnly | OtherEntity 说明 同步HUD新增可隐藏id 同步最新Player工具集函数 同步模型item_scale配置项说明 同步状态相机Shimmer语句使用说明 同步mm语句锤地特效使用方式 同步Import控件用法 同步vstack hstack新属性 同步Observer控件用法 同步输入性质控件最新语句使用方式 同步BossBars控件用法 同步slot lock用法 同步Suggestion用法 同步Bossbar控件用法 加入新章节BossBar 加入新章节ItemEffet 同步slot itemEffect用法 同步Chat控件用法 同步text控件新属性 同步自定义聊天栏、卡片消息使用方式 同步最新玩家状态判断语句
修复 修复API注册的UI重载后回调未保存（上次没修全） 修复9SliceTexture渲染问题 修复按键按下后长按被判断位释放 修复getOnlinePlayersDict未正确获取UUID 优化UI/HUD/TIPS打开速度 修复控件删除后仍然进行运算 修复文字控件高度运算错误 优化布局运算 修复文字控件无法在网格控件下被排列 添加 增加ToolTips支持[涉及文档更新] 增加路标支持（RPG游戏风格任务导航）[涉及文档更新] Slot控件增加Hover类型槽位 其内容为当前鼠标指向的物品（即正在渲染Tooltip的物品） 新增VGrid纵列网格控件 增加HStack控件别名Stack、Grid控件别名HGrid 改动 UI中纯色块rgb表达式改为rgba（rgb依然可以被读取） 增加Shimmer某个语法的容错性 文档更新 以下内容和本身更新没啥关系，只是为了让之前看过文档的人知道哪里有改动。 Shimmer的tmp级别变量改动同步至文档 mm的模型子弹增加缩放用法同步至文档 ui新增seconds以及load触发器说明同步至文档 同步控件函数关于拷贝的改动说明至文档 更正Shimmer某些旧版写法未从文档移除 同步控件val属性用法至文档 同步Shimmer Sound类最新用法 同步Shimmer SkyBox类最新用法 slot控件，备注中加入hover属性在UI和HUD中的差异 同步9SliceTexture控件使用方式 同步控件最新通用属性 生物/方块模型动画音频帧使用方式同步至文档 生物模型手持物品定位器使用方式同步至文档 生物模型拖尾效果使用方式同步至文档 生物模型刀光效果使用方式同步至文档 生物模型模型粒子效果使用方式同步至文档 文档中UI的meta函数使用改进为更详细的说明 同步tooltips使用文档 同步VGrid控件使用文档 同步路标导航使用文档
修复 修复ui重载后回调未保存 修复attack不播放 修复动画对步类型的读取 修复动画读取帧时序混乱 添加 增加自定义字体接口，可通过API注册字体渲染器 UI中包含文字的控件增加font属性的读取[涉及文档更新]
