> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/libraries/create-libraries.md).

# Crear una librería

Crea tus propias librerías de Decentraland para compartirlas con otros

Las bibliotecas son una excelente forma de compartir soluciones a problemas comunes. Los desafíos complejos se pueden abordar una sola vez, encapsular las soluciones en una biblioteca y, cuando vuelvan a surgir, solo tendrás que escribir una línea de código. Al compartir bibliotecas con la comunidad, podemos aumentar exponencialmente la productividad de todos los creadores.

Actualmente, estas bibliotecas de la [página de ejemplos](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) están disponibles para que todos las usen. Te animamos a crear y compartir las tuyas también.

Si sigues los pasos que se detallan aquí, puedes evitar la mayor parte de la complejidad que implica crear una biblioteca compatible con las escenas de Decentraland y fácil de compartir con otras personas.

## Crear una biblioteca

> **📔 Nota**: Asegúrate de usar la versión 20 de Node o una posterior antes de compilar tu biblioteca.

Para crear tu propia biblioteca y compartirla mediante NPM, sigue estos pasos:

1. Crea una carpeta nueva vacía y abre allí una nueva ventana de Visual Studio Code.
2. Selecciona la pestaña de Decentraland en la barra lateral izquierda de Visual Studio
3. Haz clic en **Crear proyecto**, luego selecciona **Biblioteca**

   Esto creará todos los archivos predeterminados y las dependencias de una biblioteca de Decentraland.
4. Define un valor único para `name` en `package.json`. Este es el nombre que se usará al publicar en NPM. Asegúrate de que no haya otro proyecto existente con ese nombre en npm. Completa también la descripción y agrega etiquetas para que otras personas puedan encontrar tu biblioteca.
5. Crea un nuevo repositorio de GitHub *público* para tu proyecto.

   El proyecto está configurado para usar GitHub Actions y publicar una nueva versión del paquete cada vez que se haga un push a `main`.

   En el archivo `package.json` , asegúrate de que en `repository` el campo `url` apunte a la URL de tu repositorio. Así será fácil encontrarlo para quienes naveguen por [npmjs.com](https://www.npmjs.com).
6. Obtén un token de NPM:
   1. Crea una cuenta o inicia sesión en <https://www.npmjs.com/>.
   2. Ve a **Cuenta > Tokens de acceso > Generar nuevo token** Crea un token nuevo y asígnale permisos de **publicación** .

      El mensaje de éxito incluye una cadena correspondiente al token que acabas de generar. Copia esta cadena y guárdala en un lugar seguro.
7. En tu repositorio de GitHub, ve a **Configuración > Secretos > Actions**y haz clic en **Nuevo secreto del repositorio**.

   Asigna a tu secreto el nombre **NPM\_TOKEN**y pega como valor la cadena del token de NPM.
8. Haz push de un cambio (cualquiera) a la rama main de tu repositorio de GitHub y se publicará el paquete.

   Eso es todo; ahora cualquiera puede instalar el paquete usando `npm i <package-name>`! Ahora puedes encontrar tu biblioteca si la buscas por nombre en [npmjs.com](https://www.npmjs.com).
9. Completa la carpeta `/src` de tu proyecto con todas las funciones que quieras exponer y sube los cambios a GitHub.

## Desarrollar

Añade al archivo `index.ts` de la biblioteca las funciones, los componentes, etc., que quieras exponer; así será fácil importarlos.

Por ejemplo, si añades el componente `RotatorComponent` a `index.ts`, podrás importar este componente en una escena escribiendo lo siguiente:

`import { RotatorComponent } from 'my-library'`

Prueba tu biblioteca mientras la desarrollas usándola en una nueva escena de Decentraland. Instala el paquete npm en una escena ejecutando `npm i <package-name>`. Luego, crea una escena que sirva para probar la funcionalidad de la biblioteca. Intenta cubrir distintos casos de prueba con tu escena para asegurarte de que la biblioteca funcione como esperas en todos ellos.

### Iteraciones rápidas

Si necesitas hacer continuamente pequeños ajustes en tu biblioteca y probarlos, puede resultar agotador tener que confirmar los cambios y esperar a que termine la publicación en npm antes de probar la nueva versión en una escena. Por suerte, existe una alternativa mucho más rápida para hacer pruebas con tu biblioteca.

En un **proyecto de escena de prueba**:

1. Añade este script a la lista `scripts` de package.json: `"link-sdk": "cd node_modules/@dcl/sdk && npm link && cd ../js-runtime && npm link"`
2. Ejecuta `npm install`
3. Ejecuta `npm install YOUR_LIBRARY_PATH`, por ejemplo, `npm install /User/projects/dcl-sdk7-library-test`
4. Ejecuta `npm run link-sdk`

En el **proyecto de la biblioteca**:

1. Ejecuta `npm install`
2. Ejecuta `npm run build`
3. Ejecuta: `npm link @dcl/sdk @dcl/js-runtime`

> **❗Advertencia**: El orden de estos pasos es importante. Es posible que no funcione si los realizas en otro orden.

Esto mantendrá tu escena sincronizada con la versión de la biblioteca que está directamente en tu unidad local. Para probar cualquier cambio en la biblioteca, solo tienes que ejecutar `npm run build` en la carpeta de la biblioteca; no hace falta publicar los cambios en GitHub o NPM.

> **💡 Consejo**: Para comprobar que la vinculación se haya realizado correctamente, ejecuta `npm ls --link`. Deberías ver el nombre de la biblioteca apuntando a la carpeta de tus archivos locales.

Si realizas cambios en la biblioteca, debes ejecutar `npm run build` para actualizarlos. Para no tener que hacerlo cada vez:

1. Añade el script "start": "tsc -p tsconfig.json --watch" a la biblioteca
2. Ejecuta `npm start` en la biblioteca

Cuando termines de probar, recuerda desvincular la biblioteca.

1. En la carpeta de la escena, ejecuta `npm install <library name>`
2. Luego, en la biblioteca, ejecuta `rm -rf node_modules && npm install`

## Control de versiones

Las versiones de tu biblioteca se publican automáticamente en `npm` con una etiqueta `@latest` y una etiqueta `@next` .

La etiqueta `@next` siempre apunta al último commit de la rama `main`  . Esta versión podría ser inestable, ya que es posible que los últimos cambios no se hayan probado. Los usuarios de tu biblioteca pueden instalarla (bajo su propia responsabilidad) con el comando `npm i <library name>@next`.

La etiqueta `@latest` apunta a la última versión estable de la biblioteca. Esta es la versión que normalmente deberían instalar los usuarios de tu biblioteca. Es la versión que npm obtiene cuando ejecutan `npm i <library name>`.

Para que la etiqueta `@latest` apunte a tus commits más recientes, tendrás que crear una **versión** de tu biblioteca en GitHub.

1. Abre la página de tu proyecto en GitHub. Abre el enlace **Releases** , en el margen derecho de la página.
2. Haz clic en **Crear una nueva versión**.
3. En **Elegir etiqueta** escribe un nombre para la nueva versión; por ejemplo, "1.1.0". Escribe también un nombre en **Título de la versión**. Suele ser el mismo nombre: "1.1.0".

   > Importante: la etiqueta debe ser un número, sin letras ni símbolos adicionales. El número debe ser mayor que el de las versiones publicadas anteriormente.
4. Describe la versión para que los usuarios sepan qué hay de nuevo.

   > Consejo: haz clic en el botón **Generar automáticamente las notas de la versión** para imprimir todos los commits desde la última versión.
5. Pulsa **Publicar versión**. Esta acción desencadena una nueva publicación automática en npm con la `@latest` flag. Ahora los usuarios de tu biblioteca descargarán esta versión.

## Notas sobre usabilidad

Haz todo lo posible para que otros creadores puedan usar tu biblioteca fácilmente. Nuestras suposiciones siempre ayudan a dar forma a las herramientas que creamos. A menudo nos parecen obvias, pero otras personas con un contexto diferente pueden tener suposiciones completamente distintas.

* Elige cuidadosamente los nombres de todos los elementos de tu biblioteca, incluidas las funciones, los componentes y los parámetros. Es mejor usar un nombre largo que se explique por sí solo que uno corto que sea un completo misterio.
* Piensa en la mayor variedad posible de casos de uso para tu biblioteca. Quizás alguien la use en un wearable inteligente; quizás alguien necesite activar o desactivar tu sistema en determinados momentos; quizás alguien necesite añadir varias instancias de tu sistema en la misma escena. No todos se enfrentarán a los mismos desafíos que tú.
* Dicho esto, no necesitas admitir todos los casos de uso posibles. De hecho, siempre hay que encontrar un equilibrio entre flexibilidad y simplicidad de uso: crear buenas herramientas consiste en encontrar el punto justo. Decide estratégicamente qué aspectos no vas a admitir. Sin embargo, es importante documentar claramente las limitaciones que hayas decidido establecer.
* Esto nos lleva a la documentación. Documenta tu biblioteca con claridad, incluyendo ejemplos, descripciones de la función de cada parámetro, comentarios sobre qué situaciones no funcionarían y las suposiciones que haces sobre el contexto en que se utilizará. El archivo README.md de la biblioteca suele ser el mejor lugar para incluir este contenido.
* Otra herramienta muy útil es añadir comentarios con metadatos directamente en el código. El IDE (como Visual Studio Code) muestra estos comentarios mientras los usuarios escriben. Puedes describir para qué sirve cada función o componente, qué se espera que reciba cada parámetro y qué devuelve una función. Así, los usuarios de tu biblioteca no tienen que alternar entre el código y la documentación: ¡todo está en un mismo lugar! Por ejemplo, observa esta función de la biblioteca `@dcl/ecs-scene-utils` :

  ```ts
  /**
   * Limita un valor para que no supere un valor mínimo ni uno máximo.
   *
   * @param value - número de entrada
   * @param min - Valor mínimo de salida.
   * @param max - Valor máximo de salida.
   * @returns El valor resultante, ajustado entre min y max
   * @public
   */
  export function clamp(value: number, min: number, max: number) {
  	let result = value

  	if (value > max) {
  		result = max
  	} else if (value < min) {
  		result = min
  	}
  	return result
  }
  ```

  Los usuarios de esta biblioteca ven estas sugerencias mientras escriben la función `clamp()` :
* Declara siempre los tipos. No dejes que los demás tengan que adivinar qué estructura tendrá el objeto que van a usar.
* Mantén tu biblioteca ligera y centrada en una sola funcionalidad. Cuando se compila una escena de Decentraland, todo el código de todas sus bibliotecas se empaqueta con ella, incluso el código que la escena nunca utiliza. Por este motivo, es mejor evitar crear bibliotecas grandes y pesadas. Es preferible tener bibliotecas ligeras que permitan a los creadores usar solo lo que realmente necesitan.
* Mantente al tanto del repositorio de tu biblioteca; es posible que la gente envíe pull requests o informe de problemas.
* Incluye información sobre la licencia en tu repositorio para que los demás sepan si pueden usar tu biblioteca. La biblioteca predeterminada incluye una licencia Apache 2 de código abierto; puedes cambiarla si lo deseas.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/libraries/create-libraries.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
