Add public documentation exemple of EndlessJournjey

Author: KitetsuK

__assets/_projects/EndlessJourney/README.md

@@ -0,0 +1,70 @@
+# Simplified Explanation of the Gameplay Ability System (GAS)
+
+The **Gameplay Ability System (GAS)** is a framework in Unreal Engine that helps you create and manage abilities, attributes, and interactions for characters or objects in your game. It’s highly customizable and integrates well with animations, visual effects, and sounds.
+
+## Key Features of GAS
+
+### 1. **Gameplay Abilities**
+- Abilities represent actions or skills characters can perform, like casting spells, attacking, or using special moves.
+  - **Active Abilities**: Triggered by player input (e.g., pressing a button).  
+  - **Passive Abilities**: Automatically activate under specific conditions (e.g., health regeneration).  
+- Abilities can be linked to:
+  - **Animations** (e.g., sword slash)
+  - **Visual Effects** (e.g., particle systems for magic)
+  - **Sounds** (e.g., ability sound cues)
+  - **Other Gameplay Logic** (e.g., cooldown timers or stamina checks).
+
+---
+
+### 2. **Attributes and Attribute Sets**
+- **Attributes** are values like health, stamina, or damage that define a character’s stats.
+- **Attribute Sets** group related attributes for easier organization (e.g., one set for combat stats and another for resource management).
+- Attributes can:
+  - Be dynamically modified during gameplay.
+  - Interact with other attributes (e.g., increasing strength boosts attack damage).
+
+---
+
+### 3. **Gameplay Effects**
+- **Gameplay Effects** are used to change attributes, such as:
+  - **Dealing Damage**: Reduce health when hit.
+  - **Healing**: Restore health over time or instantly.
+  - **Buffs/Debuffs**: Temporarily boost or reduce stats (e.g., speed up movement, lower defense).
+- Effects can be simple or complex:
+  - **Simple**: Fixed value (e.g., reduce health by 50).
+  - **Complex**: Scale based on attributes (e.g., damage based on the caster’s strength).
+
+---
+
+### 4. **Ability Tasks**
+- **Ability Tasks** are specialized tasks used within abilities for asynchronous or time-dependent actions, like:
+  - Waiting for an event (e.g., cooldown to finish).
+  - Performing a multi-step combo (e.g., a sequence of punches).
+  - Adding delays or timers to abilities.
+- Custom tasks can be created to implement unique mechanics for your game.
+- They can be written in:
+  - **C++**: For complex logic or performance-heavy features.
+  - **Blueprints**: For quick prototyping and visual scripting.
+
+---
+
+### 5. **Multiplayer Support**
+- GAS is **multiplayer-friendly** and designed to work with Unreal’s networking model.
+- **Server-Client Interaction**:
+  - **Server Authority**: The server validates and executes abilities to prevent cheating.
+  - **Client Prediction**: Clients can predict ability outcomes for smooth gameplay (e.g., instant feedback for attacks).
+- **Replication**:
+  - Attributes, effects, and ability states are replicated across the network so all players see consistent results.
+- Examples in multiplayer:
+  - A healer casts an area-of-effect (AoE) ability that heals teammates. Each player’s health attribute is updated on both client and server.
+  - A player uses a dash ability, and the movement is predicted on the client to avoid lag, while the server confirms the action.
+
+---
+
+## Why Use GAS?
+
+- **Scalability**: Start with simple abilities and expand to more advanced ones as your project grows.
+- **Flexibility**: Easily link abilities to other game elements like animations or sounds.
+- **Multiplayer Support**: Robust tools for syncing abilities and attributes across clients and servers.
+- **Efficiency**: Built-in systems for managing complex gameplay interactions without reinventing the wheel.
+- **Quality**: Made by Epic Games and used in AAA titles like *Paragon* and *Fortnite*, ensuring high performance and reliability.