PhysicsService
PhysicsService : Instance
Overview
PhysicsService는 물리 연산에서 객체 간 충돌 규칙을 세밀하게 제어하는 서비스로, 충돌 그룹을 생성하고 각 그룹 간의 상호작용 여부를 설정할 수 있습니다.
예를 들어, 플레이어의 레벨에 따라 특정 벽을 통과할 수 있도록 설정하는 방식으로 활용할 수 있습니다.
Properties
Methods
CollisionGroupSetCollidable
지정한 두 충돌 그룹이 서로 충돌할 수 있을지 여부를 결정합니다.
등록되지 않은 그룹에 설정을 시도하면 오류가 발생하므로, IsCollisionGroupRegistered() 메서드를 사용해 각 그룹의 존재 여부를 먼저 확인하는 것이 좋습니다.
Parameters
string Group1
충돌 그룹1의 이름입니다.
string Group2
충돌 그룹2의 이름입니다.
bool bCollidable
그룹 간 충돌 여부입니다.
Return
void
Code Samples
local Part = script.Parent
local PhysicsService = game:GetService("PhysicsService")
local DefaultGroup = "Default"
local GroupA = "GroupA"
PhysicsService:RegisterCollisionGroup(GroupA)
Part.CollisionGroup = GroupA
local collidable = false
PhysicsService:CollisionGroupSetCollidable(DefaultGroup, GroupA, collidable)CollisionGroupsAreCollidable
두 충돌 그룹 간의 충돌 가능 여부를 확인하는 기능을 제공합니다.
Parameters
string Group1
충돌 그룹1의 이름입니다.
string Group2
충돌 그룹2의 이름입니다.
Return
bool
Code Samples
GetMaxCollisionGroups
물리 엔진에서 동시에 생성할 수 있는 충돌 그룹의 최대 개수를 반환합니다.
현재 제한은 17개이며, 이를 초과하여 그룹을 만들 수 없으므로 복잡한 충돌 규칙을 설계할 때는 그룹 수를 효율적으로 관리하는 것이 중요합니다.
Parameters
Return
Value
생성 가능한 충돌 그룹의 최대 개수입니다.
Code Samples
local PhysicsService = game:GetService("PhysicsService")
print(PhysicsService:GetMaxCollisionGroups())GetRegisteredCollisionGroups
등록된 모든 충돌 그룹을 테이블로 반환합니다.
Parameters
Return
Array
등록된 충돌 그룹의 목록입니다.
Code Samples
local PhysicsService = game:GetService("PhysicsService")
local CollisionGroups = PhysicsService:GetRegisteredCollisionGroups()
print(CollisionGroups)IsCollisionGroupRegistered
특정 충돌 그룹이 등록되어 있는지를 검사합니다.
CollisionGroupSetCollidable() 등 충돌 그룹 설정과 관련된 메서드를 호출하기 전에, 해당 그룹이 등록되어 있는지 확인하여 오류를 방지할 수 있습니다.
Parameters
string Group
검사할 충돌 그룹의 이름입니다.
Return
bool
등록되어있는지 여부입니다.
Code Samples
local PhysicsService = game:GetService("PhysicsService")
local DefaultGroup = "Default"
local IsRegistered = PhysicsService:IsCollisionGroupRegistered(DefaultGroup)
print(IsRegistered)RegisterCollisionGroup
지정한 이름으로 충돌 그룹을 생성합니다.
Default, RootPart, BodyPart, Projectile처럼 이미 등록된 이름은 사용할 수 없습니다.
충돌 그룹 설정은 성능에 영향을 줄 수 있으므로, 런타임에서 생성하기보다는 스튜디오 편집 단계에서 미리 설계해 두고 사용하는 것이 권장됩니다.
Parameters
string Group
등록할 충돌 그룹의 이름입니다.
Return
void
Code Samples
local Part = script.Parent
local PhysicsService = game:GetService("PhysicsService")
local GroupA = "GroupA"
PhysicsService:RegisterCollisionGroup(GroupA)RenameCollisionGroup
지정한 충돌 그룹의 이름을 변경하는 기능으로, 다른 충돌 그룹과의 충돌 설정은 그대로 유지됩니다.
Default, RootPart, BodyPart, Projectile 등 기본 제공되는 충돌 그룹의 이름은 변경할 수 없습니다.
이름 변경은 성능에 영향을 줄 수 있으므로, 런타임에서 수정하기보다는 스튜디오 편집 단계에서 미리 설계해 두고 사용하는 것이 권장됩니다.
Parameters
string FromGroup
이름을 변경할 충돌 그룹의 이름입니다.
string ToGroup
변경할 이름입니다.
Return
void
Code Samples
local PhysicsService = game:GetService("PhysicsService")
local GroupA = "GroupA"
local NewName = "GroupNewName"
PhysicsService:RenameCollisionGroup(GroupA, NewName)UnregisterCollisionGroup
지정한 충돌 그룹을 삭제하는 기능으로, 해당 그룹에 속해 있던 파트는 Default로 자동 변경됩니다.
Default, RootPart, BodyPart, Projectile 등 기본 제공되는 충돌 그룹은 삭제할 수 없습니다.
충돌 그룹 삭제는 성능에 영향을 줄 수 있으므로, 런타임에서 삭제하기보다는 스튜디오 편집 단계에서 미리 설계해 두고 사용하는 것이 권장됩니다.
Parameters
string Group
삭제할 충돌 그룹의 이름입니다.
Return
void
Code Samples
local PhysicsService = game:GetService("PhysicsService")
local GroupA = "GroupA"
PhysicsService:UnregisterCollisionGroup(GroupA)Events
See also
Collision GroupsLast updated