Edit of asset "GDCEF Godot4" Accepted

Old/Current New/Edit
Title GDCEF Godot4
Description gdCEF - Web Viewer Plugin for Godot 4.x
=======================================

gdCEF is a web viewer plugin for Godot >= 4.2, compatible with Linux, Windows, and macOS.
It uses the Chromium Embedded Framework (CEF) to bring web content into your 2D and 3D applications.

Notes:
------
1. Godot 3 users: gdCEF is no longer maintained but still available here:
https://godotengine.org/asset-library/asset/1426

2. Android and iOS are not supported by CEF and therefore not by gdCEF.

Installation Methods
====================

There are three ways to install gdCEF in your project:

1. Direct Download (Prebuilt Binaries)
---------------------------------------
- Download binaries from GitHub:
https://github.com/Lecrapouille/gdcef/releases
- Extract the archive and place the 'cef_artifacts' folder into your project.

Limitations:
* Fixed versions of CEF and Godot.
* The artifacts folder name cannot be changed.
* Only x64 architectures are supported due to CI limitations.

2. Script-Based Download (since v0.12.0)
----------------------------------------
- Download the gdCEF source code from the Godot Asset Library.
- Use the provided Python 3 build script:
addons/gdcef/build.py
- C++ source folders can be deleted as they are not compiled.
- Set the GITHUB_GDCEF_RELEASE variable to the version you want.
- Run the script to download binaries and set up demo scenes.

Limitations:
* Same as the direct download method.

3. Build from Source (Recommended)
----------------------------------
- Download the gdCEF source code from the Godot Asset Library.
- Run the Python 3 script: addons/gdcef/build.py
- The script is preconfigured but can be customized at the top.

Build Process (takes 5–15 minutes):
* Downloads and compiles godot-cpp.
* Downloads and extracts prebuilt CEF.
* Compiles gdCEF.

Requirements:
* Python 3 with necessary packages.
* Build tools: SCons, CMake, Make or Ninja.
* On macOS: Xcode Command Line Tools.
* On Windows: Visual Studio, Windows SDK, console with admin rights.

After compilation, you can try the demo scenes in:
addons/gdcef/demos

Documentation
=============

- Installation Guide:
https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/doc/installation.md

- API Reference:
https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/doc/API.md

- Design Details:
https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/doc/detailsdesign.md

- Demos Info:
https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/demos/README.md

- FAQ:
https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/README.md#faq

Community & Support
===================

For help with installation or general questions, join our Discord:
https://discord.gg/EckEwy7S5U
gdCEF is a web viewer plugin for Godot 4.2 and 4.3, available on Linux, Windows and MacOSX, based on the Chromium Embedded Framework (CEF) for your 2D and 3D applications.

Note 1: For Godot 3 users, gdCEF is no longer maintained but still available at: https://godotengine.org/asset-library/asset/1426
Note 2: Android and iOS devices are not supported by CEF and therefore by gdCEF.

There are three methods to install gdCEF in your project:

1. Direct Download Method:
- Download pre-built gdCEF artifacts directly from GitHub: https://github.com/Lecrapouille/gdcef/releases
- Available for Linux, Windows and MacOSX (x64 architectures only).
- Simply untar and place the cef_artifacts folder in your project.
- Limitations:
* Cannot choose CEF or Godot versions.
* Cannot customize the artifacts folder name.
* Limited to x64 architectures due to CI constraints.

2. Script-Based Download (since v0.12.0):
- Download gdCEF source code from Godot Asset Library.
- Use the provided Python3 build script (addons/gdcef/build.py).
- Folders with C++ source code can be removed as they are not compiled.
- Set GITHUB_GDCEF_RELEASE variable to your desired version.
- Run the script to download artifacts and prepare demos.
- Has the same limitations as the direct download method.

3. Compilation Method (Recommended):
- Download gdCEF source code from Godot Asset Library.
- Run the Python3 build script (addons/gdcef/build.py).
- Script is preconfigured but customizable in its first section.
- Process (5-15 minutes):
* Downloads and compiles godot-cpp.
* Downloads and compiles prebuilt CEF.
* Compiles gdCEF.
- Requirements:
* Python3 with required plugins.
* Build tools: Scons, CMake, Make or Ninja.
* For MacOSX: Xcode Command Line Tools.

Once gdCEF has been compiled, you can try demos in the addons/gdcef/demos folder.

The project also offer documentation:
- Installation: https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/doc/installation.md
- API: https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/doc/API.md
- Details Design: https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/doc/detailsdesign.md
- Demos: https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/demos/README.md
- FAQ: https://github.com/Lecrapouille/gdcef/blob/godot-4.x/addons/gdcef/README.md#faq

Otherwise, for installation help or general questions, the best way is to join our Discord: https://discord.gg/EckEwy7S5U
Category 2D Tools
License MIT
Repository Provider GitHub
Repository Url https://github.com/Lecrapouille/gdcef
Issues Url https://github.com/Lecrapouille/gdcef/issues
Godot version Godot 4.2
Version String 0.17.0-godot4 0.14.1-godot4
Download Commit 27202c7a291f36847042c3f7fdbddedec8331125 0319a57410c3bb6c94caefc8a63a58f4806f40fc
Download Url (Computed) https://github.com/Lecrapouille/gdcef/archive/27202c7a291f36847042c3f7fdbddedec8331125.zip https://github.com/Lecrapouille/gdcef/archive/0319a57410c3bb6c94caefc8a63a58f4806f40fc.zip
Icon Url https://raw.githubusercontent.com/Lecrapouille/gdcef/godot-4.x/addons/gdcef/demos/3D/icon.png