📜
Dead Sea Scrolls
  • Getting Started
    • Dead Sea Scrolls (DSS)
    • Installation
  • Tutorials
    • Making a basic menu
    • Adding changelogs
    • Adding menu palettes
    • Gotchas
  • Documentation
    • Global Methods
    • Objects
      • Directory
      • DirectoryKey
      • Page
  • Meta
    • Missing Definitions
Powered by GitBook
On this page
  • Intro
  • Setting up
  • Adding changelogs
  • Formatting codes
  1. Tutorials

Adding changelogs

Learn how to add changelogs to your mod.

Intro

We're going to add changelogs to our mod that will appear along with changelogs from other enabled mods. When new changelogs are added, a popup will appear for the player, letting them know of the change.

Setting up

Changelogs tend to be quite long. To keep things organized, you generally want to keep all the changelogs in a dedicated file. Let's create a new file in our mod called changelogs.lua. Make sure you include it in your main.lua file, or else it won't be loaded.

include("changelogs") -- This should be the path to your changelogs file

Adding changelogs

Adding changelogs is super easy. Just use the AddChangelog function of the DeadSeaScrollsMenu global.

  • The first argument is variadic and can be up to 4 arguments long. It is used to categorize your changelogs and place them under up to 4 layers of buttons. Typically, the first argument is your mod's name and the second argument is the version your changelogs are for.

  • The final argument should be the string that is your changelog. You can define a long string with two square bracket pairs. Long strings can span across multiple lines without needing to define a new line with .

Unlike other strings, the strings provided in these arguments are automatically converted to lowercase. This lets you copy and paste changelogs from other places without needing to edit much.

DeadSeaScrollsMenu.AddChangelog("Awesome Mod", "v1.0.0", [[I made this awesome mod!

It is just so cool.

Thanks for playing!!!
]])

Formatting codes

You can add formatting codes to your changelogs. These can do various things, such as changing font size and text color.

You can edit the font size of a line by adding a font size tag to the beginning of it. The font size is 1 by default. There is no tag for setting the size to 1.

Code
Description

{FSIZE2}

A large font size.

{FSIZE3}

A very large font size.

DeadSeaScrollsMenu.AddChangelog("Awesome Mod", "v1.0.0", [[I made this awesome mod!

{FSIZE2}It is just so cool.

{FSIZE3}Bye!]])

Font size codes will remove any text before them in the line, so they should always be used at the start of a new line.

You can change the color of a chunk of text by wrapping it in a color tag.

Code
Description

{CLR1}

Text will be invisible.

{CLR2}

Text will be the primary text color of the theme.

{CLR3}

Text will be the secondary text color of the theme.

DeadSeaScrollsMenu.AddChangelog("Awesome Mod", "v1.0.0", [[{FSIZE2}{CLR1I made}{CLR3this awesome mod!}

{FSIZE2}{CLR2It is just so cool}.

{FSIZE2}{CLR3Bye!}]])

If you're going to use multiple color codes in a single line, do not add a space between the code and whatever comes before or after it. Doing so will remove some characters in your sentence.

When giving DSS a string you usually have to make all readable text lowercase, else the uppercase characters will appear as a different character. DSS does not require this with changelogs and will automatically convert your string to lowercase. If you do not want this behavior, you can wrap it in this tag.

DeadSeaScrollsMenu.AddChangelog("Awesome Mod", "v1.0.0", [[

THIS TEXT APPEARS NORMALLY
EVEN THOUGH IT IS UPPERCASE

{SYMTHIS TEXT DOES NOT APPEAR NORMALLY!}

]])

You can download the example mod and inspect how it works below.

PreviousMaking a basic menuNextAdding menu palettes

Last updated 2 years ago

110 KB file on MEGA
Logo
All mods with changelogs added will appear on the main changelogs page
Clicking on the changelog and viewing it through the menu
All different font sizes shown in use, from smallest to largest.
Displaying the invisible color being used mid-line next to the secondary color. The second line is the primary color, and the third line is the secondary color.
The first paragraph appears normally and readable, while the second paragraph is a bunch of exclamation points and division symbols.