大家好，由于本次更新了新版角色，有可能导致各位玩家的作品出现一些问题，对此我们十分抱歉。在此我们在经过研究总结，整理出来了一份相对比较完善的兼容清单，以下是本次更新导致的问题及解决方法，如有缺失，请各位玩家体谅，将问题写到本帖下方，我们会尽快整理这些问题并回复，感谢大家的支持和贡献。

详细更新内容：2021年1月11日编辑器版本V1.12.9更新内容

索引

1. [重要]旧版角色动作解决方案

2. 动作无法播放

3. 角色（NPC）无法交互

4. [重要]修改表格编写顺序

5. 角色工具配饰挂点偏移

6. 如何使用官方自带模板UI

7. 角色动作播放逻辑错误

8. [BUG]角色挂件错位

9. 声音对象无法用服务器脚本播放

10. 地图版本与编辑器版本无法适配

11. 旧版角色出现双血条

12. 自定义角色走路、跳跃、攀爬和死亡没有音效

13. [BUG]Tween动画repeatDelay属性失效

14. [BUG]GetAnimationEvent无法使用

1.[重要] 旧版角色动作解决方案

        在此我们推荐创作们使用新版角色和新版动作，如需使用旧版角色和旧版动作，适配方案如下。

    1.1 准备一个官方默认旧版角色，确保旧版角色 – [Animation]文件夹下的所有动作为官方自带动作

    1.2 在[游戏设置] – [默认模板]中 – 下载[动作模板]。

    1.3 下载的动作模板在[玩家初始化] – [StarterCharaterScripts]下方的[OfficialAnimate]。

    1.4 删除[OfficialAnimate]下所有动作。

    1.5 将旧版角色 - [Animation]下所有动作资源移至[玩家初始化] – [StarterCharaterScripts]下方的[OfficialAnimate]下方。

    1.6 打开OfficialAnimation脚本，复制以下内容，将脚本的12-24行替换为复制内容

local animNames =
{ --以下为旧版动作资源ID
    Stand = {id = "rwid://T1VabTB7Cv1RCvBVdK", weight = 1}, 
    Run = {id = "rwid://T1fybTBmKv1RCvBVdK", weight = 1},
    Jump = {id = "rwid://T11tbTB5Wv1RCvBVdK", weight = 1},
    Fall = {id = "rwid://T1VybTBmhv1RCvBVdK", weight = 1},
    Climb = {id = "rwid://T1xtbTBKWv1RCvBVdK", weight = 1},
    SitDown = {id = "rwid://T17UJTB_hT1RCvBVdK", weight = 1},
    LoseControl = {id = "rwid://T1pRbTB7d_1RCvBVdK", weight = 1},
    GetUp = {id = "rwid://T1ctbTByWT1RCvBVdK", weight = 1},
    Walk = {id = "rwid://T1CUJTB_JT1RCvBVdK", weight = 1},
    Driving = {id = "rwid://T1KmJTBgWT1RCvBVdK", weight = 1},
}

    1.7 把旧版角色拖动至[玩家初始化]下。

    1.8 运行项目。

    解读：角色动作会依据动作资源ID进行播放。如需适配旧版动作，只需要匹配旧版动作资源ID即可

2.动作无法播放

    常见问题：新版本不支持 动作对象.Play = true 实现动作播放

    解决方案：建议统一使用 动作对象:PlayAnimation() 方式实现动作播放效果，并将动画优先级设为运动、姿势或动作

举例

local avatar = script.Parent --获取角色
local RunAnimation = avatar.Animate.Run --获取角色下的名字为“Run”动作对象（动作对象创作者自行决定）
RunAnimation.AnimationPriority = Enum.AnimationPriority.Action --将Run动作的优先级设为"动作"
RunAnimation:PlayAnimation() --播放Run动作

3.角色（NPC）无法交互

    常见问题：角色无法与角色进行交互   

    解决方案：如需实现NPC交互功能，将OfficialAnimate改为服务器脚本，脚本内容不变。

4.[重要]修改表格编写顺序

    table类型的数据作为参数进行传递时，若存在key值为数字1的数据，则传递的table为原table中key值从数字1开始连续的部分，删除其余部分；若不存在key值为数字1的数据，则传递的table会保留所有数据，但会把其中number类型的key值转化为string类型。

解决方案：关于表格方面的具体解释及例子可点击查看此帖子。

5.角色工具配饰挂点偏移

    常见问题：旧版角色载入新版后会出现挂点错位现象（如：工具、配饰等）

    解决方案：重新修改挂接参数下位置偏移/方向偏移的数值。

6.如何使用官方自带模板UI

    官方模板UI控件改为客户端脚本创建，编辑器初始不再有UI对象。如果旧版项目中有涉及获取官方UI的脚本，在新版中可能无法找到官方UI对象。

    解决方案：官方UI模板在下载后会放入玩家初始化 - StarterPlayerScripts下。创作者们可以使用官方脚本获取和修改UI对象

官方UI模板下载位置：游戏设置 - 默认模板

官方UI模板下载后资源位置：玩家初始化 - StarterPlayerScripts

7.角色动作播放逻辑错误

角色动作播放逻辑统一使用角色下自带Animate脚本实现。

解决方案：

1.直接来学一个！ 点击这里学习如何用脚本做一个简单动作

2.官方自带脚本模板OfficialAnimate，将OfficialAnimate脚本复制到新版角色下方，可以让新版角色使用旧版角色默认动作。

创作者还可以通过修改OfficialAnimate脚本内容制作自己想要的动作功能。

OfficialAnimate模板下载位置：游戏设置 - 默认模板 - 动作模板

官方动作模板下载后资源位置：玩家初始化 - StarterCharacterScripts下

8.[BUG] 角色挂件错位

角色在装饰挂件时，可能会出现挂件位置与角色挂点不匹配的情况（所有挂件位置都会出现在脖子位置）

解决方案：创作者需要自行手动进行调整装饰挂件。

9.声音对象无法用服务器脚本播放

注意，声音依然可以通过服务器脚本编写播放，但是会通过客户端执行，播放逻辑不会经过服务器。

解决方案：使用客户端脚本编写声音相关功能

10.地图版本与编辑器版本无法适配

地图版本高于编辑器版本，编辑器无法打开地图。

解决方案：

在C:\Users\%用户名称%\AppData\LocalLow\CodeView\重启世界编辑器\Scene_MyGame下打开对应地图文件夹

使用记事本打开[你的地图名称.version]VERSION文件，将编辑器的版本号输入至StudioVersion和StudioNewVersion后方

11.旧版角色出现双血条

    常见问题：旧版角色出现双血条

    11.1 在角色属性面板 - [角色参数] - [生命显示模式]改为[不显示]

    11.2 把角色拖动至玩家初始化下方

    11.3 在角色下方创建[客户端脚本]，复制粘贴以下内容

local boy = script.Parent --定义角色对象 
boy.HealthDisplayType = Enum.HealthDisplayMode.AlwaysDisplay --角色的[生命显示模式]设为[显示]

    11.4运行项目

12.自定义角色走路、跳跃、攀爬和死亡没有音效

解决方案：

12.1（可选择） 将[玩家初始化下]的自定义角色移至工作区，如果没有跳过此步。

12.2 点击素材箱，下载”V1128角色声音”。

12.3 把”V1128角色声音”孙级下的所有声音移动到 [%你的自定义角色%] – [Root]下。

12.4 把 [%你的自定义角色%] 移动至 [玩家初始化下] ，运行游戏，结束。

PS：创作者们也可以直接下载单独音源，在素材箱搜索Run Sound、Jumping Sound、Climb Sound和Dying Sound即可获取。

13. [BUG] Tween动画repeatDelay属性失效BUG

    我们将在1月20日（周三）更新编辑器，修复上述问题，请创作者们耐心等待。

14. [BUG] GetAnimationEvent无法使用

    我们将在1月20日（周三）更新编辑器，修复上述问题，请创作者们耐心等待。