Balatro GBA

这是一个尝试在Game Boy Advance平台上尽可能准确地重现Balatro游戏的非官方项目，包含了让Balatro游戏体验令人满意的所有视觉效果。这个技术演示/概念验证版本严格限制内容，仅包含Balatro的最小版本，不会重现完整游戏。

此版本适用于已经拥有并了解官方完整游戏玩法的人群。 如果您需要理解某些机制或能力，请参考Balatro Wiki。

免责声明：此项目未经Playstack或LocalThunk认可或附属

这是一个非盈利的社区粉丝项目，仅旨在作为对完整版Balatro的致敬，在Game Boy Advance上重现一个最小版本的Balatro，并非意图侵犯或从完整版游戏的销售中分流。

功能特性

完整的扑克手牌分析系统 - 支持同花顺、四条、葫芦等所有标准扑克手牌判定
小丑卡牌系统 - 实现多种小丑卡牌的特殊效果和乘数计算
盲注机制 - 包含小盲注、大盲注和BOSS盲注的完整实现
GBA硬件优化 - 利用HBLANK中断和仿射变换实现流畅的视觉效果
音频系统 - 集成maxmod音频引擎，支持音效和背景音乐
精灵管理系统 - 高效的精灵对象管理和渲染系统

安装指南

系统要求

Game Boy Advance模拟器或硬件
GBA开发工具链（如devkitARM）
支持GBA ROM的编译环境

依赖项

项目基于以下库构建：

libtonc（GBA底层库）
maxmod（音频引擎）
GRIT（图形转换工具）

编译步骤

安装devkitARM开发环境
配置Makefile中的工具链路径
运行make命令编译项目
生成GBA ROM文件可在模拟器或硬件上运行

使用说明

基本游戏流程

游戏遵循Balatro的核心玩法循环：

选择盲注级别
构建和优化扑克手牌
使用小丑卡牌增强得分
击败盲注获得奖励

核心代码示例

扑克手牌分析

// hand_analysis.h
bool hand_contains_straight(u8 *ranks) {
    for (int i = 0; i < NUM_RANKS - 4; i++) {
        if (ranks[i] && ranks[i + 1] && ranks[i + 2] && ranks[i + 3] && ranks[i + 4])
            return true;
    }
    // 检查A到5的顺子
    if (ranks[ACE] && ranks[TWO] && ranks[THREE] && ranks[FOUR] && ranks[FIVE])
        return true;
    return false;
}

bool hand_contains_flush(u8 *suits) {
    for (int i = 0; i < NUM_SUITS; i++) {
        if (suits[i] >= MAX_SELECTION_SIZE) {
            return true;
        }
    }
    return false;
}

小丑卡牌效果系统

// joker_effects.c
static JokerEffect jolly_joker_effect(Joker *joker, Card *scored_card) {
    JokerEffect effect = {0};
    if (scored_card != NULL) return effect;

    u8 suits[NUM_SUITS];
    u8 ranks[NUM_RANKS];
    get_played_distribution(ranks, suits);

    if (hand_contains_n_of_a_kind(ranks) >= 2)
        effect.mult = 8;
    return effect;
}

仿射背景渲染

// affine_background.c
IWRAM_CODE void affine_background_prep_bgaff_arr() {
    for (u16 vcount = 0; vcount < SCREEN_HEIGHT; vcount++) {
        const s32 timer_s32 = timer << 8;
        const s32 vcount_s32 = vcount << 8;
        const s16 vcount_s16 = vcount;
        const s32 vcount_sine = lu_sin(vcount_s32 + timer_s32 / ANIMATION_SPEED_DIVISOR);
        
        asx.scr_x = (SCREEN_WIDTH / 2);
        asx.scr_y = vcount_s16 - (SCREEN_HEIGHT / 2);
        asx.tex_x = (1000 * 1000) + (vcount_sine);
        asx.tex_y = (1000 * 1000);
        asx.sx = 128;
        asx.sy = 128;
        asx.alpha = vcount_sine + (timer_s32 / ANIMATION_SPEED_DIVISOR);

        bg_rotscale_ex(&bgaff_arr[vcount], &asx);
    }
    bgaff_arr[SCREEN_HEIGHT] = bgaff_arr[0];
}

音频系统封装

// audio_utils.c
void play_sfx(mm_word id, mm_word rate) {
    mm_sound_effect sfx = { {id}, rate, 0, SFX_DEFAULT_VOLUME, SFX_DEFAULT_PAN, };
    mmEffectEx(&sfx);
}

列表数据结构

// list.c
List *list_new(int init_size) {
    List *list = (List *)malloc(sizeof(List));
    if (list == NULL) return NULL;
    list->_array = (void **)malloc(sizeof(void*) * init_size);
    if (!list->_array) {
        free(list);
        return NULL;
    }
    list->size = 0;
    list->allocated_size = init_size;
    return list;
}

游戏状态管理

项目使用状态机管理游戏流程，包括启动画面、主菜单、游戏进行、盲注选择等不同状态，确保游戏逻辑清晰分离。