========================================================================
 Vehicle Delivery  (车辆投送)   v0.9.130
 By AceCat (design, testing, ideas) & DS (implementation)
========================================================================

A GTA San Andreas script for MoonLoader.
Register your cars, then call them to you.

一个 GTA SA 的 MoonLoader 脚本：注册你喜欢的车，之后随时把它叫到身边。


------------------------------------------------------------------------
 REQUIREMENTS  /  运行要求   (IMPORTANT! 重要！)
------------------------------------------------------------------------

  * MoonLoader 0.026 or newer          /  MoonLoader 0.026 或更高
  * MoonImGui  ** NOT bundled with MoonLoader **
      -> moonloader\lib\MoonImGui.dll
      -> moonloader\lib\imgui.lua
    MoonImGui  ** MoonLoader 不自带 **
      -> moonloader\lib\MoonImGui.dll
      -> moonloader\lib\imgui.lua

  Most "it doesn't work" reports are caused by a missing MoonImGui.
  大多数"装了没反应"都是因为缺 MoonImGui。

  Optional / 可选 : CLEO
  Not required / 不需要 : modloader, GSX


------------------------------------------------------------------------
 INSTALLATION  /  安装
------------------------------------------------------------------------

  1. Install MoonLoader into your GTA SA folder.
     把 MoonLoader 装进 GTA SA 目录。

  2. Install MoonImGui (see above).
     装好 MoonImGui（见上）。

  3. Copy these into moonloader\ :
     把下面这些复制进 moonloader\ ：

         VehicleDelivery.lua
         VehicleDelivery_AceDS\      (the whole folder / 整个文件夹)

  4. Start the game and press  K  to open the window.
     进游戏，按  K  打开窗口。


------------------------------------------------------------------------
 KEYS  /  按键
------------------------------------------------------------------------

  K        Open / close the main window      开关主窗口
  F6       Reload the script (no restart)    重载脚本（不用退游戏）
  Y        Confirm in a Y/N dialog           确认
  N        Cancel in a Y/N dialog            取消
           (also cancels a summon during the first 2 steps, no charge)
           （召唤前 2 格时按 N 可取消召唤，不扣钱）
  Mouse    Click buttons                     点击按钮

  In-window buttons / 窗口内按钮:

    REGISTER THIS CAR   Register the car you are driving  注册当前驾驶的车
    CALL $500           Call the selected car             呼叫选中的车
    DEL / SURE?         Delete (2 clicks)                 删除（两次点击）
    DEL ALL             Delete the whole model           删除整个车型
    <<  ^  v  >>        Reorder / move across pages      排序 / 跨页搬移
    RESET CJ            Emergency reset (if you get stuck) 应急复位
    Phone anim: ON/OFF  Toggle the phone animation       开关掏手机动画


------------------------------------------------------------------------
 FEATURES  /  功能
------------------------------------------------------------------------

  * Register any car you sit in (driver seat).         注册你坐着的任何车
  * Call it for $500 - a homie drives it to you.        $500 叫车，厚米送来
  * Multiple presets per model (colours/paintjobs).      同车型多套预设
  * Old called cars are recycled automatically.          自动回收旧车
  * Per-save-slot registry (slots 1-8), never mixed.     按存档分槽，互不干扰
  * Resizable window, size remembered on close.          可调窗口，关窗记住尺寸
  * Two-pane UI: CARS on top, PRESETS below.             两栏界面
  * Preset buttons tinted with that preset's car colour. 预设按钮按车色着色
  * Deletion needs 2 confirmations (warning colours).     删除需两次确认

  Requires text input features (rename / Chinese search) are NOT available
  in this build of MoonImGui and are planned for later.
  文字输入类功能（重命名 / 中文搜索）在本版 MoonImGui 上不可用，计划后续支持。


------------------------------------------------------------------------
 KNOWN ISSUES  /  已知问题
------------------------------------------------------------------------

  * No Chinese text in the UI - MoonImGui's default font has no CJK glyphs.
    界面不支持中文 —— MoonImGui 默认字体没有中文字形。
    (Chinese font loading was attempted and abandoned; it always rendered "???")

  * If you get stuck holding a phone while entering a car, click RESET CJ.
    上车时开手机若卡住，点窗口里的 RESET CJ 应急复位。

  * In-game renames and Chinese/pinyin search: planned.
    预设重命名、中文拼音搜索：计划中。


------------------------------------------------------------------------
 SETTINGS  /  设置文件
------------------------------------------------------------------------

  Created automatically at:
  自动创建于：

      moonloader\VehicleDelivery_data\settings.lua

  You can edit it with Notepad. Example:
  可以用记事本改。示例：

      return {
        chineseFont = false,
        phoneAnimation = true,
        windowW = 660,
        windowH = 480,
        windowX = 100,
        windowY = 100,
      }

  Your car registry lives in:
  车辆注册表位于：
      moonloader\VehicleDelivery_data\slotN\cars.lua
  (with automatic backups cars.bak1.lua / cars.bak2.lua)
  （自动备份 cars.bak1.lua / cars.bak2.lua）


------------------------------------------------------------------------
 MOD API  /  模组接口 (for other mods / 给其他模组)
------------------------------------------------------------------------

      if CallerAPI then
          CallerAPI.registerVehicleName(615, 'My Custom Car')
          CallerAPI.addDriveableRule(function(model) return nil end)
          CallerAPI.on('car_registered', function(entry) end)
          CallerAPI.on('summon_started', function(model, replace) end)
          CallerAPI.on('summon_done',    function(car, model) end)
      end

  Hooks only - with no extension mods installed, behaviour is unchanged.
  只加钩子 —— 没装扩展模组时行为完全不变。


========================================================================
 Vehicle Delivery - AceCat & DS
 [[AceCat]] [[AceDS]] [[DSAce]] [[DSAceCat]]
 hex 0x416365436174 0x4163654453 0x4453416365 0x4453416365436174
========================================================================
