v0.6.3 — The Queue

Arteria

A cosmic idle RPG inspired by Melvor & RuneScape. Train skills, run 18 story quests across Act I & II, talk to NPCs, and progress even while you're away.


18
Story Quests
25
Planned Skills
5
Skill Pillars
99
Max Level
24h
Offline Cap
25
Tests Passing

The Queue

Crafting Queue & WYWA Report: You can now queue up multiple consecutive skilling or crafting actions. The While You Were Away report now properly displays your defeated enemies count natively.

👤
v0.6.2
The Profile

New account hub! Identity, progress snapshot, rewards & entitlements, quick actions. Optional selected title.

⚔️
v0.5.1
Combat Alpha

A full auto-battler engine with 4 combat zones, 12 prayers, loot tables, and loadout management.

🗺️
v0.5.1
World Exploration

Explore the World Map with 6 unique locations including Frostvale and Fey Markets. instant travel and NPC interactions.

🏦
v0.5.1
OSRS Bank Redesign

Custom tabs (emoji + name), type filters, and long-press item → "Create new tab with this item".

🧪
v0.5.1
Herblore & Harvesting

Gather herbs across 7 nodes and brew 7 distinct potions from Healing to Void Resistance.

🎣
Fishing

10 spots from Shrimp to Cosmic Jellyfish. Area-grouped UI and bobbing animation.

⚒️
Smithing & Forging

Smithing: smelt ore → bars (Bronze to Runite). Forging: 5 weapon types (dagger, shortsword, longsword, scimitar, 2H Longblade) + armour. 54 recipes. Metal-tier grouping.

Runecrafting

14 altars, essence consumption, two-stage production. Backbone for future magic combat.

🍳
Cooking

10 recipes: raw fish → cooked food. Bank Food filter, daily quests (Cook Shrimp, Cook Trout), Stats tracking.

⚙️
Smart Action Loops

Loop consumes inventory inputs; tasks auto-stop when you run out of materials.

📜
18 Story Quests

Act I & II quests with requirements, steps, and difficulty. Available list gated by level, flags, and completed quests.

Mastery

Earn 1 point per level-up per skill. Spend in Settings → Mastery on permanent buffs (+5% XP per level, up to 5 levels per skill). Stacks with Patron.

🔔
Settings & Notifications

Theme, Gameplay (Confirm Task Switch, Battery Saver, Horizon HUD), Mastery, Audio, Idle Cap Reached, Idle Soundscapes. Easter egg: "Don't Push This" → title "The Stubborn".


Quests & Expeditions

18 story quests across Act I and Act II. Steps auto-complete when you meet requirements (e.g. have the items); hand in for gold, XP, and flags. Narrative gating, difficulty tiers, Cosmic Comedy tone.

18 Total Quests
15 Act I
3 Act II
4 Difficulty Tiers

The Cosmic Sneeze

NoviceAct I

Awaken in the Crownlands and find someone who knows what's going on. The start of the Cosmic Comedy.

A Merchant's Trust

NoviceAct I

Bring Nick the merchant copper ore to earn his favour. Unlocks further trading quests.

First Catch

NoviceAct I

Catch shrimp for a fisherman by the dock. Your first step into the Fishing skill.

Rune Awakening

NoviceAct I

Mine essence and craft air runes at the Air Altar. The gateway to Runecrafting.

The Cursed Sample

IntermediateAct I

A scholar wants cursed ores for research. Requires knowing about the Sneeze Cult.

Blibbertooth's Blessing

IntermediateAct I

Complete the Cult's initiation. Offer cosmic runes and receive their blessing.

Voices in the Void

ExperiencedAct II

Strange whispers drift from the mines. A cosmic shard may reveal their meaning.

Gold Rush

ExperiencedAct II

Nick pays premium for gold ore. Mine a sizable haul and cash in.

In-app: Quests tab shows Available (gated by level, flags, completed quests), Active with step tracking, and Completed archives. More quests and radiant dailies planned.


Core Systems

Arteria is a fully modular monorepo. Each layer of the game is a self-contained, independently testable system.

⚙️
arteria-engine
Game Engine

A pure TypeScript package with zero React dependencies. Houses the RuneScape-style XP table, the delta-time tick processor (TickSystem), and the GameEngine orchestrator that handles both realtime and offline batch processing. Independently unit-tested with Jest.

XPTable.ts TickSystem.ts GameEngine.ts jest-tested
🏦
arteria-state
Redux Store

The single source of truth for all game state. Built with Redux Toolkit's gameSlice, managing player skills, inventory, active tasks, and gold. Fully typed with RTK and react-redux hooks. Wired into the UI layer via typed useAppSelector / useAppDispatch.

RTK 2.11 gameSlice typed hooks
💾
arteria-persist
MMKV Persistence

Synchronous C++ key-value storage powered by react-native-mmkv v4. The usePersistence hook listens to React Native's AppState. On background, it snapshots Redux state + timestamp to MMKV. On foreground, it loads the save, calculates elapsed time, and hydrates the store.

MMKV v4 AppState autosave
⏱️
arteria-loop
Game Loop

useGameLoop drives the realtime experience — a 100ms setInterval that feeds delta-time into the engine and dispatches results to Redux. On first load it calculates offline catch-up via a timestamp diff, capped at 24 hours for F2P fairness.

100ms tick offline catchup 24h F2P cap
📱
arteria-ui
Mobile App

Built on Expo SDK 55 with Expo Router v6 for file-based navigation. Features a dark Melvor-inspired theme with 30+ design tokens, 5 tab screens (Skills, Combat, Bank, Shop, Settings), skill cards with animated XP bars, and real-time train/stop dispatch buttons.

Expo SDK 55 Expo Router RN 0.83 New Arch
🧪
arteria-tests
Test Suite

Multi-project Jest at monorepo root. Unit tests for XPTable (RuneScape XP curve), TickSystem (partial tick carryover, RNG, offline batching), and GameEngine (createNewPlayer, processOffline). npm run test:coverage for engine coverage. Integration and E2E placeholders. Target: 80% on business logic.

Jest 29 ts-jest 7 suites 25 passing

Game Features

Everything you'd expect from a premium idle RPG, built from scratch on mobile-first architecture.

⛏️
Skill Training
Train 25 skills across 5 pillars. RuneScape-style XP curve with level gating and mastery tiers.
🌙
Offline Progression
The engine runs even when you're away. Come back to hours of accumulated resources, XP, and loot.
⚔️
Auto-Combat
Fight 12 enemy factions — from Void-Touched Wildlife to Primordial Fragments — actively or offline.
🔨
Crafting Chains
Skills interlock. Smithing needs Mining. Alchemy needs Farming. Every action feeds another.
📜
RuneScape-Style Quests
18 story quests with narrative gating, difficulty tiers (novice → master), and rewards. Available / Active / Completed ledger in-app.
🌌
Cosmic Lore
Unravel the mysteries of Valdoria and the Luminar/Voidmire cosmic balance. Branching NPC dialogue and absurdist tone.
💎
F2P Friendly
All gameplay is free. Premium is convenience only — no pay-to-win. Patron's Blessing extends offline cap to 12h.

The Kingdom of Valdoria

A cosmic peninsula where bright Luminar energy and dark Voidmire essence clash — and reality itself sometimes glitches.

🏰
The Crownlands
Central hub and player home territory. A bustling capital where cosmic knights patrol streets lit by floating Luminar lanterns.
🌲
The Whispering Woods
An enchanted forest with sentient trees that gossip about passing adventurers. Higher-level trees can be negotiated with for better yields.
🌋
The Scorched Reach
A volcanic region where Voidmire pools underground. Rich in rare ores, but cursed items drop more frequently here.
🏔️
The Skyward Peaks
Mountains that pierce the lower Celestial Spires. Home to the Celestial Bureaucracy — angels obsessed with paperwork.
📜
The Sunken Archives
Underground ruins of previous civilizations. Contains knowledge of previous Anchors who failed to stabilize reality.
🎪
The Fey Markets
Planar crossover point where otherworldly traders appear on rotation. Limited-time rare recipes and exotic materials.
⚖️
The Order of the Balanced Scale
Led by a sentient suit of empty armor. Perfectly normal.
🌑
The Void-Touched Collective
Not evil — just unsettling vibes and excellent parties.
📋
The Celestial Bureaucracy
Angels who require divine blessings in triplicate.
🤡
Cult of Blibbertooth
Their temples are comedy clubs. Quests accidentally save the world.

Skill System

Five interconnected pillars — every skill level opens new recipes, areas, and story content.

⛏️
Mining
Gathering
🪵
Logging
Gathering
🎣
Fishing
Gathering
🌿
Harvesting
Gathering
🗺️
Scavenging
Gathering
🔨
Smithing
Crafting
⚒️
Forging
Crafting
🧶
Tailoring
Crafting
⚗️
Alchemy
Crafting
Runecrafting
Crafting
🍳
Cooking
Crafting
🏠
Construction
Crafting
🏹
Fletching
Crafting
⚔️
Attack
Combat
💪
Strength
Combat
🛡️
Defence
Combat
🏹
Ranged
Combat
🔮
Magic
Combat
❤️
Constitution
Combat
🗺️
Exploration
Support
✝️
Cleansing
Support
🤝
Barter
Support
👑
Leadership
Support
📚
Research
Support
🌌
Aether Weaving
Cosmic (Endgame)
🕳️
Void Walking
Cosmic (Endgame)
👼
Celestial Binding
Cosmic (Endgame)
Chronomancy
Cosmic (Endgame)

Companions

Hire Wandering Souls — NPCs with their own skills who train, fight, and occasionally cause explosions on your behalf.

⚔️
Barnaby the Uncertain
Warrior · Unlocks at Leadership 20
A well-meaning warrior who deals devastating damage — when he doesn't accidentally hit himself. Optimistic regardless of outcomes.
Trait: 2× damage, but 50% chance to strike himself instead. He calls this "character building."
🧪
Scholar Yvette
Researcher · Unlocks at Leadership 35
A brilliant researcher who dramatically speeds up your crafting queues. Minor side effect: occasional lab explosions.
Trait: +30% crafting speed. 5% chance per craft to explode — but you get a partial resource refund and a funny quote.
🛡️
Sir Reginald Pomp
Knight · Unlocks at Leadership 50
An aristocratic knight who automatically sells your grey-tier loot. He delivers a long, eloquent speech about each discarded item.
Trait: Auto-sells junk items for gold. You can't skip the speeches. You learn to love them.

The Anchor

You aren't just a randomly chosen hero. You are a cosmic accident—an Anchor whose soul is unusually heavy, immune to the chaos of the Unraveling.

🧬
Ancestries
Play as a standard Human, a time-dilated Elf, a cosmic-mining Dwarf, a partially unreal Fey-Touched, or a translucent Void-Blooded character.
⚖️
Affinities
Align yourself with defensive Luminar energy, offensive Voidmire corruption, or walk the slow but perfectly flexible path of the Balanced.
🃏
Cosmic Quirks
Roll a random comedic modifier on creation. You might attract sentient furniture, or find your hair changing color when someone lies nearby.

The Encounter

Combat occurs in pocket dimensions where time moves differently, allowing offline progression. Auto-combat learns your preferences and auto-flees to save your loot.

⚔️
Quick Hits
Delves

Short 5-10 minute active experiences, or 1-hour offline auto-clears. Perfect for a quick lunch break or queuing up right before a meeting.

🗺️
Deep Dives
Expeditions

Multi-floor gauntlets spanning up to 30 minutes active or 4 hours offline. Prepare your loadout and limited consumables wisely before heading in.

🌀
Weekly Rules
Cosmic Modifiers

Dungeons rotate modifiers weekly. "Gravity's Suggestion" reverses fall damage (falling up hurts). "Blibbertooth's Blessing" makes enemies explode into confetti on crits.


A Day in Arteria

Designed to respect your time. Progress happens whether you play for 2 minutes or 2 hours.

9:00 AM — Morning Commute (2 min)
📱 Collect & Queue
Open the "While You Were Away" report. Grab overnight combat loot. Start a 2-hour crafting queue. Check daily quests.
12:30 PM — Lunch Break (15 min)
⛏️ Active Play
Mine 10 Silver Ore for a daily quest. Run a dungeon in active mode for bonus loot. Collect finished crafts and restart the queue.
6:00 PM — Evening Session (45 min)
⚔️ Deep Play
Test a new combat ability. Visit the Fey Market for rare recipes. Start an 8-hour legendary craft. Harvest your garden.
10:00 PM — Bedtime (3 min)
🌙 Queue Overnight
Set auto-combat in a new area. Queue long crafts. Set a push notification for when your Fey-Touched Sword finishes. Sleep well.

Technology Stack

Production-grade tooling, built for performance on every Android device.

Expo SDK 55
React Native 0.83
TypeScript 5.9
Redux Toolkit 2.11
react-native-mmkv v4
Expo Router v6
RN Reanimated 4
React 19.2
npm Workspaces
Jest 29 + ts-jest
New Architecture
Gradle 9.3

Changelog

Every version from foundation to current. Kept in sync with DOCU/CHANGELOG.md and in-app Patch Notes.

v0.1.0
Foundation — Initial scaffold: Expo SDK 54, monorepo (apps/mobile + packages/engine), Redux Toolkit, MMKV, dark theme, 5 tab screens.
v1.0.0
Persistence & Pipeline — Gradle 9.3, Android prebuild, Melvor-style palette (30+ tokens), Skills/Bank/Combat/Shop/Settings screens, Jest tests.
v1.1.0
Deployment & Fixes — Batch scripts (Start, EAS OTA, EAS Build). EXPO_ROUTER_APP_ROOT fix (root babel, index proxy, metro watchFolders). EAS CLI via npx.
v0.2.0
Pipeline & Gathering — Core loop, Mining, Skill Pillars, Total Level, XP [current/next], ticks-to-level, wipe save. State migration, Level Up Toast, tab insets.
v0.2.1
Immersion — Global Action Ticker, Header XP dashboard, MaterialCommunityIcons, edge-to-edge Android, back buttons, node progress bars.
v0.2.2
Juice — Bank search + filters, Train Toast, pulsing tab glow, Loot Vacuum. XP Bar Pulse, Haptic Heartbeat, Inventory Full "!". SmoothProgressBar (60fps).
v0.2.3
Horizon & Logging — Logging UI, log items, Logs filter. Shop 50% sell, Curse system. Horizon (3-tier HUD), rare gems, mythic fish, Seasonal Rotation. Patch Notes screen. Local APK fix.
v0.2.4
Premium UI Polish — AnimatedNumber, BouncyButton, ActivePulseGlow, tick shake (Mining, Logging).
v0.2.6
Lore Expansion — Branching NPC dialogue, Narrative Gating, Quest Ledger screen. Glassmorphism overhaul for the website.
v0.3.0
The Big Update — Theme Engine (picker, tab bar, StatusBar). Quick-Switch Sidebar. Smithing, Forging. Quest step auto-complete (engine checks inventory/skills; steps complete when requirements met). Mastery (1 pt/level-up, spend for +% XP in Settings). Random Events (Blibbertooth, Cosmic Sneeze, Genie, Treasure Chest, Lucky Strike). Fishing, Runecrafting, Activity Log, Feedback Toasts, Settings, Bank sort, Shop 25/50/Max. Easter egg "Don't Push This".
Quest expansion
18 Story Quests — Act I & II. Narrative gating, step auto-complete, hand-in for rewards (gold, XP, flags, items). Difficulty badges on cards.
v0.4.0
Daily, Stats & Lumina — Daily quests (3/day, reset midnight, Claim gold/Lumina). Stats tab (gathered by type, play time). Custom bank tabs, Sell All Junk (configurable), Login bonus (7-day streak), Lumina currency UI (Bank/Shop/Settings).
v0.4.1
The Anchor Man — Main character & nickname (The Anchor). Goblin first enemy + Peek modal. Cooking skill (10 fish→cooked recipes). Bestiary stub (Enemies Spotted). Bank fix.
v0.4.2
Skill Pets & Polish — Rare pet drops from skilling, Pets screen, active pet emoji. Tick SFX (tink/thump/splash). OTA pipeline hardened (runtimeVersion, ABI splits plugin). Check for Updates in Settings. Dev server Wi‑Fi fix.
v0.5.1
THE 0.5.1 extended update directors cut remix - alpha — Consolidates versions 0.4.3 through 0.5.1. Introduces the Technical User Manual, Midnight Theme, 16 achievements, Combat Alpha (auto-battler, prayers, zones), World Map, OSRS Bank, Herblore, Harvesting, Scavenging, and Gameplay Settings.
v0.5.2
The Celestial Expansion — Astrology skill, Meteorites, and Stardust.
v0.5.3
The Legion & The Soul — Slayer & Summoning groundwork, Master Mark NPC, 5 Pouches, Branching Dialogues.
v0.6.0
The Ascended Master — Magic Hub, Thieving skill, Agility Courses, Mastery Skill Capes, Farming skill (patches, seeds, harvest), Firemaking skill (burn logs for XP), Woodworking skill (logs → furniture, shields, staves; flagship workbench UI), Exploration skill (expeditions, discovery items, World Map level gates), Wizardry & Sorcery (study tomes, cast spells with runes), Expansions system (Patron's Pack = Exp. 1), Enhanced UI for Slayer, Summoning, and Resonance. Stability audit. Random events in-game only. WYWA offline XP fix (apply on Collect & Continue).
v0.6.1
The Forge & The Bow — Skill Capes complete (10 missing added). New skills: Fletching (arrows, bows) and Tailoring (cloth gear). Crafting UI redesign (Radial Mastery). EquipSlot expansion (hands, cape).
v0.6.2
The Profile — Profile screen (Settings → Character → Profile). Identity, progress snapshot, rewards & entitlements, quick actions. Optional selectedTitle.
v0.7.0
The Timelines — Anchor Timeline Selection System (multi-slot character account management) and Alchemy Skill activation.
v0.6.3
The Queue — Crafting Queue implementation (skilling and crafting consecutive tasks). WYWA Combat Report natively displaying defeated enemies.
Unreleased
Future updates (v0.6.4+).

Roadmap

From engine to endgame — every milestone is tracked and nothing is deleted from this history.

✓ Feb 25
v0.1.0: Foundation — Project scaffold, monorepo setup, engine package, Redux store, dark UI theme, 5 tab screens.
✓ Feb 26
v1.0.0: Persistence & Pipeline — Gradle, prebuild, Melvor palette, tabs. MMKV wired to AppState, local Android build pipeline, Jest test suite (25 passing).
✓ Feb 26
v1.1.0: Deployment & Fixes — Batch scripts, EXPO_ROUTER_APP_ROOT fix (Babel, metro, index proxy). EAS CLI via npx.
✓ Feb 26
v0.2.0: Pipeline & Gathering — Core loop, Mining (Copper–Cosmic), Skill Pillars, Total Level, XP tracking. State migration, Level Up Toast.
✓ Feb 27
v0.2.3: Horizon & Logging — 3-tier goal HUD, rare gems, mythic fish, Seasonal Rotation. Logging UI, Shop 50% sell, Curse system. Patch Notes, local APK fix.
✓ Mar 02
v0.2.6: Lore Expansion — Branching NPC dialogue, NPC interactions, quest ledger UI, narrative gating for skilling nodes.
✓ Mar 03
v0.3.0: The Big Update — Theme Engine, Quick-Switch Sidebar. Smithing, Forging. Quest step auto-complete, Mastery (spend points for +% XP). Random Events. Fishing, Runecrafting, Activity Log, Bank sort, Shop 25/50/Max, Settings, Idle Soundscapes. Easter egg "Don't Push This".
✓ Mar 03
Quest expansion — 18 story quests (Act I & II), step auto-complete, hand-in rewards.
✓ Mar 03
v0.4.0: Daily, Stats & Lumina — Daily quests, Stats tab, custom bank tabs, Sell All Junk, login bonus, Lumina UI.
✓ Mar 03
v0.4.1: The Anchor Man — Main character & nickname. Goblin first enemy + Peek modal. Cooking skill. Bestiary stub. Bank fix.
✓ Mar 06
v0.5.1: Extended Update Director's Cut Remix - Alpha — Consolidates versions 0.4.3 through 0.5.x. Harvesting, Scavenging, Herblore. OSRS Bank Redux. World Map exploration. Forging weapon expansion. Lumina Shop. Full auto-battler combat loop, HP regen, food eating, combat styles, enemy data, 20 mastery upgrades. Technical Tome, Midnight theme, and 16 achievements.
⚡ Next
Polishing Combat — Act III quests, radiant/repeatable quests. Alchemy, Auto-eating, UI improvements.
Phase 3
Crafting Engine — Queue system, Smithing, Alchemy, Cooking. Cross-skill dependencies. Active minigame multipliers.
Phase 4
Combat & Dungeons — 12 enemy factions, auto-combat vs. active mode, dungeon system (Delves, Expeditions), companion integration.
Phase 5
Connective Tissue — Character creation, support skills, companion system (Barnaby, Yvette, Reginald), quest engine.
Phase 6–7
Narrative & Economy — Main storyline (4 Acts), factions, Lumina shop, battle pass, login bonuses, push notifications.
Year 1+
Post-Launch — Guilds, PvP arena, The Shimmering Sea, Cosmic Skills, The Infinite Stair, Blibbertooth Festival.