Skip to content

README-ru.md

Latest commit

 

History

History
135 lines (101 loc) · 10.9 KB

README-ru.md

File metadata and controls

135 lines (101 loc) · 10.9 KB

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 уровне
  • Отображение маны: Показывается в процентах (0.00%–100.00%) на всех экранах; внутренние значения блокчейна остаются в basis points (0–10000)
  • i18n: Полная поддержка русского и английского языков
  • Доступность: WCAG 2.1, поддержка экранных дикторов, навигация с клавиатуры
  • PWA: Устанавливается, работает офлайн

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

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

Ноды VIZ

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

  • wss://solox.world/ws
  • https://viz.lexa.host/
  • 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/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