项目与素材

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 上为 在“文件”中显示）可以打开它。

对于当前打开的项目，点按或轻点标题栏中的项目名称，然后选择 在访达中显示（iPad 上为 在“文件”中显示），或选择 文件 › 在访达中显示（⌥⌘R）。在主页上，它位于每个项目的菜单中。“文件”App 无法选中某个文件，所以在 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 包含素材包——可以在项目中使用的图片、声音和图块的集合。素材包使用 .pyxenpack 格式（也是 ZIP 压缩包）。

部分素材包随应用附带。其余素材包在你选择时下载：卡片上会显示下载和素材包大小；如果项目用到了此设备上还没有的素材包，可在其文件列表中下载。无法下载时（例如处于离线状态），Pyxen 会告诉你，项目保持原样。无需更新 Pyxen 也可能出现新的素材包：Pyxen 会在启动时和打开素材包时检查素材包列表，离线时显示上次看到的列表。

每个素材包的页面都会说明作者以及使用方式。大多数素材包属于公共领域（CC0），可以自由使用，包括在导出的游戏中。标有需要署名的素材包要求你的游戏注明作者。导出时，Pyxen 会把游戏用到的所有素材包的署名写入 licenses.txt 和 CREDITS.txt；页面上的拷贝署名可以给你在其他地方使用的那一行。

素材包的文件由所有使用它的项目共享，因此会以只读方式打开，并有一栏说明它属于谁。要修改其中一个，请在该栏或“文件”中该文件的菜单里选择 编辑副本（直接在上面绘制也会打开同一个面板）：该文件或所选的帧会成为你项目自己的文件，引用它的代码会改用副本，这一切是一步操作，撤销 即可还原。副本会保留署名。项目设置 › 署名 列出游戏中由他人制作的全部内容，副本一经修改即显示 已修改，并保存你自己的致谢；预览 CREDITS.txt 会显示导出时写入的内容。

示例游戏

Pyxen 附带完整的游戏，包含全部代码和素材：可以研究、修改和学习的真正可玩的游戏。在 Pyxen 主页的玩一玩，读一读中找到它们。它们打开时不会保存，所以你可以随意修改；要保留修改，请保存。

主页的代码片段每个十行：一个想法，直接运行。

Dungeon Survivors 是在 Moonlit Cellar 里的十分钟：敌人从四面八方一波波涌来，你的武器自己瞄准，每次升级都能三选一。它的五件武器写在 weapons.py 里，每件一个函数，可以阅读和修改。Big Slime 会留下宝箱：武器到 8 级且你持有它对应的被动道具时，宝箱会让它进化。到第十分钟，Slime King 来临；打倒它，就赢下这一夜。

文件与 iCloud

Pyxen 使用 iPadOS 和 macOS 的标准文稿模型。项目在 iPad 上出现在“文件”App 中，在 Mac 上出现在访达中，与你的其他文稿放在一起。如果启用了 iCloud，你的项目会自动同步。

账户是可选的，Pyxen 不收集任何遥测数据。你的文件留在你放置的地方。