README_CN.md

February 5, 2026 · View on GitHub

promo

语言

  English

  简体中文

  Русский

关于

JavaFX 游戏开发框架

Maven CentralBuild Statuscodecovsponsor JFXCentral

为什么选择FXGL ?

  • 无需安装或设置
  • “开箱即用”：Java 8-25、Win/Mac/Linux/Android 8+/iOS 11.0+/Web
  • 简单干净的API，相比起其他引擎API级别更高
  • JavaFX 的超集：无需学习新的 UI API
  • 真实世界的游戏开发技术：实体组件、插值动画、粒子等等
  • 游戏很容易打包成一个可执行的 .jar 或原生镜像

适合：

  • 任何 2D 游戏（横向卷轴 /platformer/ 街机 / RPG游戏）
  • 任何具有复杂 UI 控件/动画的业务应用程序
  • 实验性 3D 特性
  • 爱好/学术/商业项目
  • 教学/学习/提高游戏开发技能
  • 应用创意的快速原型制作

最小的例子

public class BasicGameApp extends GameApplication {

    @Override
    protected void initSettings(GameSettings settings) {
        settings.setWidth(800);
        settings.setHeight(600);
        settings.setTitle("Basic Game App");
    }

    public static void main(String[] args) {
        launch(args);
    }
}

入门

如需快速深入了解代码，请参阅独立的基本示例。否则，请参阅：

Maven

  • Maven项目模板，编程语言为 Java 和/或 Kotlin
<dependency>
    <groupId>com.github.almasb</groupId>
    <artifactId>fxgl</artifactId>
    <version>25</version>
</dependency>

Gradle

如有错误请以模板为准。

repositories {
    jcenter()
}

dependencies {
    compile 'com.github.almasb:fxgl:25'
}

模块化

如果您希望开发模块化应用程序，这里有一个完整的示例module-info.java：

open module app.name {
    requires com.almasb.fxgl.all;
}

独立完整包含所有依赖的 jar 文件

从Releases下载最新的 uber jar

社区

  • 英国布莱顿大学
  • 英国诺丁汉大学
  • 美国佐治亚理工学院
  • 美国kidOYO
  • 美国沃尔顿高中
  • 美国科南特高中
  • 丹麦新西兰商业技术学院
  • 巴西南里奥格兰德联邦教育、科学和技术学院
  • 瑞士西北高等专业学院 工程/计算机科学学院

如果您的机构想要使用或正在使用 FXGL，请在Discussions中添加注释以添加到列表中。

社区教程：

社区项目（使用fxgl主题标识）：

如果您希望在此处展示您的项目，只需在Discussions中添加注释即可。

开发团队

角色描述在贡献指南中给出。

维护者（合作者）：

协调员：

测试人员：

贡献与支持

如果您想从源代码构建 FXGL 或想贡献，请参阅贡献指南（包括非代码）。FXGL 是完全模块化的，因此新的贡献者不需要了解整个代码库，只需要了解做出贡献的模块即可。贡献将根据行为准则进行审查。

您可以通过简单地为 repo 加注星标或成为赞助商来支持 FXGL 的开发或表现出兴趣。

赞助商

用户：

  • @Marsl10
  • @SergeMerzliakov
  • @mbains
  • @sabit86
  • @hendrikebbers
  • @ImperaEtConquer
  • @thejeed
  • @chikega

公司：

  • @karakun

与我们取得联系