oxmc
691f85d8ce
- Root cause of the persistent white/blank browser on the Chrome 152 build: the official-build (is_official_build=true) native binary hits Linux's first-run/EULA check in ContentMainRun (no master_preferences shipped -> eula_required defaults true -> CHROME_RESULT_CODE_EULA_REFUSED) before it can spawn any renderer/GPU child. Add --no-first-run to DEF_CEF_ARGS, and add an in-game GuiMcefEula prompt (shown once on the first main menu open) that writes the actual "EULA Accepted"/ "First Run" sentinel files CEF checks for, deferring CEF's native startup until accepted (or setting virtual mode on decline). - webdisplays' postInit() (which now unavoidably runs before CEF may have started, since that's gated on EULA acceptance) crashed with an NPE calling registerJSQueryHandler before cefRouter existed; queue such registrations and flush them once CEF actually initializes. - Rewrite LocateWidevine.java (previously dead code - never called from anywhere, and buggy even on its own: manifest "platforms" is an array of objects not strings, the search loop could overwrite a found path with null, and every Log.info(TAG, msg) call passed TAG as the format string and silently dropped the actual message). --enable-widevine has no effect on our platform (it's a Fuchsia-only switch); actual Widevine support needs enable_widevine=true at CEF's GN build time (already set) plus a real CDM binary in CEF's cache dir, which we have no component-updater network path to fetch ourselves. Wire LocateWidevine.installInto() to find and symlink (falling back to copy) an existing Widevine CDM from the system's real browser install into CEF's cache dir instead. - Move ModScheme out of the example package into net.montoyo.mcef.client and register the "mod://" scheme directly from ClientProxy, so it no longer requires any example-browser code to be loaded/enabled.
MCEF
Minecraft Chromium Embedded Framework (MCEF) is an API to allow Minecraft Modders to add custom web browsers into Minecraft. The project was initialy made for WebDisplays (www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/1291044-web-displays-browse-on-the-internet-in-minecraft). It is based on JCEF (https://code.google.com/p/javachromiumembedded/), which is based on CEF (https://bitbucket.org/chromiumembedded/java-cef) which is based on chromium (http://www.chromium.org).
Features
- 2D & 3D web view rendering (not only in GUIs)
- Java -> JavaScript (IBrowser.runJavaScript)
- JavaScript -> Java (IJSQueryHandler)
- Embedded files (mod://modname/file.html => /assets/modname/html/file.html)
- HTML5, CSS3 are supported.
What can I do with this?
- If you're tired of Minecraft's GuiScreen, you can make a HTML/JS/CSS GUI.
- Open a link to your wiki.
- Whatever you want, but please not a WebDisplays clone.
Currently supported platforms
- Windows 10 x64
- macOS (Intel-based Macs only) - needs work, frequent crashes
- Linux x64 (tested on Fedora 34 and Ubuntu 20.04)
For players
This is the Github project of MCEF; here you can only read the source code of it. You can download the mod in its latest version from here: http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/2324969-minecraft-chromium-embedded-framework-mcef
For modders
DONT copy the net.montoyo.mcef.api package into your project. Instead, download the latest API release from https://github.com/montoyo/mcef/releases and put it in the libs folder. Users will have to download the mod from the MinecraftForum thread. To understand how it works, you may look at the net.montoyo.mcef.example package, which demos:
- The IBrowser interface, how to draw it and control it
- The IJSQueryHandler interface, how to handle JavaScript queries
- The IDisplayHandler interface, how to handle browser URL changes
- How to use the mod:// scheme
For forkers
Don't forget to add "-Dfml.coreMods.load=net.montoyo.mcef.coremod.ShutdownPatcher" to the VM options, otherwise the Java process will hang forever!