Skip to Content
Nextra 2 Alpha
DocumentationCreator ToolsThe coin creator in Telegram

The coin creator in Telegram

/newpack (or /emojipack) with no premium emoji attached opens the coin flow: an image first, then a choice between full customization and an instant random coin. The wizard offers 11 spin styles and 7 colours, and no texture option at all.

The flow, in order

From nothing to a coin

  1. Send /newpack (or /emojipack) with no premium emoji pasted into it. The bot replies “Let’s make a 3D coin emoji. Send an image — upload a PNG, SVG, or AVIF as a file to keep transparency, or paste an image URL.”, with a Cancel button.
  2. Send one image — a document upload, a photo, or a bare http(s) URL. (If the original /newpack message already carried an image, or a caption containing an http(s) URL, this step is skipped and that image is used immediately.)
  3. The bot asks “Would you like to customize the coin?” with three buttons: Yes, customize / No, surprise me / Cancel.
  4. Pick one of the two paths below.

There is no texture option anywhere in this flow. The Telegram wizard exposes exactly two customizable settings — spin style (11 options) and colour (7 options) — and always builds with face_frac fixed at 0.95 and front_only on; neither is exposed as a button.

No, surprise me

Skips every remaining question and builds immediately. The bot replies “Creating your coin now!”.

What it sets

SettingValue
TitleYour Telegram display name (first + last name; if neither, @username; if no username either, “My”), truncated to 49 characters, with ” - @memescaleai” appended — 64 characters total.
Spin stylefast — the wizard’s default.
ColourOne of the 7 colours, chosen at random.
face_frac / front_only0.95 / on, same as every coin this wizard builds.

Overwrites an earlier pick

If a spin style and/or colour were already chosen — for example through the Add New Emojis → Coin flip chooser, which asks for spin then colour before the image — tapping No, surprise me still applies fast and a random colour, discarding whatever was picked.

Yes, customize

Order of questions

  1. Bot asks “Send a name for the pack.” Your reply is truncated to 64 characters (empty text falls back to “Coin pack”) and is deleted from the chat.
  2. Bot asks “Pick a spin style.” — 11 buttons, 3 per row.
  3. Bot asks “Pick a colour.” — 7 buttons, 2 per row.
  4. If this is a new pack and the image is already attached, the coin build starts the moment a colour is picked: “Creating your coin now!” Otherwise — adding to an existing pack through the chooser, where no image has been sent yet — the bot asks for the image next.

The name is always collected before the spin style and colour, so the pack’s title is known before the build ever starts — there is no point in this flow where a coin can commit without a name already chosen.

Spin styles and colours

Values, order and labels below are exact. Nine of the eleven spin styles have no description anywhere in the codebase, so none are described here — only the name and the value each button sends.

Spin style — ep:m:<value>, 11 options, 3 per row

ValueLabel
fastFast (default)
classicClassic
bounceBounce
wobbleWobble
pendulumPendulum
glideGlide
launchLaunch
driftDrift
heavyHeavy
showcaseShowcase
cinemaCinema

Colour — ep:c:<value>, 7 options, 2 per row

ValueLabel
goldGold (default)
silverSilver
rosegoldRose Gold
emeraldEmerald
blueSteel Blue
holoHolo
blackOnyx

Where the coin is built

The bot does not render the coin itself. It posts the image, colour, spin style, face_frac and front_only as a multipart upload to the dashboard host’s internal /api/internal/coin-build endpoint (90-second client timeout) and receives the finished animated-sticker bytes back. The dashboard host runs scripts/coin_tgs.py to do the actual rendering — the coin is built on the dashboard host, never on the bot’s own server.

The @memescaleai watermark

No, surprise me appends ” - @memescaleai” to its own auto-generated title, described above. That is a separate mechanism from the pack watermark proper: the only flow that force-appends ” @memescaleai” to a name you typed is the Existing Emoji mode’s naming step — not the coin flow. A name you type in Yes, customize is used exactly as typed, with nothing appended.