diff --git a/docs/tasks/flagship-modpack-eternal-skyforge/design-document.md b/docs/tasks/flagship-modpack-eternal-skyforge/design-document.md new file mode 100644 index 0000000..cecf26f --- /dev/null +++ b/docs/tasks/flagship-modpack-eternal-skyforge/design-document.md @@ -0,0 +1,581 @@ +# Firefrost: The Eternal Skyforge - Flagship Modpack Design + +**Status:** Planning +**Priority:** Tier 3 - Content Creation +**Time Estimate:** 20-40 hours (iterative development) +**Last Updated:** 2026-02-17 + +--- + +## Executive Summary + +**Firefrost: The Eternal Skyforge** is a custom Create-focused modpack that embodies the Fire + Frost philosophy through gameplay. Players master the art of weapon forging and factory automation in a skyblock environment where Fire (passion, competition, progression) meets Frost (precision, engineering, mastery). + +**Core Theme:** Forge legendary weapons through automated factories in the sky. + +--- + +## Design Philosophy + +### Fire + Frost in Gameplay + +**Fire (Passion/Competition):** +- Competitive weapon forging leaderboard +- Timed crafting challenges +- PvP arena with custom weapons +- Fast progression early game +- Exciting combat mechanics + +**Frost (Precision/Engineering):** +- Complex multi-step factory builds +- Precise Create contraptions required +- Engineering challenges for optimization +- Long-term mastery goals +- Technical depth in automation + +**Balance:** Easy to start (Fire), hard to master (Frost) + +--- + +## Core Concept + +### The Eternal Skyforge + +**Setting:** A mystical skyblock world where ancient forges float in the void + +**Premise:** +You are a Forgemaster awakening in the Eternal Skyforge - a dimension where legendary weapons are born. Using the power of Create machinery and elemental materials, you must rebuild the great forges and craft weapons worthy of legend. + +**Gameplay Loop:** +1. **Gather** → Mine/farm elemental resources (Fire Essence, Frost Crystals, etc.) +2. **Forge** → Create automated weapon production lines +3. **Test** → Battle in the arena or challenges +4. **Improve** → Optimize your forges, craft better weapons +5. **Compete** → Leaderboards for fastest/best weapons + +--- + +## Core Mods + +### Essential (The Foundation) + +**Create v0.5.1+ (Core Mod)** +- Mechanical power (rotational force) +- Automation components +- Factory building blocks +- Kinetic power network + +**Skyblock World Generation** +- Void world with starting platform +- Custom island structures +- Resource generation mechanics + +**Custom Weapon Crafting** +- Tetra OR Tinkers' Construct (decision needed) +- Deep customization +- Stat-based progression +- Legendary weapon tiers + +### Supporting Mods (The Pillars) + +**Resource Generation:** +- **Ex Nihilo: Sequentia** - Sieving, composting, mob spawning +- **Botania** - Mana system, flower automation +- **Thermal Series** - Additional processing, power + +**Quality of Life:** +- **JEI (Just Enough Items)** - Recipe viewing +- **FTB Quests** - Guided progression +- **FTB Teams** - Multiplayer cooperation/competition +- **Waystones** - Fast travel between forges + +**Building & Aesthetics:** +- **Chipped** - Building block variety +- **Supplementaries** - Decorative blocks +- **Macaw's** mods - Roofs, bridges, furniture +- **Lanterns Belong on Walls** - Aesthetic placement + +**Combat & Challenges:** +- **Apotheosis** - Enchantment overhaul +- **Artifacts** - Unique gear rewards +- **Reliquary** - Magical items +- **Boss mods** (Twilight Forest, Mowzie's Mobs, etc.) + +**Performance:** +- **Embeddium** (Sodium port for Forge) +- **Oculus** (Iris shaders port) +- **FerriteCore** - Memory optimization +- **ModernFix** - Performance improvements + +--- + +## Progression System + +### Phase 1: The Awakening (Early Game) + +**Goal:** Establish basic forge and automation + +**Key Milestones:** +- [ ] Build starter Create contraptions +- [ ] Set up basic resource generation (sieving) +- [ ] Craft first manual weapon +- [ ] Create simple automated smelter +- [ ] Unlock fire essence gathering + +**Estimated Time:** 2-4 hours + +**Fire Element:** Fast-paced initial setup, exciting discoveries +**Frost Element:** Learn Create basics, understand power systems + +--- + +### Phase 2: The Apprentice Forge (Mid Game) + +**Goal:** Automated weapon component production + +**Key Milestones:** +- [ ] Build multi-step production lines +- [ ] Automate ore processing +- [ ] Create mechanical press setups +- [ ] Unlock frost crystal farming +- [ ] Craft first automated weapon +- [ ] Build enchanting automation + +**Estimated Time:** 8-12 hours + +**Fire Element:** Unlock powerful weapons, combat challenges +**Frost Element:** Complex factory optimization, precision engineering + +--- + +### Phase 3: The Master Forgemaster (Late Game) + +**Goal:** Legendary weapon mass production + +**Key Milestones:** +- [ ] Fully automated legendary weapon production +- [ ] Massive Create factories +- [ ] Boss defeats for rare materials +- [ ] Ultimate weapons crafted +- [ ] Forge challenges completed +- [ ] Leaderboard placement + +**Estimated Time:** 20-40 hours + +**Fire Element:** Epic boss battles, competitive rankings +**Frost Element:** Ultimate factory optimization, mastery challenges + +--- + +## Custom Questing + +### Quest Categories + +**📖 Main Quest Line: The Forgemaster's Path** +- Tutorial quests (Create basics) +- Progression gates (unlock new materials/recipes) +- Boss fight unlocks +- Final challenge quest + +**🔥 Fire Path Quests (Competition)** +- Timed crafting challenges +- Combat trials +- Speed achievements +- Leaderboard rewards + +**❄️ Frost Path Quests (Engineering)** +- Factory optimization challenges +- Automation milestones +- Efficiency goals +- Precision building + +**🏆 Achievement Quests** +- Hidden discoveries +- Easter eggs +- Rare weapon crafting +- Complete collections + +--- + +## Weapon System Design + +### Weapon Tiers + +**Tier 1: Apprentice Weapons (Common)** +- Basic stats +- Manual crafting +- Tutorial weapons +- Examples: Iron Blade, Basic Bow + +**Tier 2: Journeyman Weapons (Uncommon)** +- Improved stats +- Requires simple automation +- Elemental infusions +- Examples: Flame Sword, Frost Bow + +**Tier 3: Master Weapons (Rare)** +- Strong stats +- Complex crafting chains +- Special abilities +- Examples: Volcanic Greatsword, Glacial Staff + +**Tier 4: Legendary Weapons (Epic)** +- Exceptional stats +- Fully automated production +- Unique abilities +- Examples: Eternal Flameblade, Frostfall Hammer + +**Tier 5: Mythic Weapons (Legendary)** +- Best-in-slot +- Extreme crafting requirements +- Boss materials needed +- Examples: Skyforge Divine Blade, Eternal Frost Reaper + +### Weapon Stats + +**Damage Types:** +- Physical (raw damage) +- Fire (burning, area damage) +- Frost (slow, debuff) +- Lightning (chain damage) +- Void (penetration) + +**Special Abilities:** +- AOE attacks +- Life steal +- Crowd control +- Movement bonuses +- Passive effects + +--- + +## Factory Templates + +### Starter Forge (Phase 1) + +**Components:** +- Hand crank → Millstone → Furnace +- Basic sieving setup +- Manual weapon assembly bench + +**Footprint:** 7x7x4 blocks +**Output:** 1 weapon per 5 minutes (manual operation) + +--- + +### Automated Weapon Line (Phase 2) + +**Components:** +- Ore generation → Crusher → Washing → Smelting +- Mechanical press → Sequenced assembly +- Encased fan for smelting +- Andesite funnels for routing +- Chutes for vertical movement + +**Footprint:** 15x12x8 blocks +**Output:** 1 weapon per 2 minutes (fully automated) + +--- + +### Master Forge Complex (Phase 3) + +**Components:** +- Multi-level factory (3-4 floors) +- Parallel production lines +- Boss material integration +- Enchantment automation +- Quality control sorting + +**Footprint:** 30x30x20 blocks +**Output:** Multiple legendary weapons per hour + +--- + +## Fire vs Frost Gameplay Styles + +### Fire Path Players + +**Playstyle:** +- Focus on combat and exploration +- Quick, efficient factories +- Prioritize weapon stats over factory aesthetics +- Compete on leaderboards +- Speed-run progression + +**Recommended Weapons:** +- High DPS melee +- AOE abilities +- Fast attack speed +- Damage over time effects + +--- + +### Frost Path Players + +**Playstyle:** +- Focus on factory beauty and efficiency +- Complex, over-engineered contraptions +- Prioritize automation elegance +- Showcase builds +- Maximize output per resource + +**Recommended Weapons:** +- Precision ranged weapons +- Crowd control abilities +- Strategic advantage tools +- Defensive capabilities + +--- + +## Multiplayer Features + +### Cooperative Elements + +**Shared Forges:** +- Team factory building +- Resource sharing +- Collaborative challenges +- Combined leaderboard teams + +**Trading:** +- Weapon marketplace +- Resource exchange +- Blueprint sharing + +--- + +### Competitive Elements + +**Leaderboards:** +- Fastest weapon crafted +- Highest DPS weapon +- Most legendary weapons +- Forge efficiency ratings + +**Arena PvP:** +- Custom weapon battles +- Ranked matches +- Tournament events + +--- + +## Custom Recipes + +### Example: Legendary Flameblade + +**Materials:** +- 4x Inferno Steel Ingot (processed ore + fire essence) +- 2x Dragon Heart Shard (boss drop) +- 1x Eternal Flame Core (rare) +- 8x Enchanted Thread (automated production) + +**Crafting Process:** +1. Smelt Inferno Ore → Inferno Steel +2. Mechanical press shapes blade +3. Sequenced assembly adds components +4. Enchanting automation applies buffs +5. Final assembly with boss materials + +**Production Time:** 15 minutes automated +**DPS:** 25 base + fire damage over time +**Special Ability:** Flames spread to nearby enemies + +--- + +## Server Rules & Balance + +### Weapon Nerfs/Buffs + +- PvP damage reduced 30% from PvE +- Boss weapons have cooldowns in PvP +- Enchantments capped at level 5 for balance + +### Automation Limits + +- Max factory size: 50x50x30 blocks +- TPS protection: lag-causing builds removed +- Chunk loading limits per player + +### Economy + +- Server shop for basic materials (anti-grind) +- Player-to-player trading encouraged +- No pay-to-win mechanics + +--- + +## Technical Details + +### Minecraft Version + +**Target:** 1.20.1 (LTS for modding stability) +**Fallback:** 1.19.2 if mods unavailable + +### Modloader + +**Forge** - Better mod compatibility for Create ecosystem + +### Mod Count + +**Target:** 80-120 mods (medium-weight pack) +**RAM Requirement:** 6-8 GB allocated + +### Server Requirements + +**Recommended:** +- 16 GB RAM (8GB allocation to server) +- 4+ CPU cores +- SSD storage +- 20-30 player capacity + +--- + +## Development Roadmap + +### Phase 1: Core Setup (Week 1-2) + +- [ ] Select Minecraft version +- [ ] Choose weapon mod (Tetra vs Tinkers) +- [ ] Install core mods (Create, skyblock, etc.) +- [ ] Test mod compatibility +- [ ] Create basic world template + +### Phase 2: Recipe Development (Week 3-5) + +- [ ] Design weapon tiers +- [ ] Create custom recipes (CraftTweaker/KubeJS) +- [ ] Balance resource costs +- [ ] Test crafting chains +- [ ] Design factory templates + +### Phase 3: Questing (Week 6-8) + +- [ ] Write main quest line +- [ ] Create Fire/Frost path quests +- [ ] Design achievement system +- [ ] Test quest progression +- [ ] Balance rewards + +### Phase 4: Polish & Balance (Week 9-12) + +- [ ] Performance optimization +- [ ] Balance testing +- [ ] Bug fixes +- [ ] Custom textures/models (if possible) +- [ ] Server configuration + +### Phase 5: Beta Testing (Week 13-16) + +- [ ] Closed beta with staff +- [ ] Public beta with subscribers +- [ ] Gather feedback +- [ ] Iteration and improvements + +### Phase 6: Launch (Week 17+) + +- [ ] Public release +- [ ] Marketing push +- [ ] Monitor for issues +- [ ] Regular updates + +**Total Timeline:** 4-5 months from concept to launch + +--- + +## Marketing & Branding + +### Tagline + +**"Where Steel Meets Steam, Legends Are Forged"** + +### Key Selling Points + +- **Unique Concept:** No other Create + Skyblock + Weapon Forging pack +- **Fire + Frost Philosophy:** Two distinct playstyles in one pack +- **Beautiful Factories:** Showcase potential for content creators +- **Competitive Edge:** Leaderboards and challenges +- **Optimized:** Runs well on mid-range hardware + +### Target Audience + +- Create mod fans +- Factory builders +- Competitive players +- Skyblock enthusiasts +- Ages 16-35 + +--- + +## Content Creator Potential + +### Streamer-Friendly Features + +- Progression goals for series +- Build showcases +- Competitive events +- Multiplayer dynamics + +### YouTube Series Ideas + +- "Skyforge to Mastery" (progression series) +- Factory tour showcases +- Weapon tier rankings +- Speed-run challenges +- PvP tournaments + +--- + +## Stretch Goals (Future Updates) + +**Version 1.1:** +- Dimensions for resource gathering +- New boss fights +- Additional weapon types (shields, spears) + +**Version 2.0:** +- Magic system integration +- Airships for transportation +- Guild system for teams + +**Version 3.0:** +- Custom dimension for PvP arena +- Seasonal events and limited weapons +- Cross-server leaderboards + +--- + +## Success Metrics + +### Launch Goals + +- [ ] 100+ downloads in first week +- [ ] 5+ content creator features +- [ ] 50+ concurrent players on server +- [ ] 4.5+ star rating on CurseForge + +### 6-Month Goals + +- [ ] 10,000+ downloads +- [ ] Active community on Discord +- [ ] Regular events and updates +- [ ] Featured on modpack lists + +--- + +## Related Tasks + +- **Terraria Branding Training Arc** - Learn asset creation skills +- **Discord Reorganization** - Server structure for modpack +- **Staff Recruitment** - Builders for spawn area +- **Staggered Restart System** - Server maintenance + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️ + +--- + +**Document Status:** COMPLETE DESIGN +**Next Steps:** Begin Phase 1 development when ready +**Owner:** The Wizard (Michael) with community input +**Timeline:** 4-5 months to launch