libgdx 3D 游戏开发完整路线：从相机投影到四端发布

【免费下载链接】libgdxDesktop/Android/HTML5/iOS Java game development framework项目地址: https://gitcode.com/gh_mirrors/li/libgdx

libgdx 是一款跨平台 Java 游戏框架，同一套代码能跑在 Desktop、Android、HTML5 和 iOS 上。想切入 libgdx 3D 游戏开发，不必先啃完 API 文档，只要把“相机—模型—表面—光照—运动—打包”这条链路走通，一个能转、能贴图、有光影、能落到手机和浏览器的场景就成立了。下面按能力递进拆解每一环，类名与目录均对应仓库真实路径，方便边读边查。

🧭 把 2D 直觉换成透视相机：三参数怎么调

从 2D 到 3D，第一件要换掉的是“屏幕坐标”思维：3D 里所有点都先经过相机投影到屏幕，相机就是这段变换的开关。libgdx 用PerspectiveCamera表示透视相机，构造时传入fov（垂直视野角，67 度常用）、视口宽、视口高；之后position定位置、lookAt定向、near/far定裁剪面，最后必须update()才会重算投影矩阵。

PerspectiveCamera cam = new PerspectiveCamera(67, Gdx.graphics.getWidth(), Gdx.graphics.getHeight()); cam.position.set(10, 10, 10); cam.lookAt(0, 0, 0); cam.near = 1f; cam.far = 30f; cam.update();

让鼠标拖动转视角

手算参数很容易晕。仓库带了CameraInputController，挂到InputMultiplexer上即可用鼠标平移、旋转、缩放；gdx-tests 示例 里的Basic3DTest是标准接法，直接照抄。

🧊 加载 .g3dj 模型并贴进场景

相机就位后，放一个真实模型。libgdx 的模型用 g3d 格式（.g3djJSON 可读 /.g3db二进制），G3dModelLoader继承ModelLoader，配合JsonReader读文件，这就是 libgdx 模型加载的核心路径。加载出Model后再包一层ModelInstance才有摆放位置，最后交给ModelBatch：它在begin(camera)到end()间收集实例、按材质分组、一次 flush，省掉逐帧绑定。

Model model = new G3dModelLoader(new JsonReader()).loadModel(Gdx.files.internal("data/g3d/head.g3db")); ModelInstance instance = new ModelInstance(model); ModelBatch modelBatch = new ModelBatch(); modelBatch.begin(cam); modelBatch.render(instance); modelBatch.end();

图：head_color.png，head.g3db 的贴图，随材质解析后交给 ModelInstance 渲染

🎨 给模型贴砖块纹理：材质与法线贴图

模型默认是灰的——因为还没绑材质。Material是一组Attribute，贴一张漫反射图只需加一条TextureAttribute，法线、高光各加一条。.g3dj材质文件本质就是这些属性的 JSON，G3dModelLoader读模型时会顺带解析同目录材质；data/g3d/materials/下有 brick、cloth、metal 等现成例子可参考。

图：brickRound_diffuse.png，作为 diffuse 贴图贴到墙面模型上

图：Cannon_Normal_01a.png，法线贴图补出表面凹凸，配合漫反射更立体

💡 用 Environment 加一盏平行光与天空盒

没有光的场景是一片死黑，这是 libgdx 3D 游戏开发里最易漏的一步。libgdx 把光照打包在Environment里传给ModelBatch：先设一条ColorAttribute.AmbientLight定环境光，再add一盏DirectionalLight（前三参数是颜色、后三是方向向量）。背景可直接把 skydome 或一张全景图当天空盒。

Environment env = new Environment(); env.set(new ColorAttribute(ColorAttribute.AmbientLight, 0.4f, 0.4f, 0.4f, 1f)); env.add(new DirectionalLight().set(0.8f, 0.8f, 0.8f, -1f, -0.8f, -0.2f));

图：skydome.png，作为天空盒让场景有远天背景

图：space.jpg，2:1 全景图，可作环境反射或天空背景

🕹️ 让物体落地：接入 libgdx 物理引擎

纯变换的模型不受重力、不碰撞。要真实交互，用 gdx-bullet 扩展：建一个btDynamicsWorld，把btRigidBody加进去，每帧stepSimulation(delta, substeps)，再把刚体getWorldTransform同步回ModelInstance.transform，渲染与物理即对齐。BasicBulletTest里地面用btBoxShape、球体用btSphereShape，是最小可跑范式；2D 场景另有 gdx-box2d 扩展。

图：jump.png，动画帧序列；3D 里同样靠逐帧更新 transform 驱动角色

📦 从 Gradle 配置到四端产物：多端发布

写一次、跑多端，正是 libgdx 跨平台的价值，也是 libgdx 3D 游戏开发的收尾。看 settings.gradle 就能确认后端矩阵：gdx-backend-lwjgl3（桌面）、gdx-backend-android、gdx-backend-gwt（浏览器）、gdx-backend-robovm（iOS）各自独立成模块，核心逻辑共享在gdx模块。你只需为每个目标端建一个启动类（实现ApplicationListener），场景与资源完全复用；发布时按端选 Gradle 任务，桌面出 jar、Android 出 apk、GWT 编译成 JS 进index.html、iOS 经 RoboVM 打包。桌面端可先读 gdx-backend-lwjgl3 后端 的初始化入口。

下一步行动清单

• 用PerspectiveCamera加CameraInputController，先跑通一个能转视角的空场景
• 把data/g3d/head.g3db换成你的.g3dj模型，确认材质贴图正常
• 给场景加一盏DirectionalLight，观察明暗面变化
• 用gdx-bullet加一个落地刚体，把物理变换同步回ModelInstance
• 在settings.gradle里为 android 与 gwt 各建一个启动类，分别出包验证 libgdx 多端发布

【免费下载链接】libgdxDesktop/Android/HTML5/iOS Java game development framework项目地址: https://gitcode.com/gh_mirrors/li/libgdx