TROPIKAL STUDIO TROPIKALSTUDIO
Manual de uso · versión 0.1.28User manual · version 0.1.28

Ayuda de TROPIKAL STUDIOTROPIKAL STUDIO help

Todo lo que el estudio hace, explicado por tarea. Busque abajo o vaya directo a una sección; los enlaces con # se pueden compartir y abrir desde la aplicación. Everything the studio does, explained by task. Search below or jump to a section; #-links are shareable and open from inside the application.

1 · Qué es el estudio1 · What the studio is

TROPIKAL STUDIO es un IDE de diseño visual para Windows. Usted describe y dibuja su aplicación o su videojuego —pantallas, niveles, reglas, datos y narrativa— y el estudio guarda todo como un modelo semántico con procedencia: cada objeto sabe de dónde salió y quién lo cambió.TROPIKAL STUDIO is a visual design IDE for Windows. You describe and draw your app or video game —screens, levels, rules, data and narrative— and the studio stores everything as a semantic model with provenance: every object knows where it came from and who changed it.

El estudio no genera el código de su aplicación o juego. Su producto final es un paquete de diseño —un HTML autocontenido o un ZIP editable— que usted entrega a la IA que prefiera para que lo implemente. Así el diseño queda completo, revisable y editable antes de escribir una sola línea de código. La única excepción es el prototipo jugable autorizado (decisión D34): una maqueta ejecutable con Phaser, sin red y de plataformas en esta etapa, que sirve para comprobar la primera escena y no es el juego final.The studio does not generate your app or game code. Its final product is a design package —a self-contained HTML or an editable ZIP— that you hand to the AI of your choice for implementation. That way the design is complete, reviewable and editable before a single line of code is written. The only exception is the authorized playable prototype (decision D34): a runnable Phaser mockup, offline and platformer-only at this stage, used to check the first scene and not the final game.

Hay dos estudios especializados: APPS (pantallas, formularios, tablas, dashboards y navegación) y GAMES (niveles, personajes, objetos, mecánicas y familias gráficas por género). Se eligen al crear el proyecto y comparten lienzo, documentos y entrega.There are two specialized studios: APPS (screens, forms, tables, dashboards and navigation) and GAMES (levels, characters, objects, mechanics and graphic families per genre). You pick one when creating the project; both share canvas, documents and delivery.

2 · Lienzo y piezas2 · Canvas and pieces

Cree un proyecto con Ctrl+N o desde la pestaña Inicio. El lienzo es la superficie de diseño: arrastre personajes, objetos y fondos desde la biblioteca de piezas y suéltelos donde quiera. Cada pieza queda como un objeto del modelo, no como un dibujo perdido.Create a project with Ctrl+N or from the Home tab. The canvas is the design surface: drag characters, objects and backgrounds from the piece library and drop them anywhere. Each piece becomes a model object, not a lost drawing.

  • Galería de niveles (GAMES): al crear un escenario 2D se abre una galería de niveles listos —kit de jugador, plataformas, arena cenital, oleada de enemigos, carreras, mazmorra, carrera infinita, sigilo, pueblo, arena de jefe, laberinto y más— agrupados por familia y con buscador. La galería muestra únicamente niveles reales: los kits de interfaz (HUD, pausa, menús, controles) no aparecen como escenarios. «Usar este nivel» siembra la composición completa como documento editable con sus elementos ya colocados; «Empezar en blanco» crea el lienzo vacío. Las reglas descritas son especificaciones editables, no lógica ejecutable.Level gallery (GAMES): creating a 2D scene opens a gallery of ready-made levels —player kit, platformer, top-down arena, enemy wave, racing, dungeon, endless runner, stealth, town, boss arena, maze and more— grouped by family with a search box. The gallery shows only real levels: interface kits (HUD, pause, menus, controls) do not appear as scenes. “Use this level” seeds the full composition as an editable document with its elements already placed; “Start blank” creates the empty canvas. Described rules are editable specifications, not executable logic.
  • Inspector (derecha): nombre, posición, tamaño, familia y propiedades de la pieza seleccionada. Todo lo que edite ahí entra al modelo y a la entrega.Inspector (right): name, position, size, family and properties of the selected piece. Everything you edit there enters the model and the delivery.
  • Zoom y paneo: Ctrl+rueda acerca y aleja; Espacio+arrastrar mueve la vista sin tocar las piezas.Zoom and pan: Ctrl+wheel zooms; Space+drag moves the view without touching pieces.
  • Deshacer: Ctrl+Z y Ctrl+Y recorren el historial; el panel Historial muestra cada cambio con su etiqueta.Undo: Ctrl+Z and Ctrl+Y walk the history; the History panel lists every change with its label.
  • Pestañas: cada documento o composición abre su pestaña; Ctrl+Tab cambia y Ctrl+W cierra. La distribución de paneles se recuerda al volver.Tabs: each document or composition opens its own tab; Ctrl+Tab switches and Ctrl+W closes. Your panel layout is remembered when you return.
  • Problemas (abajo): la revisión continua lista errores y avisos; cada incidencia lleva al objeto exacto que la produce.Problems (bottom): continuous review lists errors and warnings; each issue jumps to the exact object that causes it.

3 · Kits gráficos3 · Graphic kits

La pestaña Kits gráficos convierte sus láminas (tilesets, spritesheets, fondos, HUD) en piezas utilizables. Importe PNG, JPG, WEBP o AVIF y elija cómo recortar:The Graphic kits tab turns your sheets (tilesets, spritesheets, backgrounds, HUD) into usable pieces. Import PNG, JPG, WEBP or AVIF and choose how to cut:

  • Recorte libre: marque a mano cada región sobre la lámina, con vista previa ampliada. El editor tiene zoom (botones o Ctrl + rueda), tiradores y campos numéricos para ajustar el rectángulo al píxel; al guardar, el PNG se regenera.Free crop: mark each region by hand over the sheet, with a magnified preview. The editor has zoom (buttons or Ctrl + wheel), handles and numeric fields to adjust the rectangle to the pixel; saving regenerates the PNG.
  • Cuadrícula: defina columnas y separación y el estudio corta toda la lámina en piezas uniformes; ideal para tilesets y spritesheets de animación.Grid: set columns and spacing and the studio cuts the whole sheet into uniform pieces; ideal for tilesets and animation spritesheets.

El panel sigue un solo camino en cuatro pasos: 1 Importar → 2 Recortar → 3 Clasificar → 4 Usar y entregar. Cada pieza recibe una familia (personaje, objeto, terreno, fondo, interfaz…) y un nombre editable. Para usarla, arrástrela directa al lienzo o pulse «Colocar». La exportación de piezas recortadas (PNG numerados + piezas.json) vive ahora en Entregar, junto al paquete editable; ya no hay una «canasta» aparte.The panel follows a single four-step path: 1 Import → 2 Cut → 3 Classify → 4 Use and deliver. Each piece gets a family (character, object, terrain, background, interface…) and an editable name. To use it, drag it straight onto the canvas or press “Place”. Exporting cropped pieces (numbered PNGs + piezas.json) now lives in Deliver, next to the editable package; there is no separate “basket” anymore.

IA local integrada (CLIP, sin claves): «Clasificar piezas del kit» sugiere la familia de cada pieza en su propio equipo, tras una descarga única del modelo. «Aplicar todas las seguras» escribe de un clic las sugerencias con confianza suficiente; las dudosas quedan marcadas para revisión manual, pieza por pieza, con su imagen a la vista. Nada se escribe hasta que usted lo aplica.Built-in local AI (CLIP, no keys): “Classify kit pieces” suggests each piece’s family on your own machine, after a one-time model download. “Apply all confident” writes the confident suggestions in one click; unsure ones stay marked for manual review, piece by piece, with the image in view. Nothing is written until you apply it.

IA del kit (opcional, en la nube): «Analizar imágenes» construye una lámina de contacto con sus piezas y se la envía al proveedor de visión que usted tenga configurado; el resultado es una descripción editable que entra al documento del kit. «Proponer» usa el brief del proyecto para sugerir la composición del nivel. Nada de esto se ejecuta solo: siempre lo dispara usted, y requiere su propia clave de API.Kit AI (optional, cloud): “Analyze images” builds a contact sheet from your pieces and sends it to the vision provider you have configured; the result is an editable description that enters the kit document. “Propose” uses the project brief to suggest the level composition. None of this runs on its own: you always trigger it, and it requires your own API key.

4 · Documentos4 · Documents

El diseño escrito vive en documentos Markdown por proyecto: mecánicas, pantallas o niveles, datos, narrativa y notas. Son la parte que la IA leerá para implementar: escriba en lenguaje natural, con listas y tablas si ayudan.The written design lives in per-project Markdown documents: mechanics, screens or levels, data, narrative and notes. They are what the AI will read to implement: write in plain language, with lists and tables where they help.

  • Cada documento abre su pestaña con editor y vista previa; los enlaces internos y las referencias a piezas se mantienen al exportar.Each document opens its own tab with editor and preview; internal links and piece references survive export.
  • El asistente puede proponer texto para un documento; usted revisa y acepta o descarta. Nada se escribe sin su aprobación.The assistant can propose text for a document; you review and accept or discard. Nothing is written without your approval.
  • La revisión marca documentos vacíos o contradicciones con el modelo (por ejemplo, una mecánica que menciona una pieza inexistente).Review flags empty documents or contradictions with the model (for example, a mechanic mentioning a nonexistent piece).

5 · Escenarios 3D5 · 3D scenes

Los proyectos GAMES pueden incluir escenarios 3D traídos de Designer3D con el contrato tropikal.scene3d.v1. Pulse Importar 3D en la barra (o el «+» del grupo Escenarios 3D del explorador) y elija el ZIP: el estudio valida el manifiesto escena.json, copia los modelos GLB a su proyecto y abre el visor.GAMES projects can include 3D scenes brought from Designer3D under the tropikal.scene3d.v1 contract. Press Import 3D in the toolbar (or the “+” of the explorer’s 3D Scenes group) and choose the ZIP: the studio validates the escena.json manifest, copies the GLB models into your project and opens the viewer.

  • Visor, no editor. Orbite con el ratón, acerque con la rueda y haga clic sobre un objeto para seleccionarlo. No hay gizmos ni edición de geometría, física o ejecución: el diseño 3D se crea en Designer3D y aquí se inspecciona y se documenta.Viewer, not editor. Orbit with the mouse, zoom with the wheel and click an object to select it. There are no gizmos, geometry editing, physics or execution: 3D design is authored in Designer3D and inspected and documented here.
  • Inspector. Nombre, posición, rotación (grados), escala, visibilidad, clip de animación con bucle y propiedades de diseño libres (por ejemplo «colisión» o «tipo»). Cada cambio es un paso deshacer del historial.Inspector. Name, position, rotation (degrees), scale, visibility, animation clip with loop and free design properties (for example “collision” or “type”). Every change is an undoable history step.
  • Animaciones. Los clips con nombre que trae el GLB se eligen en el inspector; la barra del visor permite pausarlas, ocultar la cuadrícula y volver a la cámara del manifiesto.Animations. Named clips embedded in the GLB are chosen in the inspector; the viewer toolbar can pause them, hide the grid and return to the manifest camera.
  • Reglas del contrato. Y arriba, 1 unidad = 1 metro, rotaciones en grados (Euler XYZ); texturas embebidas en el GLB; los objetos repetidos comparten archivo; máximo 32 MB por archivo y 128 MB por paquete. Los ZIP que no cumplan se rechazan con el motivo exacto.Contract rules. Y-up, 1 unit = 1 meter, rotations in degrees (Euler XYZ); textures embedded in the GLB; repeated objects share one file; 32 MB per file and 128 MB per package caps. ZIPs that break the rules are rejected with the exact reason.
  • Entrega. El paquete incluye el manifiesto exacto en design.json, los GLB en assets/scene3d/ y una sección del HANDOFF.md que describe cada objeto con sus propiedades, listo para la IA que implemente.Delivery. The package includes the exact manifest in design.json, the GLB files under assets/scene3d/ and a HANDOFF.md section describing every object with its properties, ready for the implementing AI.

6 · Asistente de IA6 · AI assistant

El asistente (Ctrl+. o el botón IA de la barra) conversa con usted sobre el proyecto abierto: propone pantallas, niveles, mecánicas y texto, y construye a la vista paso a paso para que usted corrija mientras aparece.The assistant (Ctrl+. or the AI button in the toolbar) talks with you about the open project: it proposes screens, levels, mechanics and text, and builds in view step by step so you can correct as it appears.

  • Su clave, su proveedor. Configure el proveedor y la clave en los ajustes de IA. Las claves se guardan únicamente en el llavero de Windows: nunca en el proyecto, ni en el paquete exportado, ni en registros.Your key, your provider. Configure provider and key in the AI settings. Keys are stored only in the Windows keyring: never in the project, the exported package, or logs.
  • Diez proveedores con asesoría. OpenAI, Anthropic, DeepSeek, Qwen, OpenRouter, Google Gemini, Zhipu GLM, Moonshot/Kimi, SiliconFlow y cualquier compatible OpenAI. Cada tarjeta explica para qué destaca y trae la liga «Obtener clave» a su consola. Al elegir el modelo activo, las etiquetas le dicen si es Recomendado, Económico y si Ve imágenes, con una nota de para qué sirve. Sin proveedor activo, una guía de cuatro pasos le lleva de cero a conectado; «Comprobar clave y catálogo» valida su clave sin gastar tokens.Ten providers with guidance. OpenAI, Anthropic, DeepSeek, Qwen, OpenRouter, Google Gemini, Zhipu GLM, Moonshot/Kimi, SiliconFlow and any OpenAI-compatible endpoint. Each card explains what it is good at and links “Get API key” to its console. When you pick the active model, tags tell you whether it is Recommended, Budget and whether it Sees images, with a note on what it is for. With no active provider, a four-step guide takes you from zero to connected; “Check key and catalog” validates your key without spending tokens.
  • Sin nube por defecto. El estudio funciona completo sin conexión; las llamadas a IA en la nube ocurren solo cuando usted pulsa una acción que las usa.No cloud by default. The studio works fully offline; cloud AI calls happen only when you press an action that uses them.
  • Usted decide. Cada propuesta llega como cambio revisable con deshacer; el estado «IA sin configurar» en la barra inferior le recuerda que aún no hay proveedor.You decide. Every proposal arrives as a reviewable change with undo; the “AI not configured” status in the bottom bar reminds you no provider is set yet.
  • Ve lo que usted ve. Las fichas sobre el cuadro de texto muestran el proyecto, el documento abierto y su selección; al pulsarlas, le llevan al objeto. La IA conoce además el inventario completo de objetos del proyecto, aunque no estén seleccionados.It sees what you see. The chips above the text box show the project, the open document and your selection; pressing them takes you to the object. The AI also knows the project's full object inventory, even when nothing is selected.
  • Adjunte imágenes. Con el botón 📎 o arrastrando archivos al cuadro de texto (hasta 6 por mensaje). Las imágenes se importan al proyecto y la IA las usa como referencia visual para colocar y ajustar piezas. Si el modelo activo no procesa imágenes, se le avisa y los adjuntos se citan por nombre y ruta.Attach images. With the 📎 button or by dragging files onto the text box (up to 6 per message). Images are imported into the project and the AI uses them as visual reference to place and adjust pieces. If the active model cannot process images, you are told and the attachments are cited by name and path.
  • Pregunta antes de adivinar. Si falta información esencial, la IA devuelve preguntas con opciones en lugar de inventar cambios; usted responde (o deja en blanco y ella decide) y la propuesta llega después. Ningún error queda en silencio: siempre verá un mensaje claro con el siguiente paso.It asks before guessing. If essential information is missing, the AI returns questions with options instead of inventing changes; you answer (or leave blank and it decides) and the proposal arrives afterwards. No error is silent: you always see a clear message with the next step.
  • Borrador con IA al crear. En el nuevo proyecto, «Borrador con IA» genera los documentos visuales y la ficha «Borrador inicial» paso a paso, con alcance corto (2–4 pantallas del recorrido principal) o completo (hasta 16). Puede partir de una idea o de un informe de investigación en .md/.txt que pega o carga como archivo: el informe queda como especificación del proyecto antes que cualquier IA y activa el alcance completo. Sin proveedor, el proyecto se crea igual con su idea o informe como especificación pendiente de IA, y «Usar la clave del Tropikal anterior» importa la configuración legacy de un clic. La tecnología de GAMES inicia vacía para que usted la elija.AI draft on creation. In the new project, “AI draft” generates the visual documents and the “Initial draft” spec step by step, with short scope (2–4 screens of the main flow) or full (up to 16). You can start from an idea or from a research report in .md/.txt that you paste or load as a file: the report becomes the project specification before any AI and activates full scope. With no provider, the project is still created with your idea or report as a specification pending AI, and “Use the previous Tropikal key” imports the legacy configuration in one click. The GAMES technology starts empty for you to choose.

La validación de claves por tarjeta, las guías de género internas, la simulación de construcción, la crítica por lentes y el puente «Traer de una IA» se explican paso a paso en la sección 14.Per-card key validation, internal genre guides, construction simulation, lens-based critique and the “Bring from an AI” bridge are explained step by step in section 14.

7 · Revisión y entrega (HTML o ZIP)7 · Review and delivery (HTML or ZIP)

Antes de entregar, pase Validar y Revisar: el estudio comprueba coherencia del modelo (piezas sin familia, documentos vacíos, referencias rotas) y le lleva a cada incidencia. Cuando esté limpio, Entregar exporta un HTML autocontenido (recomendado) o un ZIP de diseño editable.Before delivering, run Validate and Review: the studio checks model coherence (pieces without family, empty documents, broken references) and jumps to each issue. When clean, Deliver exports a self-contained HTML (recommended) or an editable design ZIP.

El HTML autocontenido es una web autodocumentada en un solo archivo: conserva el modelo semántico completo como isla JSON, los recursos embebidos, el informe de diseño y la guía para la IA externa. Suma una guía para construirlo manualmente que se adapta a la tecnología declarada (Godot, Unity, Phaser, framework web, Flutter o HTML/JS). El ZIP editable conserva la definición completa del proyecto, documentos e imágenes recortadas; ábralo, modifíquelo o vuelva a importarlo.The self-contained HTML is a self-documented web in a single file: it preserves the full semantic model as a JSON island, the embedded assets, the design report and the guide for the external AI. It adds a guide to build it manually that adapts to the declared technology (Godot, Unity, Phaser, web framework, Flutter or HTML/JS). The editable ZIP keeps the full project definition, documents and cropped images; open it, modify it or re-import it.

Entregue ese paquete a su IA de confianza y pida que lo implemente, o use la guía manual para construirlo usted mismo. El estudio no compila ni ejecuta el proyecto final: esa es la parte de la otra IA o suya. El prototipo jugable autorizado (decisión D34) es una maqueta de comprobación, no el juego terminado.Hand that package to your trusted AI and ask it to implement, or use the manual guide to build it yourself. The studio does not compile or run the final project: that is the other AI's part, or yours. The authorized playable prototype (decision D34) is a checking mockup, not the finished game.

El detalle de cada formato, la reimportación con historial y el prototipo jugable autorizado están en Entregar: HTML, informe y prototipo.Details of each format, history-preserving re-import and the authorized playable prototype are in Deliver: HTML, report and prototype.

8 · Inicio: lobby, demos y proyectos recientes8 · Home: lobby, demos and recent projects

La pestaña Inicio es el lobby del estudio: la primera pantalla al abrirlo sin proyecto. Reúne una campaña estrella, tres demos, una tira de plantillas y sus proyectos recientes, todos con miniatura para reconocerlos de un vistazo. No hace falta configurar nada para empezar.The Home tab is the studio lobby: the first screen when it opens with no project. It gathers a star campaign, three demos, a strip of templates and your recent projects, all with thumbnails so you recognize them at a glance. Nothing needs to be configured to start.

  1. Abra el estudio sin proyecto y quédese en Inicio. Si ya tiene uno abierto, use Archivo → Cerrar proyecto para volver al lobby.Open the studio with no project and stay on Home. If you already have one open, use File → Close project to return to the lobby.
  2. Para empezar en dos clics, abra Inicio y pulse Crear y probar en la demo Campaña del bosque o Arena neón: el estudio crea el proyecto real y abre la maqueta jugable. En Panel de logística el botón es Crear, porque es una demo de APPS sin partida.To start in two clicks, open Home and press Create and try on the Forest campaign or Neon arena demo: the studio creates the real project and opens the playable mockup. On Logistics panel the button is Create, because it is an APPS demo with no play session.
  3. Las tarjetas de demo muestran una miniatura del contenido y la etiqueta Jugable cuando abren una partida. La campaña estrella del héroe ofrece Empezar con esta campaña y crea el nivel de bosque completo.Demo cards show a thumbnail of their content and the Playable badge when they open a session. The hero's star campaign offers Start with this campaign and creates the full forest level.
  4. Los proyectos de las demos se guardan en Documentos → Tropikal Studio con el nombre de la tarjeta; si repite una demo, el estudio añade un número para no sustituir el anterior.Demo projects are saved under Documents → Tropikal Studio with the card's name; if you repeat a demo, the studio appends a number so the previous one is not replaced.
  5. La tira Plantillas abre el diálogo Nuevo proyecto con esa plantilla ya elegida: revise nombre y carpeta y pulse Crear proyecto.The Templates strip opens the New project dialog with that template already selected: review name and folder and press Create project.
  6. En Recientes cada tarjeta enseña una instantánea del proyecto y su ruta; un clic lo abre tal como lo dejó. Si aún no hay, verá el aviso Todavía no hay proyectos recientes.Under Recent, each card shows a snapshot of the project and its path; one click opens it as you left it. If there are none yet, you will see the notice No recent projects yet.

9 · Probar: la maqueta viva9 · Try it: the live mockup

Probar abre la escena activa como Maqueta jugable: una vista que se recorre de verdad para comprobar el diseño, siempre etiquetada como maqueta. No es el juego final ni código generado por la IA, y no modifica nada del proyecto.Try it opens the active scene as a Playable mockup: a view you can actually walk through to check the design, always labeled as a mockup. It is not the final game or AI-generated code, and it changes nothing in the project.

  1. Abra un escenario 2D de GAMES y pulse Probar en la barra superior. También aparece en la guía que sigue al asistente de arranque.Open a GAMES 2D scene and press Try it in the top bar. It also appears in the guide that follows the startup wizard.
  2. Lea la etiqueta: Maqueta con assets de muestra cuando usa gráficos de ejemplo, o Maqueta — con tus gráficos cuando la escena ya tiene sus imágenes. El Modo de representación permite alternar entre ambos.Read the badge: Mockup with sample assets when sample graphics are used, or Mockup — with your graphics when the scene already has your images. Representation mode switches between them.
  3. Muévase con las flechas o WASD y salte con Espacio. La maqueta simula gravedad, suelos y plataformas sólidas, patrullas y contactos por rol, coleccionables, meta y el HUD del diseño, con figuras animadas según el rol de cada elemento.Move with the arrows or WASD and jump with Space. The mockup simulates gravity, solid floors and platforms, patrols and role-based contacts, collectibles, the goal and the design's HUD, with figures animated according to each element's role.
  4. Lo que no simula: combate, física o reglas finales, IA de enemigos, audio ni red. Los tipos sin comportamiento se dibujan estáticos y la maqueta no inventa un jugador que no existe: si la escena no tiene un personaje, verá el aviso Esta escena no tiene jugador.What it does not simulate: combat, final physics or rules, enemy AI, audio or network. Types without behavior are drawn statically and the mockup does not invent a player that does not exist: if the scene has no character, you will see This scene has no player.
  5. Al tocar la meta la maqueta se pausa y se le recuerda que no se ha cambiado nada del diseño. Use Reiniciar para volver a empezar la partida.Touching the goal pauses the mockup and reminds you that nothing in the design has changed. Use Restart to start the session again.
  6. Pulse Salir (Esc) o la tecla Esc para volver al lienzo exactamente donde estaba.Press Exit (Esc) or the Esc key to return to the canvas exactly where you were.

10 · Paneles, riel y layouts10 · Panels, rail and layouts

Los paneles se organizan como en Visual Studio: se acoplan alrededor del lienzo, se fijan o se autoocultan en un riel lateral, y puede guardar una distribución de trabajo con los Layouts. Su distribución se recuerda sola entre sesiones.Panels are organized like in Visual Studio: docked around the canvas, pinned or auto-hidden on a side rail, and you can save a working arrangement with Layouts. Your layout is remembered between sessions on its own.

  1. Muestre u oculte paneles desde Ventana: Explorador de soluciones, Cuadro de herramientas, Prefabs, Kits gráficos, Inspector de propiedades, Asistente IA y Panel inferior.Show or hide panels from Window: Solution explorer, Toolbox, Prefabs, Graphic kits, Property inspector, AI assistant and Bottom panel.
  2. Use el pin de la pestaña para fijar o soltar un panel: si está fijado, la acción dice Desfijar: al cerrar el panel se autooculta en el riel; si está suelto, dice Fijar el panel al dock.Use the tab pin to pin or release a panel: when pinned, the action reads Unpin: closing the panel auto-hides it on the rail; when released, it reads Pin the panel to the dock.
  3. Al cerrar un panel desfijado no se pierde: pasa al riel lateral, cuyos botones anuncian Paneles autoocultos: haz clic para abrirlos. Un clic lo abre como panel flotante (overlay) sobre el lienzo; solo hay uno a la vez, como en Visual Studio.Closing an unpinned panel does not lose it: it moves to the side rail, whose buttons announce Auto-hidden panels: click to open. One click opens it as a floating panel (overlay) over the canvas; only one at a time, as in Visual Studio.
  4. Cierre el overlay con Esc o haciendo clic fuera de él. El botón Mueve el riel al otro lado cambia el riel de borde si le estorba.Close the overlay with Esc or by clicking outside it. The Move the rail to the other side button switches the rail edge if it gets in your way.
  5. Aplique una distribución desde Ventana → Layouts: Diseño, Revisar, Chat IA o Nivel. Antes de cambiarla, el estudio guarda la suya en Mi layout y se lo avisa.Apply an arrangement from Window → Layouts: Design, Review, AI chat or Level. Before changing it, the studio saves yours in My layout and tells you so.
  6. Vuelva a su distribución con Ventana → Layouts → Mi layout. Si aún no hay ninguna guardada, el estudio le explicará que todavía no existe Mi layout.Return to your arrangement with Window → Layouts → My layout. If none is saved yet, the studio explains that My layout does not exist yet.
  7. No busque un botón de guardar distribución: paneles, tamaños, pestañas, zoom e idioma se recuerdan al cerrar y volver a abrir el estudio.Do not look for a save-layout button: panels, sizes, tabs, zoom and language are remembered when you close and reopen the studio.

11 · Entregar: HTML, informe y prototipo11 · Deliver: HTML, report and prototype

El botón Entregar de la barra abre el Paquete de entrega del diseño. Elija el formato según el destino: un HTML autocontenido para una IA o una persona, una carpeta con informe para revisión, o un prototipo jugable para comprobar la primera escena. El estudio diseña y documenta; no genera el código de su aplicación o juego.The Deliver button in the toolbar opens the Design delivery package. Choose the format for the destination: a self-contained HTML for an AI or a person, a folder with a report for review, or a playable prototype to check the first scene. The studio designs and documents; it does not generate your app or game code.

  1. Antes de exportar, pase Validar y Revisar. Los avisos no bloquean la entrega, pero le dicen qué falta y le llevan al objeto exacto.Before exporting, run Validate and Review. Warnings do not block delivery, but they tell you what is missing and take you to the exact object.
  2. Pulse Exportar HTML autocontenido: obtiene un solo archivo .html que se abre sin conexión, con el modelo, los recursos embebidos, el informe y la guía de construcción. Ese HTML se puede reimportar y conserva el historial de cambios cuando el paquete lo incluye.Press Export self-contained HTML: you get a single .html file that opens offline, with the model, embedded assets, report and build guide. That HTML can be re-imported and keeps the change history when the package includes it.
  3. Para recuperar una entrega, use Importar paquete de diseño (ZIP o HTML) y elija una carpeta nueva. Se crea un proyecto editable nuevo, sin sustituir ni cerrar el actual.To recover a delivery, use Import design package (ZIP or HTML) and choose a new folder. A new editable project is created without replacing or closing the current one.
  4. Pulse Exportar carpeta e informe para una carpeta nueva con design.json, HANDOFF.md, REPORT.html, assets/ y licenses/. Abra el informe y use Ctrl+P si quiere guardarlo como PDF.Press Export folder and report for a new folder with design.json, HANDOFF.md, REPORT.html, assets/ and licenses/. Open the report and use Ctrl+P if you want to save it as PDF.
  5. Use Exportar ZIP de diseño cuando necesite el archivo editable completo. Elija siempre un nombre nuevo: el estudio nunca sobrescribe una entrega existente.Use Export design ZIP when you need the full editable archive. Always choose a new name: the studio never overwrites an existing delivery.
  6. En proyectos GAMES, Exportar prototipo jugable (HTML) produce una maqueta ejecutable con Phaser 4 (MIT) embebido. Es un prototipo autorizado (decisión D34): no es el juego final ni código generado por la IA, funciona sin red y en esta etapa cubre solo plataformas —correr, saltar, gravedad, sólidos, patrullas, coleccionables, meta y HUD—. Los tipos sin comportamiento se dibujan estáticos y se avisan dentro del propio HTML.In GAMES projects, Export playable prototype (HTML) produces a runnable mockup with Phaser 4 (MIT) embedded. It is an authorized prototype (decision D34): not the final game or AI-generated code, it works without a network, and at this stage it covers only platformers —run, jump, gravity, solids, patrols, collectibles, goal and HUD—. Types without behavior are drawn statically and flagged inside the HTML itself.
  7. Revise licencias y tamaño antes de compartir. El paquete no incluye claves, ajustes del host ni la base interna, y rechaza campos privados y rutas reconocibles.Review licenses and size before sharing. The package includes no keys, host settings or internal database, and rejects private fields and recognizable paths.

12 · Biblioteca gráfica global12 · Global graphics library

La Biblioteca gráfica guarda imágenes compartidas por todos los proyectos de este equipo. Es distinta de los Kits gráficos: aquí importa un recurso una sola vez y lo reutiliza en cualquier diseño, sin volver a buscarlo en disco.The Graphics library stores images shared by every project on this machine. It is different from Graphic kits: here you import a resource once and reuse it in any design without hunting for it on disk again.

  1. Abra Herramientas → Biblioteca gráfica.Open Tools → Graphics library.
  2. Pulse Importar imágenes… y elija uno o varios archivos. Cada archivo se guarda una sola vez y recibe una miniatura.Press Import images… and choose one or more files. Each file is stored once and gets a thumbnail.
  3. Busque por nombre con Buscar en la biblioteca y abra la pantalla o escena donde quiera usarla.Search by name with Search the library and open the screen or scene where you want to use it.
  4. Pulse Insertar. El recurso se copia al diseño como imagen embebida, de modo que cada entrega lleva solo lo que usa y no depende de la biblioteca.Press Insert. The resource is copied into the design as an embedded image, so each delivery carries only what it uses and does not depend on the library.
  5. Para retirar un recurso, use Quitar de la biblioteca. Los diseños donde ya se insertó no cambian; solo desaparece de la biblioteca, y esa acción no se deshace.To remove a resource, use Remove from library. Designs where it was already inserted do not change; it only disappears from the library, and that action cannot be undone.
  6. Si no hay un documento abierto, el estudio le pedirá abrir una pantalla o escena antes de insertar.If no document is open, the studio asks you to open a screen or scene before inserting.

13 · Niveles: galería, packs e importación13 · Levels: gallery, packs and import

En GAMES, un nivel puede empezar desde la galería de prefabs, desde un pack de tablero, desde un generador con semilla o desde un archivo externo. Todos los caminos siembran elementos editables con reglas descritas: son especificaciones, no lógica ejecutable.In GAMES, a level can start from the prefab gallery, a board pack, a seeded generator or an external file. Every path seeds editable elements with described rules: they are specifications, not executable logic.

  1. Pulse Diseñar → Nueva escena. Se abre la galería Elige un nivel para empezar, agrupada por familia y con buscador. Usar este nivel siembra la composición completa; Empezar en blanco crea el lienzo vacío.Press Design → New scene. The Pick a level to start gallery opens, grouped by family with a search box. Use this level seeds the full composition; Start blank creates the empty canvas.
  2. Abra Ventana → Prefabs para los packs del grupo Integrados: Pack de ajedrez, Pack de damas, Pack de dados y Pack de naipes. Un clic los inserta como composición en el documento activo, con sus reglas descritas y sin abrir un nivel.Open Window → Prefabs for the packs under Built-in: Chess pack, Checkers pack, Dice pack and Playing cards pack. One click inserts them as a composition into the active document, with their rules described and without opening a level.
  3. Para generar un nivel, use Diseñar → Generador procedural de niveles…. En Generadores procedurales elija Laberinto perfecto, Cuadrícula de plataformas o Terreno de plataformas, ajuste la Semilla y pulse Otra variante hasta dar con la que quiere.To generate a level, use Design → Procedural level generator…. In Procedural generators choose Perfect maze, Platform grid or Platform terrain, adjust the Seed and press Another variant until you get the one you want.
  4. La misma semilla y los mismos parámetros producen exactamente los mismos elementos; el Hash de la vista previa lo confirma. Pulse Insertar en la escena activa para aplicarlo como un cambio normal.The same seed and parameters produce exactly the same elements; the preview Hash confirms it. Press Insert into active scene to apply it as a normal change.
  5. Para traer un nivel hecho fuera, pulse Importar Tiled o LDtk… y elija un archivo .tmx o .ldtk. El estudio crea la escena con sus objetos y tiles, y le dice cuántos importó.To bring in an externally made level, press Import Tiled or LDtk… and choose a .tmx or .ldtk file. The studio creates the scene with its objects and tiles and tells you how many it imported.
  6. Para partir de un dibujo, pulse Nivel desde imagen… y elija un PNG, JPG o WebP de hasta 16 MiB. La imagen entra como fondo y la paleta Descriptores del nivel le permite colocar cada descriptor en el centro del marco con un clic, para ajustarlo después en el lienzo o en el inspector.To start from a drawing, press Level from image… and choose a PNG, JPG or WebP up to 16 MiB. The image enters as a background and the Level descriptors palette lets you place each descriptor at the center of the frame with one click, then tune it on the canvas or in the inspector.
  7. Si otra IA le preparó el diseño, pulse Diseño de otra IA…, pegue o importe su JSON de layout, añada la imagen de fondo si la tiene y pulse Crear escena. Las posiciones salen tal cual del JSON: el estudio no interpreta la imagen.If another AI prepared the design, press Design from another AI…, paste or import its layout JSON, add the background image if you have it and press Create scene. Positions come straight from the JSON: the studio does not interpret the image.

14 · IA: claves, crítica y «Traer de una IA»14 · AI: keys, critique and “Bring from an AI”

La IA es opcional y usa su clave. El estudio diseña y documenta: no genera el código de su aplicación o juego. La única excepción autorizada es el prototipo jugable con Phaser, explicado en Entregar: sin red y de plataformas en esta etapa.AI is optional and uses your key. The studio designs and documents: it does not generate your app or game code. The only authorized exception is the Phaser playable prototype, explained under Deliver: offline and platformer-only at this stage.

  1. Abra Herramientas → Opciones de IA…, elija la tarjeta de un proveedor, pegue su clave y seleccione proveedor y modelo activos. La clave queda solo en el llavero de Windows.Open Tools → AI options…, choose a provider card, paste your key and select the active provider and model. The key stays only in the Windows keyring.
  2. Pulse Validar clave en la tarjeta del proveedor que quiera comprobar: verifica esa clave y su catálogo sin gastar tokens de respuesta. Para el proveedor activo también tiene Comprobar clave y catálogo y Probar conexión.Press Validate key on the card you want to check: it verifies that key and its catalog without spending response tokens. For the active provider you also have Check key and catalog and Test connection.
  3. No configure nada especial para las guías de género internas: el estudio elige una guía de plataformas, cenital o gestión de apps según su idea y la suma al prompt, sin llamadas adicionales al modelo. Mejoran la disposición, los nombres y el ahorro de tokens.Nothing special is needed for the internal genre guides: the studio picks a platformer, top-down or app-management guide based on your idea and adds it to the prompt, with no extra model calls. They improve layout, naming and token thrift.
  4. En Revisar, pulse Simular la construcción: la IA recorre el diseño y anota cada decisión que falta, con una recomendación segura. Aplíquelas de una vez con Aplicar las recomendaciones de una vez; no compila ni ejecuta nada.In Review, press Simulate the build: the AI walks the design and notes every missing decision, with a safe recommendation. Apply them at once with Apply the recommendations at once; it compiles or runs nothing.
  5. La Crítica por lentes ofrece cinco miradas —construcción, jugador nuevo, narración, producción y coherencia—. Cada hallazgo cita Evidencia real y propone un ajuste seguro, una pregunta para usted o una sugerencia que acepta con Aceptar sugerencia.The Lens critique offers five views —build, new player, narrative, production and coherence—. Each finding cites real Evidence and proposes a safe fix, a question for you or a suggestion you accept with Accept suggestion.
  6. Para usar una IA web, abra Inteligencia Artificial → Traer de una IA…, pulse Copiar prompt y péguelo en su IA. Traiga la respuesta como bloque ```tropikal``` o cargue el archivo con Cargar archivo .md/.txt….To use a web AI, open Artificial Intelligence → Bring from an AI…, press Copy prompt and paste it into your AI. Bring the answer back as a ```tropikal``` block or load the file with Load .md/.txt file….
  7. Pulse Revisar: el estudio valida el bloque y enumera operaciones y problemas. Si todo cuadra, Aplicar como cambio lo aplica como un solo cambio deshacible; si algo no es válido, no se aplica nada.Press Review: the studio validates the block and lists operations and issues. If everything checks out, Apply as change applies it as a single undoable change; if anything is invalid, nothing is applied.
  8. Active Vigilar portapapeles al copiar desde el menú Inteligencia Artificial o con la casilla del diálogo. Cuando detecta un bloque nuevo muestra Contenido de IA detectado — Revisar e importar con Revisar y Descartar: el vigilante solo propone, nunca aplica solo, y se apaga con un aviso si el sistema bloquea el portapapeles.Enable Watch clipboard on copy from the AI menu or the dialog checkbox. When it detects a new block it shows AI content detected — Review and import with Review and Discard: the watcher only proposes, never applies on its own, and turns off with a notice if the system blocks the clipboard.

15 · Simuladores15 · Simulators

El asistente de nuevo proyecto incorpora la categoría SIMULADORES para vehículos y sistemas. El estudio la trata como un juego de simulación: comparte escenas, Probar, revisión y entrega con GAMES.The new-project wizard adds the SIMULATORS category for vehicles and systems. The studio treats it as a simulation game: it shares scenes, Try it, review and delivery with GAMES.

  1. Pulse Ctrl+N o Archivo → Nuevo proyecto…. En ¿Qué vas a construir? elija SIMULADORES: la descripción anuncia escenas con terreno, cámara y HUD.Press Ctrl+N or File → New project…. Under What are you building? choose SIMULATORS: the description announces scenes with terrain, camera and HUD.
  2. Elija la Tecnología / destino en el catálogo 1.1.0, con 115 destinos en 10 familias, incluida la familia de simulación. Puede buscar, usar Recientes o escribir cualquier tecnología propia.Choose the Technology / target from catalog 1.1.0, with 115 targets in 10 families, including the simulation family. You can search, use Recent or type any technology of your own.
  3. Elija la plantilla Estación de vehículos: siembra una pista de pruebas con límites, vehículo, cámara de seguimiento, HUD y meta. Todo son elementos editables y reglas descritas, no física de conducción implementada.Choose the Vehicle station template: it seeds a test track with limits, vehicle, follow camera, HUD and goal. All are editable elements and described rules, not implemented driving physics.
  4. Escriba el nombre, elija la carpeta y pulse Crear proyecto. Después puede abrir la escena y pulsar Probar para recorrer la maqueta.Type the name, choose the folder and press Create project. Then open the scene and press Try it to walk through the mockup.
  5. Ajuste el trazado, los controles propuestos y las reglas en los documentos e inspector. La entrega y el prototipo jugable siguen las mismas reglas que en GAMES.Tune the track, proposed controls and rules in documents and inspector. Delivery and the playable prototype follow the same rules as in GAMES.

16 · Atajos de teclado16 · Keyboard shortcuts

Ctrl+SGuardar proyectoSave project
Ctrl+Shift+SGuardar todoSave all
Ctrl+Z / Ctrl+YDeshacer / rehacerUndo / redo
Ctrl+NNuevo proyectoNew project
Ctrl+OAbrir proyectoOpen project
Ctrl+TabSiguiente pestañaNext tab
Ctrl+WCerrar pestañaClose tab
Ctrl+.Asistente de IAAI assistant
DeleteBorrar selecciónDelete selection
Ctrl+ruedaZoom del lienzoCanvas zoom
Espacio+arrastrarPaneo del lienzoCanvas pan
F1Atajos y acerca deShortcuts and about

17 · Actualizaciones17 · Updates

Edición de Microsoft Store: la Store actualiza el estudio por usted, en segundo plano y sin permisos de administrador. No hay que hacer nada: cuando exista una versión nueva, su equipo la recibirá solo.Microsoft Store edition: the Store updates the studio for you, in the background and without administrator permissions. Nothing to do: when a new version exists, your machine receives it on its own.

Ediciones del portal (instalador y portable): la versión vigente se anuncia en la página de descarga con su tamaño y huella SHA-256. Descargue el instalador nuevo y ejecútelo: sustituye el programa conservando proyectos y ajustes, y deja los accesos del menú Inicio bajo el nombre TROPIKAL STUDIO. En la portable, descomprima el ZIP nuevo donde quiera y sustituya su copia cuando le venga bien.Portal editions (installer and portable): the current version is announced on the download page with its size and SHA-256 fingerprint. Download the new installer and run it: it replaces the program keeping projects and settings, and leaves Start Menu shortcuts under the TROPIKAL STUDIO name. For the portable, unzip the new ZIP wherever you like and replace your copy when convenient.

El estudio no descarga ni instala nada por su cuenta: sin actualizador integrado, sin sorpresas. Sus proyectos viven en sus carpetas y ninguna actualización los toca.The studio does not download or install anything on its own: no built-in updater, no surprises. Your projects live in your folders and no update touches them.

18 · Preguntas frecuentes18 · FAQ

¿El estudio genera el código de mi app o juego?Does the studio generate my app or game code?

No. Genera el diseño completo y su especificación en un paquete de diseño (HTML autocontenido o ZIP editable); la implementación la hace la IA a la que usted se lo entregue. La única excepción es el prototipo jugable autorizado (decisión D34), una maqueta ejecutable con Phaser, sin red y de plataformas en esta etapa, que no sustituye al juego final.No. It produces the complete design and its specification in a design package (self-contained HTML or editable ZIP); implementation is done by the AI you hand it to. The only exception is the authorized playable prototype (decision D34), a runnable Phaser mockup, offline and platformer-only at this stage, which does not replace the final game.

¿Dónde quedan mis proyectos y mis claves?Where do my projects and keys live?

Los proyectos, en su carpeta de datos de usuario de Windows; las claves de IA, solo en el llavero de Windows. Ni el paquete exportado ni los registros contienen claves.Projects live in your Windows user data folder; AI keys only in the Windows keyring. Neither the exported package nor logs contain keys.

¿Funciona sin internet?Does it work offline?

Sí: diseñar, recortar kits, escribir documentos y exportar no necesitan conexión. Solo las acciones de IA en la nube y la consulta de actualizaciones la usan.Yes: designing, cutting kits, writing documents and exporting need no connection. Only cloud AI actions and the update check use it.

¿Qué imágenes acepta el recorte de kits?Which images does kit cropping accept?

PNG, JPG, WEBP y AVIF, incluidos spritesheets de animación con cuadrícula de columnas y separación.PNG, JPG, WEBP and AVIF, including animation spritesheets with column-and-spacing grid.

¿La actualización borra mi trabajo?Does updating delete my work?

No. Sus proyectos viven en sus carpetas, fuera del programa. La Store actualiza sola; el instalador del portal sustituye solo el programa y conserva ajustes y distribución de paneles. Ni al actualizar ni al desinstalar se toca su trabajo.No. Your projects live in your folders, outside the program. The Store updates on its own; the portal installer replaces only the program and keeps settings and panel layout. Neither update nor uninstall touches your work.

¿Cuánto cuesta?How much does it cost?

Gratis durante la fase inicial, sin cuentas ni tarjetas. Si más adelante hay planes de pago se anunciarán con claridad y lo ya publicado seguirá siendo suyo.Free during the initial phase, no accounts or cards. If paid plans come later they will be announced clearly and what is already released stays yours.

19 · Herramientas curadas y límites19 · Curated tools and limits

Esta es la lista vigente en la versión 0.1.28. Lo que el estudio hace, lo hace con piezas curadas y verificadas; lo que no hace todavía se dice aquí para que no pierda tiempo buscándolo.This is the list in force for version 0.1.28. What the studio does, it does with curated, verified pieces; what it does not do yet is listed here so you don't waste time looking for it.

Lo que sí puede hacerWhat it can do

  • Packs curados 2D: sprites, animaciones por clips y roles listos (héroe, enemigo, coleccionable, meta, plataforma). Puede cambiar el gráfico de un objeto viendo todos sus clips antes de decidir, y descargar packs gratis desde la tienda general, donde se ve su contenido completo.Curated 2D packs: sprites, clip animations and ready roles (hero, enemy, collectible, goal, platform). You can replace an object's graphic after previewing every clip, and download free packs from the general store, where their full contents are visible.
  • Mecánicas completas: plataformas móviles, enemigos que patrullan, coleccionables y metas funcionan en la maqueta y en el export. La IA solo inserta mecánicas curadas y el estudio valida la zona que tocó.Complete mechanics: moving platforms, patrolling enemies, collectibles and goals work in the mockup and in the export. The AI only inserts curated mechanics, and the studio validates the area it touched.
  • Escenarios 3D: importar y ver escenas tropikal.scene3d.v1 (escena.json + GLB), inspeccionar objetos, transformar con gizmo, duplicar y borrar. El taller Designer3D viaja incluido, con su biblioteca de modelos vacía y packs curados descargables.3D scenes: import and view tropikal.scene3d.v1 scenes (escena.json + GLB), inspect objects, transform with a gizmo, duplicate and delete. The Designer3D workshop ships bundled, with an empty model library and downloadable curated packs.
  • IA bajo su diseño: con su propia clave, el asistente propone sobre la escena o el objeto seleccionado, inserta piezas del pack y explica el cambio. Perfiles Rápido, Equilibrado y Profundo controlan el esfuerzo.AI under your design: with your own key, the assistant suggests based on the scene or selected object, inserts pack pieces and explains the change. Fast, Balanced and Deep profiles control the effort.
  • Entrega: HTML autocontenido, ZIP de diseño editable, informe de propuesta en PDF firmable y Word editable, y prototipo jugable 2D con Phaser sin red.Delivery: self-contained HTML, editable design ZIP, proposal report as a signable PDF and editable Word file, and a 2D playable prototype with Phaser and no network.

Lo que todavía no haceWhat it does not do yet

  • No escribe el código final de su producto. Entrega diseño, especificación y prototipo; la implementación de producción la hace la IA o el equipo que usted elija. El prototipo jugable es una excepción limitada, no un juego terminado.It does not write your product's final code. It delivers design, specification and prototype; production implementation is done by the AI or team you choose. The playable prototype is a limited exception, not a finished game.
  • No hay multijugador, backend, cuentas ni pagos: ni en la maqueta ni en el export. Para eso hace falta el desarrollo posterior.No multiplayer, backend, accounts or payments: neither in the mockup nor in the export. Those require later development.
  • No publica en tiendas ni gestiona fichas, licencias o actualizaciones de sus productos.It does not publish to stores or manage listings, licenses or updates for your products.
  • No es un editor de audio, vídeo ni modelos 3D: usa assets de los packs y escenas; no graba sonido, no edita vídeo y no modela mallas desde cero.It is not an audio, video or 3D model editor: it uses pack assets and scenes; it does not record sound, edit video or model meshes from scratch.
  • Sin código arbitrario ni plugins de terceros: no se ejecutan scripts ajenos ni se instalan extensiones. Las mecánicas son las curadas.No arbitrary code or third-party plugins: no foreign scripts run and no extensions are installed. Mechanics are the curated ones.
  • Licencias con reglas: se usan assets CC0 y CC-BY con atribución; no se incluyen GPL, AGPL ni licencias no comerciales. Los modelos de Quaternius y las animaciones de Mixamo no se redistribuyen.Licenses with rules: CC0 and CC-BY assets are used with attribution; GPL, AGPL and non-commercial licenses are not included. Quaternius models and Mixamo animations are not redistributed.
  • La IA no trabaja sola: necesita su clave, conexión y consume tokens de su proveedor. No hay agente autónomo ni tareas en segundo plano.The AI does not work alone: it needs your key, a connection and consumes tokens from your provider. There is no autonomous agent or background tasks.

Si algo de esta lista cambia, la ayuda se actualiza con la versión. La tienda y el escaparate muestran lo que ya se puede hacer hoy.If anything on this list changes, this help updates with the version. The store and the showcase show what can already be done today.