> For the complete documentation index, see [llms.txt](https://whitepaper.eclipsera-game.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.eclipsera-game.com/eclipsera-legends.md). # Eclipsera Legends **Version 1.0 — Game Systems & World Design**
*** ### 1. Executive Summary **Eclipsera Legends** is a persistent online strategy RPG that combines kingdom building, hero progression, tactical combat, crafting, diplomacy, espionage, territorial conquest, alliance warfare, and competitive PvP within a single persistent fantasy world. Players do not simply enter individual matches and leave. They build a kingdom, develop characters, manage resources, research technologies, forge equipment, expand their territory, establish relationships with other rulers, and participate in increasingly complex forms of conflict. The central philosophy of Eclipsera Legends is: > **Build your kingdom. Develop your heroes. Shape your territory. Compete with other players.** The game is designed around a continuous progression loop in which economic development, character development, combat, diplomacy, and territorial control influence one another. Eclipsera Legends is currently positioned as a **Web2 online game**. Players can also convert eligible in-game Gems into USD according to the game's applicable economic rules. *** ## 2. Game Vision Eclipsera Legends aims to create a persistent strategy RPG in which players feel that their kingdom is continuously developing even when they are not engaged in direct combat. Traditional RPGs often separate activities into independent modes: * Combat * Crafting * Building * PvP * Social systems Eclipsera instead connects these systems. A player might: **Develop a farm → produce food → sustain workers → mine materials → forge equipment → strengthen a hero → defeat monsters → obtain resources → conquer territory → defend the new castle → establish diplomacy → join an alliance → participate in MvM warfare.** Every major activity contributes to the larger progression of the kingdom. *** ## 3. Core Game Philosophy Eclipsera Legends is built around five principles. #### 3.1 Progression Players should always have something meaningful to improve: * Buildings * Heroes * Equipment * Technology * Territory * Relationships * Alliances * Empire level #### 3.2 Strategy Power should not come only from accumulation. Players must decide: * Where to invest resources * Which characters to develop * Which territory to conquer * When to fight * When to defend * When to negotiate * When to use espionage * Which equipment to craft #### 3.3 Persistence The kingdom is a long-term project. Buildings, characters, territory, relationships, technology, and strategic decisions create a persistent progression history. #### 3.4 Interaction The world becomes more meaningful when players interact with one another through: * PvP * Alliances * MvM * Diplomacy * Espionage * Trading and economic activity #### 3.5 Meaningful Resource Circulation Resources should not exist only to satisfy upgrade requirements. Wood, Stone, Iron, Water, Wheat, Bread, and Gems are intended to circulate through multiple systems, creating a functioning game economy. *** ## 4. The Core Gameplay Loop The fundamental Eclipsera loop is: > **Build → Grow → Explore → Fight → Collect → Craft → Expand → Compete → Govern → Build Further** #### Build Develop the Kingdom and its buildings. #### Grow Train heroes and improve characters. #### Explore Enter PvE content, expeditions, and the world map. #### Fight Battle monsters, players, and opposing alliances. #### Collect Acquire resources, items, equipment, and Gems. #### Craft Transform materials into increasingly powerful equipment. #### Expand Conquer additional territories and establish new castles. #### Compete Participate in PvP and large-scale MvM warfare. #### Govern Use diplomacy, espionage, alliances, and political systems. #### Build Further Return resources and rewards to the Kingdom to continue progression. *** ## 5. Kingdom The Kingdom is the player's primary strategic base. It is where players: * Produce resources * Train characters * Manage food * Build defenses * Research technology * Craft equipment * Govern characters * Prepare for combat * Develop their Empire The Kingdom is not simply a menu or headquarters. It is the foundation that supports every other major system. *** ### 5.1 Building Development Major buildings progress from **Level 1 to Level 30**. Early levels are intentionally accessible so new players can understand the game and experience rapid development. As levels increase: * Resource requirements increase * Production improves * New functions become available * Strategic requirements become more important * Development becomes increasingly demanding This creates a progression curve in which: **Early game = fast understanding and growth** **Mid game = strategic optimization** **Late game = specialization, competition and territorial management** *** ## 6. Kingdom Economy The Kingdom uses several fundamental resources. #### Water
Used for: * Farming * Expeditions * Kingdom operations * Other resource-generation activities #### Wheat
Produced primarily through farming. Used to produce Bread. #### Bread
Bread represents the Kingdom's primary food/labor resource. It supports: * Character survival * Certain production systems * Training * Crafting * Other Kingdom activities #### Wood
Used for: * Construction * Repairs * Crafting * Technology * Other Kingdom systems #### Stone
Used for: * Construction * Repairs * Defense * Crafting * Technology #### Iron
A critical advanced material used for: * Equipment * Special items * Crafting * Upgrades * Repairs #### Eclipsera Legends Gems
Gems are the primary premium economic resource following removal of ECS. Gems are used in applicable: * PvP systems * Kingdom systems * Economic systems * Progression systems Eligible Gems may also be converted into USD according to the game's current economic rules. *** ## 7. Food & Survival Food is intentionally important because characters are central to the game. The basic production chain is: **Water → Wheat → Bread → Character survival** #### Wheat Farm Produces Wheat over time. Character assignments can increase production. #### Bakery Converts: **2 Wheat → 1 Bread** Bread is consumed by characters over time. If Bread reaches zero, characters can suffer HP loss according to the game's starvation rules. This prevents the Kingdom from becoming a completely passive resource generator and creates a basic survival-management layer. *** ## 8. Resource Production The Kingdom contains specialized production facilities. #### Rock Crusher Produces Stone. Production is influenced by assigned characters and their relevant abilities. #### Sawmill Produces Wood. Production is influenced by assigned characters and Wood-related abilities. #### Iron Mine Produces Iron. Iron is one of the most strategically important resources because advanced crafting and progression depend on it. #### Well Produces Water. Character assignment can influence production efficiency. The overall system is designed so that **characters act as multipliers for Kingdom infrastructure**. *** ## 9. Characters & Heroes Characters are one of the most important components of Eclipsera Legends. Characters can contribute to: * Combat * Mining * Production * Defense * Diplomacy * Espionage * Governance * Crafting * Exploration This means characters are not merely combat units. A powerful character can improve the Kingdom even when they are not fighting. *** ### 9.1 Hero Progression Heroes develop through: * Experience * Levels * Attributes * Skills * Equipment * Combat * Activities
### Eclipsera Legends — 14 Main Heroes and 20 Child Heroes
\ \ \ Each hero has a unique **element, role, and special ability**. Players can choose heroes based on their preferred strategy and build different combinations for PvE, PvP, and MvM. | Hero | Element | Main Ability | Effect | | ------------- | --------- | ----------------- | ------------------------------------------------------ | | **Archera** | Physical | Evasion | Avoids enemy attacks and takes no damage. | | **Korthas** | Physical | Defense Break | Reduces all enemies' Defense by 15 for 3 turns. | | **Hayate** | Earth | Damage Boost | Increases all allies' damage by 10 for 3 turns. | | **Bruxus** | Physical | Damage Reduction | Reduces all enemies' damage by 15 for 3 turns. | | **Solvarion** | Sun | HP Blessing | Increases all allies' HP by 20%. | | **Caeloria** | Magic | Special Reversal | Reverses enemy special attacks back against the enemy. | | **Valyra** | Fire | Sleep | Prevents an enemy from using skills on its next turn. | | **Motoko** | Lightning | HP Increase | Increases maximum HP by 30%. | | **Blua** | Water | Damage Reflection | Reflects incoming damage back to the attacker. | | **Rena** | Water | HP Swap | Swaps her HP with the enemy's HP. | | **Finza** | Magic | Energy Drain | Reduces enemy energy by 60%. | | **Nytheris** | Dark | Lifesteal | Restores HP by absorbing 50% of damage. | | **Vitalis** | Sun | Defense Boost | Increases all allies' Defense by 10 for 3 turns. | | **Hero 14** | — | — | Final ability to be defined. | #### Hero Design The heroes are designed around different combat styles: * **Attack:** Hayate, Korthas * **Defense:** Motoko, Vitalis, Solvarion * **Counter:** Archera, Blua, Caeloria * **Control:** Valyra, Finza * **Sustain:** Nytheris * **Risk & Reward:** Rena * **Enemy Disruption:** Bruxus **Players win by choosing the right hero and using their ability at the right time—not simply by using the strongest character.** *** ## 10. Character Life Cycle
Eclipsera goes beyond conventional RPG character progression. Characters can experience a broader life cycle: **Appointment → Relationships → Marriage → Children → Succession → Retirement** This creates long-term continuity within the Kingdom. *** ### 10.1 Government Players can appoint characters to positions such as: * King * Ministers * Successors * Noble titles Leadership roles create a governance layer within the Kingdom. *** ### 10.2 Relationships Characters can complete relationship quests. Relationships can develop into: * Marriage * Sworn Brotherhood Marriage creates the possibility of a new generation of characters. *** ### 10.3 Heirs Marriage can result in children. Children eventually mature and can become: * Heroes * Workers depending on their development and quest completion. This creates a generational progression system. *** ## 11. PvE
PvE is the primary individual combat experience. Players fight monsters using tactical turn-based combat. The objective is not simply to maximize damage. Players must manage: * HP * Stamina * Power * Timing * Action selection * Enemy behavior *** ## 12. PvE Action System Combat uses six core actions. #### Base Attack A reliable standard attack. It consumes Stamina and provides consistent damage. #### Special Attack 1 A stronger offensive action with greater resource requirements. #### Special Attack 2 The strongest offensive action. It requires full Power. This creates a strategic payoff for surviving long enough to accumulate Power. #### Rest Rest restores Stamina. It becomes important during extended battles. #### Counter Attack A defensive reaction. The player attempts to anticipate incoming attacks and reflect damage. #### Energy Drain Reduces enemy resources and disrupts their ability to attack. Together these actions create a simple but strategically meaningful combat system. *** ## 13. PvE Rewards Successful PvE encounters can provide: * Items * Equipment * Crafting materials * Crystals where applicable * Gems * Character progression PvE therefore feeds directly into the Kingdom and long-term progression. *** ## 14. PvP
PvP is Eclipsera's competitive individual combat system. Players compete using tactical combat rather than purely statistical comparison. PvP emphasizes: * Prediction * Timing * Resource management * Character selection * Ability sequencing * Counterplay * Survival *** ### 14.1 PvP Teams Players maintain a pool of characters and select a combat team before entering a match. Characters have standardized core combat attributes where applicable to preserve competitive fairness. *** ### 14.2 PvP Actions PvP uses the same fundamental combat philosophy: * Base Attack * Special 1 * Special 2 * Rest * Counter Attack * Energy Drain * Character-specific abilities Players must anticipate what their opponent is likely to do. *** ## 15. PvP Gem Economy The former ECS-based PvP system has been discontinued. PvP participation uses **Eclipsera Legends Gems** under the current game economy. This allows the competitive system to remain integrated into the game's internal economy without requiring a separate blockchain token. The objective is to make PvP a meaningful competitive destination for players who have developed their characters through normal gameplay. *** ## 16. World Map
The World Map is the persistent geographic layer of Eclipsera Legends. It connects: * Kingdoms * Castles * Regions * Monster zones * Alliances * Territorial conflict Players can gradually expand beyond their initial territory. *** ## 17. Territorial Conquest Additional regions must be conquered. Each region contains a sequence of combat challenges. Players must clear the required rounds in order. Upon successful conquest: * The regional Castle becomes available * New development opportunities appear * The territory becomes part of the player's broader Empire *** ## 18. Regional Castles Every unlocked Castle functions as an independent Land instance. It has its own: * Buildings * Resources * Characters * Defense * Monsters * Development requirements Resources are not automatically shared between Castles. This forces players to make meaningful decisions about manpower and resource allocation. *** ## 19. Territorial Risk Expansion creates additional responsibility. A larger Empire requires: * More characters * More resources * More defense * More repairs * More strategic management Monsters can attack developed territories. If a Castle suffers catastrophic destruction, its functions can become unavailable until the player reconquers the territory. Therefore: > **Conquest is not simply ownership. It is responsibility.** *** ## 20. MvM & Alliance Warfare MvM is the large-scale competitive layer. Players cooperate through Alliances to fight opposing groups and control territory. The system is designed around: * Hex-based warfare * Territory * Castles * Coordinated attacks * Defense * Resource management * Diplomacy * Espionage * Technology *** ## 21. Hex Battle The world can be represented as a hex-based strategic battlefield. Hexes can represent: * Territory * Movement * Strategic positions * Objectives * Resource areas * Defensive locations This provides a geographic strategy layer above individual combat. *** ## 22. Alliance Warfare
Alliance members coordinate their forces rather than fighting independently. Successful alliances must manage: * Attack timing * Defensive positioning * Territory * Character deployment * Resources * Intelligence * Diplomacy The goal is to transform individual player strength into coordinated strategic power. *** ## 23. Diplomacy Diplomacy allows players to build relationships without immediately resorting to warfare. Players can: * Find other rulers * Establish relationships * Send envoys * Respond to visitors * Form alliances * Pursue political relationships Relationship progression can move through stages such as: **Spirit → Ceasefire → Alliance → Marriage** Diplomacy therefore creates a political alternative to direct conflict. *** ## 24. Espionage
Espionage introduces information warfare. Players can train heroes as spies and send them against enemy kingdoms. Core mission categories include: #### Peek Scout an enemy castle. #### Steal Attempt to steal resources. #### Loyalty Reduce the loyalty of an enemy general. #### Kill Attempt to eliminate an enemy general. Advanced missions require appropriate progression and previous intelligence against the target. *** ## 25. Counter-Espionage
Defenders can assign characters to counter-espionage. The defensive system can: * Detect enemy spies * Generate intelligence reports * Attempt to capture infiltrators * Handle captured spies This creates a strategic contest between: **Spy strength vs. defensive intelligence** *** ## 26. Captured Characters When enemy characters are captured through applicable warfare systems, the defender may have strategic choices. Depending on the applicable system, captured characters may be: * Returned * Imprisoned * Executed * Converted through loyalty mechanics Captured characters have loyalty. If loyalty declines sufficiently, ownership can potentially change according to the game's rules. This creates an additional strategic layer around warfare beyond simply reducing HP. *** ## 27. Technology
Technology provides long-term Kingdom development. Research unlocks new systems and capabilities. Technology can affect: * Economy * Combat * Diplomacy * Espionage * Defense * Production * Kingdom development The purpose of technology is to create meaningful choices rather than simply provide linear numerical bonuses. *** ## 28. Blacksmith
The Blacksmith is the Kingdom's equipment-production system. Crafting uses: * Wood * Stone * Iron * Bread Blacksmith progression unlocks increasingly advanced crafting. #### Level 2 Starting Special Items. #### Level 3 Craft Gems. #### Level 4 Final Special Equipment. The Blacksmith can eventually produce legendary equipment. *** ## 29. Deterministic Crafting Eclipsera's crafting philosophy is: > **Know what you need. Gather it. Craft it.** The system avoids making critical equipment progression dependent entirely on random outcomes. Players work toward defined recipes. This gives resource collection a clear purpose and makes long-term crafting progression understandable. *** ## 30. Enhancement Gems The Blacksmith system includes enhancement Gems such as: * Blood * Mirror * Solar * Void * War * Decay These materials contribute to advanced equipment crafting. They are consumed as part of the crafting process rather than functioning as standalone equipment. *** ## 31. Legendary Equipment Advanced Blacksmith progression allows players to craft powerful special equipment. The system is intended to create long-term goals for: * Iron production * Resource management * Character development * Kingdom investment This creates a direct connection between economic development and combat progression. *** ## 32. Empire Progression The Kingdom progresses through six broad eras: #### Survival Era The beginning of Kingdom development. #### Settler Era The player establishes a functioning settlement. #### Kingdom Era Core infrastructure becomes established. #### High Kingdom The Kingdom becomes highly developed. #### Imperial Era Most major systems approach advanced development. #### Golden Empire The Kingdom reaches its highest development stage. *** ## 33. Total Empire Level Every building contributes to the Kingdom's overall development. The fundamental calculation is: > **Total Empire Level = Sum of Building Levels** Empire progression also requires minimum development of important buildings. This prevents players from simply maximizing one structure while ignoring the rest of the Kingdom. The objective is balanced development across: * Food * Production * Defense * Governance * Crafting * Technology *** ## 34. Marketplace The Marketplace provides a player-driven asset economy where applicable game assets can be exchanged. The Marketplace can support: * Characters * Weapons * Equipment * Rare items * Other eligible assets The system is designed around player supply and demand. The previous ECS-based marketplace concept is no longer applicable to the current game architecture. *** ## 35. Economy & USD Eclipsera Legends does not use the former ECS token economy. The game instead uses **Eclipsera Legends Gems** within its current economic model. A key difference is that Gems are not intended to turn the game into a blockchain-based experience. Eclipsera Legends is positioned as a **Web2 game**. Players engage with the game normally: **Play → Develop → Earn Gems → Use Gems → Progress** Where eligible Gems can be converted into USD according to the game's current conversion and withdrawal rules. The economic objective is to make earning potential part of gameplay rather than requiring players to purchase or speculate on a separate token. *** ## 36. The Role of Gems Gems connect the game's progression systems. They can participate in: * Competitive PvP * Kingdom systems * Economic progression * Rewards * Other eligible activities The most important design principle is that players should have reasons to earn Gems through **actual gameplay**. This means: > **The Kingdom itself can become part of the player's economic progression.** Players are not required to rely exclusively on tournaments or special events to participate in the game's economic loop. *** ## 37. Player Progression A player's long-term progression can be viewed across several dimensions. #### Kingdom How developed is the player's land? #### Characters How advanced are the player's heroes and workers? #### Equipment How powerful and specialized is their equipment? #### Technology How many systems and strategic capabilities have been unlocked? #### Territory How much land does the player control? #### Diplomacy What relationships have they established? #### Military How effective are their PvE, PvP and MvM forces? #### Economy How efficiently can they generate and circulate resources? There is no single number that completely defines a player's success. *** ## 38. New Player Experience The early game should be intentionally accessible. New players should quickly experience: 1. Building 2. Resource production 3. Character development 4. Combat 5. Rewards 6. Crafting 7. Territory 8. Competition Early progression should communicate: > **"There is always something I can do next."** The game should avoid making new players wait long periods before understanding why the game is fun. *** ## 39. Mid-Game The mid-game introduces strategic specialization. Players begin deciding: * Which buildings to prioritize * Which characters to develop * Which equipment to craft * Which technologies to research * Which territories to conquer * Which relationships to establish The game transitions from: **"What can I build?"** to: **"What should I build?"** *** ## 40. End Game The end game is dominated by strategic competition and Empire development. Players can pursue: * High-level Kingdom development * Advanced equipment * Territorial expansion * PvP * Alliance warfare * Diplomacy * Espionage * MvM * Competitive seasons * Long-term character progression The end game should not have a single mandatory path. Players can specialize as: * Warriors * Kingdom builders * Economists * Diplomats * Spies * Territory conquerors * PvP specialists * Alliance leaders *** ## 41. Strategic Identity Eclipsera Legends is intended to support multiple player identities. #### The Builder Focuses on Kingdom development and economic efficiency. #### The Warrior Focuses on combat and hero progression. #### The Conqueror Focuses on territorial expansion. #### The Diplomat Focuses on relationships and alliances. #### The Spy Focuses on intelligence and disruption. #### The Crafter Focuses on materials and advanced equipment. #### The Commander Focuses on alliance warfare and MvM. These identities can overlap. A successful player may combine several of them. *** ## 42. Social Gameplay The persistent world encourages interaction between players. Players can: * Form alliances * Negotiate * Fight * Trade * Spy * Defend one another * Compete for territory * Build political relationships The goal is to make other players part of the world rather than simply opponents selected from a matchmaking queue. *** ## 43. Fairness Competitive systems should prioritize meaningful player decisions. Important fairness principles include: * Clear combat rules * Transparent mechanics * Strategic counterplay * Meaningful resource management * Anti-cheat systems * Validation of combat results * Equal team-size requirements where applicable PvP should reward knowledge, preparation, timing and execution. *** ## 44. Persistent World Philosophy Eclipsera Legends is designed around the idea that actions should have consequences. Conquering territory creates: * New responsibilities Attacking another kingdom creates: * Political consequences Developing a character creates: * New strategic possibilities Forging equipment creates: * New combat options Forming an alliance creates: * New obligations Using espionage creates: * New risks The world therefore becomes a collection of player decisions rather than a collection of disconnected missions. *** ## 45. Long-Term Gameplay The long-term progression can be summarized as: **Build a Kingdom** ↓ **Develop Characters** ↓ **Master PvE** ↓ **Forge Equipment** ↓ **Research Technology** ↓ **Expand Territory** ↓ **Develop Multiple Castles** ↓ **Build Diplomatic Relationships** ↓ **Join or Create Alliances** ↓ **Compete in PvP** ↓ **Fight in MvM** ↓ **Use Espionage and Counter-Espionage** ↓ **Develop a Greater Empire** ↓ **Repeat at a higher strategic level** *** ## 46. Design Philosophy The central design philosophy of Eclipsera Legends is: #### The Kingdom is the foundation. #### Characters are the engine. #### Resources are the fuel. #### Combat is the test. #### Territory is the reward. #### Diplomacy is the political layer. #### Espionage is the information layer. #### Alliances are the social layer. #### Technology is the progression layer. #### Gems are the current economic layer. Together, these systems form one persistent game. *** ## 47. The Eclipsera Legends Ecosystem The complete ecosystem can be represented simply:
``` ECLIPSERA LEGENDS │ ┌──────────────┴──────────────┐ │ │ KINGDOM WORLD │ │ ┌────────┼────────┐ ┌──────┼──────┐ │ │ │ │ │ │ Economy Heroes Technology PvE Territory MvM │ │ │ │ │ │ └────────┼────────┴─────────────┘ │ │ │ │ │ Crafting │ │ │ │ │ └──────────────┬──────────────┘ │ │ │ PvP Alliance │ │ └─────────┬───────────┘ │ Diplomacy │ Espionage │ Counter-Espionage │ Gems │ USD Economy ``` *** ## 48. Conclusion **Eclipsera Legends** is designed as a persistent online strategy RPG where the player's Kingdom is more than a collection of buildings and the characters are more than combat statistics. Every major system contributes to the same persistent world. Players build. They develop. They explore. They fight. They craft. They negotiate. They spy. They conquer. They defend. They cooperate. And ultimately, they shape the development of their own Empire. The game's fundamental progression can therefore be expressed in one sentence: > **Build your Kingdom, raise your Legends, conquer the world, and decide what kind of Empire you will create.** Eclipsera Legends is intended to evolve continuously through new territories, heroes, technologies, combat systems, seasonal content, alliances, competitive formats, and additional strategic mechanics while preserving the core principle of a **persistent world where every player's Kingdom has a history, a position, and a future.** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://whitepaper.eclipsera-game.com/eclipsera-legends.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.