Primeros pasos
BTC Studio desarrolla extensiones para TypeWriter, el motor de misiones y narrativa para servidores Paper. Esta documentación describe cada extensión: qué hace, cómo instalarla y cada una de las entradas que añade, campo por campo.
TypeWriter en cinco minutos
TypeWriter sustituye los archivos de configuración por un panel web. Abres el panel desde el servidor (/typewriter connect), construyes páginas formadas por entradas, las enlazas entre sí y publicas: el servidor aplica los cambios sin reiniciarse.
| Concepto | Qué es |
|---|---|
| Página | Un contenedor de entradas. Las páginas de secuencia contienen diálogos y acciones, las páginas estáticas contienen definiciones (artefactos, hablantes, definiciones de NPC), las páginas de manifiesto contienen lo que está siempre activo (audiencias, visualizaciones) y las páginas cinemáticas contienen líneas de tiempo. |
| Entrada | Un bloque de construcción, identificado por su tipo (por ejemplo schematic_block). Cada entrada tiene campos que rellenas en el inspector. |
| Disparador | Un enlace de una entrada a la siguiente: un evento activa una acción, que activa un diálogo… |
| Hecho | Un valor almacenado o calculado por jugador, que se usa en los criterios para decidir si una entrada se ejecuta y que cambian los modificadores. |
| Audiencia | Un filtro sobre los jugadores (en una región, con un objeto en la mano, en una etapa de misión). Las visualizaciones como las placas de nombre, los bloques falsos o los HUD se muestran a una audiencia. |
| Artefacto | Datos persistentes que pertenecen a una extensión (esquemas colocados, existencias de tiendas, estadísticas). |
Las extensiones añaden nuevos tipos de entrada a esta caja de herramientas. Una vez instalada una extensión, sus entradas aparecen en la barra de búsqueda del panel y tras el botón + del tipo de página correspondiente.
Instalar una extensión
- Instala TypeWriter en un servidor Paper y comprueba que el panel se abre.
- Descarga la extensión: desde sus releases de GitHub si es gratuita, o desde Voxel o BuiltByBit si es de pago. Los botones están en la parte superior de cada página de extensión.
- Instala los plugins indicados en Requires (Requisitos) en la página de la extensión.
- Coloca el JAR en
plugins/Typewriter/extensions/y reinicia el servidor. - Abre el panel: las nuevas entradas están disponibles en la barra de búsqueda.
Cada página de extensión muestra la versión que documenta y la versión de TypeWriter que necesita. Cuando actualices TypeWriter, actualiza a la vez sus extensiones a una versión compatible.
Orientarse en esta documentación
- El catálogo de extensiones enumera todas las extensiones, con filtros por disponibilidad y temática.
- Cada página de extensión sigue la misma estructura: descripción general, características, instalación, primeros pasos, comandos, permisos, placeholders, entradas y resolución de problemas.
- Cada página de entrada muestra la entrada tal como aparece en el panel (identificador, tipo, icono) y la tabla de sus campos con su tipo, valor por defecto y descripción. Estas tablas se generan a partir del código fuente de la extensión, por lo que coinciden con el código publicado.
| Disponibilidad | Significado |
|---|---|
| Free (Gratuita) | Código abierto, descargable desde GitHub. |
| Paid (De pago) | Integraciones premium, a la venta en Voxel y BuiltByBit. |
| Private (Privada) | Se ejecuta en la red BornToCraft con la versión BTC de TypeWriter; está documentada a modo de referencia y no se distribuye. |
| Soon (Próximamente) | En desarrollo; las entradas aún pueden cambiar. |
Obtener ayuda
Haz tus preguntas en el Discord de BTC Studio. Si encuentras un error en una extensión gratuita, abre una incidencia en su repositorio de GitHub indicando la versión de la extensión, la versión de TypeWriter y el primer error del registro del servidor.