项目与素材

Pyxen 使用简单的基于文件的项目模型:你的项目就是设备上的文件。账户是可选的,没有任何功能需要它。

.pyxen 格式

Pyxen 项目是一个 .pyxen 文件。它是一个包含你的代码、图片和声音的 ZIP 压缩包。你可以:

因为它是标准的 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 应用都能直接处理。

Pyxen 26.6 及更早版本以及 iPad 上的 Pyxen 只能打开 .pyxen 文件:要在它们上面打开或用于分享,请把文件夹项目转换为 .pyxen 文件。

添加素材

你的项目可以包含:

项目的 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,项目设置 › 美术 › 更改样式… 就会重新绘制它;修改之后则保持原样。

素材包

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 不收集任何遥测数据。你的文件留在你放置的地方。