Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vhou-atroph/build-a-cog

A Python package to make the creation of Cog actors easier!
https://github.com/vhou-atroph/build-a-cog

library pyo3 pypi-package python rust toontown toontown-rewritten toontownrewritten ttr

Last synced: 28 days ago
JSON representation

A Python package to make the creation of Cog actors easier!

Host: GitHub
URL: https://github.com/vhou-atroph/build-a-cog
Owner: Vhou-Atroph
License: mit
Created: 2022-11-21T21:13:20.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2024-03-24T19:42:53.000Z (9 months ago)
Last Synced: 2024-11-13T15:09:00.101Z (about 1 month ago)
Topics: library, pyo3, pypi-package, python, rust, toontown, toontown-rewritten, toontownrewritten, ttr
Language: Rust
Homepage: https://pypi.org/project/build-a-cog/
Size: 657 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: readme.md
- License: LICENSE

Awesome Lists containing this project

README

# build-a-cog

A Python package to make the creation of Cog actors easier!

## Dependencies

build_a_cog depends on Panda3D. If you have not installed it already, you can do so with the following command:

```ps
pip install Panda3D
```

## Installing

To install the latest version of build_a_cog, open your favorite command terminal and use the following command:

```ps
pip install build_a_cog
```

If for whatever reason you are unable to install build_a_cog through pip, you can also install it through the [latest source distribution released on GitHub](https://github.com/Vhou-Atroph/build-a-cog/releases/latest). Download the .whl file and open your favorite command terminal. Navigate to wherever the file was downloaded and run the following command:

```ps
pip install [file]
```

## Usage

With build_a_cog, the creation of Cog actors becomes much easier.
Like with any other Panda3D Toontown project, you must first extract the Phase Files. You can do so with the following command, with [x] being replaced by the id of the phase file:

```ps
multify.exe -xf phase_[x].mf
```

With build_a_cog, you will need phase_3, phase_3.5, phase_4, phase_5, phase_6, phase_7, phase_11, and phase_12. Once these files are extracted, drop them into the same directory you want to have your Python files in. Your directory should look similar to this:

Next, drop the three suit type models in your main directory. tt_a_ene_cga_zero.bam, tt_a_ene_cgb_zero.bam, and tt_a_ene_cgc_zero.bam are all in phase_3.5/models/char. Finally, you will need the suit icon model: ttr_m_gui_gen_cogIcons.bam. You can find this file in phase_3/models/gui. Once these files are in your directory, it should look like this:

Now that all the necessary files are here, you can open the Python file containing your scene and start to program! Here's an example scene:

```python
from direct.directbase.DirectStart import base

import build_a_cog as cog

yesman = cog.build(cog.Cog(suit=cog.Suit(model="tt_a_ene_cga_zero.bam",
sigil="CorpIcon",
torso="phase_3.5/maps/c_blazer.jpg",
arms="phase_3.5/maps/c_sleeve.jpg",
legs="phase_3.5/maps/c_leg.jpg",
hands=(0.95,0.75,0.75,1.0)
),
head=cog.Head(file="phase_4/models/char/suitA-heads.bam",
node="yesman",
texture=None,
color=None
),
animation=cog.Animation(file="phase_5/models/char/tt_a_ene_cga_song-and-dance.bam",
anim_loop=True,
loop_from=None,
loop_to=None,
loop_restart=None,
pose=False,
pose_frame=None
)
))

yesman.setPos(0,20,-4.2)
yesman.setH(180)
yesman.reparentTo(render)

base.run()
```

This code will produce the following cog:

![A Yesman cog from Toontown performing the Song and Dance animation.](https://raw.githubusercontent.com/Vhou-Atroph/build-a-cog/main/tests/test_cog.png)

## Documentation

You can find documentation for build_a_cog in the [rustycog lib.rs file](https://raw.githubusercontent.com/Vhou-Atroph/build-a-cog/main/src/lib.rs).

## License

Code in build_a_cog is licensed under the [MIT License](https://raw.githubusercontent.com/Vhou-Atroph/build-a-cog/main/LICENSE).