--- title: "FreeKill, 一个开源的桌游框架 - Angryecho" description: "关于本项目 欢迎来到FreeKill，挥洒你的创意！FreeKill是一款开源的桌游引擎，在多个平台可用， 目前支持Linux、Mac、Windows、Android，以及FreeBSD。通过FreeKill，你可以创建自己想要的桌游玩法， 亦可基于已经完成的桌游对其进行进一步的拓展。" canonical_url: "https://www.angryecho.com/c/san_guo_sha/p/P2TBBkMIQG76U0FK8pg6Q" meta: "og:description": "关于本项目 欢迎来到FreeKill，挥洒你的创意！FreeKill是一款开源的桌游引擎，在多个平台可用， 目前支持Linux、Mac、Windows、Android，以及FreeBSD。通过FreeKill，你可以创建自己想要的桌游玩法， 亦可基于已经完成的桌游对其进行进一步的拓展。" "og:image": "https://www.angryecho.com/_og/d/c_Post%2Ctitle_~5ZCQ5qe9572R%2Cdescription_~5ZCQ5qe95LiA5LiL77yM5bCx5LiK5ZCQ5qe9572R44CC%2CpostId_P2TBBkMIQG76U0FK8pg6Q%2Crevision_~MjAyNi0xMC0yNVQwMjo1Nzo1MC4xODM3Nzla%2Cp_Ii9jL3Nhbl9ndW9fc2hhL3AvUDJUQkJrTUlRRzc2VTBGSzhwZzZRIg%2Cs_AApPlQbkcBhy9bJS.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "FreeKill, 一个开源的桌游框架" --- > Index of every page on this site: [llms.txt](https://www.angryecho.com/llms.txt) # **FreeKill, 一个开源的桌游框架** --- ## 关于本项目 欢迎来到FreeKill，挥洒你的创意！FreeKill是一款开源的桌游引擎，在多个平台可用， 目前支持Linux、Mac、Windows、Android，以及FreeBSD。通过FreeKill，你可以创建自己想要的桌游玩法， 亦可基于已经完成的桌游对其进行进一步的拓展。 利用FreeKill开发的桌游便于联机，框架为你的桌游提供好了断线重连、录像与回放等基本功能， 同时具有基本的游戏大厅。 FreeKill使用Lua语言实现了性能优秀的单线程异步服务端，并且使用Qt Quick 实现GUI界面，充分发挥图形硬件性能。 详细文档请查看 https://fkbook-all-in-one.readthedocs.io/。 本Repo主要提供客户端的Qt C++支持，以及服务端的少数支持，服务端仅供进行单机游戏。 因此本Repo中包含的脚本仅供release时打包使用。关于完整功能请移步其他仓库： - 基于STL的服务端： https://github.com/Qsgs-Fans/freekill-asio - 维护所有脚本文件的仓库： https://github.com/Qsgs-Fans/freekill-core - 本项目的文档（！需要维护）： https://github.com/Qsgs-Fans/fkbook-all-in-one 未来可能会从本Repo中删除所有脚本，转而在程序运行时强制要求用户安装freekill-core包。 目前已经实现的桌游玩法的一部分： - 三国杀（可进行拓展；暂时耦合在项目内部，在未来将成为独立的Repo） - 中国象棋与国际象棋（ https://gitee.com/notify-ctrl/chess-games） - 红心大战与桥牌等（ https://gitee.com/notify-ctrl/poker-games） --- ## 安装和使用 Release页面提供Windows版和Android版的打包好的文件，请直接下载使用。 如需版本更新的话，请直接覆盖到原先的安装上更新，无需卸载旧版。 Linux或BSD用户则需要从头开始编译（ [详细编译流程在此](https://fkbook-all-in-one.readthedocs.io/zh-cn/latest/develop/02-env.html)）。 以Debian为例： ``` $ sudo apt install git gcc g++ cmake swig $ sudo apt install liblua5.4-dev libsqlite3-dev libreadline-dev libssl-dev libgit2-dev # qt6-declarative-dev - qml, qt6-tools-dev - LinguistTools $ sudo apt install qt6-base-dev qt6-declarative-dev qt6-multimedia-dev qt6-tools-dev ``` ``` $ git clone https://github.com/Qsgs-Fans/FreeKill.git $ cd FreeKill $ mkdir build && cd build $ cmake .. && make -j8 ``` 此外ArchLinux用户也可从AUR中安装： ``` $ yay -S freekill ``` Mac 用户也需要从头开始编译 ``` # install xcode and homebrew, note: qt need full xcode $ brew install cmake libgit2 lua qt pkgconfig vulkan-headers swig $ git clone https://github.com/Qsgs-Fans/FreeKill.git $ cd FreeKill $ mkdir build && cd build $ cmake .. && make -j8 $ cd .. && ./build/FreeKill ``` 更多关于游玩细节与操作请 [查看这里](https://fkbook-all-in-one.readthedocs.io/zh-cn/latest/for-players/index.html)。 --- ## 参与其中 若您能为新月杀做出贡献，我们将不胜感激。以下是关于贡献的一些注意事项： - 项目的所有lua文件（test/除外）由特殊仓库 https://github.com/Qsgs-Fans/freekill-core进行管理， 因此请不要直接修改本仓库中的Lua文件，更多信息请查看freekill-core的README页面 - 只有本仓库是在Github上托管与实际维护的，开发组对其他官方武将的实现则分散在许多小仓库中， 并且在Gitee上维护。这些仓库都在我们的组织账号之下： https://gitee.com/qsgs-fans/ - 本项目以及不少拓展包项目的需求都写在Issue中，还请善加查阅。 --- ## 许可证 本仓库使用GPLv3作为许可证。详见`LICENSE`文件。 --- ## 点一下小星星呗！ ![图片](https://api.star-history.com/svg?repos=Qsgs-Fans/FreeKill&type=Date) > 原文： [GitHub｜FreeKill, 一个开源的桌游框架](https://github.com/Qsgs-Fans/FreeKill) 排序方式 : ### **成为第一条评论！** Nobody's responded to this post yet. Add your thoughts and get the conversation going. ```json {"@context":"https://schema.org","@graph":[{"@id":"https://www.angryecho.com/c/san_guo_sha/p/P2TBBkMIQG76U0FK8pg6Q#post","@type":"DiscussionForumPosting","commentCount":0,"dateModified":"2026-10-25T02:57:50.183Z","datePublished":"2026-10-24T19:32:43.532Z","description":"关于本项目 欢迎来到FreeKill，挥洒你的创意！FreeKill是一款开源的桌游引擎，在多个平台可用， 目前支持Linux、Mac、Windows、Android，以及FreeBSD。通过FreeKill，你可以创建自己想要的桌游玩法， 亦可基于已经完成的桌游对其进行进一步的拓展。","headline":"FreeKill, 一个开源的桌游框架","isPartOf":"https://www.angryecho.com/c/san_guo_sha","mainEntityOfPage":"https://www.angryecho.com/c/san_guo_sha/p/P2TBBkMIQG76U0FK8pg6Q","text":"关于本项目\n\n欢迎来到FreeKill，挥洒你的创意！FreeKill是一款开源的桌游引擎，在多个平台可用，\n目前支持Linux、Mac、Windows、Android，以及FreeBSD。通过FreeKill，你可以创建自己想要的桌游玩法，\n亦可基于已经完成的桌游对其进行进一步的拓展。\n\n利用FreeKill开发的桌游便于联机，框架为你的桌游提供好了断线重连、录像与回放等基本功能，\n同时具有基本的游戏大厅。\nFreeKill使用Lua语言实现了性能优秀的单线程异步服务端，并且使用Qt Quick\n实现GUI界面，充分发挥图形硬件性能。\n详细文档请查看https://fkbook-all-in-one.readthedocs.io/。\n\n本Repo主要提供客户端的Qt C++支持，以及服务端的少数支持，服务端仅供进行单机游戏。\n因此本Repo中包含的脚本仅供release时打包使用。关于完整功能请移步其他仓库：\n\n\n\n\n\n基于STL的服务端：https://github.com/Qsgs-Fans/freekill-asio\n\n\n\n维护所有脚本文件的仓库：https://github.com/Qsgs-Fans/freekill-core\n\n\n\n本项目的文档（！需要维护）：https://github.com/Qsgs-Fans/fkbook-all-in-one\n\n未来可能会从本Repo中删除所有脚本，转而在程序运行时强制要求用户安装freekill-core包。\n\n目前已经实现的桌游玩法的一部分：\n\n\n\n\n\n三国杀（可进行拓展；暂时耦合在项目内部，在未来将成为独立的Repo）\n\n\n\n中国象棋与国际象棋（https://gitee.com/notify-ctrl/chess-games）\n\n\n\n红心大战与桥牌等（https://gitee.com/notify-ctrl/poker-games）\n\n\n\n安装和使用\n\nRelease页面提供Windows版和Android版的打包好的文件，请直接下载使用。\n如需版本更新的话，请直接覆盖到原先的安装上更新，无需卸载旧版。\n\nLinux或BSD用户则需要从头开始编译（详细编译流程在此）。\n\n以Debian为例：\n\n$ sudo apt install git gcc g++ cmake swig\n$ sudo apt install liblua5.4-dev libsqlite3-dev libreadline-dev libssl-dev libgit2-dev\n# qt6-declarative-dev - qml, qt6-tools-dev - LinguistTools\n$ sudo apt install qt6-base-dev qt6-declarative-dev qt6-multimedia-dev qt6-tools-dev\n\n$ git clone https://github.com/Qsgs-Fans/FreeKill.git\n$ cd FreeKill\n$ mkdir build && cd build\n$ cmake .. && make -j8\n\n此外ArchLinux用户也可从AUR中安装：\n\n$ yay -S freekill\n\nMac 用户也需要从头开始编译\n\n# install xcode and homebrew, note: qt need full xcode\n$ brew install cmake libgit2 lua qt pkgconfig vulkan-headers swig\n$ git clone https://github.com/Qsgs-Fans/FreeKill.git\n$ cd FreeKill\n$ mkdir build && cd build\n$ cmake .. && make -j8\n$ cd .. && ./build/FreeKill\n\n更多关于游玩细节与操作请查看这里。\n\n\n\n参与其中\n\n若您能为新月杀做出贡献，我们将不胜感激。以下是关于贡献的一些注意事项：\n\n\n\n\n\n项目的所有lua文件（test/除外）由特殊仓库https://github.com/Qsgs-Fans/freekill-core进行管理，\n因此请不要直接修改本仓库中的Lua文件，更多信息请查看freekill-core的README页面\n\n\n\n只有本仓库是在Github上托管与实际维护的，开发组对其他官方武将的实现则分散在许多小仓库中，\n并且在Gitee上维护。这些仓库都在我们的组织账号之下：https://gitee.com/qsgs-fans/\n\n\n\n本项目以及不少拓展包项目的需求都写在Issue中，还请善加查阅。\n\n\n\n许可证\n\n本仓库使用GPLv3作为许可证。详见LICENSE文件。\n\n\n\n点一下小星星呗！\n\n\n\n\n\n原文：GitHub｜FreeKill, 一个开源的桌游框架","url":"https://www.angryecho.com/c/san_guo_sha/p/P2TBBkMIQG76U0FK8pg6Q","author":{"@type":"Person","name":"UID:35917424","url":"https://www.angryecho.com/u/NGA35917424"},"image":["https://api.star-history.com/svg?repos=Qsgs-Fans/FreeKill&type=Date"],"interactionStatistic":[{"@type":"InteractionCounter","interactionType":"https://schema.org/LikeAction","userInteractionCount":0},{"@type":"InteractionCounter","interactionType":"https://schema.org/DislikeAction","userInteractionCount":0},{"@type":"InteractionCounter","interactionType":"https://schema.org/ViewAction","userInteractionCount":0},{"@type":"InteractionCounter","interactionType":"https://schema.org/ShareAction","userInteractionCount":0}]}]} ``` ## Sitemap See the full [sitemap](https://www.angryecho.com/sitemap.md) for all pages.