Duckov Modding 示例 (Duckov Modding Example)

文件夹结构

• decompile (反编译后的代码文件夹 / Decompiled code folder)
• full_decompile (完整解包后的代码文件夹 / Fully decompiled code folder)
• history (历史版本文件夹 / History folder)
• test (测试项目用文件夹 / Test folder)

DLL解包方法 / DLL Decompile Method

使用ILSpy命令行工具一次性解包所有代码

1. 安装ILSpy命令行工具（只需安装一次）：

   dotnet tool install --global ilspycmd
   

2. 创建解包目录：

   mkdir full_decompile
   

3. 使用ILSpy解包DLL文件：

   ilspycmd "E:\Steam\steamapps\common\Escape from Duckov\Duckov_Data\Managed\TeamSoda.Duckov.Core.dll" -o decompile -p
   

   参数说明：

   • -o decompile：指定输出目录
   • -p：生成项目文件，便于在IDE中打开

4. 解包完成后，可以在decompile目录中查看所有解包后的源代码，并使用IDE打开TeamSoda.Duckov.Core.csproj项目文件。

解包其他DLL文件

如需解包其他DLL文件，使用相同的命令格式：

ilspycmd "DLL文件路径" -o 目标目录 -p

工作原理概述

official

使用dotnet编译Debug和Release版本

编译命令

使用dotnet命令行工具可以轻松区分编译Debug和Release版本：

1. 编译Debug版本（默认配置）：

   dotnet build
   

   或明确指定：

   dotnet build -c Debug
   

2. 编译Release版本：

   dotnet build -c Release
   

3. 发布Release版本（优化后的可发布版本）：

   dotnet publish -c Release
   

Debug和Release版本的区别

• Debug版本：

  • 包含调试信息
  • 未进行代码优化
  • 文件大小较大
  • 适合开发和调试阶段

• Release版本：

  • 不包含调试信息（默认情况下）
  • 进行了代码优化
  • 文件大小较小
  • 运行性能更好
  • 适合发布和分发

输出位置

编译后的DLL文件通常位于以下位置：

• Debug版本：bin/Debug/netstandard2.1/YourModName.dll
• Release版本：bin/Release/netstandard2.1/YourModName.dll

推荐做法

1. 开发阶段使用Debug版本，便于调试
2. 发布Mod前使用Release版本，确保性能最优
3. 发布时只需将Release版本的DLL文件、info.ini和preview.png打包

示例：完整编译流程

# 清理之前的构建
dotnet clean

# 编译Release版本
dotnet build -c Release

# 或者直接发布到指定目录
dotnet publish -c Release -o ./publish

Duckov 游戏反编译代码分析

本文档分析了Duckov游戏反编译代码中各个文件和文件夹的作用。

目录结构

decompile/

Duckov游戏的主要反编译代码目录，包含了游戏的核心功能实现。

核心系统文件

ADSAimMarker.cs

处理ADS（瞄准镜）状态下的瞄准标记功能，控制玩家在瞄准时的视觉反馈。

AICharacterController.cs

AI角色控制器，负责管理非玩家角色(NPC)的基本移动和行为逻辑。

AIMainBrain.cs

AI主大脑组件，控制NPC的核心决策逻辑和行为模式。

AISound.cs

AI声音系统，处理NPC产生的声音事件，用于吸引其他AI的注意或触发特定行为。

AISpecialAttachmentBase.cs

AI特殊附件基类，定义了NPC可以装备的特殊物品的基本行为和属性。

AISpecialAttachment_Shop.cs

商店NPC的特殊附件实现，处理商店相关的特殊功能和交互。

AISpecialAttachment_SpawnItemOnCritKill.cs

暴击击杀时生成物品的特殊附件，实现特定NPC在被暴击击杀时掉落额外物品的功能。

AI_PathControl.cs

AI路径控制组件，管理NPC的导航和寻路行为。

ATMPanel.cs

ATM（自动取款机）面板UI组件，处理玩家与ATM的交互界面。

ATMPanel_DrawPanel.cs

ATM取款面板子组件，专门处理取款功能的UI逻辑。

ATMPanel_SavePanel.cs

ATM存款面板子组件，专门处理存款功能的UI逻辑。

ATMView.cs

ATM视图组件，管理ATM的整体视觉表现和用户界面。

AT_InteractWithMainCharacter.cs

与主角交互的动作任务，处理NPC与玩家角色的交互逻辑。

AT_SetBlackScreen.cs

设置黑屏的动作任务，用于场景转换或过场动画中的黑屏效果。

AT_SetVirtualCamera.cs

设置虚拟摄像机的动作任务，用于控制游戏中的摄像机切换和视角变化。

AccessoryBase.cs

配件基类，定义了游戏内配件物品的基本行为和属性，处理配件与武器/角色的连接和初始化。

Accessory_Lazer.cs

激光瞄准器配件实现，提供武器瞄准时的激光线显示功能，包括障碍物检测和命中点标记。

ActionProgressHUD.cs

动作进度HUD组件，显示角色执行各种动作（如钓鱼、开锁等）的进度条，并提供取消操作的指示。

Action_Fishing.cs

钓鱼动作实现，处理完整的钓鱼流程，包括选择鱼饵、等待鱼咬钩、收鱼等阶段的状态管理。

AddBuffAction.cs

添加增益效果动作，用于给角色添加临时增益效果（如提升属性、特殊能力等）。

AddToWishListButton.cs

添加到愿望清单按钮UI组件，允许玩家将想要的物品添加到愿望清单中。

AimMarker.cs

瞄准标记组件，控制屏幕上的瞄准准星显示，包括准星散布、距离显示和击杀标记等功能。

AimTargetFinder.cs

瞄准目标查找器，用于自动寻找和锁定瞄准目标。

AimTypes.cs

瞄准类型定义，包含游戏中不同瞄准模式的枚举和配置。

AudioEventProxy.cs

音频事件代理，用于处理游戏中的音频播放事件。

BaseBGMSelector.cs

背景音乐选择器基类，管理游戏中的背景音乐播放逻辑。

BaseSceneUtilities.cs

场景工具基类，提供场景加载和管理的通用功能。

BezierSpline.cs

贝塞尔曲线实现，用于游戏中的路径规划和曲线运动。

BitcoinMinerView.cs

比特币矿机视图组件，处理游戏内比特币挖矿功能的UI显示。

BlueNoiseSetter.cs

蓝噪点设置器，用于图形渲染中的噪点效果。

BoundaryGenerator.cs

边界生成器，用于创建游戏世界的边界和限制区域。

BowAnimation.cs

弓箭动画控制器，处理弓类武器的动画效果。

Breakable.cs

可破坏物体组件，定义可以被玩家破坏的物体行为。

BuffVFX.cs

增益效果视觉特效，处理增益状态的视觉表现。

BuilderViewInvoker.cs

建造视图调用器，用于激活和显示建造界面。

BulletCountHUD.cs

子弹数量HUD显示，显示当前武器的剩余弹药数量。

BulletPool.cs

子弹对象池，管理子弹实例的创建和回收，优化性能。

BulletTypeDisplay.cs

子弹类型显示组件，用于UI中展示不同子弹类型。

BulletTypeHUD.cs

子弹类型HUD，显示当前使用的子弹类型信息。

BulletTypeInfo.cs

子弹类型信息，定义各种子弹的属性和特性。

BulletTypeSelectButton.cs

子弹类型选择按钮，允许玩家切换不同类型的子弹。

重要文件夹分析

CameraSystems/

摄像机系统文件夹，包含游戏摄像机的控制和管理功能。

• CameraPropertiesControl.cs：摄像机属性控制器，管理摄像机的各种参数设置。

Duckov/

Duckov游戏核心系统文件夹，包含游戏的基础功能模块。

• AudioManager.cs：音频管理器，控制游戏中的音效和音乐播放。
• CheatMode.cs：作弊模式，用于开发和测试的特殊功能。
• CursorManager.cs：光标管理器，控制游戏中的光标显示和行为。
• EXPManager.cs：经验值管理器，处理角色升级和经验获取。
• GameMetaData.cs：游戏元数据，存储游戏的基本信息。
• ItemShortcut.cs：物品快捷键，管理物品的快速使用功能。

Duckov.Buffs/

增益效果系统文件夹，处理角色临时增益状态。

• Buff.cs：增益效果基类，定义增益的基本行为和属性。
• CharacterBuffManager.cs：角色增益管理器，管理角色的所有增益效果。

Duckov.Crops/

作物系统文件夹，处理游戏中的种植和收获功能。

Duckov.Economy/

经济系统文件夹，管理游戏内的货币和交易。

Duckov.UI/

用户界面系统文件夹，包含所有UI组件和交互逻辑。

Duckov.Buildings/

• BuildingManager.cs - 建筑管理器，处理建筑的放置、移除和保存，管理建筑区域数据和建筑令牌
• Building.cs - 建筑基类，定义建筑的基本属性和行为
• BuildingArea.cs - 建筑区域类，管理特定区域内的建筑布局
• BuildingBuyAndPlaceResults.cs - 建筑购买和放置结果处理
• BuildingDataCollection.cs - 建筑数据集合，存储所有建筑的信息
• BuildingEffect.cs - 建筑效果系统，处理建筑对游戏环境的影响
• BuildingInfo.cs - 建筑信息类，包含建筑的详细属性
• BuildingRotation.cs - 建筑旋转系统，处理建筑的朝向

Duckov.Crops/

• CellDisplay.cs - 作物单元格显示组件，处理作物在花园中的视觉效果
• Crop.cs - 作物系统核心，管理作物生长、浇水、成熟和收获逻辑
• CropAnimator.cs - 作物动画控制器，处理作物生长阶段和状态变化的动画效果
• CropData.cs - 作物数据结构，定义作物属性、生长时间和产出信息
• CropDatabase.cs - 作物数据库，存储所有作物类型的相关数据
• CropInfo.cs - 作物信息展示组件，提供作物详细信息的UI显示
• Garden.cs - 花园管理系统，包含作物网格、自动浇水和尺寸管理
• IGardenAutoWaterProvider.cs - 花园自动浇水提供者接口，定义自动浇水系统的标准
• IGardenSizeAdder.cs - 花园尺寸扩展器接口，用于扩展花园容量
• ProductRanking.cs - 产品评级系统，根据作物质量进行等级评定
• SeedInfo.cs - 种子信息组件，管理种子属性和种植要求

Duckov.Economy/

• EconomyManager.cs - 经济系统管理器，处理金钱、物品解锁和交易逻辑
• Cost.cs - 成本结构体，定义物品和金钱的成本计算方式
• StockShop.cs - 商店系统，实现商品买卖、库存管理和价格调整

Duckov.Achievements/

• AchievementManager.cs - 成就系统管理器，处理成就解锁条件和进度跟踪
• AchievementDatabase.cs - 成就数据库，存储所有成就的定义和描述
• StatisticsManager.cs - 统计数据管理器，记录玩家游戏行为和成就进度

Duckov.Buffs/

• Buff.cs - Buff效果系统，管理增益/减益效果的属性、持续时间和特效
• CharacterBuffManager.cs - 角色Buff管理器，处理Buff的添加、移除和更新逻辑

Duckov.Bitcoins/

• BitcoinMiner.cs - 比特币挖矿系统，实现基于性能的挖矿机制和产出计算

Duckov.Effects/

• DamageAction.cs - 伤害效果动作，处理Buff造成的伤害计算和特效

Duckov.MiniMaps/

• IPointOfInterest.cs - 兴趣点接口，定义地图标记的基本属性和行为
• MapMarkerManager.cs - 地图标记管理器，处理自定义地图标记的创建和管理
• MapMarkerPOI.cs - 地图标记兴趣点，实现玩家自定义地图标记功能
• MiniMapCenter.cs - 小地图中心点，定义各场景的小地图中心坐标
• MiniMapCompass.cs - 小地图指南针，显示玩家朝向和方向指示
• MiniMapSettings.cs - 小地图设置，管理小地图的配置和场景映射
• PointsOfInterests.cs - 兴趣点系统，管理地图上的各种兴趣点标记
• SimplePointOfInterest.cs - 简单兴趣点实现，提供基础的兴趣点功能

核心游戏系统

天气系统文件夹，处理游戏中的天气变化和效果。

核心游戏系统

CameraArm.cs

摄像机臂组件，控制第三人称摄像机的位置、角度和距离，支持俯视视角切换。

CameraMode.cs

摄像机模式控制器，管理游戏中的摄像机模式切换（如正常模式和摄影模式）。

CameraShaker.cs

摄像机震动效果，处理爆炸、冲击等场景中的摄像机震动。

Carriable.cs

可携带物品基类，定义可以被角色拾取和携带的物品行为。

CharacterMainControl.cs

角色主控制器，是游戏中最核心的组件之一，管理角色的所有基本行为，包括移动、攻击、使用物品、装备管理等。

Duckov.Quests/

• Quest.cs - 任务系统核心类，定义任务基本属性和状态
• QuestManager.cs - 任务管理器，控制任务的激活、完成和追踪
• QuestTask_BubblePopper_Level.cs - 泡泡射击关卡任务
• QuestTask_GoldMiner_Level.cs - 金矿挖掘关卡任务
• QuestTask_Snake_Score.cs - 贪吃蛇得分任务
• QuestTask_UnlockBeacon.cs - 解锁信标任务
• QuestGiver.cs - 任务发布者，负责分配任务给玩家
• Condition.cs - 任务条件类，定义任务完成条件
• Reward.cs - 任务奖励系统
• Task.cs - 任务子任务基类

Duckov.Scenes/

• MultiSceneCore.cs - 多场景核心管理器，负责主场景和子场景的加载、卸载和切换，处理场景间传送和场景状态管理
• MultiSceneLocation.cs - 多场景位置结构体，定义场景中的特定位置点，用于场景间传送定位
• MultiSceneTeleporter.cs - 多场景传送器，实现场景间的传送功能，包含传送冷却时间和传送动画
• SceneIDAttribute.cs - 场景ID属性标记，用于标识场景ID字段
• SceneLocationsProvider.cs - 场景位置提供者，管理场景中的位置点，提供位置查询和路径解析功能
• SubSceneEntry.cs - 子场景条目类，定义子场景的基本信息，包括环境音效、室内/室外标识、缓存位置和传送器信息

Duckov.Utilities/

• CommonVariables.cs - 通用变量管理器，提供全局变量存储和访问功能，支持float、int、bool和string类型的数据持久化
• GameplayDataSettings.cs - 游戏数据设置，包含游戏中的各种配置数据，如战利品数据、标签系统、预制体数据等
• LootSpawner.cs - 战利品生成器，负责在游戏世界中生成战利品，支持随机生成和固定生成两种模式
• LootBoxLoader.cs - 战利品箱加载器，处理战利品箱的加载和初始化
• FishSpawner.cs - 鱼类生成器，负责在水中生成鱼类
• SetActiveByPlayerDistance.cs - 根据玩家距离激活/停用对象，优化游戏性能

核心游戏系统

Duckov.Modding/

• ModManager.cs (437行) - 模组管理器，负责游戏模组的加载、激活和卸载。提供模组扫描、排序、优先级设置等功能，支持Steam创意工坊模组集成。使用单例模式管理全局模组状态，支持模组动态加载/卸载，提供模组优先级排序和状态持久化功能。
• ModInfo.cs (27行) - 模组信息结构体，存储模组的元数据信息，包括名称、显示名称、描述、预览图、DLL路径等。支持本地和Steam创意工坊模组的统一信息表示。
• ModBehaviour.cs (30行) - 模组行为基类，所有模组的主类需要继承此类，提供模组生命周期钩子方法。包含OnAfterSetup和OnBeforeDeactivate虚拟方法，允许模组在加载和卸载时执行自定义逻辑。
• SteamWorkshopManager.cs (265行) - Steam创意工坊管理器，处理与Steam创意工坊的交互。实现模组上传、下载、订阅管理功能，处理Steam API调用和模组安装验证。使用Steamworks API进行UGC(用户生成内容)管理，支持异步上传操作，提供上传进度监控和错误处理机制。

Duckov.Options/

• OptionsManager.cs (102行) - 选项管理器，负责管理游戏的各种设置选项。处理鼠标灵敏度、音量、图形设置等配置的保存和加载，提供选项变更事件通知。使用ES3插件进行数据持久化，提供选项变更事件通知，支持自动备份和恢复功能确保数据安全。

游戏管理核心

• GameManager.cs (161行) - 游戏管理器，作为游戏的核心管理类，负责协调所有主要系统。使用单例模式确保全局唯一性，管理音频、UI输入、游戏规则、暂停菜单、场景加载、黑屏、事件系统、玩家输入、夜视、模组管理、笔记索引和成就系统等核心组件。
• LevelManager.cs (726行) - 关卡管理器，负责关卡初始化、角色创建和场景管理。处理主角色和宠物的创建与初始化，管理战利品箱库存，支持多场景位置系统，提供关卡初始化事件通知和异步初始化流程。使用UniTask进行异步操作，支持关卡初始化状态跟踪和注释系统。
• SceneLoader.cs (300行) - 场景加载器，负责场景之间的异步加载和过渡。处理场景加载前的准备工作，管理加载界面和过渡效果，支持多场景位置系统和点击继续功能。使用UniTask进行异步操作，提供加载注释系统和事件通知机制。

UI系统

• UIInputManager.cs (380行) - UI输入管理器，负责处理所有UI相关的输入事件。管理导航、确认、取消、鼠标点击、物品拾取、物品使用、相机模式切换等多种输入操作，提供键盘修饰键状态检测和射线投射功能。使用Unity新输入系统，支持事件驱动的输入处理机制。
• PauseMenu.cs (38行) - 暂停菜单，继承自UIPanel基类，提供游戏暂停界面的显示和隐藏功能。支持静态方法调用，提供显示状态查询和切换功能，是游戏UI系统的基础组件之一。

游戏规则系统

• GameRulesManager.cs (136行) - 游戏规则管理器，负责管理游戏难度和规则设置。处理预设规则集和自定义规则集的加载与保存，支持规则索引选择和规则变更通知。使用单例模式，通过SavesSystem进行数据持久化，提供规则集切换和自定义规则创建功能。

• Ruleset.cs (80行) - 规则集类，定义游戏的各种规则参数。包含对玩家伤害系数、敌人生命值系数、尸体生成、战争迷雾、高级减益模式、后坐力倍数、敌人反应时间、攻击间隔等参数的设置。使用LocalizationKey进行本地化支持，提供显示名称和描述的多语言功能。

• RulesetFile.cs (12行) - 规则集文件类，继承自ScriptableObject，用于在Unity编辑器中创建和存储规则集资源。通过CreateAssetMenu特性支持在Unity菜单中创建新的规则集文件，提供Data属性访问内部的Ruleset数据。

• DifficultySelection.cs (297行) - 难度选择界面，负责游戏难度选择的UI逻辑。处理难度选项的显示、解锁状态检查和选择确认，支持自定义难度创建和难度解锁条件验证。使用PrefabPool管理UI元素，提供本地化支持和异步操作流程。

• RuleEntry_Float.cs (61行) - 浮点数规则条目，负责处理浮点类型游戏规则的UI交互。使用SliderWithTextField组件提供滑块和文本输入功能，通过反射访问Ruleset字段，实现规则值的实时更新和显示。支持自定义规则模式下的值修改，并在非自定义模式下恢复为预设值。

• RuleEntry_Int.cs (61行) - 整数规则条目，负责处理整数类型游戏规则的UI交互。使用SliderWithTextField组件提供滑块和文本输入功能，通过反射访问Ruleset字段，实现规则值的实时更新和显示。支持自定义规则模式下的值修改，并在非自定义模式下恢复为预设值。

• RuleEntry_Bool.cs (45行) - 布尔值规则条目，继承自OptionsProviderBase，负责处理布尔类型游戏规则的UI交互。提供开关选项界面，通过反射访问Ruleset字段，使用本地化文本显示开/关状态，支持规则值的切换和保存。

  玩家系统

• PlayerStorage.cs (242行) - 玩家存储系统，负责管理玩家物品存储和缓冲区。处理物品的添加、合并、保存和加载，支持存储容量动态计算和物品缓冲区管理。使用单例模式，通过UniTask处理异步加载操作，提供事件通知机制，与SavesSystem集成实现数据持久化。

• CharacterMainControl.cs (2263行) - 角色主控制器，管理玩家的核心行为和状态。处理移动、攻击、交互、装备、技能、生命值、体力、能量、水分等所有玩家属性，支持重量状态系统和多种动作状态管理。包含大量属性哈希值用于性能优化，提供武器切换、瞄准、奔跑、冲刺等动作控制，是游戏中最复杂的系统之一，协调玩家角色的所有行为和属性。

  Duckov.Weathers/

• WeatherManager.cs (154行) - 天气管理器，负责控制游戏中的天气系统。处理天气类型（晴天、多云、雨天、风暴）的生成和切换，支持强制天气设置和天气数据持久化。使用单例模式，通过Storm和Precipitation模块计算天气状态，提供缓存机制优化性能，与SavesSystem集成实现天气数据保存和加载。

• Weather.cs (10行) - 天气枚举定义，包含游戏中所有可能的天气类型：晴天(Sunny)、多云(Cloudy)、雨天(Rainy)、一级风暴(Stormy_I)和二级风暴(Stormy_II)。

• Storm.cs (74行) - 风暴系统，管理游戏中的风暴周期和强度。计算风暴等级、风暴ETA(预计到达时间)、风暴剩余百分比，提供多级风暴状态转换逻辑。使用时间偏移量和周期计算实现风暴的自然循环，包含休眠期、一级风暴和二级风暴三个阶段。

• Precipitation.cs (78行) - 降水系统，负责计算游戏中的降水强度和类型。使用柏林噪声算法生成自然的降水模式，支持多云和雨天阈值设置，提供频率、偏移和对比度参数调整。通过时间坐标和种子值确保降水模式的连续性和一致性。

  核心游戏系统

• GameClock.cs (150行) - 游戏时钟系统，负责管理游戏内时间和实际游戏时间。处理游戏内时间流逝、天数计算、时间步进，支持时间缩放和存档时间读取。使用单例模式，通过SavesSystem实现时间数据持久化，提供静态属性访问当前时间、天数、小时、分钟等信息，触发游戏时钟步进事件。

• GameManager.cs (161行) - 游戏管理器单例，负责全局游戏状态管理。包含音频管理、UI输入管理、难度管理、暂停菜单、场景加载、黑屏过渡、事件系统、玩家输入、夜视系统、模组管理、笔记索引和成就系统等核心组件。使用单例模式，通过静态属性提供各子系统访问接口，处理游戏暂停状态和时间穿越检测。

• LevelManager.cs (726行) - 关卡管理器，处理关卡加载、角色创建、出口创建、爆炸效果、角色模型、AI系统、战争迷雾、时间控制、宠物系统和战利品箱等关卡相关功能。使用单例模式，管理关卡初始化流程、角色和宠物的创建与保存、战利品箱库存管理，支持多场景位置和关卡配置。

• Health.cs (465行) - 生命值系统，处理角色的生命值计算、伤害处理、护甲系统、元素抗性和死亡事件。支持不同团队和生命值显示，包含最大生命值和当前生命值属性、身体和头部护甲计算、元素因子（物理、火焰、毒、电、空间）处理、角色缓存和隐藏状态检测。使用事件系统（OnHealthChange、OnMaxHealthChange、OnDeadEvent、OnHurtEvent）通知生命值变化，支持无敌状态和死亡后自动销毁功能。

• Movement.cs (281行) - 角色移动系统，基于ECM2框架实现角色移动控制。处理行走、奔跑、瞄准转向和强制移动等移动状态，包含移动输入处理、速度计算（walkSpeed、runSpeed）、加速度控制（walkAcc、runAcc）和转向速度管理。支持瞄准方向设置、目标点瞄准、地面约束和物理重力影响，提供位置强制设置和移动状态检测（Moving、Running、StandStill）功能。

• InputManager.cs (904行) - 输入管理系统，负责处理玩家输入和设备控制。支持鼠标键盘和触摸设备输入，处理移动、瞄准、奔跑、交互、武器切换、开火、装弹、使用物品等多种输入操作。包含瞄准目标查找、后坐力处理、输入缓冲、输入阻止和输入设备切换等功能。使用Unity新输入系统，提供输入状态检测和输入冷却机制，支持武器槽位哈希值优化和输入事件回调。

• GameCamera.cs (278行) - 游戏摄像机系统，基于Cinemachine实现第三人称摄像机控制。处理摄像机跟随、瞄准视角切换、FOV调整和深度对焦效果。支持正常和边界两种瞄准模式，包含摄像机臂控制、瞄准偏移计算和防晕模式。使用Volume系统处理景深效果，提供摄像机位置更新事件和强制同步功能，与InputManager和CharacterMainControl紧密集成实现流畅的摄像机控制。

• CharacterCreator.cs (35行) - 角色创建系统，负责处理角色实例化和初始化。基于异步UniTask框架实现角色创建流程，包含角色预制体实例化、模型设置、物品装备和基础Buff添加。支持从ItemAssetsCollection异步加载物品实例，处理非突袭地图的基础Buff添加，提供角色创建失败时的资源清理机制。与GameplayDataSettings紧密集成，使用预制体和Buff配置数据。

• CharacterMainControl.cs (2263行) - 角色主控制系统，实现角色的核心功能和状态管理。处理角色移动、攻击、技能、物品使用、装备管理、生命值、体力、能量、水分、食物等全方位角色属性。包含重量状态系统（轻、正常、重、超重、过载）、武器切换、瞄准系统、Buff管理、伤害接收和角色动作控制。使用哈希值优化属性访问，支持团队设置、隐藏状态、角色预设和音频类型配置。与Movement、Health、ItemControl等多个子系统紧密集成，提供完整的角色控制API。

• Buff.cs (229行) - Buff效果系统基类，定义增益/减益效果的核心行为和属性。支持多层叠加、持续时间管理、独占标签系统和特效显示。包含多种Buff类型（出血、饥饿、口渴、重量、中毒、疼痛、电击、燃烧、空间、风暴保护、晕眩等），提供优先级机制处理同类型Buff冲突。使用Effect系统实现Buff效果，支持本地化显示和图标配置，提供Buff生命周期管理（Setup、Update、OutOfTime）和层级变化事件。

• CharacterBuffManager.cs (158行) - 角色Buff管理器，负责处理角色所有Buff的添加、移除和更新逻辑。使用List存储Buff实例，提供只读集合访问接口。支持按ID添加/移除Buff、按标签批量移除、Buff存在性查询和按标签获取Buff。实现独占Buff优先级处理、多层Buff管理和超时自动移除机制。使用事件系统通知Buff添加和移除，提供每帧更新处理Buff状态变化和生命周期管理。