====== PlayGround ======

====== Replacing image files ======
Images in OMORI contain most visual elements you can see through the game, those include but are not limited to:
  * Battle backgrounds
  * Characters
  * Enemies
  * Faces
  * UI

Changing images can be done with any image editor and requires a [[modding:getting_started|decrypted copy of OMORI]].

===== Finding the files to replace =====
The first step to modifying the game's images are locating the images you want to change.
Images can be found under ''img'' in the folder of your [[modding:getting_started|decrypted copy]].

Under ''img'' you should find the following folders

{{:modding:decrypted_folder_img.png?400|}}

Each folder contains a series of image files, usually in a ''png'' format, that each serve the purpose indicated by the folder's name.

^Folder name^Folder contents^
|''animations''|Frames that compose the animations appearing in combat|
|''atlases''|Miscellaneous images, themselves made out of images from other folders, mainly for ease of access and loading, editing those should not be required for anything|
|''battlebacks1''|Backgrounds that appear in battle|
|''characters''|Miscellaneous sprites that appear in the overworld|
|''enemies''|Images of the enemies that appear in FOE FACTS|
|''faces''|Faces of the various main characters, both in combat and out of combat|
|''overlays''|Images that appear overlaid on top of the game during certain story segments|
|''parallaxes''|Backgrounds that appear on certain maps, most notably in BLACKSPACE|
|''pictures''|Miscellaneous images used for all sorts of purposes|
|''slotmachine''|Images that appear in the slot machine minigame in the LAST RESORT|
|''sv_actors''|Images of the enemies that appear in combat, including emotion variations and animations|
|''system''|Images that form the game's user interface|
|''tilesets''|Tilesets that are used in maps throughout the game|

===== Editing sets of images =====
Some images you might find appear to contain multiple sprites, those can either be used as animation frames, indications of a state, or both.

{{:playground:image_2021-09-16_215613.png?400|}}

''img/sv_actors/!battle_bun_bunny.png'' is an example of such an image

Those images can be divided in multiple ways, depending on their purpose in the game, as such it is recommended to keep in mind the original layout while editing the image. The division does not care for the image's size, as it is done dynamically.

For instance, all battle sprites are divided in a 4x6 pattern, the image that is displayed in the battle changes alongside the horizontal axis to form an animation, and the status of the enemy dictates the vertical position of the image (Neutral, taking damage, defeated, sad, angry and happy).

//Note: Certain enemies, notably enemies that can feel more emotions than just SAD, ANGRY and HAPPY will have more vertical sprites in their image//

====== Putting the images in a mod ======
After editing your images, you must put them in your **mod folder** under the same path relative to your decrypted ''/www/'', for instance, if you have edited the image in ''www_playtest_01234567/img/sv_actors/!battle_bun_bunny.png'', you must put that image in ''www/mods/<yourmodID>/img/sv_actors/!battle_bun_bunny.png''.

Afterwards, you must edit the file ''www/mods/<yourmodID>/mod.json'' to include the path to your modified image's folder in its assets, so in our example, your ''mod.json'' should look similar to this:

<code json>
{
    "id": "yourmodID",
    "name": "Your mod's name",
    "description": "A longer description for your mod",
    "version": "1.0",
    "files": {
      "plugins": [],
      "text": [],
      "data": [],
      "maps": [],
      "assets": ["img/sv_actors/"],
      "exec": []
    }
  }
 </code>
  
 And done! Your modified file should now appear in game in the place that you replaced.

TODO: Talk about image deltas.