Undertale Text Box Generator developer help

How to use the generator from your own or a third-party program

Using the "API" will require a user token at some point. It will always be free to use, but you should keep that in mind.

We still don't have an API, strictly speaking, but it's really easy to use the text box generator from its URL. All you need to do is pass data as a parameter and get the resulting image. Any kind of program capable of downloading and uploading images or, in a less optimal case, able to build links and send them, is also capable of interacting with the generator.

The easiest way to generate an image is by adding data to this URL: https://demirramon.com/utgen.png?message=(text)

The text inside the message parameter must be properly URL-encoded, as characters like spaces, ?, &, and + can cause issues and unintended behavior. If not possible, they must be replaced with %20, %3F, %26, and %2B respectively.

To select the parameters from the generator site, you must add them anywhere inside the message string (I recommend before or after the text), like this:
character=toriel size=1 margin=true Greetings, my child.

Adding that into the message parameter would result in a link similar to this one and generate the following image:
https://www.demirramon.com/gen/undertale_box.png?message=character%3Dtoriel+size%3D1+margin%3Dtrue+Greetings%2C+my+child.

Avaliable parameters

box sets the box shape. The avaliable box types are: undertale, underswap, underfell, octagonal, derp.
boxcolor sets the color of the box outline. It can be a name or a HEX color.
character selects a character. Check the section below for character names. If you want to input a URL, set this parameter to "custom".
expression chooses a expression. Check the section below for expressions.
url uses the image from a URL if you selected "custom" as a character. Otherwise, this will be ignored.
charcolor changes the color of the sprite.
font chooses a font (can only be set once).
asterisk sets if there will be asterisks (true) or not (false). It can also be a color or multiple split by commas.
size sets the scale of the box: 1 for small, 2 for medium, and 3 for large.
margin sets if there will be a black margin around the box (true) or not (false).
mode changes the text mode. If set to "darkworld", the text will have purple drop shadows and, when colored, will have gradients.

All of these parameters are optional. Default values for the font and asterisk will depend on the selected character.

You can also change the color of the text with the color code anywhere in the text. If you want to get rid of the space added after changing a color you can use the special code text=join right after.

Character and expression codes

To use the characters and their expressions you will need to know their names. There's also alias that work just like the names so it's a little easier to remember them.

Instructions for the content API will be added to this section soon.
For now, you can use the selector below to check for character and expression names manually.

Characters

Expressions