<<< Back to User Guide

How to Use Custom Icons (local only)

I recoloured a bunch of Skaven sprites for my team bio, one thing led to another and I spent a long time trying to see if anyone had figured out how to put custom icons/colours in the client - as far as I can tell, they have not, and the feature is seemingly not in the works to implemented at this time.

I then spent a long time reading through the FFB Github to try and see if I could figure out a way to do it myself, and I now have. There must be others out there somewhere like me, so I thought I'd post a quick step-by-step to save them the trouble.

A few caveats - the custom icons only appear on your own client and they are not associated with a particular player or team (so you will see them when spectating other teams, and you don't have much control over which particular icon goes to which player).

Step One: Download and Paint your Icons

FUMBBL's player iconsets are publicly available here. I did a simple palette-swap for each of the red-team Skaven positional to be purple, like below. Image (I know they look pretty reddish on the forum but I promise you can tell they're purple on the field)

So long as you keep the image dimensions correct (4:1) you can go as wild as you want with the changes, including bashing together sprites or drawing brand new ones.

Step Two: Turn On Local Cache in the Client

Open up a game (spectate or replay will do) and go to User Settings > Client Settings > Local Icon Cache > and turn it On. Select a folder that will be easy for you to find.

The first time you open FFB after turning it on, that folder will populate with a bunch of images/icons (mostly star players and pitches) and a file called "map.json" with a format like this:

Code:

and so on.

You can add your own mappings of URLs to this map.json to "trick" the client into using an image you have saved to the cache folder. So save the modified iconset to the cache folder - I named mine "Linemen.png".

Step Three: Find the Icon ID

This can be found in a number of places and is just the same id you would is for the picon tag used in BB code. You can find It by right clicking on the icon and copying the address, or hovering over the icon on the page already linked above or even use the Player API (by inserting the relevant players player id instead on '999')

Code:

So in this case, 58625 or https\://cdn.fumbbl.com/i/58625.png for the full reference.

Step Four: Add the Mapping

Open up map.json, and add to the end of the list (right before the double curly bracket "}}") your new mapping. For my recoloured linemen, it would be:

Code:

Now when the game is going to load Skaven linemen, it will reference that URL and check the cache, see that we already have an image saved for that iconset, and use our custom sprites instead - purple rats on the field!

Copied from Oughta Forum Post. Great work.