Rename plugin and add player position logging

Replace CommonLibF4 template identity with Fallout4Together across README, setup and xmake; update developer log with build/test entries. Implement player transform tracking in src: add PlayerTransform struct, change detection (position + wrapped Z rotation), throttling (minimum interval), and logging to Fallout4Together.log. Wire up F4SE messaging listener and a permanent task to poll on the game thread; include <chrono> and update startup log message. Add warnings for missing task/messaging interfaces and when player reference is unavailable.
2026-05-31 17:55:27 +12:00
parent b61043a3fe
commit 88506e0415
6 changed files with 281 additions and 11 deletions
@@ -89,3 +89,121 @@ Use this format for future updates:

 - 
 ```
+## 2026-05-31
+
+### What Changed
+
+- Built the initial Fallout 4 Together DLL.
+- Installed the DLL into `Data/F4SE/Plugins/`.
+- Launched Fallout 4 through F4SE.
+
+### What Worked
+
+- The plugin loaded successfully.
+- The plugin wrote a log file.
+- The template test message `Hello World!` appeared in the log.
+
+### What Broke
+
+- The plugin is still using the template log name and identity.
+
+### Notes
+
+- The current log file is named `commonlibf4-template.log`.
+- The next step is to rename the plugin identity and log output to `Fallout4Together`.
+
+### Next Steps
+
+- Replace template name references with `Fallout4Together`.
+- Replace `Hello World!` with a Fallout 4 Together startup message.
+- Rebuild the DLL.
+- Launch through F4SE again.
+- Confirm `Fallout4Together.log` is created.
+
+
+## 2026-05-31
+
+### What Changed
+
+- Renamed the plugin/log identity from the CommonLibF4 template to Fallout4Together.
+- Rebuilt and installed `Fallout4Together.dll`.
+- Launched Fallout 4 through F4SE.
+
+### What Worked
+
+- `Fallout4Together.log` was created.
+- The plugin loaded successfully.
+- The plugin startup code executed.
+
+### What Broke
+
+- Nothing currently recorded.
+
+### Notes
+
+- The log still contains the template message `Hello World!`.
+- Next step is to replace this message with a Fallout 4 Together startup message.
+
+### Next Steps
+
+- Replace `Hello World!` with a proper plugin startup log message.
+- Rebuild and reinstall the DLL.
+- Confirm the updated message appears in `Fallout4Together.log`.
+- Begin testing local player position readout.
+
+## 2026-05-31
+
+### What Changed
+
+- Updated the Fallout 4 Together plugin startup message.
+- Added local player position readout.
+- Logged the player's X, Y, Z position and Z rotation angle.
+
+### What Worked
+
+- `Fallout4Together.dll` built successfully.
+- Fallout 4 launched through F4SE.
+- `Fallout4Together.log` was created.
+- The plugin loaded successfully.
+- The plugin safely read and logged the local player position.
+
+### What Broke
+
+- Nothing recorded.
+
+### Notes
+
+- The first successful player position log was:
+
+```text
+Player position: X=2048.00, Y=2048.00, Z=0.00, AngleZ=0.00
+
+## 2026-05-31
+
+### What Changed
+
+- Updated player position logging so it only writes when the player position changes.
+- Added throttling so movement updates do not flood the log.
+- Rebuilt and tested `Fallout4Together.dll`.
+
+### What Worked
+
+- Fallout 4 launched through F4SE.
+- `Fallout4Together.log` was created.
+- The plugin logged the player position while moving.
+- Position logging now updates at a readable pace instead of many times per second.
+
+### What Broke
+
+- Nothing recorded.
+
+### Notes
+
+- The player transform readout milestone is now working.
+- The plugin can access the local player and track movement changes.
+
+### Next Steps
+
+- Create a local test server.
+- Send player transform data from the plugin to the server.
+- Keep the first network test local-only.