Reference읽기 시간: 4분최근 수정: 2026. 4. 14

Tween (WIP)

VivenBehaviour 에서 쓸 수 있는 Position · Rotation · Scale 트윈 메서드 모음. self 대상 버전과 other GameObject 대상 Target 버전이 쌍으로 제공됩니다.

📖
WIP:

본 문서는 작업 중이며, Scale · DoShake · DoPunchScale · DoFillAmount 등 일부 메서드의 세부 시그니처는 공식 API 문서를 참고하세요.

모든 메서드는 self:Method() 형태로 호출하며, Target 접미사 버전은 첫 인자로 다른 GameObject 를 받습니다. 두 번째/세 번째 인자는 이동·회전 값, 마지막 인자는 지속 시간(초) 입니다.

Position

DoMove(Vector3, duration) / DoMoveTarget(other, Vector3, duration)

self:DoMove(Vector3(1, 0, 0), 1)            -- 자기 자신을 (1,0,0) 으로 1초 동안
self:DoMoveTarget(other, Vector3(1, 0, 0), 1) -- other 를 (1,0,0) 으로 1초 동안

축 개별 DoMoveX / Y / Z · DoMoveXTarget / YTarget / ZTarget

self:DoMoveX(10, 1)                 -- 자기 자신 x 축으로 1초 동안 이동
self:DoMoveYTarget(other, 10, 1)    -- other y 축으로 1초 동안 이동

Local 버전 — DoMoveLocal, DoMoveLocalX/Y/Z (+ Target 버전)

transform.localPosition 기준으로 이동합니다. 사용법은 위와 동일.

self:DoMoveLocal(Vector3(1, 0, 0), 1)
self:DoMoveLocalZ(10, 1)

Rotation

DoRotate(Vector3, duration) / DoRotateTarget(other, Vector3, duration)

self:DoRotate(Vector(0, 30, 0), 1)  -- y 축 30도를 1초 동안 회전

축 개별 DoRotateX / Y / Z (+ Target 버전)

self:DoRotateY(30, 1)                -- y 축 30도 1초
self:DoRotateZTarget(other, 30, 1)   -- other z 축 30도 1초

Local 버전 — DoRotateLocal, DoRotateLocalX/Y/Z (+ Target 버전)

transform.localRotation 기준. 사용법은 동일.

Scale

DoScale, DoScaleTarget, DoScaleX, DoScaleXTarget, DoScaleY, DoScaleYTarget, DoScaleZ — 세부 시그니처는 WIP.

기타

세부 옵션(이징, LoopType 등)은 API Reference 에서 확인하세요.