skinsdb/README.md

# skinsdb

This Minetest mod offers changeable player skins with a graphical interface for multiple inventory mods.

## Features

- Flexible skins API to manage the database
- [character_creator](https://github.com/minetest-mods/character_creator) support for custom skins
- Skin change menu for sfinv (in minetest_game) and [unified_inventory](https://forum.minetest.net/viewtopic.php?t=12767)
- Skins change menu and command line using chat command /skinsdb (set | show | list | list private | list public | ui)
- Supported by [smart_inventory](https://forum.minetest.net/viewtopic.php?t=16597) for the skin selection
- Supported by [i3](https://github.com/minetest-mods/i3) inventory mod
- Skin previews supported in selection
- Additional information for each skin
- Support for different skins lists: public and a per-player list are currently implemented
- Full [3d_armor](https://forum.minetest.net/viewtopic.php?t=4654) support
- Compatible to 1.0 and 1.8 Minecraft skins format
- Skinned hand in 1st person view (1.0 skins only)


## Installing skins

### Download from the [database](https://skinsdb.terraqueststudios.net/)

#### Ingame Downloader

1) Get Minetest 5.1.0-dev-cb00632 or newer
2) In the settings menu show advanced options, find the "Developer Options" tab and add "skinsdb" to "Trusted mods" (secure.trusted_mods in minetest.conf)
3) Start your world
4) Run `/skinsdb_download_skins <skindb start page> <amount of pages>`
5) Wait for the Minetest server to shut down
6) Start the server again

You might want to run `minetest` in a Terminal/Console window to check the log output instantly.

#### Python Download script

**Requirements:**

 * Python 3
 * `requests` library: `pip3 install requests`  
 
Go to the updater folder of this mod and run `python3 update_skins.py`  
The Script will download all the skins from the database for you.

### Manual addition

1) Copy your skin textures to `textures` as documented in `textures/readme.txt`
2) Create `meta/character_<name>.txt` with the following fields (separated by new lines):
    * Skin name
    * Author
    * Skin license


## License:
- GPLv3
- skin texture licenses: See "meta" folder
- hand model: CC0

### Credits

- RealBadAngel (unified_inventory)
- Zeg9 (skinsdb)
- cornernote (source code)
- Krock (source code)
- bell07 (source code)
- stujones11 (player models)
- jordan4ibanez (1st person view hand)
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`# skinsdb`
Update and rename README to README.md 2017-06-21 21:36:30 +02:00
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`This Minetest mod offers changeable player skins with a graphical interface for multiple inventory mods.`
Update and rename README to README.md 2017-06-21 21:36:30 +02:00
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`## Features`
Update and rename README to README.md 2017-06-21 21:36:30 +02:00
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`- Flexible skins API to manage the database`
			`- [character_creator](https://github.com/minetest-mods/character_creator) support for custom skins`
			`- Skin change menu for sfinv (in minetest_game) and [unified_inventory](https://forum.minetest.net/viewtopic.php?t=12767)`
mentioned chat commands in README.md 2018-02-14 20:26:14 +01:00			`- Skins change menu and command line using chat command /skinsdb (set \| show \| list \| list private \| list public \| ui)`
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`- Supported by [smart_inventory](https://forum.minetest.net/viewtopic.php?t=16597) for the skin selection`
Mention i3 support (#55) 2021-01-03 09:36:20 +01:00			`- Supported by [i3](https://github.com/minetest-mods/i3) inventory mod`
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`- Skin previews supported in selection`
			`- Additional information for each skin`
			`- Support for different skins lists: public and a per-player list are currently implemented`
			`- Full [3d_armor](https://forum.minetest.net/viewtopic.php?t=4654) support`
Added support for 1.8er Skins 2018-04-15 01:09:38 +02:00			`- Compatible to 1.0 and 1.8 Minecraft skins format`
implement skinned 1st person view hand 2022-02-15 18:57:14 +01:00			`- Skinned hand in 1st person view (1.0 skins only)`
Update and rename README to README.md 2017-06-21 21:36:30 +02:00
Add updater script using the HTTP API (#27) Check for core feature `httpfetch_binary_data` to run the updater properly. This requires Minetest cb00632 or newer. README.md: Add documentation for the updater 2019-06-06 21:47:49 +02:00
			`## Installing skins`

Update instructions for downloading skins (#93) Corrected URL and updater instructions. 2023-12-17 10:05:53 +01:00			`### Download from the [database](https://skinsdb.terraqueststudios.net/)`
Add python skin update script (#48) 2020-06-07 13:39:57 +02:00
			`#### Ingame Downloader`
Add updater script using the HTTP API (#27) Check for core feature `httpfetch_binary_data` to run the updater properly. This requires Minetest cb00632 or newer. README.md: Add documentation for the updater 2019-06-06 21:47:49 +02:00
			`1) Get Minetest 5.1.0-dev-cb00632 or newer`
Update instructions for downloading skins (#93) Corrected URL and updater instructions. 2023-12-17 10:05:53 +01:00			`2) In the settings menu show advanced options, find the "Developer Options" tab and add "skinsdb" to "Trusted mods" (secure.trusted_mods in minetest.conf)`
			`3) Start your world`
			4) Run `/skinsdb_download_skins <skindb start page> <amount of pages>`
			`5) Wait for the Minetest server to shut down`
			`6) Start the server again`
Add updater script using the HTTP API (#27) Check for core feature `httpfetch_binary_data` to run the updater properly. This requires Minetest cb00632 or newer. README.md: Add documentation for the updater 2019-06-06 21:47:49 +02:00
			You might want to run `minetest` in a Terminal/Console window to check the log output instantly.

Add python skin update script (#48) 2020-06-07 13:39:57 +02:00			`#### Python Download script`

			`Requirements:`

			`* Python 3`
			* `requests` library: `pip3 install requests`

			Go to the updater folder of this mod and run `python3 update_skins.py`
			`The Script will download all the skins from the database for you.`

Add updater script using the HTTP API (#27) Check for core feature `httpfetch_binary_data` to run the updater properly. This requires Minetest cb00632 or newer. README.md: Add documentation for the updater 2019-06-06 21:47:49 +02:00			`### Manual addition`

			1) Copy your skin textures to `textures` as documented in `textures/readme.txt`
			2) Create `meta/character_<name>.txt` with the following fields (separated by new lines):
			`* Skin name`
			`* Author`
			`* Skin license`


remove all updater to solve CC-BY-NC-SA and Newtonsoft license issues Fix for #19 2018-08-17 11:38:00 +02:00			`## License:`
			`- GPLv3`
improve skins sorting with same sort_id add skins license hint to the README.md 2019-08-09 06:54:47 +02:00			`- skin texture licenses: See "meta" folder`
implement skinned 1st person view hand 2022-02-15 18:57:14 +01:00			`- hand model: CC0`
Update and rename README to README.md 2017-06-21 21:36:30 +02:00
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`### Credits`
Update and rename README to README.md 2017-06-21 21:36:30 +02:00
Rewrite README to proper markdown and better readability 2017-10-02 10:48:57 +02:00			`- RealBadAngel (unified_inventory)`
			`- Zeg9 (skinsdb)`
			`- cornernote (source code)`
			`- Krock (source code)`
mentioned chat commands in README.md 2018-02-14 20:26:14 +01:00			`- bell07 (source code)`
Added support for 1.8er Skins 2018-04-15 01:09:38 +02:00			`- stujones11 (player models)`
implement skinned 1st person view hand 2022-02-15 18:57:14 +01:00			`- jordan4ibanez (1st person view hand)`