本页目录

libSDL2pp:SDL2 的 C++ 封装库

libSDL2pp · libSDL2pp/libSDL2pp

libSDL2pp 为 SDL2 及配套库提供 C++ 封装,以 RAII 风格对象包装 SDL 的初始化、窗口、渲染器、纹理等接口。README 示例显示,SDL 初始化会在对象析构时自动反初始化,封装层同时负责对象销毁与错误检查。仓库 topics 涵盖 SDL_image、S...

动作游戏 平台跳跃 自研引擎 C++ 角色控制 关卡管理 游戏状态管理 地图编辑器 中级
★ Stars 223 Forks 53 License 未明确 更新 2026-11-04

国内开发环境适配

Windows
官方声明支持
Linux
未知
macOS
未知
引擎 / 框架:自研引擎 暂无中文教程标记 未标记站长实测
README 仅说明 Windows 预编译版本发布于官网,自行编译需参考 INSTALL.md;国内访问官网与邮件列表服务可能较慢,具体依赖与编译环境待核验。

中文项目介绍

《The Secret Chronicles of Dr. M.》(简称 TSC)是一款开源的 2D 横版卷轴平台游戏,使用 C++ 编写。项目自带较完整的图形与音乐素材,并提供一个进阶的关卡编辑器,玩家可以据此设计自己的关卡。编辑器支持在关卡内编写脚本,README 中形容其边界“只受你的想象力限制”。

TSC 是 SMC(Secret Maryo Chronicles)的分支。SMC 已不再活跃开发,但 TSC 团队强调,本项目并非单纯延续 SMC,而是有自身的目标与设计原则,并正在逐步把这些理念融入代码库与美术资源之中。

核心功能

2D 横版卷轴玩法

经典横向卷轴平台跳跃体验。

较丰富的素材

随游戏提供成套图形与音乐资源。

进阶关卡编辑器

可自行创建关卡,并支持在关卡中编写脚本,以扩展关卡逻辑与内容。

独立的设计方向

作为 SMC 分支,团队按自己的目标与设计原则持续调整代码与美术。

技术架构分析

技术要点

  • 语言与代码库:项目以 C++ 开发,代码与美术资源分属不同授权体系(见下文“授权说明”)。
  • 脚本化关卡:关卡编辑器允许在关卡内编写脚本,这是扩展玩法的关键机制。
  • 开发协作方式:贡献者需掌握 Git 基础(README 建议阅读在线 Git 书的前两章,并强烈推荐第三章,因为项目频繁使用分支)。
  • 代码规范:提交代码前需阅读 tsc/docs/pages/conventions.md 中的编码约定。
  • 美术规范:贡献美术作品前需阅读 wiki 上的 StyleGuide。
  • 提交信息约定:针对 issue tracker 中的问题,修复缺陷用 “fixes #43”,解决其他类型工单用 “closes #43”,以便合并后由 GitHub 自动关闭对应工单。
  • 本地编辑器配置:仓库为 Emacs 与 ViM 提供本地配置;ViM 本地配置需安装 localvimrc 插件,README 给出了在多数 Bourne 兼容 shell 下的安装命令。

构建与运行

官方在网站上发布 Windows 预编译版本,可直接下载使用。若希望自行编译 TSC,请参阅仓库中的 INSTALL.md 文件,其中包含编译说明。README 未逐一列出各平台的依赖清单,具体步骤以 INSTALL.md 为准。

补充说明

授权说明

TSC 程序本体以 GNU 通用公共许可证(GPL)第 3 版或更高版本发布,版权归属包括 2003–2011 年的 Florian Richter 与 2012–2019 年的 The TSC Contributors。完整许可证文本见 COPYING,作者列表见 tsc/docs/authors.txt。

需要特别注意的是,游戏中的图形、音乐及其他艺术内容不采用 GPL 授权,而是适用各自不同的条款:通常采用某种 CC 许可,具体由素材附带的 .txt 或 .settings 文件标明作者与许可证;未标明许可证的素材沿用旧的 SMC Contribution 许可(见 tsc/docs/pages/old_smc_contribution_license.md)。这些素材是 TSC 从 SMC 分支时继承的,团队正在寻找美术人员以原创作品替换它们。

相关链接

  • 官网:https://secretchronicles.org
  • 邮件列表:https://lists.secretchronicles.org/postorius/lists/tsc-devel.lists.secretchronicles.org/
  • 论坛:https://lists.secretchronicles.org/hyperkitty/list/tsc-devel@lists.secretchronicles.org/
  • Wiki:https://wiki.secretchronicles.org
  • 问题追踪:https://github.com/Secretchronicles/TSC/issues

学习建议

若以学习为目的阅读本项目,可重点关注两点:一是 C++ 编写的 2D 平台游戏在角色移动、关卡组织上的实现方式;二是关卡编辑器与关卡内脚本机制如何把内容创作能力交给玩家。由于项目源自 SMC 分支且仍在按自身原则演进,阅读代码时也可留意其与上游设计取向的差异。

开源许可证与版权说明

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

相似项目