VEHICLE LOANS - FS25 1.25 - v1.0.0.0


INSTALL
Keep FS25_VehicleLoans.zip zipped and put it in your FS25 mods directory.
On this computer the discovered directory is:
C:\Users\tyge3\OneDrive\Documents\My Games\FarmingSimulator2025\mods
Enable Vehicle Loans on the save's mod selection screen.
For multiplayer, install the identical ZIP on the server and every client.
The Steam installation directory on A: is not the mods directory.
No files in the game installation or existing saves have been changed.

BUY WITH A LOAN
1. Open the shop, select a NEW vehicle or implement, and configure it.
2. Click the added Loan button beside the normal purchase controls.
3. Select 12, 24, 36, 48 or 60 monthly payments.
4. Select a 10%, 20%, 30%, 40% or 50% down payment.
5. Review the price, amount financed, payment, first due date and end date.
6. Confirm. Only the down payment is charged immediately; GIANTS delivers
   the configured vehicle through the normal vehicle loading system.
Pallets, bales, hand tools, leases and used-sale purchases are excluded.
The current maximum supported vehicle price is 10,000,000 game currency.

TERMS AND DATES
APR is fixed at 6%. Payments use a reducing balance amortization schedule.
The first installment is due at the next in-game month change. Payments are
monthly, regardless of the days-per-month setting or real-world time.
The final installment adjusts for cent rounding and then payments stop.
The mod uses a saved "finance year" calendar: year 1 is the first year in which
the mod was enabled, starting with March. This is not a real-world year.
For example, a 36-month loan begun in August of finance year 1 ends in August
of finance year 4. End dates are saved and retained when the save is reloaded.
Mandatory payments can make farm cash negative. There is no missed-payment
deferral, repossession, late fee or automatic extension of the end date.

VIEW / PAY OFF
Open an owned vehicle's configuration/service screen and use Vehicle loans.
Select a contract to see balance, monthly amount, next due date and end date.
Confirm payoff to repay its outstanding principal; future interest is waived.
You must have sufficient cash for early payoff.
Optional console commands: vlLoans and vlPayoff <loan id>.
These commands require the game's developer console; the store buttons do not.
Loan balances update on all clients after changes. Joining clients request a
snapshot and refresh every 30 seconds. Reopen the details dialog to refresh it.
Closed contracts may be removed from the list when a new purchase is financed.

MULTIPLAYER
The server recalculates purchase prices and controls the interest rate.
The farm's Buy Vehicles permission is required to finance or pay off a loan.
Requests are rate limited, and one purchase per farm may be loading at a time.
There is a maximum of 256 active contracts across the server.
Only the server charges monthly payments and saves the ledger.
Loan snapshots include all farms' contracts; the interface filters to your farm.
This mod does not hide loan information from other clients.

SAVES AND VEHICLE SALES
Records are saved to vehicleLoans.xml beside the normal savegame files.
Keep that file with its matching savegame and backups. Do not copy a ledger
between saves or delete it while contracts are outstanding.
Selling a financed vehicle through the standard garage/dealer sale automatically
repays its remaining principal and removes its loan. Future interest is waived.
GIANTS credits the sale price, then the original borrowing farm is charged the
remaining balance. If the sale does not cover it, farm cash pays the difference
and may become negative. Rejected sales do not affect the loan.
Resetting, reconfiguring, transferring or deleting a vehicle without a normal
sale does not close the debt. Third-party sale systems that bypass the standard
SellVehicleEvent are not covered. The original borrower remains liable.
Removing/disabling the mod suspends the payments. Re-enable it to resume.
Leave it enabled continuously while loans are active; it cannot reconstruct
months elapsed during a period in which the mod was disabled.
Pay off contracts before permanently removing it or deleting a borrowing farm.

LIVE ACCEPTANCE CHECKS STILL REQUIRED
- Loan button visible and navigable with mouse, keyboard and controller.
- Selected motor/wheels/colors/license plate match delivered vehicle.
- Delivery failure/blocked shop behavior and down-payment refund.
- Save/reload, autosave and dedicated server save/backup behavior.
- Host plus client: purchase, join-in-progress, permissions, monthly payment,
  early payoff and reconnect. Verify each debit occurs only once.
- Sleep through a month, December/January and February/March transitions.
- Interaction with other shop/finance/delivery mods.
- Garage and dealer sales: balance deducted once, loan removed on all clients,
  shortfall handling, save/reload after sale, and no later monthly deductions.

API references: installed FS25 1.24 SDK and GIANTS scripting documentation.
https://gdn.giants-software.com/documentation_scripting_fs25.php
