Follow along with the video below to see how to install our site as a web app on your home screen.
请注意: 此功能在某些浏览器中可能不可用。
修复相机文档一处错误 UI属性增加screenScale属性 默认true 设置为false后将响应原版界面尺寸设置（未实际生效） 修复按键事件异步问题 修复控件函数中icon文档的错误 修复chat控件初始宽度为0时，文字剪裁导致客户端卡死的问题（感谢蒸蛋进行的测试） 修复动作控制器对于动作结束的判断 修复资源管理器多次重载的锁竞争 修复资源管理器冷热数据未能执行显存释放造成的显存资源溢出 修复指令补全控件偏移计算错误 修复Stack、Grid类型控件初始位置二次运算导致锚点运算时进行瞬间移动（注意，如果您动态创建子控件，且使用锚点，仍然会重新排列） 修复文字图标在全息中变暗 修复1.20.1、1.20.4全息跟随模式失效 修复世界渲染时候检测实体是否渲染但取空值造成的崩溃 客户端papi语句增加parseAll 可传入"玩家 %player_name% 等级 %player_level%"这种参数，最终返回 -> "玩家 17Artist 等级 0" 当全息血条持续为-1时，实体渲染名称时自动开启 增加模型展示框显示设置 修复ADY血条替换显示同步问题 修复boss血条切换世界未清除 命令补全控件改为更加贴近原版的实现 修复罗盘控件文字缩放问题 修复1.21+版本按键无法截取到弹起事件 修复模型粒子上下文干扰 增加对模型粒子的偏移度 修复HUD的滚轮事件未对wheelValue赋值 增加悬浮控件会触发wheel事件，且控件自身具备wheelValue用于就近取值 修复文字贴图排序由于冷数据加载宽高为0导致的显示异常 修复文字格式解析对格式重置失败 文字渲染器增加对k的支持 修复输入框撤销操作未正常检测边界导致客户端崩溃 修复ChatView对换行符的处理 修复剪裁因界面尺寸整数精度问题导致像素缺少（有限的解决方案，因为这玩意参数传的是整数） 修复资源数量变化未触发资源重载 增加1.21Forge支持 增加1.21.1NeoForge支持 增加1.21.4Fabric支持 shader文档更新
更新注意，本次更新包含对JS引擎的更换，如果过去正常的脚本变得不正常，请在服务端启动脚本增加参数： 代码: 扩展 折叠 复制 java -Xms1G -Xmx2G --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.lang.reflect=ALL-UNNAMED -jar paper-1.20.1-196.jar 修复动作控制器限制条件 动作控制器增加moveLimit选项 用于将自身移动向量限制到指定倍数 修复1.21.1以上版本跳跃拦截判断 修复invoke接口编译对文件尾的判断 由于和克洛诺斯设计冲突，移除ArcartX本体对于玩家模型的持久化保存 有克洛诺斯不需要这个功能 该功能被单独剥离为单独插件，可选择性安装 修复聊天栏补全控件间距 修复Bossbar位置未能居中 修复Bossbar实体信息缺失 修复文字控件尺寸运算 修复VStack控件布局运算 修复HStack控件布局运算 修复VGrid控件布局运算 修复HGrid控件布局运算 修复悬浮物品、原版tip被UI文字遮挡 修复client变量存储格式出错 修复itemeffect渲染层次 修复文字图片过多导致的输入框初始化困难 修复客户端按键组合连续触发失败 修复悬浮控件的并发错误 修复Potion.getActivePotionEffects执行错误 mm设置实体模型增加reset参数 默认为true 当设置为false将不会更新模型上下文。适用于骨骼相同模型进行动态切换而不改变动画进程 聊天栏控件增加showCard属性 聊天栏控件增加exclude属性 stack类型控件，将读取控件level属性，进行排列，level越高，越靠前，其余顺序逻辑不变。 修复限制显示无法多层剪裁 修复Text在对齐模式下位置判断 修复进度条、血条控件边境像素显示不全 界面替换匹配条件加入正则表达式 插件端兼容java22+ 修复fabric版本F1隐藏HUD时AXHUD依然渲染 优化字体渲染代码结构 增加文字图标比例选项 修复资源加载重载时线程卡死的问题 完全重写音频模块（这烂代码是我好几年前写的，我差点没看懂） 重写物品图标资源载入逻辑 重写Shader资源载入逻辑 重写音频资源载入逻辑 重写强制加载资源包载入逻辑 修复Shader渲染器加载 增加对bbmodel5.0+版本文件读取 模型管理器增加版本策略 聊天输入控件增加sendClose属性 默认true 关闭后输出将不关闭窗口 重写模型资源管理器，改为异步按需加载 资源管理器URL文件增加本地缓存（加密落地，每个玩家独立密钥—） 增加动态资源文件本地缓存（非加密，用于比如即时传递而二维码、动态轮播图等）（各位可能不知道AX有个API能传图片到客户端吧） 重写资源管理器，增加冷热数据管理、异步加载，大幅提高加载速度减少内存占用 UI增加定时/循环任务调度器 模型molang支持简化查询 添加mm代理碰撞箱语句，这会生成一个隐形实体（包括碰撞箱不可见）代替实体挨打，解决体积变大后寻路AI会出现一些异常。 增加命名实体客户端虚拟碰撞箱配置（仅限ADY实体） 增加命名实体替换模型关闭受击变色 增加命名实体持续渲染配置（仅限ADY实体） TextBox增加inputPattern属性，以正则表达式限制允许输入内容 增加Compass（罗盘）控件,该控件可联动路标进行指引 模型关键帧指令增加相机震动 增加模型动作控制器对结束过渡时间的设置 修复1.21.1模型粒子渲染纹理错乱 模型粒子增加速度、动作属性 模型粒子实体化管理，可通过API进行删除 修复textbox、chatbox输入长度限制 slot控件增加overwriteText属性，默认为空，若存在值，则将在渲染物品时改变角落数量显示的内容 完善云同步功能，改为资源同步完毕后再进行资源加载流程 优化初始化链接时数据交换逻辑 增加MM语句摇晃相机 文档更新 更新动作控制器文档 更新mm语句文档 更新聊天栏控件新属性说明 更新stack类型控件新功能说明 更新UI属性文档 更新文字图标文档 更新ChatBox文档 更新命名实体模型配置说明 更新TextBox文档 更新Slot文档 更新模型相机帧文档 更新模型粒子帧文档 更新Compass控件用法 更新Waypoint文档 UI增加定时/循环任务调度器用法
java -Xms1G -Xmx2G --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.lang.reflect=ALL-UNNAMED -jar paper-1.20.1-196.jar
修复hud按键报错 修复提示控件位置运算错误 修复Grid类控件大小运算顺序导致的布局错误 修复Adapt控件大小运算错误 修复文字控件大小运算顺序导致的布局错误 修复Stack类控件大小运算顺序导致的布局错误 修复Scroll控件失效（实际上是大小运算顺序导致的错误） 修复文字控件运算问题导致的无法被限制控件限制显示 修复贴图二次释放导致重载时客户端爆炸 哎 好累 我不会这辈子都在修bug吧 修复释放触发器无法触发 修复UI触发器传递问题 修复精度运算导致的路标右侧无法显示 修复1211全息血条无法使用 修复相机隐藏头的骨骼后背包内断头 修复模型gui设定失效 修复模型粒子南北朝向错误
更新 增加entityCacheClearInterval配置项，配置实体缓存更新间隔。默认为5分钟检查一次 修复模型动画读取一些特殊的帧读取错误导致加载了空值 修复模型读取时对过小的块的剔除阈值过大 升级EULA验证服务，曾经的验证方式需填写账户密码不太安全，现改为许可证ID和密钥，您可能需要重新进行EULA的查看来领取许可证ID和密钥。 修复切换世界有概率模型消失 增加鼠标点击事件 slot控件itemeffect增加默认值：default 修复控件VAL重复创建 实体的无状态 -> 有状态的过渡时间改为0 mm语句：model{} 当参数为空时候则代表移除模型 修复资源加载的线程安全 增加资源管理独立后端 增加自动更新功能（仅加密压缩包文件） 修复路标文字渲染 修复UI的Slot为Icon时候不渲染TIP Shimmer物品对象增加获取list和map格式nbt 移除ALT巡视相机 多层血条增加layer变量 tip布局控件增加follow属性 默认true 控件enable属性为false时，关闭控件所有输入触发器 修复1.21+由于相机变动导致的全息跟随模式无法显示 Shimmer解释器改为声明式词法分析器生成有限自动机 + 手动二次简化 Shimmer增加Wave动画对象 Shimmer增加Swing动画对象 Shimmer增加Slide动画对象 Shimmer增加Shake动画对象 Shimmer增加Pulse动画对象 Shimmer增加Breathe动画对象 服务端新增内置Glimmer脚本引擎（即服务端版Shimmer，为了避免用户混淆改个名字，虽然这会导致每次都得改两遍源码，不过还是得照顾分不清前后端分离的新用户，哎） 实装UI编辑器（真不好意思，UI内核重写了，这玩意删了） （虽然这条没啥用但是浪费挺长时间的，还是写一下。本来准备给UI兼容JS，不过这玩意访问太不方便，重点是我没必要因为一个不了解实况的建议让维护成本x2，回滚了，再见） 优化内部遍历控件实现 控件增加单独可穿透属性 重写UI输入控制，可进行传递阻断 修复TIP Shimmer对象无法获取root实例 移除UI对象transfer属性，该属性变更至启动UI穿透或无悬停控件即生效 修复覆盖多级UI导致容器被提前关闭 移除Wheel控件 移除Slot控件的itemEffect属性 修复锚点属性位置运算错误 修复Stack类型控件可能返回负数宽高 修复悬浮控件运算方式 修复异步导致的控件位置异常 修复当替换聊天栏的时候由于异步所产生的轻微延迟 修复布局运算中错误的运算（注意这个修复可能导致原本的某些布局错位，但其实是之前的写错了，嘻嘻） 修复Tip布局控件无法关闭自适应 修复文字布局崩溃客户端 修复提示控件由于异步导致的位置概率乱飘 修复实体血条对名称的判断 修复全息渲染变为暗色 修复自定义客户端按键修改后无法保存 修复自定义客户端按键无法连续触发 修复文字控件渲染时会被模型性质控件渲染影响 修复Fabric版本无法获取额外槽位物品信息 修复1.20.4、1.21.1模型粒子渲染崩溃 UI HUD 增加delayAction函数 相机视角锁定配置由force: boolean 改为forceMode: int 视角锁定模式，0-关闭，1-强制锁定第一人称，2-强制锁定第三人称 刀光特效增加持续时间选项 shimmer menu 对象增加getCarriedItemStack 获取指针物品 Sound函数增加named语句以及removeNamed语句可通过命名id关闭音频 MM增加HideHitBox配置项，用于一些遁地或者模型隐身的怪物隐藏碰撞提及防止玩家透视 相机增加hideHead配置项，开启后，如果使用了自定义模型，使用对应预设相机后将隐藏Head和head骨骼 itemeffect改版为判断nbt静态渲染，且不再强制依赖AXUI 修复HUD重载不显示（说实话 我压根没修 但是我带着资源重载试了一百次 不带着重载了一百次没发生这个问题，我也不知道是摸明奇妙修复了还是偶然没轮到我） UI API增加run函数，用于直接热执行脚本 文档更新 更新Tooltips文档 加入Tip工具集用法 hud隐藏差异文档更新 更新进度条控件用法 更新slot控件文档 更新key语句文档 更新UI font说明 更新伤害显示文档 更新资源加载说明文档 更新纹理控件文档 更新Player工具集文档 更新命名实体匹配模型替换说明文档 更新血条控件说明文档 更新相机setting文档 更新setting文档 更新额外槽位文档 更新mm拓展语句文档 更新mm拓展配置文档 更新shimmer itemstack文档 更新预设相机文档 更新模型刀光使用文档 更新控件公共属性文档 更新UI属性文档 更新Tip属性文档 Shimmer增加Wave动画对象用法 Shimmer增加Swing动画对象用法 Shimmer增加Slide动画对象用法 Shimmer增加Shake动画对象用法 Shimmer增加Pulse动画对象用法 Shimmer增加Breathe动画对象用法 更新Shimmer UI 文档 更新Shimmer Sound文档 更新Shimmer 控件文档 更新物品图标文档 更新Shimmer Camera 文档 更新ItemEffect文档 增加模特控件用法
本版本更新建议 本次更新建议更新的人群：开发者、正在开发的服务器。 本次更新不建议更新的人群：不便经常更新客户端的服主/开发者，因为该版本是个过渡版本，新功能下次（明天）更新将面临调整。 本次更新进行了一些更加精细的优化，可能某些位置会出现一些显示错误，这是很正常的现象。目前，已修复所有已知的恶性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语句等） 新增轮盘布局控件 修复鼠标指针
修复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
修复 修复插件端和墨端的兼容性问题 修复tb版本陈旧导致的依赖下载不全 VStack HStack的maxSize判断将不再计算不可见控件 添加 物品tooltip解析时，会将!&!* !&!# !&!%替换为§* §# §% 增加Progress控件，用于直接创建带有缓动动画的条形视图，比如血条。值得注意的是它是通过剪裁而不是拉伸
