서드파티 도구

전문 개발 스튜디오의 경우, 서드파티 도구를 설정하고 자동화에 투자하는 것이 개발자 생산성을 dramatically 향상시킬 수 있습니다. 로블록스의 클라우드 우선 접근법에는 많은 장점이 있지만, 개발 작업 흐름의 특정 부분을 클라우드 밖으로 이동하면 더 큰 팀이 시간에 따라 변화를 추적하고, 코드를 검토하며, 이미 익숙한 언어와 도구를 사용할 수 있습니다.

• 외부 텍스트 편집기를 사용하거나 코드 버전 관리를 유지하고 싶다면, 스크립트 동기화가 좋은 선택입니다.
• 프로젝트 전체를 로컬 파일 세트로 관리하고 싶다면, 이 페이지는 몇 가지 도구와 전략을 다루고 있습니다.

동기화 문제

본질적으로, 로블록스와 외부 도구를 사용하는 것은 동기화 문제입니다:

• 로블록스 인스턴스를 디스크의 파일로 존재하게 하여 자신이 원하는 도구로 작업할 수 있게 하고 싶습니다.
• 작업을 마친 후, 파일을 다시 로블록스 프로젝트에 가져와야 합니다.
• 그동안 다른 누군가가 동일한 파일을 변경했다면, 충돌을 처리해야 합니다.

전체 솔루션이 원활하고 자동으로 느껴지려면, a) 파일의 변경 사항을 감지하고 b) 이러한 변경 사항을 Studio에 통합해야 합니다.

로블록스의 클라우드 우선 접근법 대신, Rojo는 "파일 시스템 우선" 접근 방식을 허용합니다. 이는 당신의 머신에서 파일을 동기화하기 위해 Studio 플러그인과 통신하는 서버를 실행합니다.

Rokit으로 Rojo 설치하기

Rojo 바이너리를 수동으로 다운로드하고 실행할 수 있지만, 그 접근 방법은 팀의 다른 개발자들이 서로 다른 Rojo 버전을 사용할 위험이 있습니다. 더 나은 솔루션은 설치 및 업그레이드 프로세스를 일관되게 유지하기 위해 리포지토리와 버전 목록을 사용하는 구성 파일을 사용하는 도구 체인 관리자 Rokit을 사용하는 것입니다.

Rokit은 프로젝트 내의 패키지보다는 기본 개발 환경을 관리하기 때문에 nvm보다 npm에 더 가깝지만, 비교가 완벽하지는 않습니다. 간단한 rokit.toml 파일은 다음과 같습니다:

[tools]
rojo = "rojo-rbx/rojo@7.6.1"
wally = "upliftgames/wally@0.3.2"
lune = "lune-org/lune@0.10.4"

그런 다음 rokit install로 이러한 도구를 설치합니다. 글로벌 rokit.toml 파일 외에도 Rokit은 프로젝트별 파일을 지원하므로, 서로 다른 프로젝트에 대해 서로 다른 버전의 Rojo, Wally 또는 기타 도구를 쉽게 사용할 수 있으며 전체 팀이 동일한 버전을 유지할 수 있습니다.

도구가 새 버전을 출시하면, .toml 파일에서 버전 번호를 명시적으로 업데이트하고, Rokit을 사용하여 업그레이드를 수행하고, 새 버전을 테스트한 후 문제가 발생하면 다운그레이드합니다. 명령 및 설치 지침은 Rokit를 참조하십시오.

Rojo 실행하기

Rokit으로 Rojo를 설치한 후, 실제로 설치한 것은 Rojo 서버입니다. 다음 단계는 로블록스 스튜디오용 Rojo 플러그인을 설치하는 것입니다.

크리에이터 스토어에서 설치하거나 다음 명령으로 로컬에 설치할 수 있습니다:

rojo plugin install

그런 다음 새로운 게임의 프로젝트 구조를 생성하고 빌드합니다:

rojo init my-new-experience
cd my-new-experience
rojo build -o my-new-experience.rbxl

또는 기존 게임을 이식할 수 있습니다. 어쨌든 프로젝트를 만든 후, Rojo 서버를 시작합니다:

rojo serve

로블록스 스튜디오에서 방금 빌드한 .rbxl 파일을 열고, Rojo 플러그인을 열고, 이제 실행 중인 서버에 연결합니다. 그 시점부터는 선호하는 텍스트 편집기에서 변경을 시작하고, 이러한 변경이 자동으로 Studio에 동기화되는 것을 볼 수 있습니다.

Rojo 프로젝트는 파일에 대한 특정 명명 요구 사항, 많은 구성 옵션 및 일부 제한이 있으며, 이 모든 것은 Rojo 문서에서 다루어집니다.

패키지 관리자

로블록스에는 강력한 API 세트가 포함되어 있지만, 일관되고 재현 가능한 방식으로 커뮤니티 소프트웨어 패키지를 사용하려면 패키지 관리자가 필요합니다. Wally는 인기 있는 옵션입니다. Rojo처럼 Rokit을 통해 설치할 수 있습니다.

게임의 Rojo 디렉터리 내에서 wally init을 실행합니다. 그런 다음 원하는 패키지를 wally.toml에 추가합니다. 파일은 다음과 같이 보일 수 있습니다:

[package]
name = "my-home-directory/my-new-experience"
version = "0.1.0"
registry = "https://github.com/UpliftGames/wally-index"
realm = "shared"

[dependencies]
react = "jsdotlua/react@17.2.1"
react-roblox = "jsdotlua/react-roblox@17.2.1"
cryo = "phalanxia/cryo@1.0.3"

그런 다음 wally install을 실행합니다. Wally는 Packages 디렉터리를 생성하고 거기에 지정된 패키지를 다운로드합니다. 마지막 단계는 Packages 디렉터리를 Rojo에 추가하여 그 내용이 로블록스로 동기화되도록 하는 것입니다. default.project.json을 열고 경로를 추가합니다. 간단하게 이 예제에서는 모든 패키지가 모든 스크립트에서 사용 가능하도록 ReplicatedStorage에 전체 디렉터리를 추가합니다. 그러나 특정 패키지를 ServerScriptService나 StarterPlayerScripts에 추가하는 것이 더 나을 수 있습니다:

{
  "name": "my-new-experience",
  "tree": {
    "$className": "DataModel",

    "ReplicatedStorage": {
      "Shared": {
        "$path": "src/shared"
      },
      "Packages": {
        "$path": "Packages"
      }
    },

    ...

  }
}

그런 다음 스크립트 내에서 일반 ModuleScript처럼 패키지를 요구할 수 있습니다:

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local React = require(ReplicatedStorage.Packages.react)
local ReactRoblox = require(ReplicatedStorage.Packages["react-roblox"])

local handle = Instance.new("ScreenGui", Players.LocalPlayer.PlayerGui)
local root = ReactRoblox.createRoot(handle)

local helloFrame = React.createElement("TextLabel", {
	Text = "안녕하세요 세상!",
	Size = UDim2.new(0, 200, 0, 200),
	Position = UDim2.new(0.5, 0, 0.5, 0),
	AnchorPoint = Vector2.new(0.5, 0.5),
	BackgroundColor3 = Color3.fromRGB(248, 217, 109),
	Font = Enum.Font.LuckiestGuy,
	TextSize = 24
})

root:render(helloFrame)

대부분의 다른 소프트웨어 프로젝트와 마찬가지로, 목표는 기여자들이 리포지토리를 클론하고 Rokit을 설치하고 몇 가지 명령을 실행하여 팀의 나머지 구성원과 동일한 개발 환경을 갖는 것입니다.

버전 관리

컴퓨터에 일반 텍스트 파일 세트를 보유하면 다양한 기능이 열리지만, 주요 기능은 _버전 관리_입니다. Git 또는 Mercurial 리포지토리에 파일을 저장하고 원격 리포지토리를 호스팅하며 GitHub, GitLab 또는 Bitbucket에서 코드 변경 사항을 검토하고 원하는 텍스트 편집기를 사용할 수 있습니다.

Visual Studio Code 및 Cursor에는 가장 큰 확장 생태계가 있지만, Sublime Text, Notepad++, 및 Vim도 인기 있는 선택입니다. 어떤 편집기를 선택하든, Studio 스크립트 편집기의 기능을 일치시키려면 일부 확장 프로그램이 필요합니다.

다음과 같은 추가를 고려할 수도 있습니다:

• 일반적인 문제를 잡고 코딩 표준을 준수하기 위한 selene와 같은 린터
• StyLua와 같은 코드 포매터
• 자동 완성, 타입 확인 등을 위한 Luau Language Server와 같은 언어 서버
• Studio에 동기화되지 않은 배포된 게임 업데이트 또는 서버 재시작용 스크립트

모든 것을 되돌리기

서드파티 도구가 변경 사항을 로블록스 스튜디오에 동기화하는 방식 때문에, 이 작업 흐름의 어떤 부분에서도 락인이 발생하지 않습니다. 언제든지 이러한 도구 중 하나 또는 모두 사용을 중지하고 Studio에서만 게임을 편집할 수 있습니다. 위험이 없기 때문에 서드파티 도구로 실험하는 것이 특히 매력적입니다.