conf.lua

-- Copyright (c) 2026 Cedric. All rights reserved.
-- Source-available under the Gen2Recomped License (see LICENSE.md): you may
-- read, build and privately modify this file; you may not redistribute it or
-- use it commercially. Cartridge-derived data is excluded and is not the
-- copyright holder's to license.

function love.conf(t)
  -- PhysFS ignores symlinks unless told otherwise, so a mod dev-linked into
  -- mods/ (ln -s, matching the mklink /J workflow on Windows) is invisible
  -- to love.filesystem.getDirectoryItems without this.
  love.filesystem.setSymlinksEnabled(true)

  local editor = os.getenv("POKEPORT_EDITOR") == "1"
  local developer = os.getenv("POKEPORT_DEV") == "1"
  if arg then
    for _, a in ipairs(arg) do
      if a == "--editor" then editor = true end
      if a == "--developer" then developer = true end
    end
  end
  -- main.lua runs in the same Lua state right after conf.lua; stash the
  -- decision in a global so it doesn't need to reparse `arg`.
  _G.POKEPORT_EDITOR_MODE = editor
  _G.POKEPORT_DEV_MODE = developer

  -- Save-directory identity.  This game and the Gen 1 port it grew out of
  -- both shipped as "pokemon-love2d" and fought over one %APPDATA%/LOVE
  -- folder, so the
  -- desktop build owns "Gen2Recomp" and src/core/SaveIdentity.lua carries
  -- existing players across on first boot.
  --
  -- Mobile deliberately keeps the old name.  Android's save directory is
  -- getExternalFilesDir()-based and therefore package-scoped (see
  -- mobile/ANDROID.md), so the two games cannot collide there in the first
  -- place -- renaming would only orphan every installed player's saves and
  -- ROM cache inside their own package folder.
  local mobileOs = love._os == "Android" or love._os == "iOS"
  local identity = os.getenv("POKEPORT_IDENTITY")
    or (mobileOs and "pokemon-love2d" or "Gen2Recomp")

  if editor then
    -- Same identity as the game, deliberately: the editor edits the game's
    -- saves and reads the game's ROM cache, both of which live under this
    -- folder.  A private editor identity would point love.filesystem at an
    -- empty directory in a packaged build, so `--editor` could not find
    -- data/generated at all (SaveIO.defaultPath already assumed this name).
    t.identity = identity
    t.window.title = "Pokemon Save Editor"
    t.window.width = 1280
    t.window.height = 800
  else
    t.identity = identity
    -- Version.lua has zero requires, so it is loadable this early; fall
    -- back to the plain title if the source is not mounted yet
    local ok, Version = pcall(require, "src.core.Version")
    t.window.title = ok and Version.title()
      or "gen2recomp"
    -- Open at the launcher's design size (the split-screen ROM selector is
    -- laid out for 1024x768). The window is resizable and the 160x144 game
    -- canvas letterboxes into whatever size it ends up, so this only sets the
    -- starting size, not the game's resolution.
    t.window.width = 1024
    t.window.height = 768
    -- Floor for the resizable desktop window.  The launcher's single-column
    -- layout is laid out against ~420 logical px of content, and the game
    -- canvas letterboxes fine below that, so this only stops a drag that would
    -- squeeze the cards past the point where their buttons still read.  Kept
    -- well under the smallest supported desktop display; mobile ignores it
    -- (fullscreen), so the handheld ports are unaffected.
    t.window.minwidth = 480
    t.window.minheight = 360
  end
  -- The window and taskbar icon on desktop (the packaged app's own icon is
  -- set per platform at build time; see tools/make_icons.py).  Checked first
  -- because LÖVE errors at boot on a missing icon file.
  local icon = "assets/logo/icon-window.png"
  if love.filesystem.getInfo and love.filesystem.getInfo(icon) then
    t.window.icon = icon
  end
  -- The same source supports the stable 11.5 ports and the pinned 12 preview.
  -- Match the running major version so a 12 build has no compatibility prompt.
  local loveMajor = love.getVersion and love.getVersion() or 11
  t.version = loveMajor >= 12 and "12.0" or "11.5"
  t.window.vsync = 1
  t.modules.joystick = true
  t.modules.physics = false

  -- love.system is not loaded during love.conf; love._os is set by the
  -- engine before conf runs (LÖVE 11.x / 11.5).
  local osName = love._os
  local mobile = osName == "Android" or osName == "iOS"
  local nx = osName == "NX"
  if nx then
    -- Switch (love-nx).  Handheld is 720p and docked is 1080p, and SDL only
    -- follows the dock/undock transition when the window is resizable and NOT
    -- exclusive fullscreen -- a fullscreen window keeps the boot mode and the
    -- picture is wrong in whichever state you did not start in.  The 160x144
    -- viewport letterboxes into either, so the size here is only a starting
    -- point.
    t.window.width = 1280
    t.window.height = 720
    t.window.fullscreen = false
    t.window.resizable = true
    t.window.highdpi = false
  elseif mobile then
    -- resizable is what unlocks orientation.  SDL's Android backend, given no
    -- SDL_HINT_ORIENTATIONS (LÖVE sets none), calls setRequestedOrientation
    -- at window creation -- FULL_SENSOR when the window is resizable (rotates
    -- freely to portrait or landscape), otherwise locked to the window's w/h
    -- aspect.  So a non-resizable tall window forced portrait; resizable lets
    -- the game follow the device.  The renderer letterboxes the 160x144
    -- viewport into whatever size results, and the on-screen touch controls
    -- re-lay themselves out from the new window size, so both orientations
    -- just work.  FULL_SENSOR ignores the device's rotation lock, so
    -- GameActivity.setOrientationBis remaps it to FULL_USER after SDL has
    -- run: same orientations allowed, but auto-rotate being off now wins.
    -- iOS follows the Info.plist orientations
    -- (see mobile/ios/overlays/love-ios.plist, now portrait + landscape).
    t.window.resizable = true
    -- Starting size is a tall portrait hint; the OS resizes to the real
    -- display and rotations resize again. highdpi is required for Retina iOS
    -- (Android always behaves as highdpi).
    t.window.width = 1080
    t.window.height = 1920
    t.window.fullscreen = true
    t.window.highdpi = true
    -- Android only (irrelevant on iOS): puts the save directory under the
    -- app's external-files folder, which is readable/writable via USB or a
    -- file manager with no runtime permission, so RomImporter can ask the
    -- player to copy their ROM there instead of needing a native file
    -- picker (LOVE 11.5 on Android has none -- see src/import/RomImporter.lua).
    t.externalstorage = osName == "Android"
    -- LOVE 11.x exposes the phone's accelerometer as a 3-axis joystick by
    -- default.  Gravity keeps one axis pinned near +/-1.0 whenever the phone
    -- is held upright, so it streams past-deadzone joystickaxis events that
    -- both hid the touch overlay every instant (it reads as "a controller is
    -- in use") and, via the generic-joystick axis mapping (#459), walked the
    -- player around by tilt.  Nothing in the game reads the accelerometer,
    -- so drop the device entirely (#468).
    t.accelerometerjoystick = false
  else
    t.window.resizable = true
  end
  if loveMajor >= 12 then
    t.highdpi = t.window.highdpi ~= false
    t.window.highdpi = nil
    -- Preserve the renderer whose pixels match the 11.5 release on desktop.
    -- Vulkan remains an explicit development opt-in while reflection parity
    -- is being verified; Metal stays the native default on Apple platforms.
    if osName == "Windows" or osName == "Linux" then
      local backend = os.getenv("POKEPORT_GRAPHICS_BACKEND")
      t.graphics.renderers = {backend == "vulkan" and "vulkan" or "opengl"}
    end
  end
end