bg3se-macos

# Baldur's Gate 3 Modding Guide for macOS

## Mod Idea: Auto-Equip Best Weapon

### Step 1: Set Up BG3SE-macOS
1. Download and install BG3SE-macOS from the official GitHub repository.
2. Place the application in your Baldur's Gate 3 folder.
3. Launch the game through BG3SE-macOS to ensure compatibility.

### Step 2: Create the Mod Script
```lua
function onInit()
    event.register('onPlayerLevelUp', onPlayerLevelUp)
end

function onPlayerLevelUp()
    local player = Game.GetPlayer(0)
    local bestWeapon = findBestWeapon(player)
    if bestWeapon then
        player.EquipItem(bestWeapon)
    end
end

function findBestWeapon(player)
    local bestWeapon = nil
    local bestDamage = 0
    for _, item in ipairs(player:GetInventory()) do
        if item:GetType() == 'Weapon' then
            local damage = item:GetDamage()
            if damage > bestDamage then
                bestDamage = damage
                bestWeapon = item
            end
        end
    end
    return bestWeapon
end
```

### Step 3: Test the Mod
1. Save the script as `auto_equip.lua` in the BG3SE-macOS scripts folder.
2. Launch the game and test the mod by leveling up your character.
3. Verify that the best weapon is automatically equipped.

## Troubleshooting
- Ensure BG3SE-macOS is running before launching the game.
- Check the console for any error messages if the mod does not work.
- Refer to the BG3SE-macOS documentation for additional support.