The name here actually follows the standard format for Text Components in minecraft, so they are configurable in all the ways that the title command typically is. You can use this wiki to learn how to further configure the name of your dialogue

This dictates what the texture of the item will look like. Its a string to chose between one of our 5 built in options. The options are:

• "BRASS_TAPE_RECORDER"
• "HAND_HELD_SPEAKER"
• "TEAL_PHONOGRAPH"
• "WOODEN_RADIO"
• "PURPLE_PHONOGRAPH"

The default option if left blank is "BRASS_TAPE_RECORDER"

There are 2 types of displays you can use for your subtitiles that affect how the subtitile text is rendered on screen.

Canvas

Canvas display is the default, it renders a box of a single color behind the text. By default it looks like this:

{
  "display": {
    "color": "black",
    "alpha": 128,
    "width": 50,
    "padding": 10,
    "margin": {
      "top": 0,
      "bottom": -80,
      "left": 0,
      "right": 0
    }
  }
}

Most of these values are self-explanatory. Padding and margin both use the same type of config, so a valid padding and margin config can either look like this

{
  "margin": {
    "top": 10,
    "bottom": 10,
    "left": 0,
    "right": 0
  }
}

or this

{
  "margin": 0
}

The single number margin/padding will apply that number of margin or padding to all 4 sides.

Turns out the color system in Resourceful Lib is really complicated, and has ALOT of configurable options. Its very nice and flexible for those of you who want to go crazy with pretty colors. I recommend using one of the preconfigured options here. If you want more explanation on the colors, join our Discord and bother ThatGravyBoat, apparently there are a dozen different ways you can configure a color. there's also a ✨ option maybe? idk join and find out ;).

Texture

Alternatively, if you're goin for a different vibe, you can replace the canvas with a rendered texture. Its a little complicated, so stick with me here.

The texture for the dialogue needs 3 components. Think of it like a sandwich. The top bun "top", which part gets rendered on top, the meat "background", the part that gets rendered multiple times in a stack to fit the height of the box, and the bottom bum "bottom" which renders on the bottom. Together, these components allow a very flexible text box experience. That looks something like this.

{
  "display": {
    "top": {
      "texture": "{modid}:guis/momento.png",
      "x": 0,
      "y": 0,
      "u": 0,
      "v": 0,
      "width": 256,
      "height": 256,
      "textureWidth": 256,
      "textureHeight": 256
    },
    "background": {
      // same as top, but slightly different
    },
    "bottom": {
      //same as top, but slightly different
    }
  },
  ...
}

Lets run through these values

"x" and "y"

• Imagine you have a selection box that you're dragging to select a group of pixels in a paint. These coordinates are where it will start selecting from.

"u" and "v"

• Ima be honest, this is rendering stuff, you probably shouldn't change this unless you know what you're doing. These values have a default value of 0 and 0, you can leave these out and it'll fill them in with the default values automatically.

"width" and "height"

• Remember how I said we're drawing a selection box starting at x and y? This is the size of that selection box.

"textureWidth" and "textureHeight"

• This is the dimensions of the entire image that the "texture" refers to. You should leave these values blank, as all gui files in Minecraft are typically 256x256 in size.

The recommended way of doing this for you texture artists is to draw your textbox in a single file, make the top, background and bottom all refer to the same file and change the 'selection box' to encapsulate different regions of the texture for the top, bottom and background sections. Your selection boxes can be touching each other, so it's fine to make the texture look like 1 connected box and then layer the selection boxes stacked next to each other.