本页目录

微信小游戏:泡泡转盘(BubbleSpinner)

BubbleSpinner · xiandew/BubbleSpinner

一款运行在微信小游戏平台的泡泡转盘类休闲游戏,使用原生 JavaScript 与 HTML5 技术实现,代码不依赖框架。仓库 README 摘录主要介绍地图编辑器 Tiled 的通用说明,未提供具体玩法细节、关卡内容或运行效果,相关部分待核验。

平台跳跃 RPG 其他 无明确引擎 C++ 关卡管理 地图编辑器 中级
★ Stars 13,035 Forks 1,997 License Apache-2.0 更新 2026-11-07

国内开发环境适配

Windows
官方声明支持
Linux
官方声明支持
macOS
官方声明支持
引擎 / 框架:无明确引擎 暂无中文教程标记 未标记站长实测
编译需安装 Qt 6 与 Qbs,国内可从 Qt 官方安装器或镜像获取;GitHub Releases 下载可能受网络影响,建议使用 Flatpak/snap 或配置镜像。待核验具体镜像可用性。

中文项目介绍

Tiled 是一款面向所有瓦片类游戏的通用地图编辑器,适用于 RPG、平台跳跃、打砖块等类型。项目使用 C++ 与 Qt 框架开发,遵循 README 中“灵活、通用”的设计目标。它不限定地图尺寸、瓦片尺寸、图层数量或图块数量,地图、图层、图块和对象均可被赋予任意自定义属性。其地图格式 TMX 结构清晰、易于理解,支持在同一张地图中使用多个图块集,并且图块集可以随时修改。

Tiled 提供跨平台安装方式:可从 GitHub Releases 或 itch.io 下载,多数 Linux 发行版也提供打包版本,但 README 提示这些包通常较旧,推荐使用 AppImage、Flatpak 或 snap 等官方发布渠道。

技术架构分析

编译与构建

编译 Tiled 前需要安装 Qt(>= 6.2)开发库以及 Qbs 构建工具。README 给出了各系统的依赖安装命令:

  • Ubuntu/Debian:sudo apt install qt6-base-dev libqt6svg6 libqt6test6 qt6-l10n-tools qt6-declarative-dev zlib1g-dev qbs
  • Fedora:sudo dnf builddep tiled
  • Arch Linux:sudo pacman -S qt6-declarative qt6-svg qt6-tools qbs
  • macOS(Homebrew):brew install qbs qttools(会自动拉取 Qt)

若需要构建 Python 插件,还需安装 Python 3 开发库(Ubuntu/Debian 为 python3-dev,Windows 可从 python.org 下载)。

最简便的方式是用 Qt Creator 打开 tiled.qbs 并运行项目。命令行构建流程如下:

qbs setup-toolchains --detect     # 设置工具链
qbs                               # 构建 Tiled
qbs run -p tiled                  # 运行 Tiled

Qt 6 与 libtiledquick

编译 libtiledquick(默认不构建)需要安装 Vulkan 头文件,Ubuntu/Debian 上为 sudo apt install libvulkan-dev。

Visual Studio 2017

在完成 Qbs 设置后,可生成 Visual Studio 2017 工程:

qbs generate -g visualstudio2017

安装自编译版本

运行 qbs install 可将 Tiled 安装到 <build-dir>/install-root。可通过 qbs qbs.installPrefix:"/usr" 修改安装前缀,或使用 qbs install --install-root /tmp/tiled-pkg 安装到打包目录。打包分发时,建议追加 projects.Tiled.useRPaths:false 禁用 Rpath。

技术要点

  • 语言与框架:C++ 与 Qt 6,构建系统为 Qbs。
  • 地图格式:TMX 格式易于理解,支持多图块集与运行时修改图块集。
  • 灵活性:不限制地图尺寸、瓦片尺寸、图层与图块数量;地图、图层、图块、对象均可附加任意属性。
  • 插件体系:README 提到 Python 插件,说明编辑器具备可扩展的插件机制。
  • 持续集成:项目使用 GitHub Actions、AppVeyor 进行构建,并通过 Weblate 管理翻译。

补充说明

安装与平台支持

README 明确列出了各平台的获取方式:

  • Windows:提供安装程序,使用 SignPath.io 与 SignPath Foundation 提供的免费代码签名。
  • macOS:构建由维护者 Thorbjørn Lindeijer 以 Apple Developer 身份签名。
  • Linux:可通过发行版包管理器安装,但建议优先使用 AppImage、Flatpak 或 snap 官方版本。

此外,Tiled 也发布在 itch.io 上,方便独立游戏开发者获取。

学习建议

Tiled 本身是地图编辑器而非游戏引擎,适合作为学习“地图编辑器”与“关卡管理”概念的参考项目。其 TMX 格式与多图块集设计,有助于理解瓦片地图的数据组织方式;Qbs 构建流程与 Qt 插件机制,则适合希望了解 C++/Qt 桌面工具开发的读者。建议从官方文档与 TMX 格式说明入手,再结合示例地图理解图层与对象属性的用法。

开源许可证与版权说明

许可证标识:Apache-2.0。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目