Sprite Sheet Extender (Deprecated)

ALERT: This mod is officially deprecated. I have made a much better version of this mod that you can access here. This mod will be kept up for those mod artists who still rely on it as they migrate to the newer mod and for those mod authors who cannot or will not migrate but still rely on this mod.

PLEASE NOTE! THIS MOD DOES NOT ADD ANY SPRITES. THIS MOD IS A UTILITY TO BE USED BY MOD CREATORS TO ALLOW THEM TO ADD SPRITES. IF YOU ARE NOT MAKING YOUR OWN MOD OR USING THIS AS PART OF SOMEONE ELSE'S MOD, THIS MOD WILL NOT DO ANYTHING AND WILL GIVE YOU AN ERROR.

This mod allows you to expand the farmer sprite sheet beyond the original 125 frame limit. All it requires is adding this mod and then adjusting the config.json file to set the x and y offset to align the hair and clothing with the added sprite. Each sprite needs x AND y coordinates to be added. If not added, events will throw an index out of range error.

-Open your mod folder

-Open manifest.json

-Add to dependencies :

"UniqueID": "mooseybrutale.spriteextender",

"IsRequired": "false"

-Launch SMAPI

-If you have GMCM installed, go to settings and add the number of sprites you are adding to the sprite sheet

-If you are only using one gender, you only need to set one gender. Leaving it at 0 will be fine.

-If you do not have GMCM, these changes can be made in your mod folder in the now added SSXConfig.json file but will require a game restart to take effect.

-Load or start new save

The mod will automatically add dummy values for the amount of sprites you specified (first time only).

These values all default to (Format: )

Your sprite frames should now be usable!

--Changing Sprite Offset--

If your farmer's hair, clothing and accessories do not line up when using your sprite, you need to change the offset settings.

You can do this by going into the SSXConfig.json file and editing the pair for the sprite or by editing it in the SMAPI console using the setFrameOffset command.

--Console Commands--

setFrameOffset - allows you to modify x and y offset for the indicated sprite

Changes made will automatically be saved to your SSXConfig.json file and loaded anytime someone loads your mod.

Format: setFrameOffset <frame index> <x-offset> <y-offset>

<frame index> - The frame number of the sprite you want to edit. MUST BE GREATER THAN 125!

<x-offset> The number of pixels to horizontally offset the farmer's hair and clothes (positive right, negative left)

<y-offset> The number of pixels to vertically offset the farmer's hair and clothes (positive down, negative up)

getFrameOffset - al