프로젝트 및 에셋

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에서는 파일 앱에서 보기)로 열 수 있습니다.

Windows에서는 문서 › Pyxen에 보관됩니다. 설정 › 일반 › 프로젝트에 나오며, 파일 탐색기에서 보기로 열 수 있습니다.

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

Windows에서는 같은 자리의 파일 탐색기에서 보기나 파일 › 파일 탐색기에서 보기(Ctrl+Alt+R)를 선택하세요.

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

폴더 프로젝트

Mac과 Windows에서는 프로젝트를 하나의 .pyxen 대신 일반 파일이 들어 있는 폴더로 둘 수도 있습니다. .pyxen에 들어 있는 것과 같은 파일들이 나란히 있어서 텍스트 편집기, git, AI 앱이 바로 다룰 수 있습니다.

Pyxen 26.6 이전 버전과 iPad의 Pyxen은 .pyxen 파일만 엽니다. 그런 곳에서 열거나 공유하려면 폴더 프로젝트를 .pyxen 파일로 변환하세요.

에셋 추가

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

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

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

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

새 타일맵

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

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

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

Pyxen 타일은 프로젝트의 아트 스타일로 그려집니다. **프로젝트 설정 › 아트 › 스타일 변경…**은 tiles.png를 바꾸지 않은 동안에는 다시 그리고, 바꾼 뒤에는 그대로 둡니다.

에셋 팩

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

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

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

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

메커닉

메커닉은 Pyxen Script로 만든, 바로 쓸 수 있는 게임 부품입니다. 플랫포머 이동, 체력과 피해, 줍는 아이템, 점수, 주인공을 따라가는 카메라 등이 있습니다. 프로젝트 설정 › 메커닉, ⋯ 메뉴의 메커닉…, 또는 파일의 메커닉 그룹에 있는 **+**에서 열 수 있습니다.

그곳에서는 하는 일에 따라 나뉘어 있습니다.

글자로 레벨은 코드에 쓴 글자 줄로, 또는 타일맵 에디터에서 그린 맵으로 레벨을 만들고, 맵에서는 각 오브젝트를 이름으로 찾습니다.

메커닉마다 페이지가 있습니다. 테스트 장면이 그곳에서 데모로 실행됩니다. 클릭하면 키로 플레이할 수 있고, Esc를 누르면 키가 돌아옵니다. 설정 슬라이더는 드래그하는 동안 데모를 바꾸며, 아무것도 저장하지 않습니다. 사용법은 써야 할 줄을, 코드는 파일 전체를, 제공하는 것은 자동 완성처럼 함수를 보여 줍니다.

프로젝트에 추가는 메커닉 파일을 주석을 내 언어로 바꿔 프로젝트에 복사하고, 필요한 메커닉도 함께 추가합니다(버튼에 이름이 나옵니다). 한 단계라서 실행 취소로 모두 되돌릴 수 있습니다. 파일은 내 것이니 읽고 고쳐도 됩니다. 파일 목록의 메커닉 아래에 버전과 함께 표시되고, 고치면 변경됨이 붙습니다. **제거…**는 먼저 묻고, 그 메커닉이 필요한 다른 메커닉을 알려 줍니다.

메커닉의 설정은 JUMP: tune(2, 16) = 11처럼 파일 안의 숫자입니다. 프로젝트 설정 › 메커닉에서 슬라이더로 보이고, 게임이 실행되는 동안에는 인스펙터의 메커닉 탭에도 보입니다. 슬라이더를 드래그하면 실행 중인 게임이 바로 바뀌고, 손을 떼면 숫자가 파일에 쓰입니다. 실행 취소로 되돌릴 수 있는 한 단계입니다. 모두 재설정은 메커닉의 숫자를 처음대로 돌립니다. 자동으로 실행을 끄면 엔진이 그 메커닉을 대신 실행하지 않고, 페이지에 내 update()에서 부를 줄이 표시됩니다. 내 스크립트에도 설정을 둘 수 있습니다. NAME: tune(1, 10) = 5 # 하는 일이라고 쓰면 파일 이름 아래에 나타납니다.

메커닉을 부르는 방식에 문제가 있으면, 오류는 내 코드 줄에 메커닉의 말로 표시되고 그 아래에 메커닉 쪽 줄이 함께 나옵니다.

샘플 게임

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

홈의 스니펫은 짧은 코드로, 하나의 아이디어가 바로 실행되며 대부분 10줄 정도입니다. Pong, Game of Life, Particles 세 가지는 뜯어보며 배우는 작은 완성 프로그램입니다.

스타터에서 자라난 샘플 아래에는 이런 게임 만들기가 있습니다. 누르면 그 스타터가 선택된 채로 새 프로젝트가 열립니다. Crownwood에서는 Adventure 스타터가, Platformer에서는 Platformer 스타터가 열립니다. 아직 프로젝트가 없을 때는 ‘계속하기’에 첫 게임으로 좋은 스타터가 보입니다.

Platformer는 Platformer 스타터의 완성된 모습입니다. 타일맵 편집기로 그린 다섯 개의 레벨에 각각 하나의 아이디어가 있습니다. Spring Meadow에는 스프링, Sky Bridge에는 움직이는 발판, Locked Tower에는 열쇠와 문, Slime Caves에는 밟을 슬라임과 하트 세 개, The Belfry에는 세 번 밟아야 하는 커다란 박쥐가 있습니다.

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

Crownwood는 초원과 숲과 물가로 된 여섯 화면을 누비는 검의 모험입니다. 마을에서 검을 찾고, 덤불을 베어 길을 내고, 표지판을 읽고, 왕관을 따라 동쪽으로 가세요. 카메라는 화면에서 화면으로 미끄러지듯 넘어가고, 화면에 들어설 때마다 게임이 저장됩니다. 필드는 타일맵 에디터로 그렸고, 주인공과 적과 하트는 오브젝트 레이어에 놓여 있습니다. 동쪽 숲의 동굴은 방 여섯 개로 된 슬라임 지하실로 이어집니다. 마지막 슬라임이 사라질 때까지 셔터가 닫히는 방, 열쇠와 잠긴 문, 금 간 벽과 금 간 바위를 영영 여는 폭탄(X, 터치스크린에서는 폭탄 버튼), 그리고 체력이 아래쪽 막대로 보이는 빅 슬라임이 있습니다. 빅 슬라임을 물리치면 하트 그릇이 나타납니다. 지하실도 타일맵 에디터로 그렸습니다.

파일과 iCloud

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

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