v1.1.0

Update Notes – Card and Effect System

This update introduces a flexible architecture for defining and executing card effects, inspired by game systems such as Wizard101, with extensibility toward mechanics found in Yu-Gi-Oh! or Magic: The Gathering. Key advancements include:

• Multi-Effect Cards: Each card can now contain multiple effects, executed sequentially according to its configuration. Implemented examples include Fireball and IceBeam.
• Animation Support: Each effect may be associated with a specific animation, provided it is registered in the AnimationPlayer. If the corresponding animation is missing, the system proceeds directly to the effect’s logic (e.g., applying damage or status conditions).
• Activation Probability: Every effect can define a percentage-based chance to trigger. Before execution, a random check determines whether the effect activates; if the roll fails, the effect is silently skipped (though this behavior can be extended to include visual or gameplay feedback if desired).
• Persistent Status Effects: Secondary effects such as Burn and Frostbite have been implemented—these apply damage over multiple turns. The logic to apply damage on the end of each turn is still not implemented, as the turn system itself isn't implemented.
• Actor Entity: A basic Actor class has been introduced to represent both the spell caster and the target. Currently, only player-initiated actions are supported; opponents remain non-interactive.
• Duel Context (DuelContext): A singleton has been created to centrally provide caster and target references during effect resolution. At this stage, only a player-specific duel context exists.

Next Steps

• Turn-Based System Implementation: A structured turn system will be developed, divided into distinct phases:
  • Draw Phase: card acquisition;
  • Pre-Combat Phase: resolution of effects that may interrupt or alter the turn;
  • Combat Phase: execution of selected spells;
  • End-of-Turn Resolution: application of persistent status effects (e.g., recurring damage from Burn or Frostbite).
• Simultaneous Action Selection: Drawing inspiration from titles like Pokémon, both player and AI will select their actions simultaneously, with effects resolved in a unified sequence. The resolution order is still under design—options include:
  • A speed-like attribute to determine priority;
  • Or dynamic spell interactions (e.g., two simultaneous Fireball casts trigger an explosion, dealing partial damage to both participants).

Notas de Atualização – Sistema de Cartas e Efeitos

Nesta atualização, foi implementada uma arquitetura flexível para definição e execução de efeitos em cartas, inspirada em sistemas de jogos como Wizard101, com potencial para expansão em direções semelhantes a Yu-Gi-Oh! ou Magic: The Gathering. Os principais avanços incluem:

• Efeitos Compostos por Carta: Cada carta agora pode conter múltiplos efeitos, executados sequencialmente conforme a configuração definida. Exemplos já implementados incluem Fireball e IceBeam.
• Suporte a Animações: Cada efeito pode estar associado a uma animação específica, desde que esta esteja previamente registrada no AnimationPlayer. Na ausência da animação correspondente, o sistema executa apenas a lógica do efeito (como, por exemplo, a aplicação de dano ou status).
• Probabilidade de Ativação: Cada efeito pode ter uma chance percentual de ser ativado. Antes da execução, o sistema realiza um sorteio; caso aprobabilidade não seja satisfeita, o efeito é ignorado sem consequências adicionais (embora isso possa ser estendido conforme necessário).
• Efeitos Secundários: Foram implementados efeitos de status persistentes, como Burn e Frostbite, que aplicam dano ao longo de múltiplos turnos. A lógica para aplicar o dano a cada turno ainda não está implementada, pois ainda não existe o sistema de turnos.
• Entidade Actor: Introduzida uma entidade básica para representar tanto o caster quanto o target de uma magia. Atualmente, o sistema suporta apenas ações originadas pelo jogador; oponentes ainda não possuem comportamento ativo.
• Contexto de Duelo (DuelContext): Criado um singleton que fornece, de forma centralizada, as referências ao caster e ao target durante a execução de efeitos. Nesta fase, há apenas um contexto ativo, relativo ao jogador.

Próximos Passos

• Implementação de Sistema de Turnos: Será desenvolvido um sistema estruturado em fases, incluindo:

  • Compra: fase de aquisição de cartas;
  • Pré-ataque: verificação de efeitos que possam interromper ou modificar o turno;
  • Ataque: execução das magias selecionadas;
  • Resolução de Status: aplicação de efeitos persistentes ao final do turno (ex.: dano por Burn ou Frostbite).

• Mecânica de Escolha Simultânea: Inspirado em jogos como Pokémon, planeja-se que jogador e IA selecionem suas ações simultaneamente, com resolução conjunta dos efeitos. Ainda está em aberto a definição do critério de ordem de resolução — podendo envolver atributos como speed ou regras específicas de interação entre magias (ex.: dois Fireball disparados simultaneamente geram uma explosão, causando dano colateral a ambos os alvos).

Full Changelog: v1.0.0...v1.1.0

v1.0.0

v1.0

---

Changelog:

• It is now possible to draw a card from the deck. (The deck is filled with 40 generic cards, apply as you wish)
• The card is its own entity/class, capable of activating effects (there is a generic effect for testing, apply what you want)
• It is possible to define whether the card should activate its effect directly with just a click (inspired by Master Duel, which also displays summon options, though this is not implemented) or if it only activates its effect when dragged into the PlayableArea (inspired by Hearthstone).
• It is now possible to rearrange the cards in hand.
• Two types of Hover have been added: Standard and Rise Only.
  • The standard hover not only slightly raises the card, but also increases its size (based on HoverScale) and slightly spreads the other cards apart (based on HoverPadding).
  • The Lift Only hover is straightforward: The card simply rises.
• You can choose whether the tool calculates the hover offset based on the card's size.

Mudanças:

• Agora é possível comprar uma carta do deck. (Deck preenchido com 40 cartas genéricas, aplique como quiser)
• A carta é sua própria entidade/classe, podendo ativar efeitos (tem um efeito genérico para testes, aplique o que quiser)
• É possível definir se a carta deve ativar seu efeito diretamente com apenas um clique (inspirado em Master Duel, que também aparece as opções de summon, mas isto não está implementado) ou se ela apenas ativa seu efeito quando arrastada para a PlayableArea (inspirado em Hearthstone).
• Agora é possível rearranjar as cartas na mão.
• Adicionados dois tipos de Hover: Padrão e Apenas subir.
  • O hover padrão além de subir a carta levemente, também aumenta seu tamanho (baseado no HoverScale) e também afasta um pouco as outras cartas (baseado no HoverPadding).
  • O hover Apenas subir é bem direto ao ponto: A carta apenas sobe.
• É possível escolher se a ferramenta calcula baseado no tamanho da carta o offset quando está em hover.

v0.1.0-beta.1

Adds example scene with Card texture configured as a scene on its own with proper configs.

v0.1.0-beta.0

Adding an example scene.

Full Changelog: https://github.com/Jaete/TCG-Hand-Layout/commits/Beta