Working with Threadbare gameplay elementsTrabajar con elementos de juego de Threadbare

Fill Barrels & Ink DrinkersBarriles de relleno e Ink Drinkers

Ink Drinkers throw ink, and Fill Barrels collect it. Put them together, and you can create all kinds of challenges for your StoryQuest!Los Ink Drinkers lanzan tinta y los Barriles de relleno la recogen. ¡Combínalos y podrás crear todo tipo de retos para tu StoryQuest!

In this guide, you'll explore some examples, bring the pieces into your own Playable Area, and customize how they work.En esta guía explorarás algunos ejemplos, traerás las piezas a tu propia Playable Area y personalizarás cómo funcionan.

In this guideEn esta guía

Explore Ink CombatExplora Ink Combat
Bring Ink Combat into Your StoryQuestLleva Ink Combat a tu StoryQuest
Customize Your ChallengePersonaliza tu reto
Reveal a Collectible Item (Optional)Revela un Collectible Item (opcional)

Explore Ink CombatExplora Ink CombatPlayJugar

Let's start by playing!¡Empecemos jugando!

The Ink Combat arena shows several ways to combine Ink Drinkers and Fill Barrels to create different challenges.La arena de Ink Combat muestra varias formas de combinar Ink Drinkers y Barriles de relleno para crear distintos retos.

Follow the signs as you explore. Pay attention to how the ink and barrels behave in each area.Sigue los carteles mientras exploras. Fíjate en cómo se comportan la tinta y los barriles en cada zona.

The example sceneLa escena de ejemplo

PlayJugar

Playable exampleEjemplo jugable play.threadbare.game/…/ink_combat_test.tscn

StoryQuest Kit pathRuta en el StoryQuest Kit res://scenes/dev/repel/ink_combat/ink_combat_test.tscn

Now that you've explored what's possible, let's try bringing an Ink Drinker and Fill Barrel into a Playable Area of your own!Ahora que ya has explorado lo que se puede hacer, ¡probemos a traer un Ink Drinker y un Barril de relleno a una Playable Area propia!

You can experiment with how they work together before deciding whether to use them in your StoryQuest.Puedes experimentar con cómo funcionan juntos antes de decidir si usarlos en tu StoryQuest.

Bring Ink Combat into Your StoryQuestLleva Ink Combat a tu StoryQuestCreateCrear

Steps 1–4Pasos 1–4

Click a number when you finish that step.Haz clic en un número cuando termines ese paso.

Choose an example to borrow fromElige un ejemplo del que tomar piezas

You don't have to build Ink Drinkers and Fill Barrels from scratch. The StoryQuest Kit has two examples you can borrow from, and both are much simpler than the Ink Combat arena you just explored!No tienes que crear Ink Drinkers ni Barriles de relleno desde cero. El StoryQuest Kit tiene dos ejemplos de los que puedes tomar piezas, ¡y los dos son mucho más sencillos que la arena de Ink Combat que acabas de explorar!

NO_EDIT CombatNO_EDIT Combat

A simple example with generic placeholder artwork. This is a good starting point for experimenting with Ink Drinkers and Fill Barrels.Un ejemplo sencillo con arte genérico provisional. Es un buen punto de partida para experimentar con Ink Drinkers y Barriles de relleno.

StoryQuest Kit pathRuta en el StoryQuest Kit res://scenes/quests/template_quests/NO_EDIT/2_NO_EDIT_combat/NO_EDIT_combat.tscn

Ink Combat Round 2Ink Combat Round 2

Another simple example that uses the familiar Ink Drinker and Fill Barrel artwork from Threadbare.Otro ejemplo sencillo que usa el arte de Ink Drinker y Barril de relleno que ya conoces de Threadbare.

StoryQuest Kit pathRuta en el StoryQuest Kit res://scenes/quests/lore_quests/quest_001/2_ink_combat/ink_combat_round_2.tscn

Either example will work for what we're doing next. Choose the one you'd like to borrow pieces from!Cualquiera de los dos ejemplos sirve para lo que vamos a hacer ahora. ¡Elige del que quieras tomar piezas!

Open both scenes in GodotAbre las dos escenas en Godot

In Godot's FileSystem panel, find the example scene you chose and double-click its .tscn file to open it.En el panel Sistema de Archivos de Godot, busca la escena de ejemplo que elegiste y haz doble clic en su archivo .tscn para abrirla.
Next, open the Playable Area where you want to try these elements. You can use a scene you've already created, or make a new one. It should have a player and some ground to explore.Después, abre la Playable Area donde quieres probar estos elementos. Puedes usar una escena que ya hayas creado o hacer una nueva. Debe tener un jugador y algo de suelo para explorar. Need help creating a Playable Area? Follow the Setting up a new scene from scratch guide, then come back here.¿Necesitas ayuda para crear una Playable Area? Sigue la guía Preparar una escena nueva desde cero y luego vuelve aquí.
Make sure both scenes are open in tabs above the viewport: the example you're borrowing from and your own Playable Area. You can use these tabs to switch between them.Asegúrate de que las dos escenas están abiertas en pestañas encima del viewport: el ejemplo del que tomas piezas y tu propia Playable Area. Puedes usar estas pestañas para cambiar entre ellas.

See how to open both scenesMira cómo abrir las dos escenas

Copy the gameplay elementsCopia los elementos de juego

With both scenes open, we're going to borrow just three things from your example: an Ink Drinker, a Fill Barrel, and FillGameLogic.Con las dos escenas abiertas, vamos a tomar solo tres cosas de tu ejemplo: un Ink Drinker, un Barril de relleno y FillGameLogic.

FillGameLogic keeps track of when the challenge is complete. With all three in your own Playable Area, you'll be ready to test and customize how they work together.FillGameLogic lleva la cuenta de cuándo se completa el reto. Con las tres piezas en tu propia Playable Area, estarás listo para probar y personalizar cómo funcionan juntas.

In your example scene, find an Ink Drinker and a Fill Barrel under OnTheGround in the . Copy both nodes.En tu escena de ejemplo, busca un Ink Drinker y un Barril de relleno dentro de OnTheGround en el . Copia los dos nodos.

Finding the right nodes:Cómo encontrar los nodos:

Example sceneEscena de ejemplo Ink DrinkerInk Drinker Fill BarrelBarril de relleno

NO_EDIT Combat ThrowingNPC Target

Ink Combat Round 2 ThrowingEnemy FillingBarrel
Switch to your Playable Area and paste both nodes under OnTheGround if you have it, or alongside your other gameplay elements. Move them into position.Cambia a tu Playable Area y pega los dos nodos dentro de OnTheGround, si lo tienes, o junto a tus otros elementos de juego. Colócalos en su sitio.
Go back to your example scene and copy FillGameLogic. Return to your Playable Area, select the top node in its Scene Tree, and paste FillGameLogic as a child.Vuelve a tu escena de ejemplo y copia FillGameLogic. Regresa a tu Playable Area, selecciona el nodo superior de su árbol de escena y pega FillGameLogic como hijo.

Example sceneEscena de ejemplo	Ink DrinkerInk Drinker	Fill BarrelBarril de relleno
NO_EDIT Combat	`ThrowingNPC`	`Target`
Ink Combat Round 2	`ThrowingEnemy`	`FillingBarrel`

See how to copy the piecesMira cómo copiar las piezas

Start the challengePon en marcha el reto

Select FillGameLogic in your Scene Tree and find these settings in the Inspector:Selecciona FillGameLogic en tu árbol de escena y busca estos ajustes en el Inspector:

Barrels to Win: How many barrels players need to fill to complete the challenge.Barrels to Win: cuántos barriles deben llenar los jugadores para completar el reto.
Autostart: Turn this on to start the challenge when the scene begins.Autostart: actívalo para que el reto empiece cuando arranque la escena.

For now, set Barrels to Win to 1 and turn on Autostart.Por ahora, pon Barrels to Win en 1 y activa Autostart.

CheckpointPunto de control

Try playing your scene.Prueba a jugar tu escena.

Your Ink Drinker should throw ink, and your barrel should fill when matching ink hits it.Tu Ink Drinker debería lanzar tinta, y tu barril debería llenarse cuando le dé tinta que coincida con él.

Using this in your StoryQuest?¿Usas esto en tu StoryQuest?

When playing your StoryQuest from the beginning, your player might not have Repel, even if it worked while testing this scene. See Adding a Powerup to learn how to give your player that ability.Si juegas tu StoryQuest desde el principio, puede que tu jugador no tenga Repeler, aunque funcionara al probar esta escena. Consulta Añadir un potenciador para aprender a darle esa habilidad a tu jugador.

Customize Your ChallengePersonaliza tu retoCreateCrear

Now that your Ink Drinker and barrel are working, you can change how they behave!Ahora que tu Ink Drinker y tu barril funcionan, ¡puedes cambiar cómo se comportan!

Most of these changes happen in Godot's Inspector. Select a gameplay element in the Scene Tree to find its settings.La mayoría de estos cambios se hacen en el Inspector de Godot. Selecciona un elemento de juego en el árbol de escena para ver sus ajustes.

Steps 5–6Pasos 5–6

Customize a Fill BarrelPersonaliza un Barril de relleno

Select your Fill Barrel and look for these properties in the Inspector:Selecciona tu Barril de relleno y busca estas propiedades en el Inspector:

Needed Amount: How many ink hits the barrel needs before it's full.Needed Amount: cuántos impactos de tinta necesita el barril para llenarse.
Label: Which type of ink can fill the barrel.Label: qué tipo de tinta puede llenar el barril.
Color: Changes the barrel's color.Color: cambia el color del barril.

Click the screenshot to see these settings in the Inspector.Haz clic en la captura para ver estos ajustes en el Inspector.

Try changing Needed Amount and playing your scene again. How does it change the challenge?Prueba a cambiar Needed Amount y vuelve a jugar tu escena. ¿Cómo cambia el reto?

How do ink labels and colors work?¿Cómo funcionan las etiquetas y los colores de la tinta?

Customize an Ink DrinkerPersonaliza un Ink Drinker

Select your Ink Drinker to explore its settings.Selecciona tu Ink Drinker para explorar sus ajustes.

Here are a few things you can change:Estas son algunas cosas que puedes cambiar:

Throwing Period: How often it throws ink.Throwing Period: cada cuánto lanza tinta.
Projectile Speed: How fast the ink travels.Projectile Speed: a qué velocidad viaja la tinta.
Projectile Follows Player: Make the ink follow the player instead of flying straight.Projectile Follows Player: hace que la tinta siga al jugador en vez de volar en línea recta.
Walking: Change how the Ink Drinker moves around.Walking: cambia cómo se mueve el Ink Drinker.

Click the screenshot to see all of an Ink Drinker's settings. There's more to explore than what's listed here, including its sound effects.Haz clic en la captura para ver todos los ajustes de un Ink Drinker. Hay más por explorar de lo que aparece aquí, incluidos sus efectos de sonido.

Try changing Throwing Period or turning on Projectile Follows Player.Prueba a cambiar Throwing Period o a activar Projectile Follows Player.

Then play your scene again to see what happens!¡Luego vuelve a jugar tu escena para ver qué pasa!

Try an experimentHaz un experimento

What happens if you add a second barrel? Or another Ink Drinker?¿Qué pasa si añades un segundo barril? ¿O otro Ink Drinker?

Try copying another gameplay element and changing a few settings.Prueba a copiar otro elemento de juego y a cambiar algunos ajustes.

You can always return to the Ink Combat arena for more ideas!¡Siempre puedes volver a la arena de Ink Combat para buscar más ideas!

You've now built and customized your own Ink Combat challenge. You can keep experimenting with these elements, or take things further by giving players a reward when they complete it.Ya has construido y personalizado tu propio reto de Ink Combat. Puedes seguir experimentando con estos elementos o ir más allá dando a los jugadores una recompensa cuando lo completen.

Optional extensionAmpliación opcional

Take It Further: Reveal a Collectible ItemVe más allá: revela un Collectible ItemCreateCrear

Want to give players something to collect when they finish your challenge? You can connect FillGameLogic to a hidden Collectible Item that appears when enough barrels are filled.¿Quieres darles a los jugadores algo que recoger cuando terminen tu reto? Puedes conectar FillGameLogic a un Collectible Item oculto que aparece cuando se llenan suficientes barriles.

Steps 7–8Pasos 7–8

Add a Collectible ItemAñade un Collectible Item

Add a CollectibleItem to your Playable Area under OnTheGround. You can copy one from NO_EDIT Combat or drag collectible_item.tscn from the FileSystem.Añade un CollectibleItem a tu Playable Area dentro de OnTheGround. Puedes copiar uno de NO_EDIT Combat o arrastrar collectible_item.tscn desde el Sistema de Archivos. res://scenes/game_elements/props/collectible_item/collectible_item.tscn
Move it to the spot where you want it to appear.Muévelo al lugar donde quieres que aparezca.
In the Inspector, turn off Revealed so the item starts hidden.En el Inspector, desactiva Revealed para que el objeto empiece oculto.
Set Item to New InventoryItem.Cambia Item a New InventoryItem.
If you copied an existing Collectible Item, check Collected Dialogue and Next Scene so you don’t accidentally reuse settings from the example.Si copiaste un Collectible Item existente, revisa Collected Dialogue y Next Scene para no reutilizar sin querer los ajustes del ejemplo.

See how to add a Collectible ItemMira cómo añadir un Collectible Item

Want to add dialogue or connect another Playable Area? The Collectible Items guide shows how to customize what happens when players collect an item, including dialogue and moving between scenes.¿Quieres añadir diálogo o conectar otra Playable Area? La guía Objetos coleccionables muestra cómo personalizar lo que pasa cuando los jugadores recogen un objeto, incluidos el diálogo y el paso de una escena a otra.

See how to set the next sceneMira cómo elegir la siguiente escena

Connect the win signalConecta la señal de victoria

Now let’s make the Collectible Item appear when the challenge is complete. We’ll connect FillGameLogic to the Collectible Item’s reveal() method.Ahora hagamos que el Collectible Item aparezca cuando se complete el reto. Vamos a conectar FillGameLogic al método reveal() del Collectible Item.

Select FillGameLogic and open the Signals tab.Selecciona FillGameLogic y abre la pestaña Signals.
Right-click goal_reached and choose Connect…Haz clic derecho en goal_reached y elige Connect…
Select your CollectibleItem, click Pick, choose reveal(), then click Connect.Selecciona tu CollectibleItem, haz clic en Pick, elige reveal() y luego haz clic en Connect.

Already connected?¿Ya está conectada?

If goal_reached already shows a connection, it came with the FillGameLogic you copied, like Round 2’s connection to LevelCompletedAnimation.Si goal_reached ya muestra una conexión, vino con el FillGameLogic que copiaste, como la conexión de Round 2 a LevelCompletedAnimation.

If you don’t need it:Si no la necesitas:

Delete LevelCompletedAnimation in the Scene tree.Borra LevelCompletedAnimation en el árbol de escena.
Select FillGameLogic again and open the Signals tab.Vuelve a seleccionar FillGameLogic y abre la pestaña Signals.
Right-click the leftover line under goal_reached and choose Disconnect.Haz clic derecho en la línea que queda bajo goal_reached y elige Disconnect.

Then connect your Collectible Item using the steps above.Luego conecta tu Collectible Item con los pasos de arriba.

When the player fills enough barrels, the Collectible Item will appear.Cuando el jugador llene suficientes barriles, aparecerá el Collectible Item.

What is a signal?¿Qué es una señal?

See how to connect the signalMira cómo conectar la señal

Test your rewardPrueba tu recompensa

Play your challenge again. When you fill enough barrels, does your Collectible Item appear?Vuelve a jugar tu reto. Cuando llenas suficientes barriles, ¿aparece tu Collectible Item?

Try collecting it to make sure everything works.Intenta recogerlo para asegurarte de que todo funciona.

Make It Your OwnHazlo tuyoReflectReflexionar

You've seen how a few gameplay elements can work together to create a challenge. Now it's your turn to make something new!Has visto cómo unos pocos elementos de juego pueden funcionar juntos para crear un reto. ¡Ahora te toca crear algo nuevo!

Think about your StoryQuest:Piensa en tu StoryQuest:

What are players trying to accomplish by filling these barrels?¿Qué intentan conseguir los jugadores al llenar estos barriles?
How could you change the barrels, Ink Drinkers, or environment to make the challenge more interesting?¿Cómo podrías cambiar los barriles, los Ink Drinkers o el entorno para que el reto sea más interesante?
Could you use any of the ideas you discovered in the Ink Combat arena?¿Podrías usar alguna de las ideas que descubriste en la arena de Ink Combat?

Start small, experiment, and see what you can create!¡Empieza con algo pequeño, experimenta y mira lo que puedes crear!

Something not working?¿Algo no funciona?

ProblemProblema	What to checkQué revisar
My Ink Drinker isn't throwing ink.Mi Ink Drinker no lanza tinta.	Check that FillGameLogic has Autostart enabled.Comprueba que FillGameLogic tiene Autostart activado.
My barrel isn't filling.Mi barril no se llena.	Make sure matching ink is reaching the barrel.Asegúrate de que al barril le llega tinta que coincide con él.
I can't repel the ink.No puedo repeler la tinta.	Check that your player has the Repel ability.Comprueba que tu jugador tiene la habilidad Repeler.
My Collectible isn't appearing.Mi Collectible no aparece.	Make sure the Collectible starts hidden and `goal_reached` is connected to `reveal()`.Asegúrate de que el Collectible empieza oculto y de que `goal_reached` está conectada a `reveal()`.