项目与素材
Pyxen 使用简单的基于文件的项目模型:你的项目就是设备上的文件。账户是可选的,没有任何功能需要它。
.pyxen 格式
Pyxen 项目是一个 .pyxen 文件。它是一个包含你的代码、图片和声音的 ZIP 压缩包。你可以:
- 在”文件” App 中重命名、复制或移动它
- 存储在 iCloud 中,从多个设备访问
- 通过 AirDrop、邮件或任何文件共享方式分享
- 通过复制文件来备份
因为它是标准的 ZIP 格式,你甚至可以在电脑上解压它来检查内容。
项目会记住保存它的 Pyxen 版本。用更新版本的 Pyxen 创建的项目也能打开和运行;第一次打开时,Pyxen 会提示一次:新版本添加的内容在更新前可能无法显示或运行。不会拒绝打开。
你的项目在哪里
你保存的项目存放在 Pyxen 的文件夹中:如果为 Pyxen 打开了 iCloud 云盘,就是 iCloud 云盘 › Pyxen;否则是设备上 Pyxen 自己的文件夹(Mac 上为 我的 Mac › Pyxen,iPad 上为“文件”App 中的 我的 iPad › Pyxen)。设置 › 通用 › 项目 会显示是哪一个,在访达中显示(iPad 上为 在“文件”中显示)可以打开它。
在 Windows 上,项目存放在 文档 › Pyxen 中:设置 › 通用 › 项目 会显示它,在文件资源管理器中显示 可以打开它。
对于当前打开的项目,点按或轻点标题栏中的项目名称,然后选择 在访达中显示(iPad 上为 在“文件”中显示),或选择 文件 › 在访达中显示(⌥⌘R)。在主页上,它位于每个项目的菜单中。“文件”App 无法选中某个文件,所以在 iPad 上会打开项目所在的文件夹。尚未保存的项目不在任何文件夹中:它的菜单会改为提供 保存…。
在 Windows 上,是同样位置的 在文件资源管理器中显示,或 文件 › 在文件资源管理器中显示(Ctrl+Alt+R)。
保存在别处或从别处打开的项目会留在原处:Pyxen 会在 继续 中列出它,从不移动它。试用 Pyxen 期间,计入数量的是 Pyxen 文件夹中的项目。
文件夹项目
在 Mac 和 Windows 上,项目也可以是一个存放普通文件的文件夹,而不是单个 .pyxen:里面就是 .pyxen 所包含的那些文件,并排放着,文本编辑器、git 或 AI 应用都能直接处理。
- 在 Mac 上,文件 › 打开文件夹… 在原位置打开一个项目文件夹(其中有
settings.pyxenproj的文件夹)。在 Windows 上,主页会列出 Pyxen 文件夹中的文件夹项目,从那里打开即可。 - 转换为文件夹 在打开的
.pyxen旁边创建一个文件夹项目;转换为 .pyxen 文件 把文件夹项目合成一个文件。两者都在 文件 菜单中、点按标题栏中的项目名称打开的菜单中,以及主页上项目的菜单中。转换前的那个保持原样;如果名称已被占用,新的会叫“Cave Jump 2”。文件夹项目会在标题栏的名称旁显示 文件夹。 - 保存… 会询问新项目的保存方式:.pyxen 文件或文件夹。
- 你工作时,Pyxen 会把更改写入文件夹中的文件。在 Mac 上,文件在 Pyxen 之外被更改时,会立即出现在 Pyxen 中;撤销可恢复原来的内容。如果你也在 Pyxen 中改了同一个文件且尚未写入,Pyxen 会询问保留哪一个,未保留的版本会移到废纸篓。在 Windows 上,Pyxen 只写入你改过的文件,在 Pyxen 之外更改的文件保持原样:关闭项目再重新打开即可看到更改。你删除的文件会移到回收站。
- iCloud 云盘中的项目文件夹,如果其中的文件还不在这台 Mac 上,会显示正在下载…;Pyxen 会向 iCloud 请求这些文件,全部下载后打开项目。
- 文件夹项目和
.pyxen一样,算作一个项目。
Pyxen 26.6 及更早版本以及 iPad 上的 Pyxen 只能打开 .pyxen 文件:要在它们上面打开或用于分享,请把文件夹项目转换为 .pyxen 文件。
添加素材
你的项目可以包含:
- 图片 — 用于精灵和图块表的 PNG 文件
- 音效 — 用于音效的 WAV 文件
- 音乐 — 用于背景音乐的 OGG Vorbis、MIDI 和追踪器模块(MOD、XM、IT、S3M)
项目的 README.md 及其译本(如 README.zh-Hans.md)在“文件”顶部、脚本 上方合为一行 自述文件。它以你的语言打开页面。其菜单中有其他语言(以其他语言打开)和 以文本形式编辑,后者打开文件本身。
用文件 › 导入图像或声音…添加素材,或用文件 › 新素材…(文件中的 +)新建一个。添加后,在代码中按名称引用:
Sprite("hero") # references an image named "hero"
Sound("jump") # references a sound named "jump"
Music("overworld") # references a music track named "overworld"
新的瓦片地图
在 文件 › 新素材… 中,瓦片地图 会询问用哪些图块来绘制地图。它先列出项目的图片,每张都标明能切出多少个图块;然后是项目所用素材包的图片,按素材包的名称分组;最后是 Pyxen 图块:地面、墙、地板、门、靶子、山丘、云、灌木和箱子,共 40 个 16 像素的图块,采用项目的调色板。
新地图默认使用项目中另一张地图所用的图块;没有的话,使用名称含有“tiles”的图片;再没有的话,使用 Pyxen 图块。图块集 显示所选的内容,下面的一行说明 创建 会做什么:
- 选择项目或素材包中的图片时,地图按原样使用它,不会添加其他内容。
- 选择 Pyxen 图块 时,创建还会把
tiles.png添加到项目中(该名称已被占用时为tiles2.png),地图可以直接绘制。这张图归你所有,可随意重画;撤销 会一步撤回地图和图块。
单元格大小 会随所选内容变化,之后仍可更改。地图的 地图设置 › 图块集 可以在之后把它链接到另一张图片。
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 主页的玩一玩,读一读中找到它们。它们打开时不会保存,所以你可以随意修改;要保留修改,请保存。
主页的代码片段都很短:一个想法,直接运行,大多只有十行。其中 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 里的十分钟:敌人从四面八方一波波涌来,你的武器自己瞄准,每次升级都能三选一。它的五件武器写在 weapons.py 里,每件一个函数,可以阅读和修改。Big Slime 会留下宝箱:武器到 8 级且你持有它对应的被动道具时,宝箱会让它进化。到第十分钟,Slime King 来临;打倒它,就赢下这一夜。
Crownwood 是一场持剑的冒险,横跨草地、树林和水边的六个画面:在村子里找到剑,劈开灌木,读读路牌,向东追寻王冠。镜头在画面之间滑动,每走进一个画面,游戏就会保存。它的大地图在瓦片地图编辑器中绘制,主角、敌人和心都放在它的物件图层上。东边树林里的洞穴通往史莱姆地窖,共六个房间:一间栅栏房,栅栏会关上,直到最后一只史莱姆消失;钥匙和上锁的门;炸弹(按 X,触摸屏上用炸弹按钮),能让裂开的墙和岩石从此打开;还有巨型史莱姆,它的生命值是画面底部的长条,打败它会留下心之容器。地窖同样是在瓦片地图编辑器中绘制的。
文件与 iCloud
Pyxen 使用 iPadOS 和 macOS 的标准文稿模型。项目在 iPad 上出现在“文件”App 中,在 Mac 上出现在访达中,与你的其他文稿放在一起。如果启用了 iCloud,你的项目会自动同步。在 Windows 上,项目和你的其他文稿一样,是文件资源管理器中的文件。
账户是可选的,Pyxen 不收集任何遥测数据。你的文件留在你放置的地方。