mkpanda 0.1.0

Cross-platform generator (mkpanda command) for new Panda3D projects.

panda3d-boilerplate

Cross-platform generator for new Panda3D projects. Installs as a global mkpanda command.

Install

Requires Python 3.8+ and pipx (recommended) or pip.

pipx install git+https://github.com/Bebopskull/panda3d-boilerplate.git
# once published to PyPI: pipx install mkpanda

Or with pip + venv:

python3 -m pip install --user git+https://github.com/Bebopskull/panda3d-boilerplate.git

Use

mkpanda /path/to/my-game

Optional second argument sets the display name (defaults to the directory name):

mkpanda /path/to/my-game "My Awesome Game"

Update

pipx upgrade mkpanda

Or to force-reinstall the latest from GitHub:

pipx install --force git+https://github.com/Bebopskull/panda3d-boilerplate.git

Uninstall

pipx uninstall mkpanda

What it creates

my-game/
├── src/
│   ├── main.py              # ShowBase entry point
│   ├── scenes/              # Scene/state system (base + menu example)
│   ├── input/               # Centralized input manager
│   └── utils/logger.py      # Stdout logging
├── assets/
│   ├── models/
│   ├── textures/
│   ├── sounds/
│   ├── fonts/
│   └── shaders/
├── config/config.prc        # Window, audio, model paths
├── tests/
├── requirements.txt         # panda3d
├── .gitignore
├── README.md
└── run.sh                   # Linux/macOS launcher

Next steps in the generated project

cd /path/to/my-game
python3 -m venv .venv
source .venv/bin/activate         # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python src/main.py

Contributing

Open to PRs. The repo layout:

• panda3d_boilerplate/cli.py — the mkpanda entry point
• panda3d_boilerplate/templates/ — files copied into new projects (with {{PROJECT_NAME}} substitution)
• pyproject.toml — packaging metadata; bump version for releases

To test changes locally:

git clone https://github.com/Bebopskull/panda3d-boilerplate.git
cd panda3d-boilerplate
pipx install --force .
mkpanda /tmp/test-project "Test"

License

MIT