Samurai's Scripts v1.8.5

Changelog

PR #106: refactor(style): normalize class methods

• Normalized more SmallBase class methods into PascalCase for consistency.
• Add a _J macro for joaat that falls back to our own definition if the global function is missing.
• Add stats.get_string and stats.set_string
• Fix PrivateLimo:TakeControl method.
• Fix YimActions interruption handler triggering when the a scenario is explicitly stopped.
• Fix bodyguards UI.
• Add a "earnings report" section to the CEO tab.

Samurai's Scripts v1.8.4

Changelog

PR #100: refactor(Businesses): refactor CEO

• Move special cargo warehouses into a new Office class.
• Fix warehouse restock command.
• Add a Player Abilities option to the Self tab.
• Fix Key binds UI's fatal crash issue in YimLuaAPI.
• Disable ALT key in KeyManager.
• Make ground loading in Self:Teleport optional to prevent teleporting to building roofs instead of ground in some cases (will properly fix later).
• Move ImGuiChildFlags to the ImGui extensions file.
• Make ImGui.BeginChildEx more readable and easier to reason about.

PR #101: feat(YHV1): Add heists script

Create YimHeistsV1 (idk if that name will be final) for quick prep skips and currently Cayo Perico setup.

• Add prep skips and teleports/waypoints for Cluckin Bell, KnoWay, Dr Dre, and Oscar Guzman
• Add Cayo Perico tab allowing for unlocking all options, setting primary/secondary targets, weapon loadout, hard mode

PR #102: refactor: several refactors

General

• Renamed the Self module to LocalPlayer to avoid confusion with Lua's self (this) keyword.
• Moved the Teleport function from LocalPlayer to Ped. Invoking it is still the same, you just call LocalPlayer:Teleport(...).

YRV3

• Refactored Auto-Sell: YRV3 no longer sets any script globals or locals; each supported sale script takes care of itself.
• Added Import/Export tab to the CEO tab. Right now this only displays data and offers tips about profit strategy. Auto-Sell and Auto-Steal may be added in the feature (this is not a promise).
• Fixed auto-sell for biker businesses. This no longer "assumes" the number of deliveries and causes you to get paid a lot more than you should.
• Refactored UI:
  • Each business now has its own UI file to avoid bloating the main file and make it easier for devs to extend it.
  • Each file that uses measureBulletWidths now caches the result.

Casino Pacino

• Casino Heist tab is now guarded behind Arcade ownership. The tab won't display heist options if the player doesn't own an Arcade.
• Improved UI and added teleport and waypoint buttons for the casino and the arcade.

Dev/Scripts

• Fix broken regex patterns in globals_locals.lua
• Fix update_offsets.py

PR #103: fix(UI): fix missing require

PR #104: refactor(YHV1): GXT labels

Not tested in Legacy

YHV1:

• Refactor to utilize in-game GXT translations where available and set up for adding more heists
• Mirror CasinoPacino in checking for required property ownership for Cayo

YRV3:

• Fix Fill Supplies due to incorrect global on Enhanced

debug_ui:

• Minor ImGui errors

misc:

• Utilize cached data more

PR #105: fix(misc): miscellaneous fixes

• Fix Bunker auto-sell.
• Fix attempts to read property stats too early into session transitions.
• Extend YRV3's auto-fill delay setting to a maximum of 10 minutes.

Samurai's Scripts v1.8.3

Changelog

PR #92: misc

Chores

• Updated .editorconfig.
• Removed unsused file.

Features

• Refactored all business-related commands.
• Added a button to reload YRV3.
• YRV3's sidebar labels are now translated by the game so they make sense.
• Disabled problematic dynamic stances from Stancer.

UI

• Settings: Added a theme editor.
• Improved ImGui.Toggle's visibility in light themes.
• Refactored ImGui.Selectable2 to use colors from the current theme instead of fixed colors.
• Refactored ImGui.Selectable2 to properly handle wide labels.
• Refactored Themes.
• Improved Notification Center and added an option to mute toast notifications.
• Added a custom bell widget for the notification center. It looks nothing like a bell...
• Fixed minimum allowed window width and height to prevent breaking the UI's aesthetics.
• Refactored YRV3's sidebar from fixed to dynamic width.

Note: The large number of changed files is caused by changes in line endings from CRLF to LF.

PR #93: fix(compat): Enhanced Memory quickfix

Fixes:

• Memory.lua will now check API version and scan the appropriate addresses

Currently, running SSV2 using YimLuaAPI on Enhanced will throw a fatal memory error in console and fail to set the game version variables properly, resulting in some modules like YRv3 being unable to load.

PR #94: refactor(ImGuiExt): refactor notification widget

• Replace the hideous "bell" with a simpler widget.
• Update Contributing.md
• Update screenshot to reflect the most recent UI changes.

PR #95: fix(Python): normalize line endings

PR #97: feat(compat): Improve base YimLuaAPI/Enhanced support

IMPORTANT: Requires at least YimLuaAPI ac1ed75 for tunables to work. (thanks @tupoy-ya)

• Add a few API checks to selectively block known broken features on Enhanced
• Alter some GUI spacing due to new ImGui bindings

• Fix MCT on YLAPI/Enhanced
• Fix non-critical ImGui errors
• Few typos

PR #98: fix: ImGui errors, refactoring, and other minor fixes

• Add DEBUG toggled text in GUI

• Rearrange Casino Heist UI to avoid being cut off in default UI
• Correct update_offsets indentation
• Refactor casino_ui and keybinds_ui

PR #99: fix(compat): fix YimLuaAPI compatibility issues

Compatibility

• Fix ImGui crashes.
• Add a BeginChild wrapper.
• Add an auto-generated weapon data table so we no longer have to rely on the weapons namespace.
• Remove deprecated ImGui.Columns from YimActions UI so it stops crashing in YimLuaAPI.

Python

• Move helper scripts into a /dev subfolder to avoid confusion.

Samurai's Scripts v1.8.2

Changelog

Important

This is a breaking change
To install this update, please remove the previous version completely and then install the new version.

PR #84: CI(Release): changelog heading

• Remove the version number from the heading and use H2.

PR #86: refactor(YRV3): refactor businesses into objects

• Refactored businesses into objects.
• Moved Nightclub from the safes tab into its own tab.
• Added business hubs (nightclub cargo) with production triggers.
• Simplified YRV3's main UI to prevent crashes.

closes #85

PR #87: chore: update screenshot

PR #88: feat(YRV3): refactor more businesses

• Refactored every remaining business into an object.
• Added more features to SalvageYard and merged it into YRV3.

PR #89: chore(codebase) code cleanup

PR #90: fix(misc): miscellaneous fixes

YRV3

• Do not render factory features if the business has not been setup.
• Fix warehouse autofill using wrong integer index.
• Refactor: Add an update method to businesses and let them handle updating themselves.
• Throttle business update tick in main thread.
• Replace problematic asserts in the Warehouse module with simple if statements.
• Do not populate Nightclub hubs if the player does not own a business hub.

GUI

• Always default to the first tab in the side bar.
• Persist previous tab between category switches.
• Fix text wrapping.

PR #91: fix(require): fix broken requires

BREAKING CHANGE

• Remove parent folder name from a few require paths.
• Fix early returns in YRV3 nightclub data initialization function not setting a boolean flag which causes YRV3 to stay in a loading state forever.
• Append breaking change notice to the changelog body when applicable.
• Remove unused files.

Samurai's Scripts v1.8.1

v1.8.1 Changelog

PR #80: docs(features): document features

Docs

• Add feature docs.

Fixes

• Fix ImGui assert in function GUI:ConfirmPopup.
• Fix stancer save-and-apply.

PR #81: feat(YRV3): add production triggers

Features/YimResupplierV3

• Added instant production triggers for biker businesses, bunker, and acid lab.
• Added auto-fill production for biker businesses, bunker, and acid lab.
• Refactored raw data, grouped everything in a table and moved it to the /data folder.
• Added localized biker business labels and 3D coordinates instead of blip IDs.

Modules/Audio

• Refactored StaticEmitter into an object.

API/Accessor

• Added optional size parameter to the At method.

API/Global Functions

• Renamed Await to TaskWait. About time we stopped lying to ourselves.

PR #82: chore(data): remove weapon lists from global ns

• Remove weapon lists from the global namespace.
• Improve the way weapon lists are populated.

PR #83: fix(data): fix acid lab locals

Samurai's Scripts v1.8.0

v1.8.0 Changelog

PR #77: fix(misc): several bug fixes & improvements

• Keep Wheels Turned

• This feature no longer teleports you outside the vehicle. You can now exit normally and keep whatever steering angle your vehicle had.

• Stancer

• Fixed an issue where switching vehicles would apply suspension data from the previous vehicle.
• Fixed wheel width and radius sliders.
• Added an "Air Suspension" section.
• Added a "Bounce Mode" feature for SUVs.

• CommandExecutor

• Refactored into a singleton.
• Renamed all class members to match the project's naming convention.
• Fixed command history navigation.
• Removed the hidden InputText hack.
• Added a command to lock/unlock the player's vehicle.
• Added a small delay when closing the commands window using the hardcoded ESC key to prevent opening the pause menu.

PR #78: docs(Readme): fix YimLuaAPI link

PR #79: miscellaneous

• YimactionsV3

• Add the ability to dynamically register CommandExecutor commands for all animations and scenarios.
• Add options to disable animation props, particle effects, and soud effects.

• Aircraft/Machine Guns

• The feature previously did not work for all aircraft machine guns because it used to iterate through an array of machine gun hashes and compares each one to our currently selected weapon. The data array was not well maintained and was missing some hashes. We now read data directly from memory so the feature will work with all aircraft equipped with MGs.

• CommandExecutor

• Fix command meta showing translation keys for some commands instead of the translated label.

• Scripts/Translations

• Move the hash map file to the Lua source.

• Src

• Move game classes into a subfolder.

Samurai's Scripts v1.7.9

v1.7.9 Changelog

PR #71: CI(release): move to schedules releases

• Zip Release:
• Do not skip workflow dispatch.
• Fix missing changelog parsing step.
• Schedule releases once a week instead of on push. This allows us to introduce and/or revert changes without worrying about triggering releases.
• Translations:
• Revert independent workflow. Let it run on push since it will no longer collide with the release workflow.
• Offset Updater:
• Move schedule to Saturday at 2AM.

PR #72: docs(Readme) update acknowledgments section

PR #73: feat(source files): organize source files

• Move Lua source into its own folder. This helps avoid missing includes in manual download situations.
• Refactor ToastNotifier and add a notification center, accessible from the nav bar.

PR #74: refactor(serializer): add mutation lock

• Serializer:
• Refactor into a true singleton.
• Add simple mutation lock.
• Add a state enum.
• Source Files:
• Move json.lua into /thirdparty
• Move HandlingEditor, WindowAnimator, SGSL, and phFragInst from /structs to more appropriate subfolders.
• Docs:
• Expand Contributing.md
• Fix Readme.md readability and silence markdownlint warnings.

PR #75: Update README.md

PR #76: fix(stancer): fix suspension

• Use suspension length for individual axles instead of compression: This allows us to set different heights without blocking suspension compression animations.
• Fix Reset function setting front wheel defaults to rear wheels.
• Move Serializer disabled flag outside of state enum.
• Reduce launch control charging time.
• Remove debug code.

Samurai's Scripts v1.7.8

v1.7.8 Changelog

Samurai's Scripts v1.7.7

v1.7.7 Changelog

🧩 Features

• Add serializable stance configs per vehicle model with optional auto-apply.
• Auto-reload Stancer on wheel change.

📝 Docs

• Add FAQ section to Readme.

Samurai's Scripts v1.7.6

v1.7.6 Changelog

🔧 Fixes:

• Features/PlayerVehicle

  • Refactored Launch Control: The feature now has two modes (realistic / ridiculous) and performs a lot better than before.
  • Refactored Fast Jets: No more air drag loss when speed is increased. Jets now handle the same as default, only faster.
  • Fixed Brake Force Display toggling ABS when the vehicle is moving in reverse.
  • Fixed optional tyre smoke color in the Drift Mode feature always set to black.

• Script Globals/Locals:

  • Fixed some locals that were swapped with their offsets due to bad regex patterns.
  • Added Enhanced globals and locals.

• Pointers:

  • Added Enhanced patterns.

• Scripts/CI:

  • Fixed offset updater and refactored it to update both legacy and enhanced.

🧩Features

• Added a stancer to the vehicle tab. It is nothing like VStancer but it gets the job done.