duckov/duckovMod
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init a bigInjectbag project

Browse Source
This commit is contained in:
wolves
2025-10-22 02:09:18 +08:00
parent 2a79a885eb
commit 6915ad54ba
9 changed files with 828 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
.gitignore vendored
View File

@@ -3,3 +3,5 @@
**/.vscode/
decompile/
.trae

318
README.md
View File

@@ -105,4 +105,320 @@ 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状态变化和生命周期管理。

15
dev.md Normal file
View File

@@ -0,0 +1,15 @@
# 开发日志
## 知识类
## 物品详情展示
[ItemDetailsDisplay](decompile\Duckov.UI\ItemDetailsDisplay.cs)
- 支持两个容器
- 槽位 - 类似于枪械上的装备
- Inventory - 容器的物品库存
- item 详细信息获取
- [ItemDetailCatch](history\ItemDetailCatch.cs)
- 可以通过这种方式获取物品的详细信息
## MOD开发
### better 针包

156
dev/137黄针.md Normal file
View File

@@ -0,0 +1,156 @@
# 物品ID 137 - 黄针 详细分析
## 基本信息
- **物品ID**: 137
- **显示名称**: 黄针
- **原始名称**: Item_Injection_A
- **描述**: 提升25%移动速度，持续120秒
- **标签**: 注射器, 医疗用品
- **图标**: Injection_A
## 物理属性
- **重量**: 0.2 (单个) / 0.4 (当前总重量)
- **堆叠数量**: 2/3 (当前数量/最大堆叠数)
- **价值**: 629
- **品质**: 3
- **可堆叠**: 是
- **可出售**: 是
- **可丢弃**: 是
## 使用属性
- **使用时间**: 1秒
- **使用工具**: Injection_A(Clone) (ItemStatsSystem.UsageUtilities)
- **耐久系统**: 无 (UseDurability: False)
- **当前状态**: 已检查 (Inspected: True)
## 容器信息
- **所属库存**: Character(Clone) (ItemStatsSystem.Inventory)
- **父物品**: Item_Character (物品)
- **插入插槽**: 无 (PluggedIntoSlot: null)
## 效果系统
- **效果列表**: System.Collections.Generic.List`1[ItemStatsSystem.Effect]
- **统计信息**: 无 (Stats: null)
- **修饰符**: 无 (Modifiers: null)
- **插槽**: 无 (Slots: null)
## 游戏对象信息
- **游戏对象名称**: Injection_A(Clone)
- **标签**: Untagged
- **激活状态**: 已激活 (isActiveAndEnabled: True)
- **音频键**: default
## 原始数据
- 名称域
```text
=== 物品ID 137 的详细信息 ===
字段信息:
System.Int32 typeID: 137
System.Int32 order: 3
System.String displayName: Item_Injection_A
UnityEngine.Sprite icon: Injection_A (UnityEngine.Sprite)
System.Int32 maxStackCount: 3
System.Int32 value: 629
System.Int32 quality: 3
ItemStatsSystem.DisplayQuality displayQuality: None
System.Single weight: 0.2
System.Single _cachedWeight: 0.4
System.Nullable`1[System.Single] _cachedTotalWeight: 0.4
System.Int32 handheldHash: -23898676
Duckov.Utilities.TagCollection tags: Duckov.Utilities.TagCollection
ItemStatsSystem.ItemAgentUtilities agentUtilities: ItemStatsSystem.ItemAgentUtilities
ItemGraphicInfo itemGraphic: null
ItemStatsSystem.StatCollection stats: null
ItemStatsSystem.Items.SlotCollection slots: null
ItemStatsSystem.ModifierDescriptionCollection modifiers: null
Duckov.Utilities.CustomDataCollection variables: Duckov.Utilities.CustomDataCollection
Duckov.Utilities.CustomDataCollection constants: Duckov.Utilities.CustomDataCollection
ItemStatsSystem.Inventory inventory: null
System.Collections.Generic.List`1[ItemStatsSystem.Effect] effects: System.Collections.Generic.List`1[ItemStatsSystem.Effect]
ItemStatsSystem.UsageUtilities usageUtilities: Injection_A(Clone) (ItemStatsSystem.UsageUtilities)
ItemStatsSystem.Items.Slot pluggedIntoSlot: null
ItemStatsSystem.Inventory inInventory: Character(Clone) (ItemStatsSystem.Inventory)
System.Action`1[ItemStatsSystem.Item] onItemTreeChanged: null
System.Action`1[ItemStatsSystem.Item] onDestroy: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onSetStackCount: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onDurabilityChanged: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onInspectionStateChanged: System.Action`1[ItemStatsSystem.Item]
System.Action`2[ItemStatsSystem.Item,System.Object] onUse: null
System.Action`1[ItemStatsSystem.Item] onChildChanged: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onParentChanged: null
System.Action`1[ItemStatsSystem.Item] onPluggedIntoSlot: null
System.Action`1[ItemStatsSystem.Item] onUnpluggedFromSlot: null
System.Action`2[ItemStatsSystem.Item,ItemStatsSystem.Items.Slot] onSlotContentChanged: null
System.Action`1[ItemStatsSystem.Item] onSlotTreeChanged: null
System.Boolean initialized: True
System.Boolean _inspecting: False
System.String soundKey:
System.Boolean isBeingDestroyed: False
属性信息:
System.Int32 TypeID: 137
System.Int32 Order: 3
System.String DisplayName: 黄针
System.String DisplayNameRaw: Item_Injection_A
System.String description: Item_Injection_A_Desc
System.String DescriptionRaw: Item_Injection_A_Desc
System.String Description: 提升25%移动速度，持续120s。
UnityEngine.Sprite Icon: Injection_A (UnityEngine.Sprite)
System.String MaxStackCountSuffixLabel: 可堆叠
System.Int32 MaxStackCount: 3
System.Boolean Stackable: True
System.Int32 Value: 629
System.Int32 Quality: 3
ItemStatsSystem.DisplayQuality DisplayQuality: None
System.Single UnitSelfWeight: 0.2
System.Single SelfWeight: 0.4
System.Boolean Sticky: False
System.Boolean CanBeSold: True
System.Boolean CanDrop: True
System.Single TotalWeight: 0.4
System.Boolean HasHandHeldAgent: False
System.String TagsLabelText: Tags: 注射器, 医疗用品
ItemStatsSystem.ItemAgentUtilities AgentUtilities: ItemStatsSystem.ItemAgentUtilities
ItemStatsSystem.ItemAgent ActiveAgent: null
ItemGraphicInfo ItemGraphic: null
System.String StatsTabLabelText: No Stats
System.String SlotsTabLabelText: No Slots
System.String ModifiersTabLabelText: No Modifiers
ItemStatsSystem.UsageUtilities UsageUtilities: Injection_A(Clone) (ItemStatsSystem.UsageUtilities)
System.Single UseTime: 1
ItemStatsSystem.StatCollection Stats: null
ItemStatsSystem.ModifierDescriptionCollection Modifiers: null
ItemStatsSystem.Items.SlotCollection Slots: null
ItemStatsSystem.Inventory Inventory: null
System.Collections.Generic.List`1[ItemStatsSystem.Effect] Effects: System.Collections.Generic.List`1[ItemStatsSystem.Effect]
ItemStatsSystem.Items.Slot PluggedIntoSlot: null
ItemStatsSystem.Inventory InInventory: Character(Clone) (ItemStatsSystem.Inventory)
ItemStatsSystem.Item ParentItem: Item_Character (物品)
UnityEngine.Object ParentObject: Character(Clone) (ItemStatsSystem.Inventory)
Duckov.Utilities.TagCollection Tags: Duckov.Utilities.TagCollection
Duckov.Utilities.CustomDataCollection Variables: Duckov.Utilities.CustomDataCollection
Duckov.Utilities.CustomDataCollection Constants: Duckov.Utilities.CustomDataCollection
System.Boolean IsCharacter: False
System.Int32 StackCount: 2
System.Boolean UseDurability: False
System.Single MaxDurability: 0
System.Single MaxDurabilityWithLoss: 0
System.Single DurabilityLoss: 0
System.Single Durability: 0
System.Boolean Inspected: True
System.Boolean Inspecting: False
System.Boolean NeedInspection: False
System.Boolean IsBeingDestroyed: False
System.Boolean Repairable: False
System.String SoundKey: default
System.Threading.CancellationToken destroyCancellationToken: System.Threading.CancellationToken
System.Boolean useGUILayout: True
System.Boolean enabled: True
System.Boolean isActiveAndEnabled: True
UnityEngine.Transform transform: Injection_A(Clone) (UnityEngine.Transform)
UnityEngine.GameObject gameObject: Injection_A(Clone) (UnityEngine.GameObject)
System.String tag: Untagged
System.String name: Injection_A(Clone)
UnityEngine.HideFlags hideFlags: None
=== 物品ID 137 信息结束 ===
```

111
dev/882注射器收纳包.md Normal file
View File

@@ -0,0 +1,111 @@
```text
=== 物品ID 882 的详细信息 ===
字段信息:
System.Int32 typeID: 882
System.Int32 order: 0
System.String displayName: Item_InjectionBag
UnityEngine.Sprite icon: Pfb_Injectors (UnityEngine.Sprite)
System.Int32 maxStackCount: 1
System.Int32 value: 29765
System.Int32 quality: 9
ItemStatsSystem.DisplayQuality displayQuality: None
System.Single weight: 0.5
System.Single _cachedWeight: 0.5
System.Nullable`1[System.Single] _cachedTotalWeight: 1.53
System.Int32 handheldHash: -23898676
Duckov.Utilities.TagCollection tags: Duckov.Utilities.TagCollection
ItemStatsSystem.ItemAgentUtilities agentUtilities: ItemStatsSystem.ItemAgentUtilities
ItemGraphicInfo itemGraphic: null
ItemStatsSystem.StatCollection stats: null
ItemStatsSystem.Items.SlotCollection slots: InjectionBag(Clone) (ItemStatsSystem.Items.SlotCollection)
ItemStatsSystem.ModifierDescriptionCollection modifiers: null
Duckov.Utilities.CustomDataCollection variables: Duckov.Utilities.CustomDataCollection
Duckov.Utilities.CustomDataCollection constants: Duckov.Utilities.CustomDataCollection
ItemStatsSystem.Inventory inventory: null
System.Collections.Generic.List`1[ItemStatsSystem.Effect] effects: System.Collections.Generic.List`1[ItemStatsSystem.Effect]
ItemStatsSystem.UsageUtilities usageUtilities: null
ItemStatsSystem.Items.Slot pluggedIntoSlot: null
ItemStatsSystem.Inventory inInventory: PetProxy (ItemStatsSystem.Inventory)
System.Action`1[ItemStatsSystem.Item] onItemTreeChanged: null
System.Action`1[ItemStatsSystem.Item] onDestroy: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onSetStackCount: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onDurabilityChanged: System.Action`1[ItemStatsSystem.Item]
System.Action`1[ItemStatsSystem.Item] onInspectionStateChanged: System.Action`1[ItemStatsSystem.Item]
System.Action`2[ItemStatsSystem.Item,System.Object] onUse: null
System.Action`1[ItemStatsSystem.Item] onChildChanged: null
System.Action`1[ItemStatsSystem.Item] onParentChanged: null
System.Action`1[ItemStatsSystem.Item] onPluggedIntoSlot: null
System.Action`1[ItemStatsSystem.Item] onUnpluggedFromSlot: null
System.Action`2[ItemStatsSystem.Item,ItemStatsSystem.Items.Slot] onSlotContentChanged: null
System.Action`1[ItemStatsSystem.Item] onSlotTreeChanged: null
System.Boolean initialized: True
System.Boolean _inspecting: False
System.String soundKey:
System.Boolean isBeingDestroyed: False
属性信息:
System.Int32 TypeID: 882
System.Int32 Order: 0
System.String DisplayName: 注射器收纳包
System.String DisplayNameRaw: Item_InjectionBag
System.String description: Item_InjectionBag_Desc
System.String DescriptionRaw: Item_InjectionBag_Desc
System.String Description: 可以装6种针，用的时候需要把针拿出来。
UnityEngine.Sprite Icon: Pfb_Injectors (UnityEngine.Sprite)
System.String MaxStackCountSuffixLabel: 不可堆叠
System.Int32 MaxStackCount: 1
System.Boolean Stackable: False
System.Int32 Value: 29765
System.Int32 Quality: 9
ItemStatsSystem.DisplayQuality DisplayQuality: None
System.Single UnitSelfWeight: 0.5
System.Single SelfWeight: 0.5
System.Boolean Sticky: False
System.Boolean CanBeSold: True
System.Boolean CanDrop: True
System.Single TotalWeight: 1.53
System.Boolean HasHandHeldAgent: False
System.String TagsLabelText: Tags: 医疗用品, 容器
ItemStatsSystem.ItemAgentUtilities AgentUtilities: ItemStatsSystem.ItemAgentUtilities
ItemStatsSystem.ItemAgent ActiveAgent: null
ItemGraphicInfo ItemGraphic: null
System.String StatsTabLabelText: No Stats
System.String SlotsTabLabelText: Slots(6)
System.String ModifiersTabLabelText: No Modifiers
ItemStatsSystem.UsageUtilities UsageUtilities: null
System.Single UseTime: 0
ItemStatsSystem.StatCollection Stats: null
ItemStatsSystem.ModifierDescriptionCollection Modifiers: null
ItemStatsSystem.Items.SlotCollection Slots: InjectionBag(Clone) (ItemStatsSystem.Items.SlotCollection)
ItemStatsSystem.Inventory Inventory: null
System.Collections.Generic.List`1[ItemStatsSystem.Effect] Effects: System.Collections.Generic.List`1[ItemStatsSystem.Effect]
ItemStatsSystem.Items.Slot PluggedIntoSlot: null
ItemStatsSystem.Inventory InInventory: PetProxy (ItemStatsSystem.Inventory)
ItemStatsSystem.Item ParentItem: null
UnityEngine.Object ParentObject: PetProxy (ItemStatsSystem.Inventory)
Duckov.Utilities.TagCollection Tags: Duckov.Utilities.TagCollection
Duckov.Utilities.CustomDataCollection Variables: Duckov.Utilities.CustomDataCollection
Duckov.Utilities.CustomDataCollection Constants: Duckov.Utilities.CustomDataCollection
System.Boolean IsCharacter: False
System.Int32 StackCount: 1
System.Boolean UseDurability: False
System.Single MaxDurability: 0
System.Single MaxDurabilityWithLoss: 0
System.Single DurabilityLoss: 0
System.Single Durability: 0
System.Boolean Inspected: True
System.Boolean Inspecting: False
System.Boolean NeedInspection: False
System.Boolean IsBeingDestroyed: False
System.Boolean Repairable: False
System.String SoundKey: default
System.Threading.CancellationToken destroyCancellationToken: System.Threading.CancellationToken
System.Boolean useGUILayout: True
System.Boolean enabled: True
System.Boolean isActiveAndEnabled: True
UnityEngine.Transform transform: InjectionBag(Clone) (UnityEngine.Transform)
UnityEngine.GameObject gameObject: InjectionBag(Clone) (UnityEngine.GameObject)
System.String tag: Untagged
System.String name: InjectionBag(Clone)
UnityEngine.HideFlags hideFlags: None
=== 物品ID 882 信息结束 ===
```

80
history/ItemDetailCatch.cs Normal file
View File

@@ -0,0 +1,80 @@
using HarmonyLib;
using ItemStatsSystem;
using System.Reflection;
using UnityEngine;
namespace test
{
/// <summary>
/// ItemDetailsDisplay的Harmony补丁
/// 为Setup方法添加后缀方法，在控制台输出激活文本和Item对象的ID
/// </summary>
[HarmonyPatch(typeof(Duckov.UI.ItemHoveringUI))]
[HarmonyPatch("SetupRegisteredInfo")]
public class ItemDetailsCatchPatch
{
/// <summary>
/// Setup方法的后缀补丁，在原始方法执行后调用
/// </summary>
/// <param name="__instance">ItemDetailsDisplay实例</param>
/// <param name="item">设置的Item对象</param>
[HarmonyPostfix]
static void Postfix(Duckov.UI.ItemDetailsDisplay __instance, Item item)
{
if (item != null)
{
// 检查是否是ID为882的物品
if (item.TypeID == 882)
{
Debug.Log("=== 物品ID 882 的详细信息 ===");
// 获取Item类的所有字段和属性
BindingFlags flags = BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance;
FieldInfo[] fields = typeof(Item).GetFields(flags);
PropertyInfo[] properties = typeof(Item).GetProperties(flags);
Debug.Log("字段信息:");
foreach (FieldInfo field in fields)
{
try
{
object value = field.GetValue(item);
string valueStr = value != null ? value.ToString() : "null";
Debug.Log($" {field.FieldType} {field.Name}: {valueStr}");
}
catch (System.Exception e)
{
Debug.Log($" {field.FieldType} {field.Name}: [获取失败] {e.Message}");
}
}
Debug.Log("属性信息:");
foreach (PropertyInfo property in properties)
{
try
{
if (property.GetIndexParameters().Length == 0) // 确保不是索引器属性
{
object value = property.GetValue(item);
string valueStr = value != null ? value.ToString() : "null";
Debug.Log($" {property.PropertyType} {property.Name}: {valueStr}");
}
}
catch (System.Exception e)
{
Debug.Log($" {property.PropertyType} {property.Name}: [获取失败] {e.Message}");
}
}
Debug.Log("=== 物品ID 882 信息结束 ===");
}
else
{
// 对于其他物品，只显示基本信息
string activationText = $"displayPatch激活 Item ID: {item.TypeID}";
Debug.Log(activationText);
}
}
}
}
}

58
history/harmonyTemplate.cs Normal file
View File

@@ -0,0 +1,58 @@
using HarmonyLib;
using UnityEngine;
namespace test
{
/// <summary>
/// 基础模板
/// 继承自Duckov.Modding.ModBehaviour
/// </summary>
public class ModBehaviour : Duckov.Modding.ModBehaviour
{
private Harmony harmony;
/// <summary>
/// 模组初始化时调用，类似于构造函数
/// </summary>
void Awake()
{
// 初始化Harmony实例
harmony = new Harmony("com.test.itemdetailsdisplay");
// 应用所有Harmony补丁
harmony.PatchAll();
Debug.Log("Test模组已加载，ItemDetailsDisplay补丁已应用");
}
/// <summary>
/// 模组销毁时调用，用于清理资源
/// </summary>
void OnDestroy()
{
// 卸载所有Harmony补丁
harmony?.UnpatchAll();
}
void OnEnable()
{
// 模组启用时重新应用补丁
if (harmony == null)
{
harmony = new Harmony("com.test.itemdetailsdisplay");
harmony.PatchAll();
}
}
/// <summary>
/// 模组禁用时调用，取消事件监听器
/// 取消订阅事件，防止在模组禁用后仍然响应事件
/// </summary>
void OnDisable()
{
// 模组禁用时卸载补丁
harmony?.UnpatchAll();
harmony = null;
}
}
}

65
test/InjectionBagSlotPatch.cs Normal file
View File

@@ -0,0 +1,65 @@
using System;
using HarmonyLib;
using ItemStatsSystem;
using ItemStatsSystem.Items;
using UnityEngine;
using System.Reflection;
namespace test
{
/// <summary>
/// 注射器收纳包槽位修改补丁
/// 将注射器收纳包(ID 882)的槽位数量从6个修改为12个
/// </summary>
[HarmonyPatch(typeof(Item))]
[HarmonyPatch("Initialize")]
public class InjectionBagSlotPatch
{
private const int InjectionBagTypeID = 882;
/// <summary>
/// Initialize方法的后缀补丁
/// 在物品初始化后检查是否是注射器收纳包
/// 槽位默认6个，变为12个
/// </summary>
/// <param name="__instance">Item实例</param>
[HarmonyPostfix]
static void Postfix(Item __instance)
{
Debug.Log($"[注射器收纳包修改] 被调用");
// 检查是否是注射器收纳包
if (__instance == null || __instance.TypeID != InjectionBagTypeID || __instance.Slots == null)
return;
// 获取槽位集合
SlotCollection slots = __instance.Slots;
if (slots.Count == 12)
return;
// 获取原始槽位数量
int originalSlotCount = slots.Count;
// 添加6个新的槽位
for (int i = 0; i < 6; i++)
{
// 创建新的Slot对象
Slot newSlot = (Slot)typeof(Slot).GetConstructor(new Type[0])?.Invoke(null);
// 设置Slot的Key属性
typeof(Slot).GetField("Key", BindingFlags.Public | BindingFlags.Instance)?.SetValue(newSlot, $"Slot_{originalSlotCount + i}");
// 添加到槽位列表
slots.list.Add(newSlot);
// 初始化Slot
typeof(Slot).GetMethod("Initialize", BindingFlags.Public | BindingFlags.Instance)?.Invoke(newSlot, new object[] { slots });
}
// 重建字典缓存
typeof(SlotCollection).GetMethod("BuildDictionary", BindingFlags.NonPublic | BindingFlags.Instance)?.Invoke(slots, null);
Debug.Log($"[注射器收纳包修改] 已将物品ID {__instance.TypeID} 的槽位数量从{originalSlotCount}修改为{slots.Count}");
}
}
}

32
test/ModBehaviour.cs
View File

@@ -1,20 +1,28 @@

using HarmonyLib;
using UnityEngine;
namespace test
{
/// <summary>
/// test模组的主要行为类
/// 继承自Duckov.Modding.ModBehaviour，用于在游戏UI中显示物品价值
/// 基础模板
/// 继承自Duckov.Modding.ModBehaviour
/// </summary>
public class ModBehaviour : Duckov.Modding.ModBehaviour
{
private Harmony harmony;
/// <summary>
/// 模组初始化时调用，类似于构造函数
/// </summary>
void Awake()
{
// 初始化Harmony实例
harmony = new Harmony("com.test.all.patches");
// 应用所有Harmony补丁
harmony.PatchAll();
Debug.Log("Test模组已加载，所有补丁已应用");
}
/// <summary>
@@ -22,12 +30,18 @@ namespace test
/// </summary>
void OnDestroy()
{
// 卸载所有Harmony补丁
harmony?.UnpatchAll();
}
void OnEnable()
{
// 模组启用时重新应用补丁
if (harmony == null)
{
harmony = new Harmony("com.test.all.patches");
harmony.PatchAll();
}
}
/// <summary>
@@ -36,7 +50,9 @@ namespace test
/// </summary>
void OnDisable()
{
// 模组禁用时卸载补丁
harmony?.UnpatchAll();
harmony = null;
}
}
}