Getting Started

Welcome to the roa-texture-loader wiki!

Creating a texture pack

creating a texture pack is really simple, and is very similar to how rivals' workshop format works.

Here is a template texture pack that you can edit to your liking, it overwrites the main menu icon to its japanese variant example-pack.zip

Texture pack folder format

texturepack-folder
|   local_pref.ini
│   pack.png
│   pack.ini
│   spr_prop.ini
│
└───spr
│   │   <sprite_name>_strip#.png
│   │   ...
│   
└───shader
|   │   <shader_name>.glsl
|   │   ...
|
└───sound
    │   <sound_name>.ogg
    │   ...

pack.png and pack.ini are not required, but can be used to identify your texture pack inside the texture pack list

e.g.

local_pref.ini defines the priority (the order that the texture pack gets loaded in; higher number = loads before other texture packs, lower number = vice versa), as well as if it is enabled or not. you don't need to include this file when sharing texture packs

example pack.ini file:

pack-name: "example-pack"
pack-description: "template texture pack"
author: "user"
version: 2.1.9.1

spr_prop.ini defines custom properties for sprites, such as

• xoffset - x offset of where the sprite will be rendered from the owner's origin point
• yoffset - y offset of where the sprite will be rendered from the owner's origin point
• speed - sprite animation speed

example spr_prop.ini file:

# this file can be used to define sprite instance variables

roa_logo_half_spr:
    xoffset: 98
    yoffset: 50
    speed: 5

Certain sprites such as character animations will ignore animation speed variables due to character states overwriting them. adding additional frames to said sprites will also not work properly

Sprites folder (spr/)

inside the spr/ folder you can place any rivals sprite or spritestrip into it (the image format must be .png, of course)

spritestrips are defined by adding _strip# at the end of the file name, just like with workshop sprites

Changing the sprite size of certain projectiles (such as Orcane droplet, Kragg rock, Zetter fireball) can cause desyncs online and potential bugs offline, as some aspects of their trigger hitbox are affected by it. avoid changing these if possible.

Shaders folder (shader/)

This folder currently isnt implemented and does nothing. Once it is, you will be able to overwrite various shaders inside of the game. (e.g. text outlines, Merchant Port's ocean distortion effect, Neo Fire Capital signs, etc)

Sounds/Music folder (sound/)

This folder overwrites sound effects and music files within the game. self explanitory

overwriting music that have _loop suffixes start at a hardcoded offset and will skip the first couple of seconds as a result. currently trying to figure out what the offsets are for each file 🤔

Migrating from rivals modding tool mods

This process is thankfully very easy, YellowAfterlife has created a data.win viewer called yytextureview (https://yal.cc/game-tools/yytextureview/) that allows custom sprites installed by the rivals modding tool to be extracted into spritestrips.

inside of yytextureview, you will want to open data.win by clicking "Menu!" on the top left of the page and "Open..." inside the dragdown. once thats successful you will have to go back into the dragdown menu and click "Save strips". this process takes a bit of time.

the extracting also pauses if you minimize the tab or go to a different window also 💀. so don't do anything else while this is happening

It will ask to download a zip file that contains all of the spritestrips, download those and extract them. You can then pick which sprites you need and copy them into your texture pack's sprite folder!