minetest-stuffs/minetest-skindb-skindata

mckaygerhard 82a4fe125c document and setup format of textures and meta info, license files

* provide information about the files and texture skins
* setup the structure and scripts
* setup the web page at sourceforge hosting place
* fill license files of each one, track real authors
* upload minetest default skin and real information
* **IMPORTANT** skin id 1 will be the CC-BY-SA minetest Sam skin
* other skins will be filled since id 31, from 2 to 31 will be CC0

2024-04-03 12:18:42 -04:00

4.3 KiB

Raw Blame History

minetest-skindb-skindata - miscelaneus files

SKIN database data for minetest.org - miscelaneous scripts

Information

This directory contains some tools to help on skins build, mostly generate meta txt files for each png skin and also the generate preview png file for each png skin.

Skins mod used those files for minetest skin changing, this data is full compatible with any kind of mod like the skindb, u_skindb or simple_skin

Technical information

Is based on now defunct skin database (http://minetest.fensta.bplaced.net), that will be now at https://skindb.sourceforge.io/

Here there are two sections, one for scripts and the other about the files that defines the texture and details of the skins.

extra scripts

Those scripts helps for development ad generate extra files, are originaly from first repository

generate_previews.sh

it will generate a mini crop file of the skin, basically will reduce proportionaly to a 16x16 charactyer body. this script is used to generate the previews needed by the mod

It requires blender with the 2.x python API (2.6x is tested) This script can also use pngcrush and imagemagick to reduce output size, it can enable them inside script and will be written to .previews/

set_meta.sh

Its used to create a simple dialog that will ask for details of the png already found parsed as argument, and will generate the meta data information txt file.

Means to be used locally and required yad gtk tool

set_meta.sh

In next section the files of skins are explained

player skin

Skin is a couple of two files, one is the png skin texture file that will be put here in ../textures/ directory. and the other is the meta txt information details that that will be put at ../meta/ directory.

In following sections will be detailed those files.

filename meta txt

The defunct skin database (http://minetest.fensta.bplaced.net), uses the a unique format, each line is as of key = "string", with a comma at the end. if no value is given will be unknow+<id> and for license will be CC-BY-NC-3.0

filename must match the file skin png file
- filename must start with "character" string
- filename format must be character_<id>.txt
- filename skin must be ../textures/character_<id>.png
file contents must be as:
- name : must be alphanumeric
- author : must be alphanumeric
- description : must be alphanumeric and maximun of 46 chars
- comment : must be alphanumeric and maximun of 46 chars
- license : must be alphanumeric and format must be as https://spdx.org/licenses/

name = "<name>",
author = "<author>",
description = "<description>",
comment = "<comment>",
license = "<SPDX licence identifier>",

For examples check ../meta/character_1.txt that must match the corresponding skin file ../textures/character_1.png

filename meta new

New sites simplifies the meta file with only lines to parse, this format manage each line is as of key directly without a comma at the end

filename must match the file skin png file
- filename must start with "character" string
- filename format must be character_<id>.txt
- BUT filename skin is character.<id>.png
file contents must be as:
- line 1 : must be alphanumeric ans is assumed as the skin name only
- line 2 : must be alphanumeric and is assumed as the skin author only
- line 3 : must be alphanumeric and format must be as https://spdx.org/licenses/

<name>
<author>
<SPDX licence identifier>,

For example you can check the new recent skindb mod.

png texture character

The file follow the format of the template description provided by AntumDeluge at the https://opengameart.org/content/minetest-character-template

Here are a source file to perform a skin template.xcf

4.3 KiB Raw Blame History