JAMO MODDING - NATIONAL DRIVER WORK DIARY
Version 1.0.3.0 | PC single-player development build | 5 November 2026

INSTALL
Copy FS25_Jamo_NationalDriverWorkDiary.zip, without extracting it, into:
Documents/My Games/FarmingSimulator2025/mods
Enable the mod when loading a single-player save.

BUY AND HOLD THE BOOK
Fully quit FS25. Replace the old ZIP in the mods folder with this ZIP,
keeping the exact filename FS25_Jamo_NationalDriverWorkDiary.zip.
Restart FS25 and enable the diary and your Jamo category mod for the save.

Open the vehicle/equipment SHOP, then Jamo Modding > Jamo Modding Tools.
Buy National Driver Work Diary for $125. It is now a hand tool.
Select/equip the book and toggle it into your hand using FS25 hand-tool
controls. The top-left controls help displays Open work diary / Shift + L
while the book is held. Press Shift + L to open or close it. Either Shift
key works. The book must be in your local player's hand, not just owned or
stored in inventory. Switching tools or putting it away closes the diary.
The front cover is rotated toward you with its title upright.
If no Jamo category helper is enabled, the standalone fallback is
Hand Tools > Jamo Modding Work Diaries. The item starts in the known
handToolsAnimals category and is routed after Jamo menus finish loading.
Existing placed books from v1.0.0.0 still load and retain their records;
the old construction listing is hidden to avoid duplicate purchases.

DAILY PAGES
Opening the diary creates a page for the current absolute in-game day.
Today returns to that page. Previous/Next day browse existing pages.
Skipped days are not fabricated. On a new day, identification details
carry over; signatures, activities, notes and odometer fields start blank.
The date label is editable. It defaults to Game day N, not a real calendar.

Driver and Two-up tabs: click a field, type, and press Enter or Apply.
Clear empties the selected field. Backspace removes characters. Escape
cancels the field edit. Closing the diary applies an unfinished field edit.
Long fields show clipped text on the sheet; the complete value is saved.
The daily sheet is rebuilt with native game-drawn lines, boxes and text,
following the supplied reference. It scales sharply without stretching a
small photograph. Entered text is larger, bold and dark blue; editor text
is also larger and bold. The original scan remains bundled as a reference.

ACTIVITIES
Use Activity to enter a period. Start/end use HH:MM in 15-minute steps.
Use Work, Rest or Break. Break is saved as Rest. Enter location, odometer,
plate changes and comments. Applying a period immediately draws its pen
line on the 24-hour bottom graph. Adjacent Work/Rest periods connect with
vertical transition lines. Isolated ends have small pen ticks. Gaps stay
blank. Recorded work/rest totals update with the trace.
Click Apply period before changing rows, pages, tabs or closing the diary.
Period arrows select existing rows. New period creates an editing slot;
Apply period adds it. Delete period removes the selected saved period.
Unapplied activity edits are drafts and do not enter the saved record.
Overlaps, invalid times and reversed intervals are rejected.
24:00 is allowed as an end; split overnight activity at midnight.
Unrecorded time stays blank. Totals do not silently treat blank time as rest.
The sheet displays 12 wider activity columns at a time. When more exist,
Activity columns > cycles through them. All periods remain editable via
the period buttons. The graph always shows the full day's saved periods.

SAVING
Save the FS25 game to write your entries to disk. Autosaves also save them.
Pages belong to the purchased hand tool and are stored within its entry in
the savegame's handTools.xml, under the mod's specialization namespace.
Legacy placed books continue to use placeables.xml.
They are not shared between separate savegames. Each book has its own pages.
Shift + L opens the exact diary currently held by your local player.
Legacy placed-book save data is preserved but does not bypass the held-book
requirement. Sell/delete that book and its records are removed with it.
Keeping one diary per farm avoids ambiguity. Typed signatures are text.

REALISTIC BOOK ASSETS
The supplied Meshy FBX was decoded and converted to a GIANTS XML I3D mesh.
Original: 530,500 triangles. Runtime: 91,049 triangles.
The original mesh, page edges, back texture and normal map are retained in
a reduced mesh. The front is remapped to a separate 2048 x 2048 cream/red
cover texture generated from the user's reference photograph. A matte
cover material keeps the title readable without a metallic appearance.
Roughness/metallic source maps are included for a GIANTS material pass;
they are not wired directly into the runtime material because their PBR
channels require deliberate packing for GIANTS shaders.

BUILD STATUS
Lua 5.1 compilation, installed FS25 XML schemas, data serialization round
trip, time validation, ownership checks, keyboard fallback, save/edit flush,
mesh references and offscreen Lua UI rendering passed automated checks.
These checks use a small engine adapter and are not FS25 gameplay tests.
See docs/verification.json and docs/VALIDATION.txt for the exact boundary.
No claim of ModHub certification or finished in-game validation is made.
Multiplayer is disabled. No network replication is implemented.

ASSET / AUTHOR NOTES
Mod implementation: Jamo Modding project, built with Codex assistance.
Inputs: user-supplied Meshy model/maps, blank daily sheet and cover photo.
Cover: built-in image generation; prompt recorded in docs/cover-prompt.txt.
NHVR wording and marks follow the supplied reference; this is an unofficial
game prop and gameplay diary, not an approved road-use work diary.
Confirm rights to supplied assets before distributing the mod publicly.

VERSION 1.0.2.0 CHANGES
- Access restricted to the held book; closes when put away.
- Native Shift + L help registered with the active hand tool.
- Handheld graphics turned to show the upright front cover.
- Crisp resolution-independent daily sheet; 12 wider activity columns.
- Larger bold field values, larger labels and larger bold typing dialog.
- Break accepted as Rest; bold stepped pen trace with vertical changes.
Automated checks and offscreen UI preview passed. Actual FS25 held-cover
orientation, help visibility and rendering need confirmation in game.

VERSION 1.0.3.0 MENU ARTWORK
Mod selection and diary store thumbnail use the user-supplied Jamo/NHVR
Outback artwork. Entire square image retained, prepared at 1024 x 1024.
