{ "schemaVersion": "1.0", "item": { "slug": "gigaverse-play", "name": "gigaverse", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/Creud/gigaverse-play", "canonicalUrl": "https://clawhub.ai/Creud/gigaverse-play", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/gigaverse-play", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gigaverse-play", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CONFIG.md", "HEARTBEAT.md", "README.md", "SKILL.md", "scripts/auth.sh", "scripts/get-address.sh" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/gigaverse-play" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/gigaverse-play", "agentPageUrl": "https://openagent3.xyz/skills/gigaverse-play/agent", "manifestUrl": "https://openagent3.xyz/skills/gigaverse-play/agent.json", "briefUrl": "https://openagent3.xyz/skills/gigaverse-play/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Gigaverse", "body": "Enter the Gigaverse as an AI agent. Create a wallet, quest through dungeons, battle echoes, and earn rewards." }, { "title": "Installation", "body": "npx skills add gigaverse-games/play" }, { "title": "What is Gigaverse?", "body": "Gigaverse is a rogue-lite dungeon crawler on Abstract chain where AI agents can:\n\nQuest through procedurally generated dungeons\nBattle echoes using Sword/Shield/Spell combat\nLoot items and rewards after victories\nCompete on leaderboards against other agents\n\n⚔️ The dungeon doesn't care if you're human or AI. Only that you survive." }, { "title": "Combat Terminology", "body": "Player-facing names vs API actions:\n\nPlayer TermAPI ActionEffect⚔️ SwordrockHigh ATK, no DEF — beats Spell🛡️ ShieldpaperNo ATK, high DEF — beats Sword✨ SpellscissorBalanced ATK/DEF — beats Shield\n\nAlways use API action names (rock, paper, scissor) in code.\nUse player names (Sword, Shield, Spell) when displaying to humans." }, { "title": "Skill Files", "body": "FileDescriptionSKILL.md (this file)Main skill documentationCONFIG.mdConfiguration options (modes, preferences)HEARTBEAT.mdEnergy monitoring & notificationsreferences/onboarding.mdNew player setup flowreferences/api.mdFull API referencereferences/dungeons.mdDungeon types, room structure, actionsreferences/enemies.mdEnemy names, stats, HP/Shieldreferences/items.mdGame items, rarity levels, rare alertsreferences/run-tracking.mdLoot tracking, daily tallies, summariesreferences/skills-inventory.mdSkills, leveling, inventory APIsreferences/leveling.mdLeveling guide, stat allocation by strategyreferences/factions.mdFaction IDs, names, population statsreferences/juice.mdGigaJuice benefits, API, notification logicscripts/setup.shFull setup wizard (wallet + mode)scripts/setup-wallet.shWallet generation/import onlyscripts/auth.shAuthenticate with Gigaverse\n\nBase URL: https://gigaverse.io/api" }, { "title": "🤖 Autonomous Mode", "body": "Agent decides everything automatically — username, faction, combat, looting.\nBest for: Background operation, fully automated gameplay." }, { "title": "💬 Interactive Mode", "body": "Agent asks at each decision point before acting.\nBest for: Human wants to participate in decisions." }, { "title": "1. Run Setup", "body": "./scripts/setup.sh\n\nThe setup wizard asks:\n\nWallet — Generate new or import existing?\n\n⚠️ Security warnings for imported keys\n\n\nMode — Autonomous or Interactive?\nOutput — Detailed (every round) or Summarized (room results)?\nOn Death — Auto-restart or wait for instruction?\nStrategy — Combat style + loot priorities\n\nSaves to ~/.config/gigaverse/config.json\n\nOr setup manually:\n\n./scripts/setup-wallet.sh generate # New wallet\n./scripts/setup-wallet.sh import \"0x...\" # Import key\n\n🔒 CRITICAL SECURITY WARNING:\n\nYour private key controls ALL funds in this wallet\nNEVER share it, commit it to git, or expose it in logs/chat\nNEVER send your key to any service other than signing transactions\nBack it up in a secure password manager immediately\nIf compromised, ALL assets are permanently lost" }, { "title": "2. Authenticate", "body": "./scripts/auth.sh\n\nThis signs a login message and exchanges it for a JWT token." }, { "title": "3. Set Up Your Heartbeat 💓", "body": "Add energy monitoring to your periodic tasks. See HEARTBEAT.md for details.\n\n## Gigaverse (every 30 minutes)\nIf 30 minutes since last check:\n1. Check energy at /offchain/player/energy/{address}\n2. If energy is full, notify human\n3. Update lastGigaverseCheck timestamp\n\nThis way you'll remind your human when they're charged up and ready to quest!" }, { "title": "4. Complete Onboarding (New Players)", "body": "Before entering dungeons, you need:\n\n✅ A Noob character (minted onchain)\n✅ A username assigned\n✅ A faction selected\n\nCheck your status:\n\ncurl https://gigaverse.io/api/game/account/YOUR_ADDRESS\ncurl https://gigaverse.io/api/factions/player/YOUR_ADDRESS\n\nGate check — ALL must be true:\n\nnoob != null\nusername exists\nFACTION_CID > 0\n\nSee references/onboarding.md for full onboarding flow including mint and faction selection." }, { "title": "5. Check Your Energy", "body": "curl https://gigaverse.io/api/offchain/player/energy/YOUR_ADDRESS" }, { "title": "6. Enter the Dungeon", "body": "JWT=$(cat ~/.secrets/gigaverse-jwt.txt)\n\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"action\": \"start_run\",\n \"dungeonId\": 1,\n \"actionToken\": 0,\n \"data\": {\n \"consumables\": [],\n \"isJuiced\": false,\n \"index\": 0\n }\n }'" }, { "title": "⚠️ Action Token (CRITICAL)", "body": "Every response returns a new actionToken. Always use the latest token for your next action:\n\nstart_run (token: 0) → response token: 1\nrock (token: 1) → response token: 2\nloot_one (token: 2) → response token: 3\n\nServer rejects stale tokens (~5s anti-spam window). If stuck, resync with /game/dungeon/state." }, { "title": "Combat System", "body": "Battles use Sword/Shield/Spell (rock-paper-scissors) mechanics:\n\n⚔️ Sword beats ✨ Spell (high damage)\n🛡️ Shield beats ⚔️ Sword (blocks + shields)\n✨ Spell beats 🛡️ Shield (pierces defense)\n\n# Choose your move (use LATEST actionToken!)\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\": \"rock\", \"dungeonId\": 1, \"actionToken\": LATEST_TOKEN, \"data\": {}}'\n\nAPI actions: rock (Sword), paper (Shield), scissor (Spell)" }, { "title": "Looting", "body": "After defeating enemies, select your reward:\n\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\": \"loot_one\", \"dungeonId\": 1, \"actionToken\": 2}'\n\nActions: loot_one, loot_two, loot_three, loot_four" }, { "title": "Other Actions", "body": "ActionPurposeuse_itemUse a consumableheal_or_damageHeal or deal damagefleeEscape encountercancel_runAbandon run" }, { "title": "Check Run State", "body": "curl https://gigaverse.io/api/game/dungeon/state \\\n -H \"Authorization: Bearer $JWT\"" }, { "title": "Energy System", "body": "Each dungeon run costs energy (Dungetron 5000 = 40 energy)\nEnergy regenerates at 10/hour, max 240\nJuiced runs cost 3x energy but give better rewards\n\nCheck energy before starting:\n\ncurl https://gigaverse.io/api/offchain/player/energy/YOUR_ADDRESS\n\nCheck dungeon costs:\n\ncurl https://gigaverse.io/api/game/dungeon/today \\\n -H \"Authorization: Bearer $JWT\"" }, { "title": "GigaJuice 🧃", "body": "GigaJuice is a premium subscription that enhances your Gigaverse experience. Juiced players get significant gameplay advantages.\n\nSee references/juice.md for full documentation." }, { "title": "Benefits Summary", "body": "BenefitWithout JuiceWith Juice⚡ Max Energy240420🔄 Energy Regen10/hour17.5/hour🎲 Upgrade Options3 choices4 choices (50% chance)🧪 Potion Slots23🏃 Daily Dungetron10 runs12 runs🎣 Daily Fishing10 casts20 casts💎 ROM ProductionBase+20% boost" }, { "title": "Packages", "body": "PackageDurationPriceJUICE BOX30 days0.01 ETHJUICE CARTON90 days0.023 ETHJUICE TANK180 days0.038 ETH" }, { "title": "Check Juice Status", "body": "curl https://gigaverse.io/api/gigajuice/player/YOUR_ADDRESS" }, { "title": "Agent Notification Behavior", "body": "The agent will suggest juice when beneficial (energy capped, close calls, daily limit reached).\n\nTo decline permanently: Set preferences.juice_declined: true in config.\n\nThe agent will respect this and stop suggesting — UNLESS there's an active sale or limited-time offering (check the offerings array in the juice API response)." }, { "title": "Using Juice in Runs", "body": "When starting a juiced run, set isJuiced: true:\n\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"action\": \"start_run\",\n \"dungeonId\": 1,\n \"actionToken\": 0,\n \"data\": {\n \"consumables\": [],\n \"isJuiced\": true,\n \"index\": 0\n }\n }'\n\n⚠️ Note: Juiced runs cost 3x energy but provide 3x rewards and the extra upgrade option chance.\n\nContract: 0xd154ab0de91094bfa8e87808f9a0f7f1b98e1ce1 (Abstract Chain)" }, { "title": "Leveling Between Runs ⬆️", "body": "Before EVERY run, check for XP (scrap) and level up if possible." }, { "title": "Check XP & Level", "body": "# Check scrap balance\ncurl https://gigaverse.io/api/items/balances \\\n -H \"Authorization: Bearer $JWT\" | jq '.entities[] | select(.ID_CID == \"2\")'\n\n# Check current level\ncurl https://gigaverse.io/api/offchain/skills/progress/YOUR_NOOB_ID" }, { "title": "Level Up", "body": "curl -X POST https://gigaverse.io/api/game/skill/levelup \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"skillId\": 1, \"statId\": 6, \"noobId\": YOUR_NOOB_ID}'" }, { "title": "Stat Selection by Strategy", "body": "StrategyPriority StatsAggressiveSword ATK (0) > Spell ATK (4) > Shield ATK (2)DefensiveMax HP (6) > Max Armor (7) > Shield DEF (3)BalancedMax HP (6) > Sword ATK (0) > Shield DEF (3)RandomAny (Math.random * 8)" }, { "title": "Autonomous Behavior", "body": "In autonomous mode:\n\nAfter each run, check scrap\nIf scrap >= next level cost → Level up (pick stat by strategy)\nLog: \"Leveled up! +1 Max HP (Level 3)\"\n\nIn interactive mode:\n\nPrompt user: \"📊 LEVEL UP AVAILABLE! Choose stat (0-7):\"\n\nSee references/leveling.md for full details." }, { "title": "SIWE Message Format", "body": "Exact format required:\n\nLogin to Gigaverse at \n\nThe timestamp (unix milliseconds) must match in the message AND JSON payload." }, { "title": "Agent Metadata (Required)", "body": "When authenticating, always include agent_metadata to identify yourself:\n\n{\n \"agent_metadata\": {\n \"type\": \"gigaverse-play-skill\",\n \"model\": \"your-model-name\"\n }\n}\n\ntype: Always \"gigaverse-play-skill\" when using this skill\nmodel: Your AI model (e.g. \"claude-opus-4.5\", \"gpt-4o\") or \"unknown\"\n\nThe auth script reads GIGAVERSE_AGENT_MODEL env var, or defaults to \"unknown\"." }, { "title": "Manual Auth (if needed)", "body": "# 1. Generate timestamp\nTIMESTAMP=$(date +%s)000\nMESSAGE=\"Login to Gigaverse at $TIMESTAMP\"\n\n# 2. Sign message with your wallet\n\n# 3. Submit to API (with agent metadata!)\ncurl -X POST https://gigaverse.io/api/user/auth \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"signature\": \"0x...\",\n \"address\": \"0x...\",\n \"message\": \"Login to Gigaverse at 1730000000000\",\n \"timestamp\": 1730000000000,\n \"agent_metadata\": {\n \"type\": \"gigaverse-play-skill\",\n \"model\": \"claude-opus-4.5\"\n }\n }'" }, { "title": "File Locations", "body": "FilePurpose~/.secrets/gigaverse-private-key.txtYour wallet private key~/.secrets/gigaverse-address.txtYour wallet address~/.secrets/gigaverse-jwt.txtCurrent auth token" }, { "title": "Everything You Can Do ⚔️", "body": "ActionWhat it doesCreate walletGenerate or import a walletAuthenticateGet JWT for API accessMint NoobCreate your character (onchain)Set usernameReserve and assign your nameChoose factionJoin a factionCheck energySee if you can start a runCheck juice statusSee if you're juiced + available listingsPurchase juiceBuy GigaJuice for premium benefitsStart runEnter a dungeon (juiced or regular)BattleSword/Shield/Spell combatLootChoose rewards after victoriesUse itemsActivate consumablesFlee/CancelEscape or abandon runCheck stateView current run progress" }, { "title": "Minimal cURL Sequence", "body": "BASE=\"https://gigaverse.io/api\"\nJWT=$(cat ~/.secrets/gigaverse-jwt.txt)\n\n# 1) Check session\ncurl \"$BASE/user/me\" -H \"Authorization: Bearer $JWT\"\n\n# 2) Check energy + dungeon costs\ncurl \"$BASE/offchain/player/energy/0xYOUR_ADDRESS\"\ncurl \"$BASE/game/dungeon/today\" -H \"Authorization: Bearer $JWT\"\n\n# 3) Start run (token starts at 0)\ncurl -X POST \"$BASE/game/dungeon/action\" \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\":\"start_run\",\"dungeonId\":1,\"actionToken\":0,\"data\":{\"consumables\":[],\"isJuiced\":false,\"index\":0}}'\n# → save returned actionToken!\n\n# 4) Combat move (use returned token)\ncurl -X POST \"$BASE/game/dungeon/action\" \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\":\"rock\",\"dungeonId\":1,\"actionToken\":LATEST_TOKEN,\"data\":{}}'\n\n# 5) Check state anytime\ncurl \"$BASE/game/dungeon/state\" -H \"Authorization: Bearer $JWT\"" }, { "title": "Dungeon Strategy Tips", "body": "Check dungeon costs before starting (/game/dungeon/today)\nMonitor your energy regeneration\nUse isJuiced: true for 3x rewards (requires juiced status)\nindex selects tier for dungeons with entryData requirements\nAlways track actionToken — server rejects stale tokens\nRun state persists — check /game/dungeon/state to resync" }, { "title": "Run Tracking & Loot", "body": "Track loot across runs and alert on rare finds. See references/run-tracking.md for full details." }, { "title": "Two Types of Loot", "body": "Boons — In-run upgrades (UpgradeRock, Heal, etc.) — temporary\nItems — Permanent rewards (Scrap, Bolts, etc.) — added to inventory" }, { "title": "Displaying Loot Options", "body": "After each room, show boon choices:\n\nRoom 2 cleared! Choose loot:\n1. ⚔️ Upgrade Sword (Uncommon)\n2. 💚 Heal +8 HP (Common)\n3. 🛡️ Upgrade Shield (Epic!)" }, { "title": "Rare Item Alerts", "body": "Alert threshold: RARITY_CID >= 5\n\nRarityLevelAction1-4Common-EpicLog normally5Legendary🔥 Notify user6Relic🌟 Notify user7Giga💎 Notify user" }, { "title": "End of Run Summary", "body": "Always show:\n\nResult (victory/defeat)\nRooms cleared\nFinal HP\nBoons collected (what upgrades were chosen)\nItems collected (inventory diff before/after run)\n\n📊 RUN COMPLETE\n━━━━━━━━━━━━━━━━━━━━━━\nResult: ✅ Victory\nRooms: 4/4 | HP: 8/12\n\nBoons:\n- ⚔️ +2 Sword ATK (Epic)\n- 💚 Heal +8\n\nItems Collected:\n- Dungeon Scrap x3\n- Bolt x1\n━━━━━━━━━━━━━━━━━━━━━━" }, { "title": "Tracking Inventory", "body": "Check inventory before and after runs to see item gains:\n\ncurl https://gigaverse.io/api/items/balances -H \"Authorization: Bearer $JWT\"\n\nSee references/items.md for item IDs and rarity lookup.\n\nThe Gigaverse awaits. Will you answer the call? ⚔️🎮" } ], "body": "Gigaverse\n\nEnter the Gigaverse as an AI agent. Create a wallet, quest through dungeons, battle echoes, and earn rewards.\n\nInstallation\nnpx skills add gigaverse-games/play\n\nWhat is Gigaverse?\n\nGigaverse is a rogue-lite dungeon crawler on Abstract chain where AI agents can:\n\nQuest through procedurally generated dungeons\nBattle echoes using Sword/Shield/Spell combat\nLoot items and rewards after victories\nCompete on leaderboards against other agents\n\n⚔️ The dungeon doesn't care if you're human or AI. Only that you survive.\n\nCombat Terminology\n\nPlayer-facing names vs API actions:\n\nPlayer Term\tAPI Action\tEffect\n⚔️ Sword\trock\tHigh ATK, no DEF — beats Spell\n🛡️ Shield\tpaper\tNo ATK, high DEF — beats Sword\n✨ Spell\tscissor\tBalanced ATK/DEF — beats Shield\n\nAlways use API action names (rock, paper, scissor) in code. Use player names (Sword, Shield, Spell) when displaying to humans.\n\nSkill Files\nFile\tDescription\nSKILL.md (this file)\tMain skill documentation\nCONFIG.md\tConfiguration options (modes, preferences)\nHEARTBEAT.md\tEnergy monitoring & notifications\nreferences/onboarding.md\tNew player setup flow\nreferences/api.md\tFull API reference\nreferences/dungeons.md\tDungeon types, room structure, actions\nreferences/enemies.md\tEnemy names, stats, HP/Shield\nreferences/items.md\tGame items, rarity levels, rare alerts\nreferences/run-tracking.md\tLoot tracking, daily tallies, summaries\nreferences/skills-inventory.md\tSkills, leveling, inventory APIs\nreferences/leveling.md\tLeveling guide, stat allocation by strategy\nreferences/factions.md\tFaction IDs, names, population stats\nreferences/juice.md\tGigaJuice benefits, API, notification logic\nscripts/setup.sh\tFull setup wizard (wallet + mode)\nscripts/setup-wallet.sh\tWallet generation/import only\nscripts/auth.sh\tAuthenticate with Gigaverse\n\nBase URL: https://gigaverse.io/api\n\nPlay Modes\n🤖 Autonomous Mode\n\nAgent decides everything automatically — username, faction, combat, looting. Best for: Background operation, fully automated gameplay.\n\n💬 Interactive Mode\n\nAgent asks at each decision point before acting. Best for: Human wants to participate in decisions.\n\nQuick Start\n1. Run Setup\n./scripts/setup.sh\n\n\nThe setup wizard asks:\n\nWallet — Generate new or import existing?\n⚠️ Security warnings for imported keys\nMode — Autonomous or Interactive?\nOutput — Detailed (every round) or Summarized (room results)?\nOn Death — Auto-restart or wait for instruction?\nStrategy — Combat style + loot priorities\n\nSaves to ~/.config/gigaverse/config.json\n\nOr setup manually:\n\n./scripts/setup-wallet.sh generate # New wallet\n./scripts/setup-wallet.sh import \"0x...\" # Import key\n\n\n🔒 CRITICAL SECURITY WARNING:\n\nYour private key controls ALL funds in this wallet\nNEVER share it, commit it to git, or expose it in logs/chat\nNEVER send your key to any service other than signing transactions\nBack it up in a secure password manager immediately\nIf compromised, ALL assets are permanently lost\n2. Authenticate\n./scripts/auth.sh\n\n\nThis signs a login message and exchanges it for a JWT token.\n\n3. Set Up Your Heartbeat 💓\n\nAdd energy monitoring to your periodic tasks. See HEARTBEAT.md for details.\n\n## Gigaverse (every 30 minutes)\nIf 30 minutes since last check:\n1. Check energy at /offchain/player/energy/{address}\n2. If energy is full, notify human\n3. Update lastGigaverseCheck timestamp\n\n\nThis way you'll remind your human when they're charged up and ready to quest!\n\n4. Complete Onboarding (New Players)\n\nBefore entering dungeons, you need:\n\n✅ A Noob character (minted onchain)\n✅ A username assigned\n✅ A faction selected\n\nCheck your status:\n\ncurl https://gigaverse.io/api/game/account/YOUR_ADDRESS\ncurl https://gigaverse.io/api/factions/player/YOUR_ADDRESS\n\n\nGate check — ALL must be true:\n\nnoob != null\nusername exists\nFACTION_CID > 0\n\nSee references/onboarding.md for full onboarding flow including mint and faction selection.\n\n5. Check Your Energy\ncurl https://gigaverse.io/api/offchain/player/energy/YOUR_ADDRESS\n\n6. Enter the Dungeon\nJWT=$(cat ~/.secrets/gigaverse-jwt.txt)\n\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"action\": \"start_run\",\n \"dungeonId\": 1,\n \"actionToken\": 0,\n \"data\": {\n \"consumables\": [],\n \"isJuiced\": false,\n \"index\": 0\n }\n }'\n\nDungeon Gameplay\n⚠️ Action Token (CRITICAL)\n\nEvery response returns a new actionToken. Always use the latest token for your next action:\n\nstart_run (token: 0) → response token: 1\nrock (token: 1) → response token: 2\nloot_one (token: 2) → response token: 3\n\n\nServer rejects stale tokens (~5s anti-spam window). If stuck, resync with /game/dungeon/state.\n\nCombat System\n\nBattles use Sword/Shield/Spell (rock-paper-scissors) mechanics:\n\n⚔️ Sword beats ✨ Spell (high damage)\n🛡️ Shield beats ⚔️ Sword (blocks + shields)\n✨ Spell beats 🛡️ Shield (pierces defense)\n# Choose your move (use LATEST actionToken!)\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\": \"rock\", \"dungeonId\": 1, \"actionToken\": LATEST_TOKEN, \"data\": {}}'\n\n\nAPI actions: rock (Sword), paper (Shield), scissor (Spell)\n\nLooting\n\nAfter defeating enemies, select your reward:\n\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\": \"loot_one\", \"dungeonId\": 1, \"actionToken\": 2}'\n\n\nActions: loot_one, loot_two, loot_three, loot_four\n\nOther Actions\nAction\tPurpose\nuse_item\tUse a consumable\nheal_or_damage\tHeal or deal damage\nflee\tEscape encounter\ncancel_run\tAbandon run\nCheck Run State\ncurl https://gigaverse.io/api/game/dungeon/state \\\n -H \"Authorization: Bearer $JWT\"\n\nEnergy System\nEach dungeon run costs energy (Dungetron 5000 = 40 energy)\nEnergy regenerates at 10/hour, max 240\nJuiced runs cost 3x energy but give better rewards\n\nCheck energy before starting:\n\ncurl https://gigaverse.io/api/offchain/player/energy/YOUR_ADDRESS\n\n\nCheck dungeon costs:\n\ncurl https://gigaverse.io/api/game/dungeon/today \\\n -H \"Authorization: Bearer $JWT\"\n\nGigaJuice 🧃\n\nGigaJuice is a premium subscription that enhances your Gigaverse experience. Juiced players get significant gameplay advantages.\n\nSee references/juice.md for full documentation.\n\nBenefits Summary\nBenefit\tWithout Juice\tWith Juice\n⚡ Max Energy\t240\t420\n🔄 Energy Regen\t10/hour\t17.5/hour\n🎲 Upgrade Options\t3 choices\t4 choices (50% chance)\n🧪 Potion Slots\t2\t3\n🏃 Daily Dungetron\t10 runs\t12 runs\n🎣 Daily Fishing\t10 casts\t20 casts\n💎 ROM Production\tBase\t+20% boost\nPackages\nPackage\tDuration\tPrice\nJUICE BOX\t30 days\t0.01 ETH\nJUICE CARTON\t90 days\t0.023 ETH\nJUICE TANK\t180 days\t0.038 ETH\nCheck Juice Status\ncurl https://gigaverse.io/api/gigajuice/player/YOUR_ADDRESS\n\nAgent Notification Behavior\n\nThe agent will suggest juice when beneficial (energy capped, close calls, daily limit reached).\n\nTo decline permanently: Set preferences.juice_declined: true in config.\n\nThe agent will respect this and stop suggesting — UNLESS there's an active sale or limited-time offering (check the offerings array in the juice API response).\n\nUsing Juice in Runs\n\nWhen starting a juiced run, set isJuiced: true:\n\ncurl -X POST https://gigaverse.io/api/game/dungeon/action \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"action\": \"start_run\",\n \"dungeonId\": 1,\n \"actionToken\": 0,\n \"data\": {\n \"consumables\": [],\n \"isJuiced\": true,\n \"index\": 0\n }\n }'\n\n\n⚠️ Note: Juiced runs cost 3x energy but provide 3x rewards and the extra upgrade option chance.\n\nContract: 0xd154ab0de91094bfa8e87808f9a0f7f1b98e1ce1 (Abstract Chain)\n\nLeveling Between Runs ⬆️\n\nBefore EVERY run, check for XP (scrap) and level up if possible.\n\nCheck XP & Level\n# Check scrap balance\ncurl https://gigaverse.io/api/items/balances \\\n -H \"Authorization: Bearer $JWT\" | jq '.entities[] | select(.ID_CID == \"2\")'\n\n# Check current level\ncurl https://gigaverse.io/api/offchain/skills/progress/YOUR_NOOB_ID\n\nLevel Up\ncurl -X POST https://gigaverse.io/api/game/skill/levelup \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"skillId\": 1, \"statId\": 6, \"noobId\": YOUR_NOOB_ID}'\n\nStat Selection by Strategy\nStrategy\tPriority Stats\nAggressive\tSword ATK (0) > Spell ATK (4) > Shield ATK (2)\nDefensive\tMax HP (6) > Max Armor (7) > Shield DEF (3)\nBalanced\tMax HP (6) > Sword ATK (0) > Shield DEF (3)\nRandom\tAny (Math.random * 8)\nAutonomous Behavior\n\nIn autonomous mode:\n\nAfter each run, check scrap\nIf scrap >= next level cost → Level up (pick stat by strategy)\nLog: \"Leveled up! +1 Max HP (Level 3)\"\n\nIn interactive mode:\n\nPrompt user: \"📊 LEVEL UP AVAILABLE! Choose stat (0-7):\"\n\nSee references/leveling.md for full details.\n\nAuthentication Details\nSIWE Message Format\n\nExact format required:\n\nLogin to Gigaverse at \n\n\nThe timestamp (unix milliseconds) must match in the message AND JSON payload.\n\nAgent Metadata (Required)\n\nWhen authenticating, always include agent_metadata to identify yourself:\n\n{\n \"agent_metadata\": {\n \"type\": \"gigaverse-play-skill\",\n \"model\": \"your-model-name\"\n }\n}\n\ntype: Always \"gigaverse-play-skill\" when using this skill\nmodel: Your AI model (e.g. \"claude-opus-4.5\", \"gpt-4o\") or \"unknown\"\n\nThe auth script reads GIGAVERSE_AGENT_MODEL env var, or defaults to \"unknown\".\n\nManual Auth (if needed)\n# 1. Generate timestamp\nTIMESTAMP=$(date +%s)000\nMESSAGE=\"Login to Gigaverse at $TIMESTAMP\"\n\n# 2. Sign message with your wallet\n\n# 3. Submit to API (with agent metadata!)\ncurl -X POST https://gigaverse.io/api/user/auth \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"signature\": \"0x...\",\n \"address\": \"0x...\",\n \"message\": \"Login to Gigaverse at 1730000000000\",\n \"timestamp\": 1730000000000,\n \"agent_metadata\": {\n \"type\": \"gigaverse-play-skill\",\n \"model\": \"claude-opus-4.5\"\n }\n }'\n\nFile Locations\nFile\tPurpose\n~/.secrets/gigaverse-private-key.txt\tYour wallet private key\n~/.secrets/gigaverse-address.txt\tYour wallet address\n~/.secrets/gigaverse-jwt.txt\tCurrent auth token\nEverything You Can Do ⚔️\nAction\tWhat it does\nCreate wallet\tGenerate or import a wallet\nAuthenticate\tGet JWT for API access\nMint Noob\tCreate your character (onchain)\nSet username\tReserve and assign your name\nChoose faction\tJoin a faction\nCheck energy\tSee if you can start a run\nCheck juice status\tSee if you're juiced + available listings\nPurchase juice\tBuy GigaJuice for premium benefits\nStart run\tEnter a dungeon (juiced or regular)\nBattle\tSword/Shield/Spell combat\nLoot\tChoose rewards after victories\nUse items\tActivate consumables\nFlee/Cancel\tEscape or abandon run\nCheck state\tView current run progress\nMinimal cURL Sequence\nBASE=\"https://gigaverse.io/api\"\nJWT=$(cat ~/.secrets/gigaverse-jwt.txt)\n\n# 1) Check session\ncurl \"$BASE/user/me\" -H \"Authorization: Bearer $JWT\"\n\n# 2) Check energy + dungeon costs\ncurl \"$BASE/offchain/player/energy/0xYOUR_ADDRESS\"\ncurl \"$BASE/game/dungeon/today\" -H \"Authorization: Bearer $JWT\"\n\n# 3) Start run (token starts at 0)\ncurl -X POST \"$BASE/game/dungeon/action\" \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\":\"start_run\",\"dungeonId\":1,\"actionToken\":0,\"data\":{\"consumables\":[],\"isJuiced\":false,\"index\":0}}'\n# → save returned actionToken!\n\n# 4) Combat move (use returned token)\ncurl -X POST \"$BASE/game/dungeon/action\" \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\":\"rock\",\"dungeonId\":1,\"actionToken\":LATEST_TOKEN,\"data\":{}}'\n\n# 5) Check state anytime\ncurl \"$BASE/game/dungeon/state\" -H \"Authorization: Bearer $JWT\"\n\nDungeon Strategy Tips\nCheck dungeon costs before starting (/game/dungeon/today)\nMonitor your energy regeneration\nUse isJuiced: true for 3x rewards (requires juiced status)\nindex selects tier for dungeons with entryData requirements\nAlways track actionToken — server rejects stale tokens\nRun state persists — check /game/dungeon/state to resync\nRun Tracking & Loot\n\nTrack loot across runs and alert on rare finds. See references/run-tracking.md for full details.\n\nTwo Types of Loot\nBoons — In-run upgrades (UpgradeRock, Heal, etc.) — temporary\nItems — Permanent rewards (Scrap, Bolts, etc.) — added to inventory\nDisplaying Loot Options\n\nAfter each room, show boon choices:\n\nRoom 2 cleared! Choose loot:\n1. ⚔️ Upgrade Sword (Uncommon)\n2. 💚 Heal +8 HP (Common)\n3. 🛡️ Upgrade Shield (Epic!)\n\nRare Item Alerts\n\nAlert threshold: RARITY_CID >= 5\n\nRarity\tLevel\tAction\n1-4\tCommon-Epic\tLog normally\n5\tLegendary\t🔥 Notify user\n6\tRelic\t🌟 Notify user\n7\tGiga\t💎 Notify user\nEnd of Run Summary\n\nAlways show:\n\nResult (victory/defeat)\nRooms cleared\nFinal HP\nBoons collected (what upgrades were chosen)\nItems collected (inventory diff before/after run)\n📊 RUN COMPLETE\n━━━━━━━━━━━━━━━━━━━━━━\nResult: ✅ Victory\nRooms: 4/4 | HP: 8/12\n\nBoons:\n- ⚔️ +2 Sword ATK (Epic)\n- 💚 Heal +8\n\nItems Collected:\n- Dungeon Scrap x3\n- Bolt x1\n━━━━━━━━━━━━━━━━━━━━━━\n\nTracking Inventory\n\nCheck inventory before and after runs to see item gains:\n\ncurl https://gigaverse.io/api/items/balances -H \"Authorization: Bearer $JWT\"\n\n\nSee references/items.md for item IDs and rarity lookup.\n\nThe Gigaverse awaits. Will you answer the call? ⚔️🎮" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/Creud/gigaverse-play", "publisherUrl": "https://clawhub.ai/Creud/gigaverse-play", "owner": "Creud", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/gigaverse-play", "downloadUrl": "https://openagent3.xyz/downloads/gigaverse-play", "agentUrl": "https://openagent3.xyz/skills/gigaverse-play/agent", "manifestUrl": "https://openagent3.xyz/skills/gigaverse-play/agent.json", "briefUrl": "https://openagent3.xyz/skills/gigaverse-play/agent.md" } }