gamelib/ReadMe.org

• Setup
• Asset pipeline
  • Blender setup
  • OGRE Export Settings
  • Converting .mesh.xml to .mesh

#+TITLE:GameLib

GameLib is my library for making games. It is the successor to base2.0.

GameLib is written in Cakelisp.

Setup

Clone the repository and its dependencies:

git clone https://macoy.me/code/macoy/gamelib.git
git submodule update --init --recursive
hg clone http://hg.libsdl.org/SDL Dependencies/SDL

Build dependencies:

./BuildDependencies_Debug.sh

Build:

./Build_Debug.sh

Asset pipeline

This is a work in progress.

Blender setup

• Install Blender. I can confirm Blender 2.91 works.

• Copy blender2ogre to Blender plugins:

cp -r Dependencies/blender2ogre/io_ogre/ ~/.config/blender/2.91/

• Open Blender, then open Preferences (Edit->Preferences), and click Add-ons

• Search for "Ogre" and check the box to enable the OGRE Exporter

• Build Ogre, if you haven't already (run BuildDependencies_Debug.sh)

• Set OGRETOOLS_XML_CONVERTER to where you built OgreMeshTool. You'll need to browse to gamelib/Dependencies/ogre-next/build/Debug/bin/OgreMeshTool_d

You are now ready to export. Open your model or create one, then do File -> Export -> Ogre3D. See the following section for settings. Note: I will be making command-line driven auto-exporting to reduce these manual steps.

OGRE Export Settings

• Don't export materials. These are v1 materials as far as I know, which don't work with Ogre 2

• Don't export scene. I don't use these files

• Ensure mesh export version is set to v2

Converting .mesh.xml to .mesh

You shouldn't need to do this step if you set OGRETOOLS_XML_CONVERTER, but in case blender2ogre didn't recognize it, here's how I worked around it:

cd Dependencies/ogre-next/build/Debug/bin
./OgreMeshTool_d -e -O puqs ../../../../../test/data/Models/Suzanne.mesh.xml

Run this after you've made an attempted export from the Blender OGRE plugin.