Skip to main content

A Python package to help bootstrap and manage Panda3D applications

Project description

Build Status Panda3D Versions

Panda3D Manager

pman is a Python package to help bootstrap and manage Panda3D applications.


  • Project quick-start
  • Automatic asset conversion
  • Automatically adds export directory to the model path
  • Convenient CLI for running and testing applications


Use pip to install the panda3d-pman package:

pip install panda3d-pman


Quick start a project with pman create. If you already have a directory for your project:

cd my_awesome_project
pman create .

pman can also create the directory for you:

pman create my_awesome_project

In addition to the create command, pman has the following commands:

  • update - re-run project creation logic on the project directory
  • help - display usage information
  • build - convert all files in the assets directory and place them in the export directory
  • run - run the application by calling python with the main file
  • test - run tests (shortcut for python test)
  • dist - create distributable forms of Panda3D applications (requires Panda3D 1.10+)
  • clean - remove built files


Primary configuration for pman is located in a .pman file located at the project root. This configuration uses TOML for markup. The .pman configuration file is project-wide and should be checked in under version control.

Another, per-user configuration file also exists at the project root as .pman.user. This configuration file stores user settings and should not be checked into version control.

Settings in .pman.user take precedence over settings in .pman. Settings defined in neither .pman nor .pman.user will use default values as defined below.

General Options

Section name: general

option default description
name "Game" The project name. For now this is only used for naming the built application in the default

Build Options

Section name: build

option default description
asset_dir "assets/" The directory to look for assets to convert.
export_dir ".built_assets/" The directory to store built assets.
ignore_patterns [] A case-insensitive list of patterns. Files matching any of these patterns will not be ignored during the build step. Pattern matching is done using the fnmatch module
converters ["native2bam"] A list of hooks to perform conversions. Any files not associated with a converter will simply be copied (assuming they do not match an item in ignore_patterns).

Run Options

Section name: run

option default description
main_file "" The entry-point to the application.
extra_args "" A string of extra arugments that are append to the invocation of main_file.
auto_build true If true, automatically run builds as part of running the application (via pman.shim.init). This is disabled in deployed applications.


To extend functionality, pman has supports for "hooks." There are currently hooks available for conversion (converters) and project creation (creation extras). These hooks are specified in config via Setuptools entry points. Hooks that ship with pman and their configuration options are described below.



Entry point: native2bam Support file formats: egg, egg.pz, obj (and mtl), fbx, dae, ply

Loads the file into Panda and saves the result out to BAM. This relies on Panda's builtin file loading capabilities.




Entry point: blend2bam Supported file formats: blend

Converts Blender files to BAM files via blend2bam.


Section name: blend2bam

option default description
material_mode "legacy" Specify whether to use the default Panda materials ("legacy") or Panda's new PBR material attributes ("pbr"). This is only used by the "gltf" pipeline; the "egg" always uses "legacy".
physics_engine "builtin" The physics engine that collision solids should be built for. To export for Panda's builtin collision system, use "builtin." For Bullet, use "bullet." This is only used by the "gltf" pipeline; the "egg" pipeline always uses "builtin."
pipeline "gltf" The backend that blend2bam uses to convert blend files. Go here for more information.

Running Tests

First install the project in editable mode along with test extras:

pip install -e .[test]

Then run the test suite with pytest:


Building Wheels

Install build:

pip install --upgrade build

and run:

python -m build



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

panda3d_pman-0.14.tar.gz (27.0 kB view hashes)

Uploaded source

Built Distribution

panda3d_pman-0.14-py3-none-any.whl (32.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page