Add explicit camp rest option

Author: web3blind

app/index.html

@@ -120,8 +120,8 @@
     <script src="js/config.js?v=20260712a"></script>
 
     <!-- I18n -->
-    <script src="js/i18n/ru.js?v=20260713a"></script>
-    <script src="js/i18n/en.js?v=20260713a"></script>
+    <script src="js/i18n/ru.js?v=20260713b"></script>
+    <script src="js/i18n/en.js?v=20260713b"></script>
 
     <!-- Utilities -->
     <script src="js/utils/helpers.js?v=20260621l"></script>
@@ -132,7 +132,7 @@
     <script src="js/blockchain/connection.js"></script>
     <script src="js/blockchain/account.js"></script>
     <script src="js/blockchain/history-source.js?v=20260621d"></script>
-    <script src="js/blockchain/broadcast.js?v=20260712b"></script>
+    <script src="js/blockchain/broadcast.js?v=20260713a"></script>
     <script src="js/blockchain/invite.js"></script>
 
     <!-- Protocols -->
@@ -170,7 +170,7 @@
     <script src="js/engine/quest-system.js?v=20260621e"></script>
     <script src="js/engine/loci.js"></script>
     <script src="js/engine/npc-framework.js"></script>
-    <script src="js/engine/state-engine.js?v=20260712c"></script>
+    <script src="js/engine/state-engine.js?v=20260713b"></script>
     <script src="js/engine/daily-leaderboard-storage.js"></script>
     <script src="js/engine/daily-leaderboard.js"></script>
 
@@ -188,7 +188,7 @@
     <script src="js/ui/screens/onboarding.js"></script>
     <script src="js/ui/screens/home.js?v=20260713a"></script>
     <script src="js/ui/screens/character.js?v=20260713a"></script>
-    <script src="js/ui/screens/hunt.js"></script>
+    <script src="js/ui/screens/hunt.js?v=20260713b"></script>
     <script src="js/ui/screens/inventory.js?v=20260621l"></script>
     <script src="js/ui/screens/chronicle.js?v=20260712a"></script>
     <script src="js/ui/screens/duel.js"></script>

app/js/blockchain/broadcast.js

@@ -253,6 +253,17 @@ var VizBroadcast = (function() {
         }, callback);
     }
 
+    /**
+     * Rest at camp: restore HP through a normal VM action.
+     * @param {Function} callback
+     */
+    function restAction(callback) {
+        gameAction({
+            t: cfg.ACTION_TYPES.REST,
+            d: {}
+        }, callback);
+    }
+
     /**
      * Update account metadata (Grimoire)
      * @param {string} jsonMetadata - JSON string
@@ -343,6 +354,7 @@ var VizBroadcast = (function() {
         armageddonAction: armageddonAction,
         templeOffering: templeOffering,
         questAction: questAction,
+        restAction: restAction,
         updateMetadata: updateMetadata,
         chroniclePost: chroniclePost,
         delegateShares: delegateShares,

app/js/engine/state-engine.js

@@ -1407,6 +1407,18 @@ var StateEngine = (function() {
         return events[0];
     }
 
+    /**
+     * Process rest for live UI — same authoritative mutation path as replay.
+     * @param {string} account
+     * @param {number} blockNum
+     * @returns {Object|null}
+     */
+    function processRestResult(account, blockNum) {
+        var events = _handleRest(account, blockNum || 0);
+        if (!events.length) return null;
+        return events[0];
+    }
+
     /**
      * Process crafting for live UI — same authoritative mutation path as replay.
      * @param {string} account
@@ -1507,6 +1519,7 @@ var StateEngine = (function() {
         getTempleBlessing: getTempleBlessing,
         processHuntResult: processHuntResult,
         processMoveResult: processMoveResult,
+        processRestResult: processRestResult,
         processCraftResult: processCraftResult,
         processMarketListResult: processMarketListResult,
         processMarketCancelResult: processMarketCancelResult,

app/js/i18n/en.js

@@ -167,6 +167,14 @@ var LangEN = {
     stat_for: 'Fortune',
 
     // Hunt
+    hunt_rest_title: 'Rest at camp',
+    hunt_rest_desc: 'Safe rest fully restores HP before the next hunt.',
+    hunt_rest_hp_now: 'Current: {hp} HP.',
+    hunt_rest_button: 'Rest at camp and restore HP',
+    hunt_rest_full: 'HP already full',
+    hunt_rest_pending: 'Recording camp rest in the World...',
+    hunt_rest_success: 'You rested at camp. HP is fully restored.',
+    hunt_rest_error: 'Could not record rest. Check the World connection and try again.',
     hunt_title: 'Hunt',
     hunt_choose_creature: 'Choose your prey',
     hunt_no_creatures_here: 'There are currently no huntable creatures in this location.',
@@ -1064,7 +1072,7 @@ var LangEN = {
     help_mana_text: 'Mana is your energy (0–100%). Every spell costs mana. Full regeneration takes ~5 days. Shown as a percentage — 1.00% = 100 basis points on the blockchain.',
 
     help_section_hp: 'HP & Recovery',
-    help_hp_text: 'HP is your health. Max HP grows from your level, class, and Resilience: base 100 + level × 10 + RES × 3, then your class multiplier is applied. It does not regenerate automatically to full — passive regen slowly restores up to 30% of your max HP (+1 HP every 100 blocks, ~5 min). Full recovery: visit the Hunt screen (camp rest) or use a Health Scroll (craftable or dropped by creatures).',
+    help_hp_text: 'HP is your health. Max HP grows from your level, class, and Resilience: base 100 + level × 10 + RES × 3, then your class multiplier is applied. It does not regenerate automatically to full — passive regen slowly restores up to 30% of your max HP (+1 HP every 100 blocks, ~5 min). Full recovery: open the Hunt screen and press “Rest at camp”, or use a Health Scroll (craftable or dropped by creatures).',
 
     help_section_quests: 'Quests & Prophecies',
     help_quests_text: 'Regular quests are accepted in the Quests screen. “Traveler” currently means visiting 3 different regions via the world map — open the map, choose another region, and press “Travel”. The Daily Prophecy must also be accepted first, then completed. If it tells you to bless others, do that in the Chronicle with the “Bless” button on other mages\' entries.',

app/js/i18n/ru.js

@@ -167,6 +167,14 @@ var LangRU = {
     stat_for: 'Удача',
 
     // Hunt
+    hunt_rest_title: 'Отдых у костра',
+    hunt_rest_desc: 'Безопасный отдых полностью восстанавливает HP перед следующей охотой.',
+    hunt_rest_hp_now: 'Сейчас: {hp} HP.',
+    hunt_rest_button: 'Отдохнуть у костра и восстановить HP',
+    hunt_rest_full: 'HP уже полное',
+    hunt_rest_pending: 'Отдых у костра записывается в Мир...',
+    hunt_rest_success: 'Вы отдохнули у костра. HP восстановлено полностью.',
+    hunt_rest_error: 'Не удалось записать отдых. Проверьте связь с Миром и попробуйте ещё раз.',
     hunt_title: 'Охота',
     hunt_choose_creature: 'Выбери добычу',
     hunt_no_creatures_here: 'В этой локации сейчас нет доступной добычи для охоты.',
@@ -1064,7 +1072,7 @@ var LangRU = {
     help_mana_text: 'Мана — ваша энергия (0–100%). Каждое заклинание тратит ману. Полное восстановление занимает ~5 дней. Отображается в процентах — 1.00% = 100 базисных пунктов в блокчейне.',
 
     help_section_hp: 'HP и Восстановление',
-    help_hp_text: 'HP — ваше здоровье. Максимум HP растёт от уровня, класса и Стойкости (Resilience): базово 100 + уровень × 10 + RES × 3, затем применяется модификатор класса. До максимума здоровье само не восстанавливается — пассивная регенерация возвращает до 30% от максимума (+1 HP каждые 100 блоков, ~5 мин). Полное восстановление: зайди на экран Охоты (отдых в лагере) или используй Свиток Здоровья (крафтится или падает с существ).',
+    help_hp_text: 'HP — ваше здоровье. Максимум HP растёт от уровня, класса и Стойкости (Resilience): базово 100 + уровень × 10 + RES × 3, затем применяется модификатор класса. До максимума здоровье само не восстанавливается — пассивная регенерация возвращает до 30% от максимума (+1 HP каждые 100 блоков, ~5 мин). Полное восстановление: открой экран Охоты и нажми «Отдых у костра» или используй Свиток Здоровья (крафтится или падает с существ).',
 
     help_section_quests: 'Задания и Пророчества',
     help_quests_text: 'Обычные задания берутся во вкладке Задания. «Путешественник» сейчас означает: посетить 3 разных региона через карту мира — откройте карту, выберите другой регион и нажмите «Путешествие». Ежедневное Пророчество тоже нужно сначала принять, а затем выполнить его цель. Если в цели сказано благословлять — это делается в Хронике кнопкой «Благословить» у записей других магов.',

app/js/ui/screens/hunt.js

@@ -31,8 +31,17 @@ var HuntScreen = (function() {
         selectedCreature = null;
         selectedSpell = null;
 
+        var needsRest = ch && ch.maxHp && ch.hp < ch.maxHp;
+        var hpText = ch && ch.maxHp ? (Helpers.formatNumber(ch.hp || 0) + ' / ' + Helpers.formatNumber(ch.maxHp)) : '';
         var html = '<div class="hunt-screen">' +
             '<h1>' + t('hunt_title') + '</h1>' +
+            '<section class="hunt-rest-section" aria-label="' + t('hunt_rest_title') + '">' +
+                '<h2>⛺ ' + t('hunt_rest_title') + '</h2>' +
+                '<p class="quest-desc">' + t('hunt_rest_desc') + (hpText ? ' ' + t('hunt_rest_hp_now', {hp: hpText}) : '') + '</p>' +
+                '<button class="btn btn-secondary" id="btn-rest-camp" type="button"' + (needsRest ? '' : ' disabled') + '>' +
+                    (needsRest ? t('hunt_rest_button') : t('hunt_rest_full')) +
+                '</button>' +
+            '</section>' +
             '<h2>' + t('hunt_choose_creature') + '</h2>';
 
         if (!creatures.length) {
@@ -143,6 +152,11 @@ var HuntScreen = (function() {
 
         Helpers.$('btn-attack').addEventListener('click', _doHunt);
 
+        var restBtn = Helpers.$('btn-rest-camp');
+        if (restBtn) {
+            restBtn.addEventListener('click', _doRest);
+        }
+
         var returnBtn = Helpers.$('btn-return-commons');
         if (returnBtn) {
             returnBtn.addEventListener('click', function() {
@@ -177,6 +191,39 @@ var HuntScreen = (function() {
         Helpers.$('btn-attack').disabled = !(selectedCreature && selectedSpell);
     }
 
+    function _doRest() {
+        var t = Helpers.t;
+        var resultEl = Helpers.$('hunt-result');
+        var btn = Helpers.$('btn-rest-camp');
+        var user = VizAccount.getCurrentUser();
+        var ch = StateEngine.getCharacter(user);
+        if (!user || !ch) {
+            if (resultEl) resultEl.innerHTML = '<p class="error">' + t('error_network') + '</p>';
+            return;
+        }
+        if (!ch.maxHp || ch.hp >= ch.maxHp) return;
+        if (btn) btn.disabled = true;
+        if (resultEl) resultEl.innerHTML = '<p class="pending">' + t('hunt_rest_pending') + '</p>';
+        SoundManager.play('tap');
+        VizBroadcast.restAction(function(err, broadcastResult) {
+            if (err) {
+                if (resultEl) resultEl.innerHTML = '<p class="error">' + t('hunt_rest_error') + '</p>';
+                if (btn) btn.disabled = false;
+                return;
+            }
+            var blockNum = (broadcastResult && broadcastResult.action && broadcastResult.action.block_num) || (StateEngine.getState().headBlock || 0);
+            var ev = StateEngine.processRestResult(user, blockNum);
+            if (!ev) {
+                if (resultEl) resultEl.innerHTML = '<p class="error">' + t('hunt_rest_error') + '</p>';
+                if (btn) btn.disabled = false;
+                return;
+            }
+            CheckpointSystem.saveCheckpoint('global', blockNum, StateEngine.getState(), function() {});
+            if (resultEl) resultEl.innerHTML = '<p class="success">' + t('hunt_rest_success') + '</p>';
+            render();
+        });
+    }
+
     function _doHunt() {
         if (!selectedCreature || !selectedSpell) return;
         var t = Helpers.t;

app/manifest.json

@@ -3,7 +3,7 @@
     "short_name": "VizMagic",
     "description": "Viz Magic — accessible browser RPG on the VIZ blockchain",
     "id": "https://vizmagic.web3blind.xyz/",
-    "start_url": "/?pwa=viz-magic-v48",
+    "start_url": "/?pwa=viz-magic-v49",
     "scope": "/",
     "display": "standalone",
     "display_override": ["standalone", "minimal-ui"],

app/sw.js

@@ -1,5 +1,5 @@
 // Viz Magic — Service Worker
-var CACHE_NAME = 'viz-magic-v48';
+var CACHE_NAME = 'viz-magic-v49';
 var ASSETS = [
     '/',
     '/index.html',

tests/player-bug-regressions.test.js

@@ -46,6 +46,7 @@ const toastJs = read('app/js/ui/components/toast.js');
 const craftingJs = read('app/js/ui/screens/crafting.js');
 const inventoryJs = read('app/js/ui/screens/inventory.js');
 const huntJs = read('app/js/ui/screens/hunt.js');
+const helpJs = read('app/js/ui/screens/help.js');
 const mapJs = read('app/js/ui/screens/map.js');
 const chronicleJs = read('app/js/ui/screens/chronicle.js');
 const mapScreenJs = read('app/js/ui/screens/map.js');
@@ -344,7 +345,7 @@ test('high-traffic UI narration, screen announcements, and inventory stat labels
 
 test('service worker updates quickly and keeps navigations network-first', function () {
   const swJs = read('app/sw.js');
-  assert.ok(/viz-magic-v48/.test(swJs), 'service worker cache version should be bumped');
+  assert.ok(/viz-magic-v49/.test(swJs), 'service worker cache version should be bumped');
   assert.ok(/self\.skipWaiting\(\)/.test(swJs), 'service worker should activate new cache without waiting for all tabs to close');
   assert.ok(/self\.clients\.claim\(\)/.test(swJs), 'service worker should claim clients after activation');
   assert.ok(/event\.request\.mode === 'navigate'[\s\S]*fetch\(event\.request\)/.test(swJs), 'navigation requests should prefer network to avoid stale cached index');
@@ -393,7 +394,7 @@ test('mobile entry helpers cover keyboard paste, home-screen shortcut, nav parit
   assert.ok(/SoundManager\.setVolume\(sfxVolume \/ 100\)/.test(read('app/js/ui/screens/settings.js')), 'settings should apply stored SFX volume on render');
   assert.ok(/localStorage\.setItem\(STORAGE_PREFIX \+ 'sfx_volume'/.test(read('app/js/ui/sound.js')), 'sound manager should persist SFX volume');
   assert.ok(/var volume = _getStoredNumber\('sfx_volume', 0\.5\)/.test(read('app/js/ui/sound.js')), 'sound manager should restore persisted SFX volume');
-  assert.ok(/viz-magic-v48/.test(read('app/sw.js')), 'service worker cache should be bumped for UI changes');
+  assert.ok(/viz-magic-v49/.test(read('app/sw.js')), 'service worker cache should be bumped for UI changes');
 });
 
 
@@ -455,8 +456,8 @@ test('magical weather is labelled and affects hunts', function () {
   assert.ok(/forecast-card-effect/.test(homeJs + mainCss), 'forecast effect column needs its own thematic icon/card');
   assert.ok(/function getCurrentFestival/.test(worldEventsJs), 'magical holidays should sometimes appear in the forecast');
   assert.ok(/festival_today_prefix/.test(homeJs + ruJs + enJs), 'forecast holidays should have localized copy');
-  assert.ok(/i18n\/ru.js\?v=20260713a/.test(indexHtml), 'Russian weather copy must be cache-busted');
-  assert.ok(/i18n\/en.js\?v=20260713a/.test(indexHtml), 'English weather copy must be cache-busted');
+  assert.ok(/i18n\/ru.js\?v=20260713b/.test(indexHtml), 'Russian weather copy must be cache-busted');
+  assert.ok(/i18n\/en.js\?v=20260713b/.test(indexHtml), 'English weather copy must be cache-busted');
   assert.ok(/home.js\?v=20260713a/.test(indexHtml), 'home forecast layout must be cache-busted');
   assert.ok(/quests.js\?v=20260712a/.test(indexHtml), 'quest-limit UX must be cache-busted');
   assert.ok(/nav.js\?v=20260712b/.test(indexHtml), 'bottom tray nav must be cache-busted');
@@ -523,7 +524,7 @@ test('reported mobile UX issues have explicit fixes', function () {
 
 test('PWA icon and HP heart use expressive color accents', function () {
   assert.ok(/viz-magic-192\.png\?v=20260713a/.test(indexHtml), 'PWA icon link should be cache-busted after plus placement/color update');
-  assert.ok(/viz-magic-v48/.test(read('app/manifest.json')), 'manifest start URL should change so launchers can refresh icons');
+  assert.ok(/viz-magic-v49/.test(read('app/manifest.json')), 'manifest start URL should change so launchers can refresh icons');
   assert.ok(/label:'❤️ HP'/.test(homeJs), 'HP label should use a red heart emoji variant');
 });
 
@@ -538,6 +539,18 @@ test('character screen uses current home-scale vitals and growth explainers', fu
   assert.ok(/char_mana_explainer/.test(characterScreenJs + ruJs + enJs), 'character screen should explain mana growth');
 });
 
+
+test('hunt screen exposes explicit camp rest promised by Help', function () {
+  assert.ok(/hunt.js\?v=20260713b/.test(indexHtml), 'hunt screen should be cache-busted');
+  assert.ok(/broadcast.js\?v=20260713a/.test(indexHtml), 'broadcast helper should be cache-busted for restAction');
+  assert.ok(/state-engine.js\?v=20260713b/.test(indexHtml), 'state-engine should be cache-busted for processRestResult');
+  assert.ok(/function restAction\(callback\)/.test(broadcastJs), 'broadcast helper should expose restAction');
+  assert.ok(/function processRestResult\(account, blockNum\)/.test(stateEngineJs), 'state engine should expose live rest processing');
+  assert.ok(/hunt-rest-section/.test(huntJs) && /btn-rest-camp/.test(huntJs), 'Hunt should show a visible rest-at-camp section and button');
+  assert.ok(/VizBroadcast\.restAction/.test(huntJs), 'rest button should record a normal VM rest action');
+  assert.ok(/Отдых у костра/.test(ruJs) && /нажми «Отдых у костра»/.test(ruJs), 'Russian Help should name the visible rest button');
+});
+
 if (process.exitCode) {
   process.exit(process.exitCode);
 }