Manual XML de Hina
Introducción al XML

¿Qué es el XML?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
XML es un lenguaje de marcas (NO ES un lenguaje de programación) utilizado en diversos campos, particularmente para enviar información en internet. Los mapas que creas en Transformice se guardan en el formato XML y es este código el que almacena todos los datos y detalles sobre tu mapa. Los suelos, el queso, los objetos y anclajes, el arte, absolutamente todo lo que hay en tu mapa no es más que código XML.


¿Para qué me sirve?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
El editor de mapas existe para facilitar la tarea de crear estos mapas sin tener que escribir manualmente el código, sin embargo muchísimas de las cosas en los mapas de Transformice no se pueden hacer desde el editor oficial. Por eso es que es necesario entender cómo funciona el XML de los mapas para poder tener acceso a todas estas cosas.

También otras personas han creado sus propios editores externos para facilitarte las cosas y hacer parte de lo que el editor oficial no hace. MapPad, Viprin's Drawing Editor y cjobjects son ejemplos de herramientas para editar mapas. A la fecha no existe ninguna herramienta que haga uso de todo lo que puedes hacer en los mapas, por lo que es común usar varios editores y complementarlo con la edición directa del XML.

¿Cómo obtengo el XML de un mapa?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Desde el editor de mapas de Transformice, en la pestaña "Guardar / Cargar / Probar" usas el botón "Copiar el mapa al portapapeles". Luego puedes ir a cualquier editor de texto, como el Bloc de notas, y pegar el código obtenido.



Estructura del XML
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
En este manual podrás conocer todos los detalles necesarios para editar los mapas directamente, pero primero comenzaremos entendiendo cómo está estructurado el código XML en general.

El código XML está formado por elementos, que a su vez pueden contener otros elementos:

<casa>

<habitación>

<cama />
<silla />
<escritorio />
</habitación>
</casa>

Como puedes ver, los elementos comienzan con una etiqueta de apertura (<casa>) y terminan con una etiqueta de cierre (</casa>). También hay elementos vacíos que solo usan una etiqueta (<silla />). El código sigue una estructura bastante fácil de entender y como se puede apreciar sigue cierta lógica (no puede haber una casa dentro de una silla, por ejemplo).


Estructura del XML de mapas
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Estas misma idea se aplica en Transformice. El XML de los mapas sigue ciertas reglas que no se pueden romper, como la lógica antes mencionada. A continuación hay un ejemplo de un mapa básico:

<C>

<P />
<Z>

<S>

<S X="400" Y="400" L="800" H="40" T="0" P="0,0,0.3,0.2,0,0,0,0" />
</S>
<D>

<DS X="30" Y="369" />
<F X="410" Y="367" />
<T X="770" Y="382" />
</D>
<O>
</O>
</Z>
</C>

Todos los mapas comienzan con la etiqueta <C></C> que contiene absolutamente todo. Dentro de C tenemos dos cosas: la etiqueta vacía <P /> que contiene las propiedades del mapa, y la etiqueta <Z></Z> que contiene todos los elementos del mapa.

El contenido de Z se divide en varias partes. Los suelos están dentro de <S></S>, las cosas para ratones están dentro de <D></D>, los objetos de chamán en <O></O> y por último las joints que veremos más adelante, están dentro de <L></L>.

El siguiente diagrama resume la estructura de los mapas:

En el ejemplo, dentro de S (los suelos) tenemos un único elemento, que sería el único suelo del mapa. En D (decoraciones/cosas para ratones) tenemos al ratón (DS), un queso (F) y la madriguera (T). Todas estas cosas siempre usan etiquetas vacías, es decir que no tienen apertura y cierre, solo una etiqueta con un conjunto de cosas dentro, llamadas atributos.


Atributos en el XML
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Los atributos son datos que están contenidos dentro de las mismas etiquetas; no son elementos ni están contenidos dentro de otros elementos, sino que acompañan al nombre de la etiqueta, a su derecha. Por ejemplo:

<DS X="30" Y="369" />

Esta es la etiqueta DS, que representa el punto de inicio de los ratones. Dentro de la misma etiqueta, a la derecha de su nombre (DS) podemos ver dos atributos. El atributo X con un valor de 30, y el atributo Y con un valor de 369.

Todos los atributos siempre se identifican con un nombre, les sigue un signo = y luego el valor del atributo entre comillas (pueden ser comillas simples, pero el editor de TFM genera el XML con comillas dobles así que acostúmbrate a usar estas).

En este caso estos dos atributos indican la posición del elemento en el mapa. Por lo tanto el punto de inicio de los ratones se encuentra en las coordenadas 30,369 (coordenadas x,y).


Cosas a tener en cuenta
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
♫ Todas las cosas en el XML son sensibles a las mayúsculas.

No es lo mismo <C> que <c> ni tampoco es lo mismo <Ds> que <DS>. Lo mismo va para los atributos, en TFM la mayoría de los atributos son en mayúsculas (X, Y, T, etc.) pero también hay algunos en minúsculas. Cuidado con eso.

♫ El editor de mapas exige que estén presentes ciertos elementos.

No pueden faltar los elementos S, D y O dentro de Z. Obviamente tampoco puede faltar Z y P dentro de C. Aún si tu mapa no tiene suelos/decoraciones/objetos, es necesario que pongas las etiquetas de apertura y cierre de esos tres grupos. El elemento L por el contrario se puede omitir.

♫ El tamaño máximo del XML es 20KB

El editor de mapas no te permite cargar un código con un tamaño superior a los 20KB. Sin embargo es posible hacer el mapa más grande después de haberlo cargado, dentro del mismo editor de mapas. Pero ten en cuenta que al hacer esto, luego si exportas el código nuevamente no lo podrás volver a cargar en el editor.

♫ Conserva los espacios

Las etiquetas de una línea (las que no tienen apertura y cierre) terminan siempre con un espacio, el slash y el signo mayor (... />). También siempre hay un espacio luego del nombre de la etiqueta y entre los atributos. Respeta esos espacios. Los saltos de línea y las tabulaciones en cambio son solo estéticas al momento de editar el XML y no hace falta que estén presentes al cargar el mapa.

Manual XML de Hina
Propiedades del mapa

Los mapas que creamos pueden tener diferentes características especiales que podremos configurar modificando las propiedades que veremos a continuación. Algunas de estas características se pueden escoger o configurar en el mismo editor de mapas, como los mapas de pareja o colisión, pero la mayoría de las propiedades solo podremos usarlas añadiéndolas manualmente en el XML.

a dit :

<C><P /><Z><S /><D /><O /></Z></C>

Las propiedades del mapa se encuentran dentro de la etiqueta P. Todas las propiedades o atributos son opcionales, sin embargo algunas tienen valores por defecto (predeterminados) como el ancho y alto del mapa.


Contenido:
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

• Tamaño del mapa
• Fondo
• Viento y gravedad
• Colisión
• Pareja
• Modo nocturno
• Portales
• Muerte por colisión
• Científico loco
• Ocultar exterior del mapa
• Ocultar anclajes
• Punto de inicio de los ratones
• Defilante
• Imágenes de fondo
• Masa de los objetos
  

Tamaño del mapa
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
El tamaño del mapa se define por dos propiedades, longitud y altura (ancho y alto).

L="longitud"
H="altura"

longitud - Ancho del mapa en pixeles.

altura - Alto del mapa en pixeles.

El tamaño de los mapas por defecto es 800x400 (ancho x alto). La longitud máxima es de 1600 (4800 en mapas defilante) y la altura máxima es de 800.


Ejemplo: Este es un mapa un poco más largo de lo normal y con una altura el doble de lo normal. En otras palabras, un mapa alto con un poco más de longitud.



Fondo
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
El fondo es una propiedad estética del mapa y no es más que la imagen que veremos detrás de todo en el mapa. Por defecto el mapa no tiene ningún fondo y en su lugar tenemos el color de fondo del juego.

F="ID del fondo"

ID del fondo - Número que identifica a cada uno de los fondos disponibles en el juego. A continuación la lista de fondos:


• 0 - Luz del día
• 1 - Amanecer
• 2 - Crepúsculo
• 3 - Luna llena
• 4 - Halloween (ancho 1600)
• 5 - Navidad
• 6 - San Valentín (ancho 4800)
• 7 - Nube oscura
• 8 - Nube oscura 2
  

Algunos fondos, como el de Halloween, están hechos para mapas largos y al ser usados en mapas de menor longitud automáticamente se encoge la imagen, quedando deformada.


Ejemplo: Un mapa simple con el fondo del amanecer.



Viento y gravedad
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Estas dos características del mapa se definen en una misma propiedad:

G="viento,gravedad"

viento - Intensidad del viento.

gravedad - Intensidad de la gravedad.

Un viento negativo irá hacia la izquierda y uno positivo hacia la derecha. El valor 0 hará un mapa sin viento. La gravedad negativa se ejercerá hacia arriba y la gravedad positivahacia abajo. El valor 0 hará al mapa sin gravedad.

Los valores por defecto son 0 y 10 respectivamente.


Ejemplo: Mapa con viento hacia el este y gravedad invertida



Colisión
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo se activa la colisión entre los ratones.

C=""

Ejemplo: Mapa de colisión



Pareja
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo el mapa funcionará con parejas.

A=""

Ejemplo: Mapa con parejas



Modo nocturno
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo se activa el modo nocturno o night mode. La pantalla se verá negra con un pequeño círculo iluminado alrededor del ratón.

N=""

Ejemplo: Mapa con modo nocturno



Portales
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo el chamán podrá poner portales en el mapa.

P=""

Ejemplo: Mapa que hace uso de los portales



Muerte por colisión
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo todos los ratones podrán morir por impactos (caídas o choques).

aie=""

Ejemplo: Mapa donde el que cae de las plataformas muere.


No es posible modificar la fuerza necesaria para que mueran. Además nótese que la restitución del suelo con el que se choca también influye la facilidad con la que mueren (un trampolín normal = muerte).


Científico loco
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo, será posible lanzar cañones hacia arriba.

bh=""

Ejemplo: Mapa que requiere que el chamán lance un cañón hacia arriba


Los chamanes obtendrán el mismo efecto que con la habilidad "Científico Loco" aunque no la tengan. Además los cañones invocados con Lua también podrán acelerar hacia arriba.


Ocultar exterior del mapa
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este atributo hará que solo se vea el área interna del mapa, ocultando todo lo que queda off-screen.

Ca=""

Ejemplo: Aquí se usa Ca para ocultar el mecanismo del mapa y las paredes



Ocultar anclajes
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este atributo hará que los anclajes en el mapa no se vean. Los que ponga el chamán aún así se verán.

mc=""

Ejemplo: Mecanismo simple con anclajes no visibles



Punto de inicio de los ratones
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Es posible definir dónde aparecerán los ratones en las propiedades del mapa. Existen tres maneras de hacerlo.

1) Definiendo uno o más puntos específicos

DS="m;x1,y1,x2,y2,x3,y3..."

x1,y1 - Coordenadas x,y del primer punto.
x2,y2 - Coordenadas x,y del segundo punto.
x3,y3 - Coordenadas x,y del tercer punto.

2) Definiendo la coordenada Y para esparcir a los ratones a lo largo del mapa:

DS="y;y0"

y0 - Coordenada Y para todos los ratones.

3) Definiendo la coordenada X para esparcir a los ratones a lo alto del mapa:

DS="x;x0"

x0 - Coordenada X para todos los ratones.

En el primer caso se pueden añadir tantos puntos como se quiera. Cada valor debe separarse por una coma y siempre van unidas las coordenadas x,y de un mismo punto. (DS="m;x1,y1"), (DS="m;x1,y1,x2,y2"), (DS="m;x1,y1,x2,y2,x3,y3,x4,y4,x5,y5"), etc.

En los últimos dos casos los ratones se esparcirán por el mapa. Nótese que su posición no es realmente al azar, si no que el juego determina arbitrariamente su posición dependiendo de la cantidad de ratones en la sala. Por lo que es necesario tener a varios ratones presentes para que puedas apreciar los resultados.

También con el primer caso el juego decide arbitrariamente en qué momento asignar a un ratón a cada punto. Por lo que si no hay suficientes ratones es posible que no aparezca ninguno en algún punto (incluso si tienes 3 puntos y 3 ratones, es posible que uno de los puntos quede vacío). Asegúrate de invitar a toda una tribu cuando vayas a probar tus mapas con múltiples puntos de inicio.


Ejemplo 1: Mapa con 4 puntos de spawn

Ejemplo 2: Mapa de colisión con ratones esparcidos a lo largo

Ejemplo 3: Mapa con portales y ratones esparcidos a lo alto



Defilante
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Usando esta propiedad puedes crear mapas de tipo defilante, con o sin scroll automático y con una longitud máxima de 4800 pixeles. Además podrás usar los objetos de defilante.

defilante="velocidad inicial,aceleración,velocidad máxima,scroll libre"

velocidad inicial - La velocidad con que se moverá el scroll en un comienzo.

aceleración - Valor que determina cómo aumentará la velocidad a lo largo del mapa

velocidad máxima - ???

scroll libre - Permite a los ratones avanzar más allá del área visible por el scroll sin que se mueran.
(1 = activado, 0 = desactivado)

Al activar el modo defilante automáticamente algunos objetos de chamán se transformarán a objetos de defilante, como se muestra a continuación:

C="6" - Pelota >>> +1
C="15" - Motor azul horario >>> Muerte
C="16" - Motor azul antihorario >>> Resorte
C="32" - Runa >>> Velocidad

(próximamente imagen aquí)

En los mapas defilante siempre morirán los ratones al salirse del área visible del scroll por la izquierda, y por la derecha al no estar activada la opción de scroll libre. Si la velocidad y la aceleración son 0, el mapa no avanzará por si solo. Es posible hacer un mapa sin scroll de ningún tipo usando los valores 0,0,0,1, sin embargo los ratones aún morirán al salirse del mapa por la izquierda.


Ejemplo: Mapa defilante extra largo con scroll libre y objetos de defilante



Imágenes de fondo
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Los atributos D y d te permiten poner imágenes de fondo y de frente, respectivamente.

D="url,x,y,r;url,x,y,r;url,x,y,r;
d="url,x,y,r;url,x,y,r;url,x,y,r;"

url - La ruta y nombre del archivo de imagen (en transformice.com)
x - Coordenada X donde estará la esquina superior izquierda de la imagen
y - Coordenada Y donde estará la esquina superior izquierda de la imagen
r - Cantidad de veces que se repetirá la imagen horizontalmente (cada 800px)

Puedes poner todas las imágenes que quieras, siempre separando cada una con ; (punto y coma).

Los valores por defecto de x,y,r son 0 y pueden ser omitidos. Un r igual a 0 hará que no se repita la imagen.

Las imágenes estarán en orden desde la que se ve más al frente hasta la que se ve más al fondo. Las imágenes de frente siempre estarán frente a las imágenes de fondo y también frente a todos los suelos, decoraciones, objetos y ratones.

Las imágenes deben estar contenidas dentro de http://transformice.com para que funcione. Puedes obtener las imágenes de TFM Pics.


Ejemplo: Casa de tribu con dos fondos y un pájaro.



Masa de los objetos
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Cambia la masa de todos los objetos de chamán, incluyendo los que sean invocados.

mgoc="masa"

masa - masa que tendrán los objetos

La masa especificada será la misma para todos los objetos. Es decir que un yunque y una pelota tendrán la misma masa.

Una masa negativa ("-1") hará a los objetos inmóviles. No los moverá ni la gravedad ni las acciones de los ratones u otros objetos.


Ejemplo: Piscina de yunques livianos

Manual XML de Hina
Propiedades de los suelos

Todos los suelos se encuentran dentro del grupo <S></S> y cada suelo es un elemento vacío <S />. Cada suelo en el mapa tendrá sus propiedades, que pueden ser visuales o físicas, y se definen en los atributos del elemento. Esto es un suelo básico:



Contenido:
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

• Atributos básicos
  
  • Posición
  • Tamaño
  • Estilo / Tipo
  • Propiedades físicas
  • Orden Z
  
  
• Colisión
• Color
• Primer plano
• Invisible
• Temporal
  

Posición
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
La ubicación del centro del suelo dentro del mapa.

X="coordenada x"
Y="coordenada y"

coordenada x - Coordenada X del centro del suelo

coordenada y - Coordenada Y del centro del suelo

Las coordenadas pueden ser negativas o ir más allá del tamaño del mapa.


Ejemplo: cuatro suelos puestos en las esquinas del mapa



Tamaño
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Las dimensiones del suelo.

L="longitud"

H="altura"

longitud - El ancho del suelo en pixeles. Para los círculos este será el radio en cambio.

altura - El alto del suelo en pixeles. No se usa en los círculos.

Las dimensiones mínimas y por defecto de los suelos son 10px x 10px.

Un círculo con L="100" es el doble de grande que un cuadrado de 100x100. L representa el radio del círculo en lugar del diámetro.

Los suelos que no sean de tipo Rectángulo o Círculo, cuando son muy grandes en alguna de sus dimensiones el tamaño visible no corresponde con su tamaño real, quedando espacios invisibles del suelo en sus extremos.


Ejemplo: Maderas de distintos tamaños



Estilo / Tipo
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Cambia el tipo y apariencia del suelo.

T="ID del tipo"

ID del tipo - el ID del tipo de suelo que se usará (ver Apéndice)

El tipo de suelo no afecta a cosas como la fricción, restitución y colisión del suelo, solo modifica su apariencia.

Las excepciones a esto son los suelos de tipo Agua y Telaraña, que se comportan de una forma totalmente diferente y para los cuales no se aplican la mayoría de las propiedades físicas anteriores.

Los suelos creados en el editor de mapas automáticamente asignan a los suelos sus propiedades físicas correspondientes al tipo. Véase esta guía para conocerlas.


Ejemplo: Suelos de distintos tipos, todos con las mismas propiedades físicas.



Propiedades físicas
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este atributo agrupa 8 propiedades diferentes. La mayoría afectan a la física del suelo.

P="dinámico, masa, fricción, restitución, rotación, rotación fija, amortiguación lineal, amortiguación angular"

dinámico - 0 para un suelo estático, 1 para un suelo dinámico
masa - La masa de un suelo dinámico
fricción - La fuerza de fricción que ejerce el suelo contra otros objetos físicos
restitución - La fuerza de rebote que tiene el suelo con otros objetos físicos
rotación - El ángulo en el que estará rotado el suelo
rotación fija - 0 para que gire libremente, 1 para que tenga rotación fija
amortiguación lineal - La resistencia del objeto a moverse por el mapa
amortiguación angular - La resistencia del objeto a girar

La masa de un objeto físico afecta la fuerza necesaria para moverlo y también la fuerza que aplicará sobre otros objetos. A mayor masa mayor fuerza. No afecta su capacidad de flotar en el agua.

Un objeto dinámico se deslizará por tiempo indefinido sobre la superficie de un suelo cuando cualquiera de ellos tenga frición 0, por mucha fricción que tenga el otro.

En cambio para el caso de la restitución, siempre se usará la restitución más alta entre los dos objetos que entren en contacto.

La rotación está dada en grados y aumentan en sentido antihorario.


Ejemplo: Algunos suelos dinámicos con diferentes propiedades



Orden Z
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Es la posición que tendrán los suelos respecto a cuál está en frente a los otros, el orden en que se ponen en pantalla. Los suelos con mayor Z se verán más al frente.

Este no es un atributo real, sino que viene dado en el XML por el orden en el que están situados los suelos. El primer suelo tendrá un Z = 0, el segundo tendrá Z =1, y así sucesivamente.


Ejemplo: El primer suelo está por detrás del segundo suelo. El tercer suelo cubre a ambos.



Colisión
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Determina con qué cosas debe hacer contacto físico el suelo.

c="tipo de colisión"

tipo de colisión - El tipo de colisión que tendrá el suelo. Hay cuatro modos de colisión:


1 - Colisión con ratones y objetos (por defecto)
2 - Colisión con objetos
3 - Colisión con ratones
4 - Sin colisión

Se consideran objetos físicos los objetos de chamán y los suelos.

Esta propiedad no tiene efecto sobre los suelos de agua y telaraña.


Ejemplo: Cuatro suelos con cada tipo de colisión y cajas para apreciar el efecto



Color
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Con este atributo se cambia el color de los suelos Rectángulo y Círculo.

o="color"

color - Color hexadecimal del suelo

El formato del color debe ser "000000" donde cada dígito es un valor hexadecimal entre 0 y F. Puedes obtener el valor hexadecimal de un color usando esta herramienta, o usar los colores de TFM recopilados aquí.


Ejemplo: Tres suelos de colores intentando representar un ambiente



Primer plano
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo el suelo se verá por encima de los ratones y objetos.

N=""

Ejemplo: En el suelo derecho se puede apreciar que tapa la cara de la rata mientras sube.



Invisible
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al agregar este atributo el suelo será completamente invisible.

m=""

No sirve para suelos de agua y telaraña. Para eso véase el atributo siguiente.


Ejemplo: Un mapa aparentemente vacío con un par de suelos invisibles.



Temporal
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Permite crear suelos que desaparezcan después de un tiempo determinado.

v="tiempo"

tiempo - El tiempo que tardará en desaparecer, en milisegundos.

Los suelos desaparecen completamente y dejan de ser parte del mapa e interactuar con objetos físicos.

Un tiempo negativo ("-1") permite hacer que el suelo no llegue a aparecer nunca. Es posible usar esto con suelos de agua y telaraña, pero seguirán interactuando físicamente, por lo que efectivamente es una manera de hacerlos invisibles.


Ejemplo: Suelos que desaparecen en orden y agua invisible

Manual XML de Hina
Cosas para ratones / Decoraciones

Dentro del grupo <D></D> encontramos lo que llamamos "Cosas para ratones". Algunos marcan la posición de elementos clave como el queso, pero la mayoría son objetos decorativos que generalmente solo cumplen una función estética.


Contenido
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

• Lista de etiquetas
• Posición
• Queso y Madriguera al frente
• Tipo de decoración
• Propiedades de las decoraciones
• Colores de las decoraciones
• Orden Z

Lista de etiquetas
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Los elementos de este grupo tienen varios nombres. Estas son todas las etiquetas que usa:

<F>	Queso
<T>	Madriguera
<DS>	Punto de inicio de los ratones
<DC>	Punto de inicio del chamán
<DC2>	Punto de inicio de segundo chamán /!\ Solo sirve en mapas P8 y P32
<P>	Decoración

Posición
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Todos los elementos tienen los atributos de posición:

X="coordenada x"
Y="coordenada y"

coordenada x - Coordenada X del elemento

coordenada y - Coordenada Y del elemento

En el caso del queso, madriguera y puntos de inicio, las coordenadas indican la posición del centro del elemento. Sin embargo para las decoraciones este no siempre será el caso.


Queso y Madriguera al frente
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al añadir este atributo al queso o madriguera, se verá por encima de los suelos y objetos.

D=""

Ejemplo: rectángulo de fondo, con el queso y madriguera visibles encima



Tipo de decoración
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este atributo, exclusivo de los elementos P, indica la decoración que se usará.

T="ID del tipo"

ID del tipo - el ID del tipo de decoración que se usará (ver Apéndice: IDs de decoraciones)

Ciertas decoraciones específicas tienen alguna funcionalidad (las pantallas para ver videos, las huellas de checkpoint).


Ejemplo: Una palmera (6) y un árbol de navidad (57).



Propiedades de las decoraciones
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Las decoraciones tienen dos propiedades. Para poner la imagen al frente y para invertirla.

P="al frente, invertida"

al frente - Si es 1 la decoración se verá encima de los suelos y objetos

invertida - Si es 1 la decoración se verá reflejada horizontalmente

Por defecto ambos valores son 0. Con lo que no estarán ni invertidas ni al frente de los suelos.


Ejemplo: La misma decoración con diferentes propiedades.



Colores de las decoraciones
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Algunas decoraciones te permiten cambiar de colores, teniendo entre 1 a 3 colores para personalizar.

C="color1, color2, color3"

color1,color2,color3 - Colores en formato hexadecimal

El formato del color debe ser "000000" donde cada dígito es un valor hexadecimal entre 0 y F.


Ejemplo: Tres decoraciones con 1, 2 y 3 colores personalizados



Orden Z
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Al igual que los suelos, las decoraciones con mayor Z estarán por encima del resto. Este orden viene dado en el XML. La primera decoración tendrá un Z = 0, la segunda tendrá Z =1, y así sucesivamente.


Ejemplo: El árbol está detrás de las otras dos decoraciones.

Manual XML de Hina
Objetos de chamán

En el grupo <O></O> van los objetos de chamán que estarán en el mapa. Todos los elementos aquí usan la etiqueta <O />.

a dit :

<C><P /><Z><S /><D /><O><O X="400" Y="200" P="0" C="10" /></O></Z></C>

Contenido
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

• Posición
• Tipo
• Propiedades
• Motor
• Orden Z

Posición
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
La ubicación en el mapa del centro del objeto.

X="coordenada x"
Y="coordenada y"

coordenada x - Coordenada X del centro del objeto

coordenada y - Coordenada Y del centro del objeto

Las coordenadas pueden ser negativas y salirse de los límites del mapa, sin embargo los objetos que se encuentren muy lejos de los límites laterales o por debajo del límite inferior, desaparecerán al iniciar el mapa. Los límites casi exactos son:

X: desde -120 hasta L+100
Y: desde -900 hasta H+499

L y H son las dimensiones del mapa (longitud y altura)

Ejemplo: Cajas dentro y fuera de los límites. Nótese que algunas cajas desaparecen.



Tipo
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
En este atributo se determina cuál objeto de chamán usar.

C="ID del objeto"

ID del objeto - El ID del objeto de chamán a utilizar (ver Apéndice: Objetos de Chamán).

Ejemplo: Piscina de objetos



Propiedades
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Los objetos tienen dos propiedades: rotación y fantasma.

P="rotación, fantasma"

rotación - Ángulo de rotación del objeto.

fantasma - Si es 1 el objeto será fantasma (transparente e intocable).

La rotación está dada en grados y aumentan en sentido antihorario.


Ejemplo: Tablas rotadas en distintos ángulos



Motor
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Estos atributos te permiten ajustar la forma en que giran los anclajes.

Mv="velocidad"
Mp="fuerza"

velocidad - La velocidad con la que girarán los objetos anclados

fuerza - La fuerza que tiene el motor para oponerse a cualquier resistencia

Estos atributos sirven para todos los anclajes (con o sin motor). Es posible anclar objetos de chamán y suelos dinámicos.

Una velocidad positiva hará un giro en sentido horario y una velocidad negativa en sentido antihorario. Pero el objeto que gira puede cambiar dependiendo de las fuerzas que interactúan, y como consecuencia puede cambiar el sentido.

Se puede usar el valor "Infinity" en la fuerza para que el objeto no se vea afectado por ninguna resistencia, sin importar lo fuerte que sea.


Ejemplo: Vehículo saltarín y molino que impide el paso



Orden Z
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
En los objetos también se aplica el orden Z de los suelos y decoraciones para indicar cuál está al frente o detrás. El orden viene dado en el XML, donde el primer objeto tendrá un Z = 0, el segundo tendrá Z = 1, y así sucesivamente.

El orden Z tiene especial importancia al trabajar con motores. En el ejemplo siguiente se puede apreciar cómo se altera totalmente el resultado al cambiar el orden Z de los objetos anclados:


Ejemplo: La primera caja está detrás de la tabla pero la segunda está delante. El primer anclaje hace girar a la caja en sentido horario mientras que el segundo anclaje hace girar a la tabla en sentido horario. El resultado es que ambas cajas giran en direcciones contrarias (la segunda caja gira como consecuencia del giro de la tabla*).

Manual XML de Hina
Guía de Joints

Los joints son elementos del mapa que esencialmente "unen" suelos (de ahí el nombre "joint"). Pueden ser uniones abstractas o elementos visibles con colores y otras propiedades visuales. Entre las cosas que podemos hacer con joints están:

• Dibujos con joints visibles
• Mecanismos de rotación (similares a los anclajes)
• Mecanismos de movimiento (motores lineales)
• Suelos anclados a distancia
• Mecanismos de poleas
• Uniones elásticas

Todo esto da lugar una cantidad inimaginable de posibles ideas de mapas. Sin embargo los joints son elementos complejos que requieren un buen dominio de los mismos y suficiente experiencia para crear cosas con ellos.


Contenido
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

• Lista de joints
• Atributos comunes
• <JD> - Joint de distancia
• <JP> - Joint prismático
• <JR> - Joint de rotación
• <JPL> - Joint de polea

Lista de joints
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Todos los joints van dentro del grupo <L></L>. Existen cuatro tipos de joints resumidos aquí:

<JD />	Joint de distancia: para unir suelos manteniendo sus distancias
<JP />	Joint prismático: une suelos manteniendo la rotación fija, permite que se muevan por un eje y puede tener un motor
<JR />	Joint de rotación: usado para anclar suelos a un punto fijo de rotación y también hacerlos girar sobre este punto
<JPL />	Joint de polea: crea un sistema de polea entre dos suelos

Atributos comunes
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Todos los joints poseen los siguientes atributos.

M1="suelo 1"
M2="suelo 2"
P1="x1, y1"
P2="x2, y2"
c="color, grosor, transparencia, frente"

suelo 1 - Valor Z del primer suelo de la unión
suelo 2 - Valor Z del segundo suelo de la unión
x1, y1 - Coordenadas del primer punto de la unión (por defecto es el centro de M1)
x2, y2 - Coordenadas del segundo punto de la unión (por defecto es el centro de M2)

color - Color de la unión
grosor - Grosor de la línea de unión
transparencia - Transparencia de las líneas. Valor decimal desde 0 = Invisible hasta 1 = opaco.
frente - Si es 1 la línea se verá por encima de los suelos y objetos.

Todos estos atributos son opcionales. Aunque para que un joint funcione necesitarás poner dos suelos.


<JD> - Joint de distancia
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Crea una unión simple entre dos suelos. Los suelos unidos conservarán una misma distancia pero podrán girar libremente. La unión puede tener elasticidad permitiendo un movimiento más libre, o ser rígida. Este joint se puede comparar a una cuerda.

Esta unión utiliza los siguientes atributos:

HZ="frecuencia"
AMP="amortiguación"

frecuencia - Frecuencia de oscilación. Mientras más bajo, más elástica será la unión. Mientras más alto será más rígida.

amortiguación - Proporción en la que se amortigua la oscilación de la cuerda. Es un valor entre 0 y 1.

La amortiguación puede ser más alta, sin embargo en 1 ya dentendrá completamente la oscilación.

Para entender el concepto de oscilación hay que imaginar un resorte. Cuando estiras el resorte y luego lo sueltas, el resorte seguirá encogiéndose y estirándose por sí solo durante un tiempo. Eso es la oscilación, y la amortiguación hará que el resorte oscile por menos tiempo. Cuando la amortiguación es 1, el resorte no oscila y al soltarlo vuelve directamente a su estado inicial.

Ejemplo: Cuatro cuerdas con la misma frecuencia pero distinta amortiguación. Nótese que la última no oscila.



<JP> - Joint prismático
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este joint permite el movimiento relativo entre dos suelos a lo largo de un eje específico. Esto quiere decir que ambos suelos se moverán libremente por un eje pero conservarán su distancia en el eje perpendicular a este. Ambos suelos tendrán la misma rotación y el eje girará y se moverá junto con los objetos.

El joint puede tener unos límites para que los suelos solo puedan moverse libremente por el eje hasta cierto punto. También puede usarse un motor para generar movimiento automático a través del eje.

AXIS="x, y"
LIM1="límite inferior"
LIM2="límite superior"
MV="fuerza, velocidad"
A="ángulo"

x, y - Coordenadas del eje. Pueden ser los valores -1, 0 y 1.
límite inferior - Límite de movimiento en la dirección contraria al eje
límite inferior - Límite de movimiento en dirección del eje
fuerza - La fuerza que tiene el motor para oponerse a otras fuerzas.
velocidad - Velocidad del motor con la que se moverá el suelo.
ángulo - Ángulo de diferencia que puede haber en la rotación de ambos objetos. En radianes.

El límite inferior debe ser menor a 0 y el límite superior mayor a 0 puesto que los suelos comenzarán con una traslación igual a 0.

El ángulo de diferencia por defecto será 0, haciendo que ambos suelos siempre tengan la misma rotación.

El eje siempre gira junto a los suelos. Si se desea un eje fijo se puede usar rotación fija en ambos suelos.


Ejemplo: Dos suelos unidos con un eje vertical (línea roja). Se moverán juntos horizontalmente.



<JR> - Joint de rotación
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este joint hace que uno o dos suelos compartan un mismo punto de rotación. Les permite girar libremente sobre este punto o con límites predefinidos, como el joint prismático. Y también puede tener un motor para generar un torque (fuerza de rotación).

MV="fuerza, velocidad"
LIM1="límite inferior"
LIM2="límite superior"

fuerza - El torque o fuerza de rotación del motor para oponerse a otras fuerzas.
velocidad - La velocidad de giro del motor.
límite inferior - El límite de rotación en sentido antihorario.
límite superior - El límite de rotación en sentido horario.

Los límites se especifican en radianes. Y al igual que en el joint prismático, el valor 0 debe estar contenido entre ambos límites.

El motor hace girar al primer suelo (M1) alrededor del punto 2 (P2). Si no se especifica un punto este será el centro del suelo correspondiente. Gracias a eso es fácil lograr lo que hace la madera en el siguiente ejemplo sin especificar ningún punto, simplemente usando dos suelos. Si mueves ambos suelos en el editor se mantiene la rotación intacta.


Ejemplo: Una lava anclada a un punto con límites. Un suelo anclado a otro suelo con motor y un hielo giratorio.



<JPL> - Joint de polea
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Este joint crea un sistema de poleas compuesto por dos suelos y dos puntos en donde están ubicadas las poleas. Las poleas no son objetos físicos, solo son puntos. El joint permite que una cuerda se extienda más rápido que la otra o que estén en equilibrio.

P3="x1, y1"
P4="x2, y2"
R="proporción de balance"

x1, y1 - Punto de la primera polea, que estará sosteniendo el primer suelo (M1).
x2, y2 - Punto de la segunda polea, que estará sosteniendo el segundo suelo (M2).
proporción de balance - Proporción de qué tanto se estirará la primera cuerda en comparación a la segunda.

La proporción por defecto es 1 y ambas cuerdas estarán en equilibrio. Si la proporción es 2, la primera cuerda se estirará el doble de rápido. Si la proporción es 0.5, la segunda cuerda se estirará el doble de rápido.

El joint de poleas se muestra con 3 líneas rectas al hacerlo visible. Es gracias a esto que Viprin's Drawing Editor logra comprimir más el arte. Dibujando 3 líneas con un único joint.


Ejemplo: Sistema de poleas con el balance inclinado hacia suelo derecho

Manual XML de Hina
Apéndice

Aquí tienes varios IDs, datos adicionales y otras cosas.


Contenido
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

IDs de suelos
IDs de decoraciones
IDs de objetos

IDs de suelos - Propiedades por defecto
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

ID	Suelo	Fricción	Restitución	Otros
0	Madera	0.3	0.2
1	Hielo	0	0.2
2	Trampolín	0	1.2
3	Lava	0	20
4	Chocolate	20	0.2
5	Tierra	0.3	0.2
6	Hierba	0.3	0.2
7	Arena	0.1	0.2
8	Nube	0.3	0.2	C = "2"
9	Agua	-	-	Flotabilidad
10	Piedra	0.3	0
11	Nieve	0.05	0.1
12	Rectángulo	0.3	0.2	o="324650"
13	Círculo	0.3	0.2	o="324650" Área circular
15	Telaraña	-	-	Detiene el movimiento

Los suelos de hierba, piedra y nieve tendrán bordes laterales diferentes cuando su longitud sea divisible por 40.



El resto de las propiedades por defecto son las mismas para todos los suelos (sin rotación, no dinámico, de fondo).


IDs de decoraciones
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

ID	Decoración	Colores	Notas
Decoraciones clásicas
0	arbusto
1	árbol
2	helecho
3	flor azul
4	letrero
5	hierba
6	palmera
7	sombrilla
8	castillo de arena
9	pala
10	cubo de arena
11	flor roja
12	espinas
13	valla
Decoraciones de casa de tribu
14	ventana	3
15	sofá	1	Es tangible
16	silla		Es tangible
17	mesa		Es tangible
18	flores	2
19	sillón	1	Es tangible
20	planta	1
21	pollo
22	estante
23	poster de pesca
24	cama	1	Es tangible y se puede rebotar un poco en ella
25	radio
26	osito
27	lámpara
28	nevera
29	armario
30	televisión
31	botella
32	planta pequeña
33	mesa de noche
34	fondo	1
Decoraciones de Halloween
35	adorno de pared 1
36	adorno de pared 2
37	escoba
38	esqueleto de ratón
39	poster de halloween
40	globos
41	telaraña con arañita
42	árbol de otoño
43	murciélagos
44	antorcha
45	fondo de cementerio
46	antorcha de piedra
47	rejas
48	calabaza de halloween
49	calabaza
Decoraciones de Navidad
50	muñeco de nieve
51	árbol de invierno
52	leche y galletas ^-^
53	corona navideña
54	bota
55	vela
56	adorno de pared	2
57	árbol de navidad
58	estalactitas de hielo
59	muérdago
60	adorno	1
61	luces
62	regalo simple
63	regalos
64	silueta de santa
65	lazo	2
Decoraciones de San Valentín
66	sombrilla
67	silla
68	mesa
69	letrero menú
70	regalo
71	vela
72	flores
73	rosa
74	adorno colgante
75	globo de corazón
76	ventana
77	corazón colgante
Decoraciones de Pesca
78	planta acuática 1
79	planta acuática 2
80	cofre
81	estrella de mar
82	ostra
83	piedras marinas 1
84	piedras marinas 2
85	coral	1
86	anémona	1
87	alga
88	vasija
Pantallas de Tribu / Music
89	pantalla grande	1	Los videos se verán aquí
90	pantalla pequeña	1	Los videos se verán aquí
Decoraciones de Halloween +
91	matraz químico 1	1
92	instrumentos químicos 1	4
93	instrumentos químicos 2	4
94	estante	2
95	piano	1
96	chimenea	1
97	candelabro mesa	2
98	ataúd	2
99	atril	1
100	balón químico	1
101	matraz químico 2	1
102	candelabro techo	4
103	barril	2
104	mesa	1	Es tangible
105	silla	2	Es tangible
106	calavera
107	telaraña 1
108	telaraña 2
109	telaraña 3
110	telaraña 4
111	telaraña 5
112	cuadro de Von Drekkemaus
113	frutas
114	espejo
115	lápida de Elise
116	cruz
117	fondo de piedra	2
118	lápida de queso
Decoraciones de casa de tribu +
119	inodoro	2
120	bañera	1
121	lavamanos
122	espejo
123	utensilios de cocina
124	cocina
125	silla mesedora	1	Es tangible
126	sartén
127	silla	2	Es tangible
128	mueble 1	3
129	mueble 2	3
130	lámpara de lava	1
Checkpoint
131	huella checkpoint	1	Sirve como checkpoint de bootcamp

IDs de los objetos
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

ID	Objeto	Masa aproximada
1	Caja pequeña	30
2	Caja grande	120
3	Tabla pequeña	55
4	Tabla grande	110
6	Pelota	8
7	Trampolín	60
10	Yunque	1000
11	Anclaje rojo
12	Motor rojo derecha
13	Motor rojo izquierda
14	Anclaje verde
15	Motor verde derecha
16	Motor verde izquierda
22	Anclaje amarillo
28	Globo
32	Runa