PHPackages                             clarkwinkelmann/flarum-ext-godot-embed - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. clarkwinkelmann/flarum-ext-godot-embed

ActiveFlarum-extension

clarkwinkelmann/flarum-ext-godot-embed
======================================

Embed Godot pck files in Flarum posts

1.0.0(4y ago)4672MITBlade

Since Jan 10Pushed 4y ago1 watchersCompare

[ Source](https://github.com/clarkwinkelmann/flarum-ext-godot-embed)[ Packagist](https://packagist.org/packages/clarkwinkelmann/flarum-ext-godot-embed)[ RSS](/packages/clarkwinkelmann-flarum-ext-godot-embed/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Godot Embed
===========

[](#godot-embed)

[![MIT license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/clarkwinkelmann/flarum-ext-godot-embed/blob/master/LICENSE.md) [![Latest Stable Version](https://camo.githubusercontent.com/30067db4b811576eec9599ac090c3a256ca0af2f356036ecc605067f175286f8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c61726b77696e6b656c6d616e6e2f666c6172756d2d6578742d676f646f742d656d6265642e737667)](https://packagist.org/packages/clarkwinkelmann/flarum-ext-godot-embed) [![Total Downloads](https://camo.githubusercontent.com/e3f2162db8375f48b5b0b47d525da81698b924317183dca450a762da87a3b4f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c61726b77696e6b656c6d616e6e2f666c6172756d2d6578742d676f646f742d656d6265642e737667)](https://packagist.org/packages/clarkwinkelmann/flarum-ext-godot-embed) [![Donate](https://camo.githubusercontent.com/0d6e4d8b50b5983a58205941b1a581b1305903393b7a39da574e3f60af3c7f5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d646f6e6174652d79656c6c6f772e737667)](https://www.paypal.me/clarkwinkelmann)

This extension adds a `[godot][/godot]` bbcode to Flarum that renders an iframe with an embedded player.

The bbcode is registered into FoF Upload as a template.

bbcode parameters (all optional):

- `filesize=INT`: `pck` file size in bytes. Automatically populated when using FoF Upload. Necessary for progress bar to be visible.
- `version=TEXT`: The unique key of a version defined in the admin panel.
- `cover=URL`: URL to an image file that will be rendered as background before the game is loaded.
- `args=TEXT`: Arguments to pass to Godot Engine. Will be parsed similarly to command line arguments and merged with `--main-pack` argument.
- `width=NUMBER` (default 600): Width of embedded player in pixels.
- `height=NUMBER` (default 400): Height of embedded player in pixels. Design is responsive, if the player is resized down, the ratio will be preserved.
- `touch=1`: Hides the "not compatible with touch devices" message.
- `autoload=1`: Loads the game without needing to click in iframe.
- `toolbar=left|right|hidden` (default: `right`): Changes on which side of the player the toolbar is inserted. `hidden` removes the toolbar completely (there will be no way to go full screen or restart).

Before you can use the extension, you need to download the templates from  and host the `webassembly_release.zip` files somewhere on your server. Then provide the public URL to that folder in the "Base path" setting in the admin panel. For example, you can extract to `/public/assets/godot` and set `/assets/godot` in the setting. Optionally add the size of the wasm file in bytes in the corresponding setting for the progress bar to render.

Multiple Godot versions can be configured in the admin panel. The order of the versions is not important, and the unique key can be anything using characters `- +,.0-9A-Za-z_`. The version selected as "default" will be injected in the FoF Upload template as well as in bbcodes that don't provide a version.

**This extension doesn't provide any built-in security!**For use in production, make sure the engine and game files are accessed through a CDN URL that doesn't allow access to Flarum cookies.

For example if your forum is hosted at `www.example.com`, you could configure `sandbox.example.com` as an alias in your VirtualHost. Then use that domain for the "Iframe Host" setting as well as FoF Upload CDN URL in case files are hosted using the `local` adapter.

If you are using a naked/apex domain as canonical URL, you can't use a subdomain as the sandbox domain! You will need a different domain! (sorry, that's how cookies work!)

You should add Apache or nginx rewrites for the following URLs:

- `/godot-embed` on main Flarum domain: block access with 401 or 404. Prevents abuse because it can load arbitrary files via query parameter.
- `/assets/files/*` on main Flarum domain: block access with 401 or 404 (when using FoF Upload `local` adapter). Malicious actors could use the liberal file validation to upload HTML files and trick users to visit for XSS.
- `/` (or anything except `/godot-embed` and `/assets/*`) on sandbox domain: redirect to main domain. This prevents anyone from accidentally trying to login on wrong domain or search engines from indexing duplicate content.

The resources are loaded like this:

- Browser: **\[Flarum domain\]** / Discussion
    - Iframe: **\[Sandbox domain\]** `/godot-embed?url=&cover=`
        - **\[Sandbox domain\]** / Flarum CSS
        - **\[Sandbox domain\]** / Flarum Fonts
        - **\[Base path\]** / Godot Engine
        - **\[Base path\]** / Godot WASM
        - ``
        - ``

Installation
------------

[](#installation)

```
composer require clarkwinkelmann/flarum-ext-godot-embed

```

Support
-------

[](#support)

This extension is under **minimal maintenance**.

It was developed for a client and released as open-source for the benefit of the community. I might publish simple bugfixes or compatibility updates for free.

You can [contact me](https://clarkwinkelmann.com/flarum) to sponsor additional features or updates.

Support is offered on a "best effort" basis through the Flarum community thread.

**Sponsors**: [Xwdit](https://github.com/Xwdit)

Links
-----

[](#links)

- [GitHub](https://github.com/clarkwinkelmann/flarum-ext-godot-embed)
- [Packagist](https://packagist.org/packages/clarkwinkelmann/flarum-ext-godot-embed)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1583d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0538135c1debcef5602dce7ece027909cc832b7a6284ab9189a19aa8de98d60d?d=identicon)[clarkwinkelmann](/maintainers/clarkwinkelmann)

---

Top Contributors

[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (33 commits)")

---

Tags

embedflarumgodot

### Embed Badge

![Health badge](/badges/clarkwinkelmann-flarum-ext-godot-embed/health.svg)

```
[![Health](https://phpackages.com/badges/clarkwinkelmann-flarum-ext-godot-embed/health.svg)](https://phpackages.com/packages/clarkwinkelmann-flarum-ext-godot-embed)
```

###  Alternatives

[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[fof/gamification

Upvotes and downvotes for your Flarum community

4157.1k6](/packages/fof-gamification)[fof/user-bio

Add a user bio to user profiles

2196.5k9](/packages/fof-user-bio)[flarum-lang/russian

Russian language pack for Flarum.

13126.1k](/packages/flarum-lang-russian)[fof/drafts

Allow users to create post and discussion drafts

1771.1k5](/packages/fof-drafts)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
