• Stars
    star
    281
  • Rank 147,023 (Top 3 %)
  • Language
  • License
    MIT License
  • Created about 4 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Unofficial Godot Engine binaries for the Raspberry Pi.

Unofficial Godot Engine for the Raspberry Pi

Unofficial Godot Engine binaries for the Raspberry Pi.

Unofficial Godot Engine for the Raspberry Pi

Limitations

  • The Raspberry Pi only supports GLES2.
  • The Raspberry Pi doesn't support GPU particles, only CPU particles.
  • We don't have 3.0.6 binaries because it doesn't have GLES2 support, only GLES3.
  • We don't have headless and server binaries for 2.1.6. We can compile them on the Raspberry Pi.
  • If the export templates from this repository don't work, you can try the ones from FRT: a Godot "platform" targeting single board computers, which offers support for multiple Raspberry Pi revisions and other single-board computers and are well tested.
  • We don't offer any kind of support. The binaries are distributed as-is 🙃.

If you would like official Godot support for the Raspberry Pi, there is a proposal about it. Go there and give us a thumbs up so we can get it 👍 😉 !

Table of contents

Compiling

See COMPILING.

Status

This table refers to the Raspberry Pi 4 only. Prior version are untested.

2.1.6 3.1.2 3.3.4 3.4.5 3.5.2
Editor *
Export template
Headless -
Server -
  • ✓: Works perfectly.
  • *: It works, but it's laggy/unresponsive at fullscreen (1920x1200). Making the editor 1/2 or 1/3 of that size makes it run better.
  • -: Not available.

📥 Downloads

Each ZIP file contains: Editor, Export template, Headless and Server.

2.1.6

These ZIP files only contain: Editor and Export template.

3.1.2

3.3.4

3.4.5

3.5.2

🚀 How to launch the Editor

To open the editor, run:

./godot_x.x.x_rpi4_editor.bin

(where x.x.x is the version of Godot).

You might need to give executable permissions to the binary. If that's the case, run:

sudo chmod +x godot_x.x.x_rpi4_editor.bin

🤖 How to export a game using the Export Templates

You don't have to use a Raspberry Pi to export a game for it. You can use any computer running any OS supported by Godot.

Godot 2.x

  • In the editor, go to Export.
  • Select the Linux/X11 template.
  • In Debug, uncheck Debugging Enabled.
  • In Custom Binary -> Release, select the version of the export template that matches the version of your project.
  • In Binary, uncheck 64 bits*.
  • Click Export.
  • You can use the .rpi4 extension when naming the exported game.

* Only for 32 bits binaries.

Godot 3.x

  • In the editor, go to Project -> Export.
  • Select the Linux/X11 template.
  • In Binary Format, uncheck 64 bits*.
  • In Custom template -> Release, select the version of the export template that matches the version of your project.
  • Click Export Project.
  • Uncheck Export With Debug.
  • Optionally, after the game is packed, you can rename the extension of the game's executable binary from .x86 to .rpi4 to avoid confusion.

* Only for 32 bits binaries.

🗃️ How to export an independent PCK file

You can export a .pck file and run it with the export templates from this repository.

Godot 2.x

  • In the editor, go to Export.
  • Select the Linux/X11 template.
  • In Binary, uncheck 64 bits*.
  • Click Export PCK/ZIP.
  • Enter the name of your game with the .pck extension.
  • Click OK.

* Only for 32 bits binaries.

Godot 3.x

  • In the editor, go to Project -> Export.
  • Select the Linux/X11 template.
  • In Binary Format, uncheck 64 bits*.
  • Click Export PCK/ZIP.
  • Uncheck Export With Debug.
  • Enter the name of your game with the .pck extension.
  • Click Save.

* Only for 32 bits binaries.

🎮 How to run a game

Case 1

  • The is no .pck file (meaning that it's embedded in the executable binary).
  • The .pck file has the same name as the executable binary and they are both in the same directory.

You can just run the executable binary, like this:

./name_of_your_godot_game.ext

Case 2

  • The .pck file has a different name than the executable binary.
  • The .pck file is in a different directory than the executable binary.
  • You are using an independent .pck file (without an executable binary).

You'll have to pass the .pck file's path using the --main-pack option, like this:

./godot_x.x.x_rpi4_export-template.bin --main-pack "/path/to/the/pck/file.pck"

On Godot 2.x, use -main_pack instead of --main-pack.

ℹ️ Troubleshooting

A game doesn't launch or crashes

If the game you are trying to play doesn't work, it will most likely be because it was made with another version of Godot.

It could also be because it uses GDNative or C#, which the Raspberry Pi binaries doesn't support.

Force Godot to use the GLES2 video render

If you get this error when trying to play a game:

Your video card driver does not support any of the supported OpenGL versions. Please update your drivers or if you have a very old or integrated GPU upgrade it.

It means that the game you are trying to run uses the GLES3 video driver, which the Raspberri Pi doesn't support.

You'll have to force Godot to use the GLES2 video driver by passing the --video-driver GLES2 parameter, like this:

./godot_x.x.x_rpi4_export-template.bin --main-pack "/path/to/the/pck/file.pck" --video-driver GLES2

On Godot 2.x, use -vd instead of --video-driver.

🗒️ Changelog

See CHANGELOG.

👤 Author

  • hiulit

🤝 Contributing

Feel free to:

🙌 Supporting this project

If you love this project or find it helpful, please consider supporting it through any size donations to help make it better.

Become a patron

Suppor me on Ko-Fi

Buy me a coffee

Donate Paypal

If you can't, consider sharing it with the world...

... or giving it a star.

Thank you very much!

👏 Credits

Thanks to:

📝 Licenses

More Repositories

1

Godot-3-2D-Destructible-Objects

A script that takes a sprite, divides it into blocks and makes them explode 💥!
GDScript
393
star
2

Godot-3-2D-Day-Night-Cycle

A 2D ☀️ Day / 🌔 Night cycle using CanvasModulate and a moon light effect using Light2D.
GDScript
329
star
3

Godot-3-2D-CRT-Shader

A 2D shader for Godot 3 simulating a CRT
GLSL
299
star
4

Sassy-Gridlover

Super easy to use Sass mixins to establish a typographic system with modular scale and vertical rhythm. Based on the Gridlover app.
HTML
221
star
5

RetroPie-Godot-Engine-Emulator

A scriptmodule to install a Godot "emulator" for RetroPie.
Shell
91
star
6

Delaunator-GDScript

A GDScript port of Delaunator: A fast library for Delaunay triangulation of 2D points.
GDScript
80
star
7

GDScriptify

A magical documentation tool for GDScript.
JavaScript
48
star
8

Godot-Plugin-Particles-Renderer

A Godot plugin to render particles into a sprite sheet
GDScript
40
star
9

itchio-godot-scraper

A scraper for Godot games hosted on https://itch.io.
JavaScript
28
star
10

cross-compile-godot-raspberry-pi

A script to easily cross-compile Godot binaries for the Raspberry Pi from Linux x86_64 and an extra script to easily transfer the compiled Godot binaries to the Raspberry Pi using rsync
Shell
28
star
11

aseprite-to-godot-variables

A Lua script to create arrays of colors and indexes of those colors from an Aseprite sprite to be used in Godot.
Lua
23
star
12

Lospec-Palette-List

Browse through thousands of awesome Lospec palettes
GDScript
22
star
13

Murtop-Raspberry-Pi-Bartop-Arcade-Machine-Project

Personal project to create an actual playable Bartop Arcade Machine from scratch using a Raspberry Pi with RetroPie and lots of wood, paint and wires :)
20
star
14

Godot-3-2D-Fake-Explosion-Particles

A script to simulate exploding particles.
GDScript
18
star
15

Godot-3-2D-Fake-Snow-Particles

A script to simulate snow particles ❄️
GDScript
18
star
16

Godot-3-2D-Fake-Confetti-Particles

A script to simulate confetti particles 🎉
GDScript
14
star
17

RetroPie-Itchio-Godot-Scraper

A tool for RetroPie to scrape Godot games hosted on https://itch.io.
Shell
12
star
18

RetroPie-Convert-Videos

A tool for RetroPie to convert videos.
Shell
12
star
19

ppa

A PPA repository for my packages (Godot)
Shell
8
star
20

Godot-3-2D-Draw-Sprite

A script to create "sprites" using the _draw() function to easily create patterns, change the color palette, or change the pixel size.
GDScript
8
star
21

es-pixel-theme-extras

Script for RetroPie to install some extras for the EmulationStation's Pixel theme (Retropie menu icons, boot splashscreen and launching images)
Shell
5
star
22

RetroPie-Shell-Script-Boilerplate

A template for building shell scripts for RetroPie.
Shell
4
star
23

RetroPie-Fun-Facts-Splashscreens

A tool for RetroPie to generate splashscreens with random video game related Fun Facts!.
Shell
4
star
24

Godot-2D-Platformer-Test

GDScript
2
star
25

RetroPie-Limit-Last-Played-Games

A tool for RetroPie to limit the number of 'last played' games.
Shell
2
star
26

es-theme-extras

Script for RetroPie to install some extras for EmulationStation themes (icons, splashscreens and launching images)
Shell
1
star
27

Stylus-Mixins

A set of Stylus mixins
CSS
1
star
28

barcelona-bicycle-anchor-points

Find public bicycle anchor points near you in Barcelona!
JavaScript
1
star
29

RetroPie-Extras

A collection of my own scripts for RetroPie
1
star
30

lospec-api

An API for the Lospec Palette List
JavaScript
1
star
31

RetroPie-Murtop

A script to install Murtop on Retropie
Shell
1
star