upbge / upbge.github.io

Official UPBGE Website

UPBGE (Uchronia Project Blender Game Engine) is a fork of Blender created by Porteries Tristan (a Blender Game Engine developer) and some of his friends in September 2015.

It's an independent branch, and its aim is to clean up and improve current Blender Game Engine (BGE) code, experiment with new features, and implement forgotten features that currently exist but have not been merged with the official Blender trunk.

Currently, after the Blender Foundation's decision to delete BGE from next 2.8 release UPBGE becomes, de facto, the only one to follow the development of the Game Engine. This gives us even more freedom, if possible, to make certain decisions, since we will never, in any way, come into conflict with the official version.

Its development cycle spans the course of 4 months: 3 months to add new features and refactors and 1 months to fix bugs. Then a new release is made available for download (around 3 or 4 per year).

Regularly, the UPBGE merges the official Blender new patches, to stay up-to-date with the last Blender evolutions.

The UPBGE team is composed of volunteers; BGE users who are interested in the game engine development, a web developer, and a communication manager.

What's new?

You can take a look at the release notes to see all the new features: UPBGE Release Notes

From The Team

We hope that new users will join the project, to help us test new features, report bugs, provide feedback and ideas to improve UPBGE (https://github.com/UPBGE/blender/issues), and that new developers will join the team to help us develop shiny new features for the game engine.

upbge.github.io's Issues

[TODO] Implement Linux AArch64

Add real download to Linux AArch64 as promised for download page.

Viewing Documentation API Search Results Requires Refresh

If you enter a string in the Documentation, API searchbox, then click on a generated search result. The new URL is accepted but the webpage content isn't automatically refreshed, which means the viewer currently has to refresh the webpage by hand manually. (e.g. F5 shortcut)

Note: If you right-click over a generated search result and force it to open the new URL in a new tab/window. The webpage content will automatically refresh and work as expected.

Github icon

The Github icon on https://upbge.org/#/community looks really bad. Can you replace it with SVG?
(You can get it right here https://github.com/logos)

missing libpython

I am trying to build from sources, but:

CMake Error at /snap/cmake/1153/share/cmake-3.24/Modules/FindPackageHandleStandardArgs.cmake:230 (message):
  Could NOT find PythonLibsUnix (missing: PYTHON_LIBRARY PYTHON_LIBPATH
  PYTHON_INCLUDE_DIR PYTHON_INCLUDE_CONFIG_DIR)
Call Stack (most recent call first):
  /snap/cmake/1153/share/cmake-3.24/Modules/FindPackageHandleStandardArgs.cmake:594 (_FPHSA_FAILURE_MESSAGE)
  build_files/cmake/Modules/FindPythonLibsUnix.cmake:176 (FIND_PACKAGE_HANDLE_STANDARD_ARGS)
  build_files/cmake/platform/platform_unix.cmake:113 (find_package)
  CMakeLists.txt:976 (include)

[BUG] scrollTo top function does not always work

Note: This issue I can produce in Firefox but not MS Edge. Not sure exactly why.

scrollTo top function does not always seem to work on certain pages.

Demo Video Link

[BUG] Header is not affected by light/dark theme toggles

Despite different theme toggles, the header theme color remains a constant dark theme color.
It should be included with the rest of the theme content.

Dark Theme

Light Theme

[TODO] Improve mobile-support for download page

Currently the download page's button(s) seem to be ignoring margin/padding in a reduced display sized environment.
Like on mobile.

Segfault

Hi, got a segmentation fault with alpha version, simply I cannot start the executable.
Also I have not be able to debug it.

Website To-Do List

Comments

I create this issue to help & remind website developers.
Feel free to manually edit this post if a task has been completed or post ideas or requests if you have any.

Work-in-Progress'

• Add basic community page content.
• Add Legacy 0.2 download links as promised for the download page.
• Add Linux AArch64 support as promised at the download page.
• Add better mobile response content for the website, especially for the download page.
• Button components don't have margin or padding detection.
• Implement real 404 error page instead of redirecting to home page.

Current Bugs

• https://upbge.org when linked doesn't show a preview image.
• [CRITICAL] Documentation search results don't automatically refresh the current page to show new content.
  NOTE_1: this only happens for the 0.3 API but works for the 0.3 Manual & UPBGE 0.2.x Manual/API.
  NOTE_2: this only happens with the website Sphinx, not old Sphinx.
  https://upbge.org/docs/latest/api/index.html works fine but not https://upbge.org/#/documentation/docs/latest/api/index.html
• Navigation header isn't affected by light/dark color theme toggles.
• scrollTo top doesn't always work when switching to Documentation, Community, or Download page.

Old URLs don't redirect correctly to new website URLs

Old urls for documentation start with: https://upbge.org/manual/manual/...
while the new website starts with https://upbge.org/#/documentation/docs/latest/manual/manual/...

Therefore clicking on links to the old documentation leads to 404 error from github

[TODO] Implement real 404 page

Currently if a invalid website URL is inserted into a browser's address bar, the website will automatically redirect to the home page.
While this process is sufficient, it does not reset the URL address on home redirect.

EXAMPLE

Before

https://upbge.org/#/abc

After

Notice the address remains as previous even after redirect.

Conclusion

• The URL address should either be reset after redirect.
• OR the redirect should be the address of a working 404 page.
e.g.