Crear skins para Jumpfall sin romper el formato actual

Esta guia reemplaza el metodo viejo de comprimir carpetas a mano. El flujo recomendado ahora usa tres partes: la herramienta de skins, el empaquetador JVSK y el juego.

Indice rapido

• 1. Flujo actual de trabajo
• 2. Rutas importantes
• 3. Estructura de una skin
• 4. Animaciones soportadas
• 5. Plantilla actual de skin.json
• 6. meta.json para el publisher y Workshop
• 7. Crear el .jvsk correctamente
• 8. Probar la skin en Jumpfall
• 9. Problemas comunes

1. Flujo actual de trabajo

2. Rutas importantes

Carpeta donde la herramienta de skins lee y prueba tu trabajo:

Carpeta donde Jumpfall lee skins locales ya empaquetadas:

Carpeta donde Jumpfall descomprime temporalmente los .jvsk:

Carpeta usada por las skins descargadas desde Workshop:

3. Estructura recomendada de una skin

La carpeta que vas a empaquetar debe tener skin.json en la raiz. Puedes nombrar las carpetas como quieras, pero se recomienda usar nombres claros con _frames.

skin/
  skin.json
  meta.json              opcional, recomendado para Workshop
  preview.png            opcional, recomendado para Workshop

  idle_frames/
    0.png
    1.png

  walk_frames/
    0.png
    1.png

  run_frames/
  jump_frames/
  fly_frames/
  punch_frames/
  landing_frames/
  death_frames/
  dash_ground_frames/
  dash_air_frames/
  climbing_wall_frames/
  climbing_wall_jump_frames/

4. Animaciones soportadas actualmente

Estos son los nombres que van dentro de files en skin.json:

El juego tambien acepta climbingwall y climbingwalljump, pero para nuevas skins usa climbing_wall y climbing_wall_jump.

5. Plantilla actual de skin.json

Esta plantilla usa el formato que Jumpfall y jumpfall_skin_tools entienden. Puedes borrar las animaciones que aun no tengas, pero deja al menos idle.

{
  "active": true,
  "fps": 12,
  "visual": {
    "scale": 1,
    "widthScale": 1,
    "heightScale": 1,
    "mirror": true,
    "colorOverlay": [255, 255, 255, 255]
  },
  "files": {
    "idle": {
      "path": "idle_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "walk": {
      "path": "walk_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "run": {
      "path": "run_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "jump": {
      "path": "jump_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": false
    },
    "fly": {
      "path": "fly_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "punch": {
      "path": "punch_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": false
    },
    "landing": {
      "path": "landing_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": false
    },
    "death": {
      "path": "death_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": false
    },
    "dashground": {
      "path": "dash_ground_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "dashair": {
      "path": "dash_air_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "climbing_wall": {
      "path": "climbing_wall_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": true
    },
    "climbing_wall_jump": {
      "path": "climbing_wall_jump_frames",
      "fps": 12,
      "pivotX": 0.5,
      "pivotY": 0,
      "xOffset": 0,
      "yOffset": 0,
      "loop": false
    }
  }
}

6. meta.json para publisher y Workshop

El archivo meta.json no controla la animacion. Sirve para el empaquetador y para la informacion del Workshop.

{
  "mod_name": "Mi Skin",
  "description": "Descripcion corta de la skin.",
  "author": "Tu nombre",
  "version": "1.0.0",
  "preview": "preview.png"
}

Cuando actualizas una skin ya publicada, el publisher puede agregar workshop_id automaticamente para saber que item debe actualizar.

7. Crear el .jvsk correctamente

Metodo recomendado: jumpfall-skin-jvsk

1. Abre jumpfall-skin-jvsk.
2. En Folder or file (.jvsk), selecciona la carpeta que contiene skin.json.
3. Completa titulo, descripcion, autor, version y preview si corresponde.
4. Elige donde guardar el archivo final, por ejemplo mi_skin.jvsk.
5. Presiona Package (.jvsk).

Metodo manual, solo si sabes lo que haces

1. Entra dentro de la carpeta de la skin.
2. Selecciona skin.json, meta.json, preview.png y las carpetas de frames.
3. Crea un ZIP con esos archivos seleccionados.
4. Renombra el ZIP de .zip a .jvsk.

mi_skin.jvsk
  skin.json
  meta.json
  preview.png
  idle_frames/
  walk_frames/

mi_skin.jvsk
  mi_skin/
    skin.json
    idle_frames/
    walk_frames/

8. Probar la skin en Jumpfall

1. Copia el archivo .jvsk final a:

2. Abre Jumpfall en PC.
3. Entra al menu de skins locales.
4. Selecciona tu skin.
5. Pruebala en un mapa con caminar, correr, saltar, pared, dash y muerte.

9. Problemas comunes