Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Mutant Standard for PursuedPyBear

Project description


This library provides convenient support for the Mutant Standard emoji for games using the PursuedPyBear engine.

This version is for PursuedPyBear v0.8 and Mutant Standard v2020.04.


  1. Install the ppb-mutant package through your preferred package management system. (pip, requirements.txt, pipenv, poetry, etc)



A demo showing all emoji can be found by running python -m ppb_mutant.index.


You can replace the use of image with an Emoji asset:

class SlimeSprite(ppb.Sprite):
    image = ppb_mutant.Emoji('slime')

In addition, the formatting syntax with the variables morph and skin may be used for Mutant's customization features:

class PunchRightSprite(ppb.Sprite):
    image = ppb_mutant.Emoji('fist_facing_right_{morph}_{skin}', morph='clw', tone='r2')

See the modifier guide for details on these.

Alternatively, most customizable emoji also have aliases defined:

class PunchRightSprite(ppb.Sprite):
    image = ppb_mutant.Emoji('fist_facing_right', morph='clw', tone='r2')


If you want to change the morph/tone of a bunch of emoji as a group, use the MorphToneGroup:

player_emoji = ppb_mutant.MorphToneGroup(morph='paw', tone='g1')

class HandSprite(ppb.Sprite):
    image = player_emoji('hand')

class ProfileSprite(ppb.Sprite):
    image = player_emoji('adult')


SelectScene is a base for allowing you to handle mutant morph and tone (color) customization. It can be used like:

class CustomizeScene(ppb_mutant.SelectScene):
    class Sprite(ppb_mutant.SelectScene.Sprite): pass

    class BackSprite(Region, ppb.Sprite):
        image = Emoji('tick')
        def on_button_pressed(self, mouse, signal):
            if self.contains(mouse.position) and mouse.button is ppb.buttons.Primary:

    def __init__(self, **props):
        self.add(self.BackSprite(position=(-4, 1.5)))

    def do_update_morphtone(self):
        print(self.morph, self.tone)

For a demo, run python -m ppb_mutant.picker.

Copyright Notice

This library uses Mutant Standard emoji, which are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.


The image assets are not stored in git.

You can download a copy from the mutant standard website by running

Project details

Download files

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

Files for ppb-mutant, version 0.11.1
Filename, size File type Python version Upload date Hashes
Filename, size ppb_mutant-0.11.1-py3-none-any.whl (18.9 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ppb-mutant-0.11.1.tar.gz (13.6 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page