Pygame 网页版论坛展示插件 - 使用说明

littleblackLB

Pygame 网页版论坛展示插件 - 使用说明
项目简介：
本插件旨在让开发者能够将使用 Python 和 Pygame 编写的游戏或应用，原封不动地打包成网页版，并直接嵌入到论坛帖子中。通过该系统，其他用户无需下载任何环境和代码，在浏览器中即可直接点击游玩您的作品。

编辑器入口
下面将教您如何将本地代码转化为论坛可用的展示模块：
第一步：修改您的 Pygame 代码（非常重要！）由于代码将运行在浏览器的 WebAssembly 环境中，因此需要对您的原生 Pygame 代码进行少量修改，将其改为异步（Async）模式。
请确保您的代码遵循以下结构（特别是 await asyncio.sleep(0) 是必加的，否则您的游戏在网页里会卡死黑屏）：
async def main():
    global COUNT_DOWN

    screen = pygame.display.set_mode((800, 600))
    pygame.display.set_caption('My Pygame Web')

    while True:
        # 这里是您的主循环
        screen.fill((0, 0, 0))
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                return

        # 游戏逻辑与渲染...

        pygame.display.flip()  # 或 pygame.display.update()

        # 3. 必须在每次主循环执行结尾添加这行代码！保持 0 即可。
        # 它的作用是把控制权暂时交还给浏览器，避免阻塞网页死机。
        await asyncio.sleep(0)

# 4. 代码必须以此方式启动，不要在后面加 sys.exit()
asyncio.run(main())

---

第二步：获取项目 Token您可以通过以下两种方式之一，在我们的专属在线编辑器中将您的游戏部署并获取用于嵌入论坛的 Token。
方式一：直接粘贴代码（适用于单文件小游戏）如果您只有一个 main.py 且不需要额外的图片、音频等素材：

• 打开编辑器页面。
• 找到中间的 Editor (代码编辑器) 区域，默认会有一个 main.py 文件。
• 清空原有内容，将您修改好异步逻辑的 Pygame 代码 直接粘贴 进去。
• 点击网页上方工具栏蓝色的 ▶️ Run 按钮。
• 等待系统打包完毕，右上方文本框内会自动填入一串字符串（Token）。双击复制这串 Token 备用。
  

方式二：导入 ZIP 压缩包（适用于多文件/带素材的项目）如果项目包含多个文件或有图片/音频素材：

• 将项目的所有文件打包成一个 .zip 压缩包。 （注意：main.py 必须在压缩包的根目录下，不要包在一层额外的文件夹里）
• 打开编辑器，点击右上角的 📂 Open ZIP 按钮，选中您刚刚打包的 ZIP 文件。
• 系统解压后，您可以在左侧的资源管理器看到文件结构。
• 确认无误，点击工具栏蓝色的 ▶️ Run 按钮。
• 等待打包运行成功，在右上方文本框内生成并复制您的专属 Token。
  

---

第三步：在论坛中填入参数获取到 Token 后，您就可以回到论坛发布您的游戏了：

• 在发帖或回帖编辑界面，点击编辑器自带的 Pygame 插件图标。
• 在弹出的窗口中，填写以下信息：
  
  • token： 粘贴前面复制的那串字符。
  • 宽 (px) 和 高 (px)： 填写您的游戏画面尺寸。请与您的代码中 set_mode 的分辨率保持等比例（例如，代码里 1600x1200，则可以在此填 800 和 600 让其完整显示在帖内）。
    
• 点击 提交。
  

完成后正常发布帖子，您的炫酷 Pygame 网页游戏就大功告成了！