engine.go

Обзор

Файл engine.go реализует игровой движок (GameEngine) для валидации игровых действий, расчёта состояния игроков и применения правил игры. Он содержит логику обработки различных игровых событий (например, прокачка уровня, PvP-сражения, крафт предметов, торговля на рынке и др.), а также механизмы валидации, предотвращения читерства и синхронизации состояния игроков между разными блокчейн-сетями (кросс-чейн).

Основная цель файла — обеспечить корректное и справедливое изменение состояния игроков на основе их действий, учитывая текущее состояние, правила игры, а также ограничения для кросс-чейн взаимодействия.

Основные компоненты

GameEngine

Класс GameEngine — это ядро логики игры, содержащее правила и методы валидации и обработки действий.

Свойства

Конструкторы

Методы

GameRules

Структура, определяющая основные параметры игры:

PlayerState

Текущее состояние игрока:

ActionResult

Результат обработки действия:

Важные структуры параметров и результатов

Основные алгоритмы и особенности реализации

Взаимодействие с другими частями системы

Примеры использования

// Создание игрового движка с дефолтными правилами
engine := NewGameEngine()

// Инициализация состояния игрока
playerState := PlayerState{
    Player: common.HexToAddress("0x123..."),
    ManaBalance: big.NewInt(1000),
    Level: big.NewInt(1),
    Experience: big.NewInt(0),
    // ...
}

// Пример действия - прокачка уровня
action := contracts.GameManagerGameAction{
    Player: playerState.Player,
    ActionType: 2, // LEVEL_UP
    ManaAmount: big.NewInt(0),
    ActionParams: []byte{/* сериализованные параметры */},
}

// Валидация действия
result := engine.ValidateAction(context.Background(), action, playerState)
if result.Success {
    playerState = result.NewState
} else {
    fmt.Println("Ошибка:", result.Error)
}

Mermaid диаграмма структуры

classDiagram
    class GameEngine {
        - rules: *GameRules
        + NewGameEngine()
        + NewGameEngineWithRules(rules *GameRules)
        + GetRules() *GameRules
        + UpdateRules(rules *GameRules)
        + ValidateAction(ctx, action, currentState) ActionResult
        + BatchValidateActions(ctx, actions, playerStates) (map, error)
        + ValidateCrossChainAction(ctx, action, currentState, targetChain) CrossChainActionResult
        + ProcessCrossChainBatch(ctx, actions, playerStates) (map, error)
        + SynchronizePlayerStateAcrossChains(ctx, player, sourceState, targetState, sourceChain, targetChain) (PlayerState, error)
        - processSpendMana(action, state) ActionResult
        - processEarnMana(action, state) ActionResult
        - processLevelUp(action, state) ActionResult
        - processCraftItem(action, state) ActionResult
        - processPvPBattle(action, state) ActionResult
        - processMarketplaceTrade(action, state) ActionResult
        - parseLevelUpParams(actionParams) (LevelUpParams, error)
        - validateLevelUp(params, playerState) error
        - calculateStatProgression(newLevel) StatProgression
        - parsePvPBattleParams(actionParams) (PvPBattleParams, error)
        - validatePvPBattle(params, playerState) error
        - calculateBattleResult(params, playerState) BattleResult
        - parseCraftingParams(actionParams) (CraftingParams, error)
        - validateCrafting(params, playerState) error
        - calculateCraftingCost(params, playerLevel) *big.Int
        - calculateCraftingResult(params, playerState) CraftingResult
        - parseMarketplaceTradeParams(actionParams) (MarketplaceTradeParams, error)
        - validateMarketplaceTrade(params, playerState) error
        - calculateMarketplaceTradeCost(params, playerLevel) MarketplaceTradeCost
        - calculateMarketplaceTradeResult(params, playerState) MarketplaceTradeResult
        - validateCrossChainConstraints(action, targetChain) error
        - mergePlayerStates(sourceState, targetState, sourceChain, targetChain) PlayerState
        - isActionTypeCrossChainCompatible(actionType) bool
        - validateCrossChainLevelUp(action) error
        - validateCrossChainCrafting(action) error
        - validateCrossChainPvP(action, targetChain) error
        - validateCrossChainMarketplace(action, targetChain) error
    }

    class GameRules {
        + LevelUpBaseCost: *big.Int
        + CraftingBaseCost: *big.Int
        + PvPEntryFee: *big.Int
        + MarketplaceFee: *big.Int
        + PvPWinReward: *big.Int
        + QuestReward: *big.Int
        + DailyReward: *big.Int
        + MaxManaPerAction: *big.Int
        + MaxActionsPerBatch: int
    }

    class PlayerState {
        + Player: common.Address
        + ManaBalance: *big.Int
        + Level: *big.Int
        + Experience: *big.Int
        + LastActionTimestamp: *big.Int
        + Wins: *big.Int
        + Losses: *big.Int
        + Rating: *big.Int
        + TotalManaEarned: *big.Int
        + TotalManaSpent: *big.Int
        + ItemsCrafted: *big.Int
    }

    class ActionResult {
        + Success: bool
        + NewState: PlayerState
        + ManaChange: *big.Int
        + Error: string
    }

    GameEngine --> GameRules
    GameEngine --> PlayerState
    GameEngine --> ActionResult

Заключение

Файл engine.go предоставляет комплексный и детализированный игровой движок с поддержкой разнообразных игровых механик и кросс-чейн взаимодействия. Его модульная структура и чёткое разделение логики по типам действий позволяют масштабировать функционал и поддерживать высокую безопасность игрового процесса.