`logo.png` in the root folder was also created by Dragoni. Everything else was created by appgurueu and is also licensed under CC BY-SA 3.0. `screenshot.png` uses `character.png` by Jordach which is licensed under [CC BY-SA 3.0](https://github.com/minetest/minetest_game/tree/master/mods/player_api/README.txt) as well.
* Just drop them in `<worldpath>/data/epidermis/textures/players/epidermis_player_<playername>.png`
* 3D Epidermis painting
* Model- and texture-agnostic. Full B3D and PNG support.
* HSV & RGB colorpickers, named color support
* Arbitrary rotation & backface culling support
* [SkinDB](http://minetest.fensta.bplaced.net/) support
* Real-time syncing with SkinDB (uploaded textures immediately become usable without a restart); no external scripts required
* Picking SkinDB skins for yourself or as Epidermis base textures
* Upload to SkinDB
## Comparison
### 2D Texture Painting Mods
* [Painted 3D armor](https://content.minetest.net/packages/Beerholder/painted_3d_armor/): A mod supporting paintings on armor. Painting still happens in 2D space and is rather limited through the use of texture modifiers; a rather old mod.
* [skinmaker](https://github.com/GreenXenith/skinmaker), a well-done mod limited to the scope of 2-dimensional creation of skins in-game using only texture modifiers. Good support for older MT versions without dynamic media, not entirely texture- and model-agnostic. Experimental.
* [Wardrobe](https://content.minetest.net/packages/AntumDeluge/wardrobe_ad/) and [Wardrobe Outfits](https://content.minetest.net/packages/AntumDeluge/wardrobe_outfits/): A few "selected" skins; the former provides an API for other mods to register more
* [Simple Skins](https://content.minetest.net/packages/TenPlus1/simple_skins/): A different set of available skins, excellent support for ancient MT versions
* [SkinsDB](https://content.minetest.net/packages/bell07/skinsdb/) and [SkinsDB for Hades Revisited](https://content.minetest.net/packages/SFENCE/hades_skinsdb/): Proper SkinDB support using an update command which shuts down the server, support for user-added skins, decent skin selection dialog including a search feature
Epidermis beats most currently available skin mods through better SkinDB support (including **uploading**) and is the first mod to provide 3-dimensional skin painting (which may however not be considered generally superior to 2-dimensional painting).
You can expect each active entity to consume memory proportional to the texture pixel count. Skins sized 64x32 should stay in the kilobyte range. There is however a [clientside memory leak](https://github.com/minetest/minetest/issues/11531) which causes textures to not be dropped from texture cache. This means that every time the texture is changed, the client will store it in memory until the session ends. For 64x32, roughly 8 KB will be stored per update/action. That means a thousand actions will roughly take 8 MB; a million actions would take 8 GB. **Therefore, it is not recommended to try using higher resolution textures, even though they are perfectly supported by the mod.**
### Disk Usage
The dynamic media API allows marking media as `ephemeral`, which means it isn't cached clientside *and* not sent to new clients. Unfortunately this means that joining players don't receive the media, which would result in undefined behavior. Therefore, this fills up client & server disk space in it's current form. Server disk space is automatically cleared on startup; client cache must be cleared manually.
If you want to be able to accurately paint, don't use cinematic camera smoothing or view bobbing. Both will make your look direction inaccurate in certain cases. Alternatively to disabling view bobbing, rest while painting (and use the newest Minetest version).
As you might have noticed, there is no kind of palette. That is no issue however: Simply abuse a second entity (or a portion of the epidermis) as palette.
## Instructions
The in-game guide item contains these instructions as well.
### Tools
#### Guide
The in-game guide provides instructions for these tools.
#### Spawners
##### Paintable spawner
Spawns a paintable epidermis with your current texture.
##### HSV colorpicker spawner
Spawns a "wallmounted" HSV colorpicker.
#### Painting Tools
Tools which work much like those found in common painting programs.
Pen, line, rectangle and filling bucket all require a color. There are three ways to pick a color:
* You can pick a color from the paintable epidermis by right-clicking it.
* You can open a RGB color picker dialog by right clicking while pointing at nothing.
* You can spawn a HSV color picker in-world by placing it against a node. Right-click to pick a color, punch the hue to change the hue of the saturation & value field.
##### Pen
The pen is the most basic tool. It is used to place single pixels (left-click).
##### Line
The line tool draws, duh, a line. Use it by "dragging": keep the left mouse button down. You will be shown a preview. Dragging stops when you change your wield item or point at a different entity.
##### Rectangle
Works like the line tool but draws a filled rectangle.
##### Filling Bucket
Floodfills adjacent pixels of exactly the same color, swapping out their color for the color of the filling bucket.
##### Undo-redo
Left-click to undo, right-click to redo. Undo-redo log size is limited due to [Memory Usage] constraints.
## Configuration
<!--modlib:conf:2-->
### `skindb`
#### `autosync`
Automatically sync with SkinDB at startup, continue syncing during game