在Ursina引擎中，为Entity对象设置碰撞体是实现交互和物理模拟的关键一步。默认情况下，当为Entity指定collider='box'时，Ursina会根据模型的边界自动生成一个碰撞箱。然而，在某些场景下，我们可能需要更精细地控制碰撞区域，例如使碰撞箱小于实际模型，以便角色能够更自由地穿梭于密集物体之间。
理解Ursina中的碰撞体
Ursina提供了多种碰撞体类型，其中BoxCollider是最常用的一种。当我们需要自定义碰撞箱的尺寸和位置时，直接使用BoxCollider类是最佳选择。其构造函数通常接受以下关键参数：
- entity: 碰撞体所依附的Entity对象。
- center: 碰撞箱的中心点，相对于其依附的Entity的局部坐标系。
- size: 碰撞箱的尺寸（长、宽、高），相对于其依附的Entity的局部坐标系。
这是许多初学者常遇到的误区：center和size的值不应直接使用全局坐标或基于全局坐标计算，而应始终考虑其与Entity自身原点的相对关系。
正确设置自定义BoxCollider
假设我们有一个tree类，它继承自Entity，并且我们希望它的碰撞箱比实际模型小，以便玩家可以稍微穿过它们。
首先，在tree类的定义中，我们可以选择不指定默认碰撞体，或者指定一个占位符，因为我们将在实例化时动态设置它。
from ursina import *
from random import randint, random
class tree(Entity):
def __init__(self, position):
super().__init__(
model="Assets/SimpleTree.fbx",
texture="Assets/Treesnow.png",
scale=0.007,
position=position,
double_sided=True,
# 初始时不指定collider，或指定一个通用类型，后续再精确设置
# collider='box' # 移除或注释掉此行，以便后续自定义
)接下来，在生成树的循环中，我们实例化tree对象后，再为其分配一个自定义的BoxCollider。关键在于center和size的设置。
- center: 如果我们希望碰撞箱的中心与Entity的局部原点对齐，那么center应该设置为Vec3(0,0,0)。如果模型原点不在底部中心，或者需要偏移，则根据实际情况调整。
- size: size应该是一个Vec3，表示碰撞箱在X、Y、Z轴上的尺寸。这些尺寸是相对于Entity的局部比例和模型大小而言的。例如，如果树的Y轴高度为6单位（在模型空间中），我们希望碰撞箱的高度也为6，宽度为2，则size为Vec3(2, 6, 2)。
以下是修正后的代码示例：
# 假设 player 已经定义
player = Entity(model='cube', collider='box', position=(0,0,0))
app = Ursina() # 确保 Ursina 应用已初始化
# ----- RANDOM TREE SPAWN ----
for i in range(-100, 100, 10):
for j in range(-100, 100, 10):
chance = random()
# 避免在玩家初始位置生成树
if abs(i - player.position[0]) < 10 and abs(j - player.position[2]) < 10:
chance = 0
if chance > 0.5:
# small offset to prevent grid-like placement
spawnTree = tree(position=(i + randint(2, 6), 0, j + randint(2, 6)))
# 正确设置自定义 BoxCollider
# center 设为 Vec3(0,0,0) 表示碰撞箱中心与树的局部原点对齐
# size 根据树模型和期望的碰撞效果进行调整
# 假设树模型在局部Y轴高度为6，我们希望碰撞箱宽度为2，高度为6，深度为2
spawnTree.collider = BoxCollider(spawnTree, center=Vec3(0, 3, 0), size=Vec3(2, 6, 2))
# 注意：这里的 center Y 轴设为 3，是因为通常模型原点在底部，
# 而碰撞箱的中心点应该在碰撞箱的几何中心，对于高度为6的碰撞箱，中心点在Y轴3的位置。
# 如果模型原点在中心，则 center Y 轴为 0。在上面的示例中，spawnTree.collider = BoxCollider(spawnTree, center=Vec3(0, 3, 0), size=Vec3(2, 6, 2)) 实现了以下效果：
- center=Vec3(0, 3, 0)：将碰撞箱的中心设置在树的局部X和Z轴原点，并在Y轴上向上偏移3个单位。这是因为通常模型原点在底部，而一个高度为6的碰撞箱，其中心点应该在高度的一半处。
- size=Vec3(2, 6, 2)：定义了一个宽度为2、高度为6、深度为2的碰撞箱。这个尺寸是相对于spawnTree的局部空间而言的。
关键调试技巧：可视化碰撞体
Ursina提供了一个非常实用的调试功能，可以帮助我们直观地看到碰撞体的实际形状和位置。在游戏运行时，连续按两次 F10 键，即可切换碰撞体的可视化模式。这将以线框或实心颜色显示所有活动的碰撞体，从而可以轻松地调整center和size参数，直到达到理想的碰撞效果。
注意事项与最佳实践
- 相对坐标理解： 始终牢记center和size是相对于Entity的局部坐标系。这意味着无论Entity在世界中的位置如何，其碰撞体的center和size定义都是一致的。
- 模型原点： 不同的3D模型可能具有不同的原点（pivot point）。有些模型原点在底部中心，有些在几何中心。这会影响BoxCollider的center参数设置。如果模型原点在底部，且碰撞箱需要覆盖整个模型高度，那么center的Y分量通常是size的Y分量的一半。
- 性能考量： 尽管Ursina的碰撞系统效率很高，但过多的复杂碰撞体仍可能影响性能。尽可能使用最简单的碰撞体形状来满足需求。对于复杂的模型，使用简单的BoxCollider或SphereCollider作为近似碰撞体通常是更好的选择。
- 动态调整： 如果需要在运行时动态改变碰撞体，可以直接修改entity.collider.center和entity.collider.size属性。
总结
通过本教程，我们学习了如何在Ursina引擎中为Entity对象精确设置自定义BoxCollider。理解center和size参数的相对性是关键，它们允许我们脱离模型的默认边界，创建符合游戏逻辑的碰撞区域。结合F10调试工具的可视化功能，开发者可以高效地调整碰撞体，确保游戏中的交互行为准确无误。掌握这些技巧将使您在Ursina项目中拥有更强大的碰撞检测控制能力。
