https://github.com/wavy-cat/wavy-totem-lib

Library to generate totems of undying for Minecraft
https://github.com/wavy-cat/wavy-totem-lib

minecraft minecraft-texturepack minecraft-tools minecraft-totem python python-library

Last synced: 5 months ago
JSON representation

Library to generate totems of undying for Minecraft

• Host: GitHub
• URL: https://github.com/wavy-cat/wavy-totem-lib
• Owner: wavy-cat
• License: bsd-3-clause
• Created: 2024-02-07T15:41:12.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-12-11T13:26:19.000Z (6 months ago)
• Last Synced: 2025-12-12T16:43:26.882Z (6 months ago)
• Topics: minecraft, minecraft-texturepack, minecraft-tools, minecraft-totem, python, python-library
• Language: Python
• Homepage: https://totemlib.wavycat.me
• Size: 431 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# TotemLib (aka wavy-totem-lib)

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/wavy-totem-lib?style=for-the-badge&logo=Python&logoColor=white&label=Version&labelColor=1A222E&color=242B36&cacheSeconds=0)

![GitHub License](https://img.shields.io/github/license/wavy-cat/wavy-totem-lib?style=for-the-badge&labelColor=1A222E&color=242B36)

![GitHub repo size](https://img.shields.io/github/repo-size/wavy-cat/wavy-totem-lib?style=for-the-badge&logo=github&logoColor=white&labelColor=1A222E&color=242B36&cacheSeconds=0)

Python library to generate totems of undying for Minecraft.

---

## Features

* Support 64x32 skins

* Zoning 2 layers and rounding the head

* Lossless scaling image size

* Asynchrony support

* Supports PyPy

* Supports different patterns (styles)



  

  

  



## Documentation

The documentation is available at https://totemlib.wavycat.me, as well as https://totemlib-docs.wavycat.workers.dev.

## Installing

#### Using uv

```bash

uv add wavy-totem-lib

```

#### Using Poetry

```bash

poetry add wavy-totem-lib

```

#### Using pip

```bash

pip install wavy-totem-lib

```

## Quick start

```python

from wavy_totem_lib import TotemBuilder, Skin, Totem, TopLayer

builder = TotemBuilder(

    Skin('my_skin.png'),

    top_layers=[TopLayer.HEAD],  # the second layer will be applied only to the head

    round_head=True  # the head will be rounded at the corners

)

totem: Totem = builder.build()

totem.image.save('totem.png')  # .image is Pillow image

```