Ogre deprecation j3o format - Example by NwosuTy · Pull Request #2726 · jMonkeyEngine/jmonkeyengine

NwosuTy · 2026-04-29T17:14:54Z

Tagged The Ogre Loader as Deprecated

Converted all Models and Scenes used in Examples to .j3o files, and then switched all deprecated ogre files loading paths to the new .j3o files except where specified needed for ogre loading testing, deleted all unused ogre files

Note: could not find the main.scene file for conversion in scenes such as the TestAspectFov, TestMultiplesFilters etc

closes #2667

Marked Ogre Loaders with Deprecated Tag Converted all Ogre files except where neccessary to .J3o file and modified where used in examples to load .j3o file itself, also deleted unused Ogre files

gemini-code-assist

Code Review

This pull request updates various asset loading paths in the jMonkeyEngine examples to use the .j3o format instead of the deprecated OgreXML (.mesh.xml, .scene) formats. Additionally, it adds deprecation notices and annotations to the Ogre-related classes and packages to encourage migration to modern formats like glTF. I have no further feedback to provide.

NwosuTy · 2026-04-30T06:08:14Z

@riccardobl I know where the problem is and would fix and send, in the mean time the main.scene/j3o file I asked of is throwing bull errors in some scenes I was asking for its location but it seems that's fine for you

riccardobl · 2026-04-30T09:43:10Z

The main.scene is loaded from a zip file via http, you can see the code here:

jmonkeyengine/jme3-examples/src/main/java/jme3test/water/TestPostWaterLake.java

Lines 77 to 80 in 530fb0e

    
               assetManager.registerLocator( 
        
                       "https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/jmonkeyengine/wildhouse.zip",  
        
                       HttpZipLocator.class); 
        
           } else {

that's from the very old jme repo on google code, if you want to convert it, I can rehost it somewhere else, but not an hard requirement for this PR as it is going to be a bit painful to debug

Restored Elephant.Skeleton.xml file for the Core tests, needed a mes.xml file with an anim composer Modified screenshottests files to load the .j3o files rather than the previously changed ogre files

github-actions · 2026-04-30T11:59:08Z

🖼️ Screenshot tests have failed.

The purpose of these tests is to ensure that changes introduced in this PR don't break visual features. They are visual unit tests.

📄 Where to find the report:

Direct Download: screenshot-test-report
Alternatively, go to the failed run summary > Artifacts > screenshot-test-report
Download the zip and open jme3-screenshot-tests/build/reports/ScreenshotDiffReport.html

⚠️ If you didn't expect to change anything visual:
Fix your changes so the screenshot tests pass.

✅ If you did mean to change things:
Review the replacement images in jme3-screenshot-tests/build/changed-images to make sure they really are improvements and then replace and commit the replacement images at jme3-screenshot-tests/src/test/resources.

✨ If you are creating entirely new tests:
Find the new images in jme3-screenshot-tests/build/changed-images and commit the new images at jme3-screenshot-tests/src/test/resources.

Note; it is very important that the committed reference images are created on the build pipeline, locally created images are not reliable. Similarly tests will fail locally but you can look at the report to check they are "visually similar".

See https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-screenshot-tests/README.md for more information

Contact @richardTingle (aka richtea) for guidance if required

Could Have Sworn i committed these files, restored them to fix null errors and failing screenshot tests

NwosuTy · 2026-04-30T12:59:11Z

@riccardobl i am done, you could proceed with a manual test, thank you

…J3o-Format

riccardobl · 2026-05-01T15:31:35Z

Thanks! I'll start reviewing this shortly.
I am rebasing this on master, so do not worry about CI failures in the meantime

…J3o-Format

NwosuTy · 2026-05-01T16:19:38Z

Sure whenever you are done and if you are satisfied with the results please inform, so I could try and apply for the bounty fee

NwosuTy · 2026-05-01T16:20:54Z

Also if you want to fix the main.scene problem, I dont mind having a go at it next month, do enjoy the learning process.

riccardobl

Looks good so far! I am still halfway through the testing, will continue later.
I've found only one single broken example so far, that is reported in this review.

….java

…uTy/jmonkeyengine into Ogre-Deprecation-J3o-Format

NwosuTy · 2026-05-01T21:54:46Z

Resolved all 3 Reviews raised @riccardobl

riccardobl · 2026-05-03T08:43:39Z

                        Node rootNode = ((SimpleApplication)app).getRootNode();
                        Camera cam = app.getCamera();
-                        Spatial ogreModel = assetManager.loadModel("Models/Oto/Oto.mesh.xml");
+                        Spatial ogreModel = assetManager.loadModel("Models/Oto/Oto.j3o");


this is actually testing the ogre format itself, so it should not be modified by this PR, this means also the Oto model should be kept in the asset folder

…uTy/jmonkeyengine into Ogre-Deprecation-J3o-Format

Co-authored-by: Riccardo Balbo <os@rblb.it>

riccardobl

Thanks!
I made some final touches and restored the ogre files (even if we don't need them anymore, i figured they could still be used by third party code).

Also if you want to fix the main.scene problem, I dont mind having a go at it next month, do enjoy the learning process.

Yeah, these two zip files basically need the same conversion you did here, the only difference is that you would have to submit the zip as attachment to the PR so that I can host it somewhere. And for testing you would need to temporarily switch the locator to ZipLocator instead of HttpZipLocator to load it locally (or just use a local http server to serve it).

If you want to submit a follow up pr for this, feel free.

Regarding this PR, it is complete and mergeable now.
You can claim the bounty by submitting an expense of type "invoice" to our bounty program via our opencollective organization page, let me know when you do that, so I can approve it on my side.

NwosuTy · 2026-05-04T06:36:06Z

Thanks!
I made some final touches and restored the ogre files (even if we don't need them anymore, i figured they could still be used by third party code).

Also if you want to fix the main.scene problem, I dont mind having a go at it next month, do enjoy the learning process.

Yeah, these two zip files basically need the same conversion you did here, the only difference is that you would have to submit the zip as attachment to the PR so that I can host it somewhere. And for testing you would need to temporarily switch the locator to ZipLocator instead of HttpZipLocator to load it locally (or just use a local http server to serve it).

If you want to submit a follow up pr for this, feel free.

Regarding this PR, it is complete and mergeable now.
You can claim the bounty by submitting an expense of type "invoice" to our bounty program via our opencollective organization page, let me know when you do that, so I can approve it on my side.

Yeah I'd like take on the issue, where do I submit the follow up

Then for this PR, thank you very much I'd create the invoice now, I do hope a wise ACH transfer is possible

…uTy/jmonkeyengine into Ogre-Deprecation-J3o-Format

@deprecated

…testdata Port the code-side changes of #2726 (the .j3o assets are already published in the jme3-testdata artifact): - jme3-examples: switch example load paths from *.mesh.xml/*.scene to the equivalent .j3o (Oto, Sinbad, Sword, Elephant, Ninja, Teapot, Sign Post, Tank2, Rocket, MonkeyHead, Tree, WaterTest, Car_Scene, Terrain, ManyLights/Main, DotScene). Includes the getWorldLightList()-> getLocalLightList() adjustment in TestManyLightsSingle. - Add @deprecated to the ogre-loading examples kept for ogre coverage (TestOgreConvert, TestOgreLoading, TestOgreAnim, TestOgreComplexAnim). - Add @deprecated to the ogre loaders in jme3-plugins (MaterialLoader, MeshAnimationLoader, MeshLoader, OgreMeshKey, SceneLoader, SceneMaterialLoader, SceneMeshLoader, SkeletonLoader, package-info). - screenshot-tests shared scenarios: ScenarioCartoonEdge -> MonkeyHead.j3o, ScenarioLightScattering -> Terrain.j3o (ScenarioOgreConvert stays on ogre). Repoint town.zip/wildhouse.zip from the dead googleapis URL to the jme-testdata raw GitHub URLs, which now serve main.j3o instead of main.scene: - HelloCollision, TestAspectFov, TestSceneLoading, TestSceneWater, TestPostWaterLake, TestMultiplesFilters load "main.j3o" from the new URLs. - TestOnlineJar and jme3-core TestLocators use the new zip URLs. Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com>

@deprecated

…testdata Port the code-side changes of #2726 (the .j3o assets are already published in the jme3-testdata artifact): - jme3-examples: switch example load paths from *.mesh.xml/*.scene to the equivalent .j3o (Oto, Sinbad, Sword, Elephant, Ninja, Teapot, Sign Post, Tank2, Rocket, MonkeyHead, Tree, WaterTest, Car_Scene, Terrain, ManyLights/Main, DotScene). Includes the getWorldLightList()-> getLocalLightList() adjustment in TestManyLightsSingle. - Add @deprecated to the ogre-loading examples kept for ogre coverage (TestOgreConvert, TestOgreLoading, TestOgreAnim, TestOgreComplexAnim). - Add @deprecated to the ogre loaders in jme3-plugins (MaterialLoader, MeshAnimationLoader, MeshLoader, OgreMeshKey, SceneLoader, SceneMaterialLoader, SceneMeshLoader, SkeletonLoader, package-info). - screenshot-tests shared scenarios: ScenarioCartoonEdge -> MonkeyHead.j3o, ScenarioLightScattering -> Terrain.j3o (ScenarioOgreConvert stays on ogre). Repoint town.zip/wildhouse.zip from the dead googleapis URL to the jme-testdata raw GitHub URLs, which now serve main.j3o instead of main.scene: - HelloCollision, TestAspectFov, TestSceneLoading, TestSceneWater, TestPostWaterLake, TestMultiplesFilters load "main.j3o" from the new URLs. - TestOnlineJar and jme3-core TestLocators use the new zip URLs. Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> Co-authored-by: Dev_Conceited <tthompson3012@gmail.com>

@deprecated

#3033) * Initial plan * Remove jme3-testdata module and use standalone org.jmonkeyengine:jme3-testdata artifact Migrate the engine build off the in-repo jme3-testdata module now that the test data lives in its own repository (jMonkeyEngine/jme-testdata) with its own release cycle on Maven Central. - Add org.jmonkeyengine:jme3-testdata:2026-10-31-2 to the version catalog - Replace project(':jme3-testdata') with the external artifact in jme3-core, jme3-terrain, jme3-jbullet, jme3-examples and the screenshot-tests modules - Extract the artifact jar for the Android and iOS example app assets instead of referencing the removed module's resources directory - Drop the module from settings.gradle and delete jme3-testdata/ Closes #3032 Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> * Use jme3-testdata 2026-10-31-3 (Java 11 compatible) Bump the standalone test data artifact from 2026-10-31-2 to 2026-10-31-3, which is built for Java 11 compatibility. Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> * Port ogre->j3o code changes from #2726 and repoint zip assets to jme-testdata Port the code-side changes of #2726 (the .j3o assets are already published in the jme3-testdata artifact): - jme3-examples: switch example load paths from *.mesh.xml/*.scene to the equivalent .j3o (Oto, Sinbad, Sword, Elephant, Ninja, Teapot, Sign Post, Tank2, Rocket, MonkeyHead, Tree, WaterTest, Car_Scene, Terrain, ManyLights/Main, DotScene). Includes the getWorldLightList()-> getLocalLightList() adjustment in TestManyLightsSingle. - Add @deprecated to the ogre-loading examples kept for ogre coverage (TestOgreConvert, TestOgreLoading, TestOgreAnim, TestOgreComplexAnim). - Add @deprecated to the ogre loaders in jme3-plugins (MaterialLoader, MeshAnimationLoader, MeshLoader, OgreMeshKey, SceneLoader, SceneMaterialLoader, SceneMeshLoader, SkeletonLoader, package-info). - screenshot-tests shared scenarios: ScenarioCartoonEdge -> MonkeyHead.j3o, ScenarioLightScattering -> Terrain.j3o (ScenarioOgreConvert stays on ogre). Repoint town.zip/wildhouse.zip from the dead googleapis URL to the jme-testdata raw GitHub URLs, which now serve main.j3o instead of main.scene: - HelloCollision, TestAspectFov, TestSceneLoading, TestSceneWater, TestPostWaterLake, TestMultiplesFilters load "main.j3o" from the new URLs. - TestOnlineJar and jme3-core TestLocators use the new zip URLs. Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> Co-authored-by: Dev_Conceited <tthompson3012@gmail.com> * Apply remaining changes Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> * fix --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> Co-authored-by: Riccardo Balbo <riccardo0blb@gmail.com> Co-authored-by: Dev_Conceited <tthompson3012@gmail.com> Co-authored-by: Riccardo Balbo <os@rblb.it>

riccardobl · 2026-10-31T16:10:36Z

Merged with #3033

@deprecated

…o (#3033) NGE port: Consume the published official test-data artifact; preserve local NGE assets in nge-testdata and examples in nge-examples. * Initial plan * Remove jme3-testdata module and use standalone org.jmonkeyengine:jme3-testdata artifact Migrate the engine build off the in-repo jme3-testdata module now that the test data lives in its own repository (jMonkeyEngine/jme-testdata) with its own release cycle on Maven Central. - Add org.jmonkeyengine:jme3-testdata:2026-10-31-2 to the version catalog - Replace project(':jme3-testdata') with the external artifact in jme3-core, jme3-terrain, jme3-jbullet, jme3-examples and the screenshot-tests modules - Extract the artifact jar for the Android and iOS example app assets instead of referencing the removed module's resources directory - Drop the module from settings.gradle and delete jme3-testdata/ Closes jMonkeyEngine/jmonkeyengine#3032 Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> * Use jme3-testdata 2026-10-31-3 (Java 11 compatible) Bump the standalone test data artifact from 2026-10-31-2 to 2026-10-31-3, which is built for Java 11 compatibility. Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> * Port ogre->j3o code changes from #2726 and repoint zip assets to jme-testdata Port the code-side changes of jMonkeyEngine/jmonkeyengine#2726 (the .j3o assets are already published in the jme3-testdata artifact): - jme3-examples: switch example load paths from *.mesh.xml/*.scene to the equivalent .j3o (Oto, Sinbad, Sword, Elephant, Ninja, Teapot, Sign Post, Tank2, Rocket, MonkeyHead, Tree, WaterTest, Car_Scene, Terrain, ManyLights/Main, DotScene). Includes the getWorldLightList()-> getLocalLightList() adjustment in TestManyLightsSingle. - Add @deprecated to the ogre-loading examples kept for ogre coverage (TestOgreConvert, TestOgreLoading, TestOgreAnim, TestOgreComplexAnim). - Add @deprecated to the ogre loaders in jme3-plugins (MaterialLoader, MeshAnimationLoader, MeshLoader, OgreMeshKey, SceneLoader, SceneMaterialLoader, SceneMeshLoader, SkeletonLoader, package-info). - screenshot-tests shared scenarios: ScenarioCartoonEdge -> MonkeyHead.j3o, ScenarioLightScattering -> Terrain.j3o (ScenarioOgreConvert stays on ogre). Repoint town.zip/wildhouse.zip from the dead googleapis URL to the jme-testdata raw GitHub URLs, which now serve main.j3o instead of main.scene: - HelloCollision, TestAspectFov, TestSceneLoading, TestSceneWater, TestPostWaterLake, TestMultiplesFilters load "main.j3o" from the new URLs. - TestOnlineJar and jme3-core TestLocators use the new zip URLs. Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> Co-authored-by: Dev_Conceited <tthompson3012@gmail.com> * Apply remaining changes Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> * fix --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com> Co-authored-by: Riccardo Balbo <riccardo0blb@gmail.com> Co-authored-by: Dev_Conceited <tthompson3012@gmail.com> Co-authored-by: Riccardo Balbo <os@rblb.it> Upstream-Commit: 8eac246644e2df626bf4f0e16be39075dafe2cc3

NwosuTy added 3 commits April 29, 2026 18:05

Deprecated Ogre Loaders

626b36a

Marked Ogre Loaders with Deprecated Tag Converted all Ogre files except where neccessary to .J3o file and modified where used in examples to load .j3o file itself, also deleted unused Ogre files

Test Gimpact and Removal of List of Ogre Files Text

c41f67f

Typo Fix

880ee10

gemini-code-assist Bot reviewed Apr 29, 2026

View reviewed changes

NwosuTy mentioned this pull request Apr 29, 2026

Deprecation of Ogre Loader #2713

Closed

Failed Test Fix

e9b04fc

Restored Elephant.Skeleton.xml file for the Core tests, needed a mes.xml file with an anim composer Modified screenshottests files to load the .j3o files rather than the previously changed ogre files

Restored J3o files and Deleted unused ogre files

01853cf

Could Have Sworn i committed these files, restored them to fix null errors and failing screenshot tests

NwosuTy changed the title ~~Ogre deprecation j3o format~~ Ogre deprecation j3o format - Example Apr 30, 2026

Merge remote-tracking branch 'upstream/master' into Ogre-Deprecation-…

f9f7367

…J3o-Format

Merge remote-tracking branch 'upstream/master' into Ogre-Deprecation-…

359e226

…J3o-Format

riccardobl requested changes May 1, 2026

View reviewed changes

Comment thread jme3-examples/src/main/java/jme3test/helloworld/HelloCollision.java Resolved

Comment thread jme3-examples/src/main/java/jme3test/model/anim/TestOgreComplexAnim.java Resolved

Comment thread jme3-examples/src/main/java/jme3test/light/TestManyLightsSingle.java Resolved

riccardobl and others added 4 commits May 1, 2026 18:38

Update jme3-examples/src/main/java/jme3test/helloworld/HelloCollision…

44a0985

….java

Fixed Documentation Typos

a48d1c5

Merge branch 'Ogre-Deprecation-J3o-Format' of https://github.com/Nwos…

8e07ad9

…uTy/jmonkeyengine into Ogre-Deprecation-J3o-Format

Fixed Broken Scene Issue regarding Main.j3o

f50a2e9

NwosuTy requested a review from riccardobl May 3, 2026 08:08