Skip to content

README-ru.md

Latest commit

 

History

History
143 lines (105 loc) · 12.4 KB

README-ru.md

File metadata and controls

143 lines (105 loc) · 12.4 KB
Raw

Viz Magic

🔮⚔️🛡️🌿
Русская версия - English version

Viz Magic — это децентрализованная браузерная RPG (dApp), полностью работающая на блокчейне VIZ. Приложение построено на трёх открытых протоколах — VM (Viz Magic), VE (Viz Events) и V (Голос) — используя гибкие операции VIZ для записи всех игровых действий в блокчейн.

Сервер не требуется. Вся игровая логика детерминирована и работает на стороне клиента. Приложение представляет собой статическую веб-страницу (HTML/JS/CSS), которую можно открыть прямо из файлов или разместить на любом веб-сервере. Работает офлайн через Service Worker и устанавливается как PWA.

Как это работает

Каждое игровое действие — охота на существ, дуэли с другими игроками, создание предметов, торговля на рынке — это Начертание (Inscription): JSON-объект, записанный в блокчейн VIZ как гибкая операция. Данные персонажа хранятся в json_metadata аккаунта под ключом vm, формируя публичный Гримуар (лист персонажа), доступный любому клиенту для чтения.

Сам блокчейн обеспечивает игровые механики:

Механика VIZ Игровая механика
SHARES (доля) Магическое Ядро — привязанная к душе сила
Ликвидный VIZ Эссенция Виз — торгуемая валюта
Энергия (0–10000 бп) Мана — ёмкость для направления силы
Операция награждения Заклинание — атаки, исцеления, баффы
custom_sequence (VM) Начертания — все игровые действия
json_metadata аккаунта Гримуар — публичный лист персонажа
Хеш блока Энтропия Судьбы — непредсказуемые исходы
Номер блока Эфирный Тик — время (1 тик ≈ 3 сек)
Делегирование Связь Покровителя — передача силы
Бенефициары Ритуальные Круги — распределение наград

Результаты (добыча с охоты, исход дуэли, качество создания) вычисляются детерминированно из хешей блоков, обеспечивая честность без серверной случайности.

Протоколы

Игра использует три протокола на гибких операциях VIZ:

  • VM (Viz Magic) — все игровые действия: настройка персонажа, охота, дуэли, создание предметов, рынок, гильдии, осады, квесты, мировые боссы. См. Спецификацию протокола VM.
  • VE (Viz Events) — изменяемое игровое состояние: зачарование, использование предметов, правки. Основан на расширении События Голоса.
  • V (Голос) — социальный слой для Хроники Мира: посты, ответы, репосты. Использует протокол Голос.

Особенности игры

  • 4 класса персонажей: Каменный Страж (terra/танк), Огнеплёт (ignis/урон), Лунный Странник (уклонение), Цветомудрец (целитель)
  • 5 школ магии: Ignis, Aqua, Terra, Ventus, Umbra с колесом доминирования
  • PvE: Охота на существ в различных зонах, получение опыта и добычи
  • PvP: Дуэли с системой commit-reveal (удар/защита/плетение/исцеление), лучший из 3, с авто-режимом
  • Армагеддон: Потратить 100% маны ради 100× XP — требует редкий артефакт Камень Армагеддона (выпадает с Thornvine Lv5+ или крафтится из Echo Shards × 3 + Shadow Shard × 3 + Fire Dust × 5 на 10 уровне). Защита от случайного запуска через чекбокс подтверждения. Каждое использование записывается в блокчейн для проверки легитимности.
  • Создание предметов: Комбинирование материалов в снаряжение — вкладка 🔨 в нижней навигации
  • Рынок: Выставление, покупка и обмен предметов в блокчейне
  • Гильдии: Создание гильдий, приглашение участников, продвижение гильдии для обнаружения, объявление войн, осада территорий
  • Квесты: Ежедневные пророчества и сюжетные квесты
  • Мировые события: Сезоны, мировые боссы, Всплески Плетения
  • Предметы: 5 уровней редкости (Обычный → Легендарный)
  • Хроника Мира: Социальные посты через протокол Голос
  • Прокачка: Система опыта с мягким потолком на 50 уровне
  • Рейтинг: Топ-100 магов по опыту — вкладка 🏆 в навигации
  • Отображение маны: Показывается в процентах (0.00%–100.00%) на всех экранах; внутренние значения блокчейна остаются в basis points (0–10000)
  • i18n: Полная поддержка русского и английского языков
  • Доступность: WCAG 2.1, поддержка экранных дикторов, навигация с клавиатуры, Боевой Рассказчик
  • PWA: Устанавливается, работает офлайн

HP и Восстановление

HP не восстанавливается до максимума автоматически. Пассивная регенерация возвращает до 30% от максимума HP (+1 HP каждые 100 блоков, ~5 мин). Полное восстановление: зайди на экран Охоты (отдых в лагере) или используй Свиток Здоровья (крафтится или падает с существ).

Доступность — Боевой Рассказчик

Боевой Рассказчик объявляет все боевые события через экранный диктор (aria-live). Включается в Настройках. Также воспроизводит короткие пространственные звуковые тоны для обозначения позиций врага и игрока. Создан для незрячих и слабовидящих игроков. Совместим с TalkBack на Android.

Как использовать

  1. Откройте app/index.html в браузере — прямо из файлов или через любой веб-сервер.
  2. Войдите с помощью аккаунта VIZ, используя обычный (regular) приватный ключ.
  3. Настройте персонажа (выберите класс) и начните своё путешествие.

Ноды VIZ

Приложение подключается к блокчейну VIZ через одну из доступных нод:

  • https://api.viz.world/
  • https://node.viz.cx/

Для разработчиков — добавляй контент и зарабатывай

Viz Magic построен так, чтобы любой разработчик мог расширять игровой мир и получать награды за свой вклад через блокчейн VIZ.

Как работает экономика контрибьюторов

Каждый монстр, мировой босс и игровой объект имеет поле author — имя VIZ-аккаунта разработчика, который его создал. Когда игрок охотится на монстра или атакует мирового босса, игра автоматически отправляет операцию award на аккаунт автора. Автор получает долю от эмиссии VIZ пропорционально количеству наград, что конвертируется в SHARES (влияние в сети).

Механика:

  1. Игрок тратит ману (энергию) — отправляется award к автору контента
  2. Автор накапливает награды в своём аккаунте VIZ
  3. SHARES растут → влияние в сети растёт → пассивный доход через делегирование

Как добавить своего монстра

Открой файл app/js/data/creatures.js и добавь объект в CREATURES:

my_creature: {
    id: 'my_creature',
    name: 'My Creature',
    school: 'aqua',          // ignis / aqua / terra / ventus / umbra
    author: 'твой-viz-аккаунт',  // ← сюда твой аккаунт VIZ
    minLevel: 2,
    maxLevel: 6,
    baseHp: 20,
    basePot: 10,
    baseRes: 5,
    baseSwf: 8,
    baseXp: 40,
    zone: 'commons_first_light',
    lootTable: [
        { itemType: 'water_crystal', name: 'Water Crystal', dropRate: 300 }
    ]
}

Поле author — твой аккаунт в VIZ. Именно на него будут уходить награды каждый раз, когда игрок охотится на твоего монстра.

Что ещё можно добавлять

  • Монстры (app/js/data/creatures.js) — новые существа с уникальными характеристиками
  • Мировые боссы (app/js/engine/world-boss.js) — рейд-боссы с полем author; каждая атака игрока отправляет award автору
  • Заклинания (app/js/data/spells.js) — новые школы магии и эффекты
  • Зоны (app/js/data/regions.js) — новые игровые регионы
  • Квесты (app/js/data/quests.js) — цепочки заданий
  • Предметы и рецепты (app/js/data/recipes.js) — крафт и лут

Присылай Pull Request — добавляй контент с полем author со своим VIZ-аккаунтом, и начни зарабатывать с первого же игрока.

Технологический стек

  • Чистый HTML / CSS / JavaScript — без фреймворков, без этапа сборки
  • viz-js-lib — взаимодействие с блокчейном VIZ
  • Service Worker — офлайн-поддержка и кеширование
  • Web App Manifest — установка как PWA

Лицензия

MIT