프로젝트 및 에셋

Pyxen은 간단한 파일 기반 프로젝트 모델을 사용합니다. 프로젝트는 기기에 있는 파일입니다. 계정은 선택 사항이며, 꼭 필요한 곳은 없습니다.

.pyxen 형식

Pyxen 프로젝트는 .pyxen 파일입니다. 코드, 이미지, 사운드를 포함하는 ZIP 아카이브입니다. 다음과 같은 작업이 가능합니다:

표준 ZIP이므로, 컴퓨터에서 압축을 풀어 내용을 검사할 수도 있습니다.

프로젝트는 어떤 Pyxen으로 저장되었는지 기억합니다. 더 새로운 Pyxen으로 만든 프로젝트도 열고 실행할 수 있습니다. 처음 열 때 한 번, 새 버전에서 추가된 것은 업데이트하기 전까지 보이지 않거나 작동하지 않을 수 있다고 Pyxen이 알려 줍니다. 거부되는 것은 없습니다.

프로젝트가 있는 곳

저장한 프로젝트는 Pyxen의 폴더에 보관됩니다. Pyxen에 iCloud Drive가 켜져 있으면 iCloud Drive › Pyxen, 아니면 기기 안의 Pyxen 폴더(Mac에서는 나의 Mac › Pyxen, iPad에서는 파일 앱의 나의 iPad › Pyxen)입니다. 어느 쪽인지는 설정 › 일반 › 프로젝트에 나오며, Finder에서 보기(iPad에서는 파일 앱에서 보기)로 열 수 있습니다.

열려 있는 프로젝트는 제목 막대의 프로젝트 이름을 클릭하거나 탭한 뒤 Finder에서 보기(iPad에서는 파일 앱에서 보기)를 선택하거나, 파일 › Finder에서 보기(⌥⌘R)를 선택하세요. 홈에서는 각 프로젝트의 메뉴에 있습니다. 파일 앱은 파일을 선택한 채로 열 수 없어서, iPad에서는 프로젝트가 들어 있는 폴더가 열립니다. 아직 저장하지 않은 프로젝트는 어느 폴더에도 없으므로, 메뉴에 대신 **저장…**이 나옵니다.

다른 곳에 저장했거나 다른 곳에서 연 프로젝트는 그 자리에 그대로 있습니다. Pyxen은 그 프로젝트를 계속하기에 보여 주고 절대 옮기지 않습니다. Pyxen을 체험하는 동안에는 Pyxen 폴더에 있는 프로젝트가 개수에 들어갑니다.

에셋 추가

프로젝트에는 다음을 포함할 수 있습니다:

프로젝트의 README.md와 README.ko.md 같은 번역은 파일 맨 위, 스크립트 위의 읽어보세요 한 줄로 표시됩니다. 사용자의 언어로 페이지를 엽니다. 메뉴에는 다른 언어(다른 언어로 열기)와 파일 자체를 여는 텍스트로 편집이 있습니다.

**파일 › 이미지 또는 사운드 가져오기…**로 에셋을 추가하거나, 파일 › 새 에셋…(파일의 +)으로 만드세요. 추가 후 코드에서 이름으로 참조합니다:

Sprite("hero")       # "hero"라는 이미지 참조
Sound("jump")        # "jump"라는 사운드 참조
Music("overworld")   # "overworld"라는 음악 트랙 참조

새 타일맵

**파일 › 새 에셋…**의 타일맵은 맵을 어떤 타일로 칠할지 묻습니다. 프로젝트의 이미지가 각각 몇 개의 타일이 되는지와 함께 나오고, 이어서 프로젝트가 쓰는 에셋 팩의 이미지가 팩 이름 아래에 나오며, 마지막에 Pyxen 타일이 있습니다. 땅, 벽, 바닥, 문, 과녁, 언덕, 구름, 덤불, 상자로 이루어진 16픽셀 타일 40개이며, 프로젝트의 팔레트로 그려집니다.

새 맵은 프로젝트의 다른 맵이 쓰는 타일로 시작합니다. 없으면 이름에 “tiles”가 들어간 이미지로, 그것도 없으면 Pyxen 타일로 시작합니다. 타일셋에 고른 것이 표시되고, 그 아래 한 줄이 생성이 무엇을 하는지 알려 줍니다.

셀 크기는 고른 것을 따르며, 나중에 바꿀 수도 있습니다. 맵의 맵 설정 › 타일셋에서 나중에 다른 이미지로 연결할 수 있습니다.

에셋 팩

Pyxen은 에셋 팩 — 프로젝트에서 사용할 수 있는 이미지, 사운드, 타일 모음 — 을 포함합니다. 에셋 팩은 .pyxenpack 형식 (역시 ZIP 아카이브)을 사용합니다.

일부 팩은 앱에 포함되어 있습니다. 나머지는 선택할 때 다운로드됩니다. 카드에는 다운로드와 팩 크기가 표시되고, 이 기기에 아직 없는 팩을 사용하는 프로젝트는 파일 목록에서 다운로드를 제안합니다. 다운로드할 수 없으면(예: 오프라인) Pyxen이 알려 주며 프로젝트는 그대로 유지됩니다. Pyxen을 업데이트하지 않아도 새 팩이 나타날 수 있습니다. Pyxen은 시작할 때와 에셋 팩을 열 때 팩 목록을 확인하고, 오프라인일 때는 마지막으로 확인한 목록을 보여 줍니다.

각 팩의 페이지에는 만든 사람과 사용 방법이 나와 있습니다. 대부분의 팩은 퍼블릭 도메인(CC0)이어서 내보낸 게임에서도 자유롭게 사용할 수 있습니다. 크레딧 표기 필요로 표시된 팩은 게임에서 제작자를 밝혀야 합니다. 내보낼 때 Pyxen은 게임이 사용하는 모든 팩의 크레딧을 licenses.txt와 CREDITS.txt에 기록합니다. 페이지의 크레딧 복사로 다른 곳에 쓸 문장을 얻을 수 있습니다.

팩의 파일은 그 팩을 쓰는 모든 프로젝트가 함께 쓰므로, 누구의 것인지 알려 주는 막대와 함께 읽기 전용으로 열립니다. 바꾸려면 그 막대나 파일 목록의 파일 메뉴에서 사본 편집을 선택하세요(그 위에 그려도 같은 시트가 열립니다). 파일이나 고른 프레임이 프로젝트의 것이 되고, 그 이름을 쓰는 코드는 사본을 쓰게 됩니다. 이 모든 것이 실행 취소로 되돌릴 수 있는 한 단계입니다. 사본은 크레딧을 그대로 지닙니다. 프로젝트 설정 › 크레딧은 게임에서 다른 사람이 만든 모든 것을 보여 주고, 사본을 바꾸면 변경됨으로 표시하며, 직접 쓴 감사 인사도 보관합니다. CREDITS.txt 미리 보기로 내보내기가 쓰는 내용을 볼 수 있습니다.

샘플 게임

Pyxen에는 모든 코드와 에셋이 담긴 완성된 게임이 들어 있습니다. 살펴보고, 고치고, 배울 수 있는 실제로 플레이 가능한 게임입니다. Pyxen 홈의 플레이하고 읽기에서 찾을 수 있습니다. 저장되지 않은 상태로 열리므로 무엇이든 바꿀 수 있습니다. 변경 내용을 남기려면 저장하세요.

홈의 스니펫은 각각 10줄로, 하나의 아이디어가 바로 실행됩니다.

Dungeon Survivors는 Moonlit Cellar에서 보내는 10분입니다. 적은 사방에서 파도처럼 밀려오고, 무기는 스스로 조준하며, 레벨이 오를 때마다 세 가지 중 하나를 고를 수 있습니다. 다섯 가지 무기는 weapons.py에 함수 하나씩으로 있어, 읽고 바꿀 수 있습니다. Big Slime은 상자를 남깁니다. 무기가 레벨 8이고 그 무기의 패시브를 갖고 있으면 상자에서 무기가 진화합니다. 10분이 되면 Slime King이 나타나고, 쓰러뜨리면 밤을 이겨 냅니다.

파일과 iCloud

Pyxen은 iPadOS와 macOS의 표준 문서 모델을 사용합니다. 프로젝트는 iPad에서는 파일 앱에, Mac에서는 Finder에 다른 문서와 함께 나타납니다. iCloud를 켜 두면 프로젝트가 자동으로 동기화됩니다.

계정은 선택 사항이며, Pyxen은 원격 측정 데이터를 수집하지 않습니다. 파일은 여러분이 둔 곳에 그대로 있습니다.