Skip to content

Cross-platform (desktop, mobile, console) 3D and 2D game engine supporting many asset formats (glTF, X3D, Spine...) and using modern Object Pascal

License

Notifications You must be signed in to change notification settings

peardox/castle-engine

 
 

Repository files navigation

Castle Game Engine

"Castle Game Engine" is a cross-platform (desktop, mobile, console) 3D and 2D game engine.

Castle Game Engine - editor with terrain

We feature:

  • Powerful visual editor to design 3D and 2D games.

  • A lot of components to design viewport contents (3D and 2D world, using scenes, cameras, navigation, primitives, lights...) and user inteface (buttons, images, labels...).

  • Support for glTF, X3D, Spine and more formats.

  • Composable shader effects, shadows, mirrors, physically based rendering, bump mapping, gamma correction...

  • Fast clean code using modern Pascal.

  • We are free and open-source.

See https://castle-engine.io/features for the complete list of engine features.

Installation and building your first application

See the Installation manual page.

We recommend you download the engine from our downloads, unpack the release and then run bin/castle-editor executable inside.

If you got the source code straight from our GitHub repository then read first Compiling from source.

Usage in short:

  • Our editor is used to design and build your applications.

  • Our build tool is used to build your applications from the command-line.

    Both the build tool and editor use the project settings from the CastleEngineManifest.xml file.

  • You can also use Lazarus.

    Make sure to register in Lazarus our packages. It's easiest to do this using the button "Register Lazarus Packages" in CGE editor "Preferences -> FPC and Lazarus" (see https://castle-engine.io/install ).

    You can install the castle_components.lpk package in Lazarus, to have LCL component TCastleControl (see https://castle-engine.io/control_on_form ).

  • You can also use Visual Studio Code. We feature a Pascal LSP server that can do code completion for Pascal and CGE API.

  • Delphinus-Support : For Delphi users that want to use TCastleControl in VCL of FMX, you can install the package using Delphinus. See Download: Delphinus for more details.

Documentation

  • Manual is the most recommended way to learn the engine.

  • API reference.

    It is also available offline in the engine archive (if you downloaded the binary engine release), just open the file doc/reference/index.html in your WWW browser.

  • Numerous examples are provided in the examples/ subdirectory.

  • Guide to creating game data.

Support

Questions? Talk to us on forum or Discord chat.

Support us on Patreon.

License

The engine is available on the terms of LGPL >= 2 license with "static linking exception". This is the same license as used by FPC RTL and Lazarus LCL. In short, you can make commercial and closed-source games using the engine, you only have to share your modifications to the engine core.

See license for details.

Have fun!

Authors

This is the life project of Michalis Kamburelis.

Thank you to all the contributors and supporters for making the engine with me throughout the years. Keep it going please :)

About

Cross-platform (desktop, mobile, console) 3D and 2D game engine supporting many asset formats (glTF, X3D, Spine...) and using modern Object Pascal

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Pascal 96.7%
  • C 1.1%
  • C++ 0.8%
  • Java 0.6%
  • Objective-C 0.3%
  • GLSL 0.2%
  • Other 0.3%