# 杂物 **Repository Path**: yang-zhengping-1/miscellaneous-items ## Basic Information - **Project Name**: 杂物 - **Description**: 杂，放置杂物的地方，杂杂杂杂 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-06-15 - **Last Updated**: 2025-09-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## **Block（方块）类属性详解及翻译** 以下是对`Block`类中所有属性的详细解释和翻译： ### **1. 基本属性** | **属性名称** | **类型** | **解释** | **翻译** | |-------------------------------|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------| | BlockIndex | int | 方块的唯一标识符，用于区分不同类型的方块。 | 方块索引 | | DefaultDisplayName | string | 方块的默认显示名称，用于在用户界面中展示。 | 默认显示名称 | | DefaultDescription | string | 方块的默认描述，用于提供有关方块的详细信息。 | 默认描述 | | DefaultCategory | string | 方块的默认分类，用于对不同类型的方块进行分组。 | 默认分类 | | DisplayOrder | int | 方块在用户界面中的显示顺序，数值越小显示越靠前。 | 显示顺序 | | DefaultIconBlockOffset | Vector3 | 方块图标在块坐标系统中的偏移量，用于调整图标的位置。 | 默认图标块偏移量 | | DefaultIconViewOffset | Vector3 | 方块图标在视图坐标系统中的偏移量，用于调整图标在视图中的位置。 | 默认图标视图偏移量 | | DefaultIconViewScale | float | 方块图标的缩放比例，用于调整图标的大小。 | 默认图标视图缩放比例 | | FirstPersonScale | float | 第一人称视角下方块的缩放比例，用于调整方块在第一人称视角中的大小。 | 第一人称缩放比例 | | FirstPersonOffset | Vector3 | 第一人称视角下方块的偏移量，用于调整方块在第一人称视角中的位置。 | 第一人称偏移量 | | InHandScale | float | 方块在手中时的缩放比例，用于调整方块在手中显示的大小。 | 手中缩放比例 | | InHandOffset | Vector3 | 方块在手中时的偏移量，用于调整方块在手中显示的位置。 | 手中偏移量 | | InHandRotation | Vector3 | 方块在手中时的旋转角度，用于调整方块在手中显示的方向。 | 手中旋转角度 | | Behaviors | string | 方块的行为描述，可能包含有关方块交互方式的信息。 | 行为 | | CraftingId | string | 方块的合成标识符，用于关联合成配方。 | 合成标识符 | | DefaultCreativeData | int | 方块在创造模式下的默认数据值，用于确定方块在创造模式中的状态。 | 默认创造模式数据 | | IsCollidable | bool | 方块是否可碰撞，决定玩家和其他实体是否可以与方块发生碰撞。 | 是否可碰撞 | | IsPlaceable | bool | 方块是否可放置，决定玩家是否可以将其放置在世界中。 | 是否可放置 | | IsDiggingTransparent | bool | 方块在挖掘时是否透明，决定挖掘过程中方块是否可见。 | 挖掘时是否透明 | | IsPlacementTransparent | bool | 方块在放置时是否透明，决定放置过程中方块是否可见。 | 放置时是否透明 | | DefaultIsInteractive | bool | 方块是否具有交互性，决定玩家是否可以与方块进行交互，例如打开门或按下按钮。 | 默认是否可交互 | | IsEditable | bool | 方块是否可编辑，决定玩家是否可以修改方块的状态，例如更改告示牌上的文字。 | 是否可编辑 | | IsNonDuplicable | bool | 方块是否不可复制，决定玩家是否可以通过复制粘贴等方式复制方块。 | 是否不可复制 | | IsGatherable | bool | 方块是否可采集，决定玩家是否可以采集方块以获取资源。 | 是否可采集 | | HasCollisionBehavior | bool | 方块是否具有碰撞行为，决定方块在碰撞时是否会发生特定的行为，例如爆炸或触发事件。 | 是否具有碰撞行为 | | KillsWhenStuck | bool | 方块是否会在实体卡住时造成伤害，决定实体卡在方块中时是否会受到伤害。 | 卡住时是否造成伤害 | | IsFluidBlocker | bool | 方块是否阻挡流体，决定流体是否可以穿过方块。 | 是否阻挡流体 | | IsTransparent | bool | 方块是否透明，决定光线是否可以穿过方块。 | 是否透明 | | DefaultShadowStrength | int | 方块的默认阴影强度，用于控制方块投射阴影的强度。 | 默认阴影强度 | | LightAttenuation | int | 光线衰减量，用于控制方块对光线的衰减程度。 | 光线衰减量 | | DefaultEmittedLightAmount | int | 方块发出的默认光量，用于控制方块发出的光线的亮度。 | 默认发出光量 | | ObjectShadowStrength | float | 方块对其他对象投射阴影的强度。 | 对象阴影强度 | | DefaultDropContent | int | 方块被破坏时默认掉落的内容的标识符。 | 默认掉落内容 | | DefaultDropCount | float | 方块被破坏时默认掉落的数量。 | 默认掉落数量 | | DefaultExperienceCount | float | 方块被破坏时给予玩家的默认经验值。 | 默认经验值 | | RequiredToolLevel | int | 破坏方块所需的工具等级，决定玩家需要使用什么等级的工具才能破坏方块。 | 所需工具等级 | | MaxStacking | int | 方块的最大堆叠数量，决定玩家可以将多少个相同的方块堆叠在一起。 | 最大堆叠数量 | | SleepSuitability | float | 方块的睡眠适宜性，用于确定方块是否适合作为床使用。 | 睡眠适宜性 | | FrictionFactor | float | 方块的摩擦系数，用于控制方块表面的摩擦力。 | 摩擦系数 | | Density | float | 方块的密度，用于确定方块的重量和物理特性。 | 密度 | | NoAutoJump | bool | 方块是否禁止自动跳跃，决定玩家是否可以在方块上自动跳跃。 | 是否禁止自动跳跃 | | NoSmoothRise | bool | 方块是否禁止平滑上升，决定玩家是否可以在方块上平滑上升。 | 是否禁止平滑上升 | | DefaultTextureSlot | int | 方块的默认纹理槽位，用于确定方块使用的纹理。 | 默认纹理槽位 | | DestructionDebrisScale | float | 方块破坏时产生的碎片缩放比例，用于控制碎片的大小。 | 破坏碎片缩放比例 | | FuelHeatLevel | float | 方块的燃料热值，用于确定方块作为燃料时的发热量。 | 燃料热值 | | FuelFireDuration | float | 方块作为燃料时的燃烧持续时间。 | 燃烧持续时间 | | DefaultSoundMaterialName | string | 方块的默认声音材质名称，用于确定方块发出的声音类型。 | 默认声音材质名称 | | ShovelPower | float | 方块的铲子力量，用于确定方块被铲子破坏时的破坏力。 | 铲子力量 | | QuarryPower | float | 方块的采石场力量，用于确定方块被采石场设备破坏时的破坏力。 | 采石场力量 | | HackPower | float | 方块的砍伐力量，用于确定方块被砍伐工具破坏时的破坏力。 | 砍伐力量 | | DefaultMeleePower | float | 方块的默认近战力量，用于确定方块作为武器时的攻击力。 | 默认近战力量 | | DefaultMeleeHitProbability | float | 方块作为武器时的默认命中概率。 | 默认近战命中概率 | | DefaultProjectilePower | float | 方块作为投射物时的默认力量，用于确定方块作为投射物时的攻击力。 | 默认投射物力量 | | ToolLevel | int | 方块的工具等级，用于确定方块的强度和可破坏性。 | 工具等级 | | PlayerLevelRequired | int | 使用方块所需的玩家等级，决定玩家需要达到什么等级才能使用方块。 | 所需玩家等级 | | Durability | int | 方块的耐久度，用于确定方块在被破坏前的耐久程度。 | 耐久度 | | DigMethod | strong | 方块的挖掘方法，用于确定方块被挖掘时的行为。 共None,Shovel,Quarry,Hack四种 | 挖掘方法 | ### **2. 方法属性** | **属性名称** | **类型** | **解释** | **翻译** | |-------------------------------|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------| | GetFirstPersonOffset | Vector3 | 获取第一人称视角下方块的偏移量。 | 获取第一人称偏移量 | | GetFirstPersonRotation | Vector3 | 获取第一人称视角下方块的旋转角度。 | 获取第一人称旋转角度 | | GetInHandScale | float | 获取方块在手中时的缩放比例。 | 获取手中缩放比例 | | GetInHandOffset | Vector3 | 获取方块在手中时的偏移量。 | 获取手中偏移量 | | GetInHandRotation | Vector3 | 获取方块在手中时的旋转角度。 | 获取手中旋转角度 | | GetDensity | float | 获取方块的密度。 | 获取密度 | | GetFirstPersonScale | float | 获取第一人称视角下方块的缩放比例。 | 获取第一人称缩放比例 | | GetObjectShadowStrength | float | 获取方块对其他对象投射阴影的强度。 | 获取对象阴影强度 | | GetFuelHeatLevel | float | 获取方块的燃料热值。 | 获取燃料热值 | | GetExplosionResilience | float | 获取方块的爆炸抗性。 | 获取爆炸抗性 | | GetExplosionPressure | float | 获取方块的爆炸压力。 | 获取爆炸压力 | | GetMaxStacking | int | 获取方块的最大堆叠数量。 | 获取最大堆叠数量 | | GetFuelFireDuration | float | 获取方块作为燃料时的燃烧持续时间。 | 获取燃烧持续时间 | | GetProjectileResilience | float | 获取方块对投射物的抗性。 | 获取投射物抗性 | | GetFireDuration | float | 获取方块燃烧的持续时间。 | 获取燃烧持续时间 | | GetProjectileStickProbability | float | 获取方块被投射物击中时的粘附概率。 | 获取投射物粘附概率 | | MatchCrafingId | bool | 判断传入的合成标识符是否与方块的合成标识符匹配。 | 匹配合成标识符 | | GetPlayerLevelRequired | int | 获取使用方块所需的玩家等级。 | 获取所需玩家等级 | | HasCollisionBehavior_ | bool | 判断方块是否具有碰撞行为。 | 判断是否具有碰撞行为 | | GetDisplayName | string | 获取方块的显示名称，根据方块的数据值和语言设置进行动态生成。 | 获取显示名称 | | GetTextureSlotCount | int | 获取方块使用的纹理槽位数量。 | 获取纹理槽位数量 | | IsEditable_ | bool | 判断方块是否可编辑。 | 判断是否可编辑 | | IsAimable_ | bool | 判断方块是否可瞄准。 | 判断是否可瞄准 | | Eat | bool | 判断方块是否可食用。 | 判断是否可食用 | | CanWear | bool | 判断方块是否可以穿戴。 | 判断是否可穿戴 | | GetClothingData | ClothingData | 获取方块的服装数据。 | 获取服装数据 | | GetToolLevel | int | 获取方块的工具等级。 | 获取工具等级 | | IsCollidable_ | bool | 判断方块是否可碰撞。 | 判断是否可碰撞 | | IsTransparent_ | bool | 判断方块是否透明。 | 判断是否透明 | | IsFluidBlocker_ | bool | 判断方块是否阻挡流体。 | 判断是否阻挡流体 | | IsGatherable_ | bool | 判断方块是否可采集。 | 判断是否可采集 | | IsNonDuplicable_ | bool | 判断方块是否不可复制。 | 判断是否不可复制 | | IsPlaceable_ | bool | 判断方块是否可放置。 | 判断是否可放置 | | IsPlacementTransparent_ | bool | 判断方块在放置时是否透明。 | 判断放置时是否透明 | | IsStickable_ | bool | 判断方块是否可粘附。 | 判断是否可粘附 | | GetProjectileSpeed | float | 获取方块作为投射物时的速度。 | 获取投射物速度 | | GetProjectileDamping | float | 获取方块作为投射物时的阻尼系数。 | 获取投射物阻尼系数 | | GetDescription | string | 获取方块的描述，根据方块的数据值和语言设置进行动态生成。 | 获取描述 | | GetFoodType | FoodType | 获取方块的食物类型。 | 获取食物类型 | | GetCategory | string | 获取方块的分类。 | 获取分类 | | GetDigResilience | float | 获取方块的挖掘抗性。 | 获取挖掘抗性 | | GetBlockDigMethod | BlockDigMethod | 获取方块的挖掘方法。 | 获取挖掘方法 | | GetShovelPower | float | 获取方块的铲子力量。 | 获取铲子力量 | | GetQuarryPower | float | 获取方块的采石场力量。 | 获取采石场力量 | | GetHackPower | float | 获取方块的砍伐力量。 | 获取砍伐力量 | | GetCreativeValues | IEnumerable | 获取方块在创造模式下的所有可能的数据值。 | 获取创造模式数据值 | | GetAlignToVelocity | bool | 判断方块是否根据速度对齐。 | 判断是否根据速度对齐 | | IsInteractive | bool | 判断方块是否具有交互性。 | 判断是否具有交互性 | | GetProceduralCraftingRecipes | IEnumerable | 获取方块的程序化合成配方。 | 获取程序化合成配方 | | GetAdHocCraftingRecipe | CraftingRecipe | 获取方块的临时合成配方。 | 获取临时合成配方 | | IsFaceTransparent | bool | 判断方块的某个面是否透明。 | 判断面是否透明 | | ShouldGenerateFace | bool | 判断是否应该生成方块的某个面。 | 判断是否生成面 | | GetShadowStrength | int | 获取方块的阴影强度。 | 获取阴影强度 | | GetFaceTextureSlot | int | 获取方块某个面的纹理槽位。 | 获取面纹理槽位 | | GetSoundMaterialName | string | 获取方块的声音材质名称。 | 获取声音材质名称 | | GenerateTerrainVertices | void | 生成方块的地形顶点。 | 生成地形顶点 | | DrawBlock | void | 绘制方块。 | 绘制方块 | | GetPlacementValue | BlockPlacementData| 获取方块的放置值。 | 获取放置值 | | GetCraftingId | string | 获取方块的合成标识符。 | 获取合成标识符 | | GetDisplayOrder | int | 获取方块的显示顺序。 | 获取显示顺序 | | GetDigValue | BlockPlacementData| 获取方块的挖掘值。 | 获取挖掘值 | | GetRequiredToolLevel | float | 获取破坏方块所需的工具等级。 | 获取所需工具等级 | | GetDropValues | void | 获取方块被破坏时掉落的值。 | 获取掉落值 | | GetDamage | int | 获取方块的当前损伤值。 | 获取损伤值 | | SetDamage | int | 设置方块的损伤值。 | 设置损伤值 | | GetDamageDestructionValue | int | 获取方块的破坏损伤值。 | 获取破坏损伤值 | | GetRotPeriod | int | 获取方块的旋转周期。 | 获取旋转周期 | | GetSicknessProbability | float | 获取方块导致玩家生病的概率。 | 获取生病概率 | | GetMeleePower | float | 获取方块的近战力量。 | 获取近战力量 | | GetMeleeHitProbability | float | 获取方块作为近战武器时的命中概率。 | 获取近战命中概率 | | GetProjectilePower | float | 获取方块作为投射物时的力量。 | 获取投射物力量 | | GetHeat | float | 获取方块的热量。 | 获取热量 | | GetBlockHealth | float | 获取方块的健康值。 | 获取健康值 | | GetDurability | int | 获取方块的耐久度。 | 获取耐久度 | | GetExplosionIncendiary | bool | 判断方块爆炸时是否具有燃烧性。 | 判断爆炸是否具有燃烧性 | | GetIconBlockOffset | Vector3 | 获取方块图标的块坐标偏移量。 | 获取图标块坐标偏移量 | | GetIconViewOffset | Vector3 | 获取方块图标的视图坐标偏移量。 | 获取图标视图坐标偏移量 | | GetIconViewScale | float | 获取方块图标的视图缩放比例。 | 获取图标视图缩放比例 | | CreateDebrisParticleSystem | BlockDebrisParticleSystem | 创建方块破坏时产生的碎片粒子系统。 | 创建碎片粒子系统 | | GetCustomCollisionBoxes | BoundingBox[] | 获取方块的自定义碰撞盒。 | 获取自定义碰撞盒 | | GetCustomInteractionBoxes | BoundingBox[] | 获取方块的自定义交互盒。 | 获取自定义交互盒 | | GetEmittedLightAmount | int | 获取方块发出的光量。 | 获取发出光量 | | GetNutritionalValue | float | 获取方块的食物营养价值。 | 获取食物营养价值 | | ShouldAvoid | bool | 判断方块是否应该被避开。 | 判断是否应该被避开 | | IsSwapAnimationNeeded | bool | 判断是否需要交换动画。 | 判断是否需要交换动画 | | IsHeatBlocker | bool | 判断方块是否阻挡热量。 | 判断是否阻挡热量 | | Raycast | float? | 对方块进行射线投射，返回射线与方块碰撞的距离。 | 对方块进行射线投射 | ### **3. 其他属性** - **BoundingBox[] m_defaultCollisionBoxes**: 方块的默认碰撞盒数组，用于定义方块的碰撞边界。 - **Random Random**: 方块的随机数生成器，用于生成随机数。 - **static string fName**: 方块名称的静态变量，用于错误消息中引用。 - **static BoundingBox[] m_defaultCollisionBoxes**: 方块的默认碰撞盒数组。 ### **4. 注意事项** - **抽象方法**: 一些方法被声明为抽象方法，例如`GenerateTerrainVertices`和`DrawBlock`，这意味着它们必须在子类中实现。这些方法通常用于定义方块的具体行为和外观。 - **虚拟方法**: 许多方法被声明为虚拟方法，例如`GetFirstPersonOffset`和`GetDisplayName`，这意味着它们可以在子类中被重写，以实现特定的功能。 - **枚举类型**: 一些属性使用枚举类型，例如`BlockDigMethod`和`FoodType`，用于定义方块的特定属性和行为。 - **语言控制**: 一些方法使用`LanguageControl`类来获取多语言支持，例如`GetDisplayName`和`GetDescription`，这意味着方块的名称和描述可以根据不同的语言环境进行动态生成。 ## **总结** 该`Block`类定义了一个方块的通用属性和行为，包括其物理特性、交互性、视觉外观、合成信息等。通过继承和重写这些属性和方法，可以创建具有不同功能和特性的各种类型的方块。