mirror of
https://github.com/UltimateMenu/UltimateMenu.git
synced 2026-10-10 03:43:09 +08:00
Document correct Nenyoo install path and in-game checks
This commit is contained in:
+3
-1
@@ -2,8 +2,10 @@
|
||||
|
||||
This edition runs the YimMenu Legacy script through a Nenyoo API adapter. The bundled `lib/Ultimate_Menu_Legacy.lua` is an unchanged copy of `YimMenu/Ultimate_Menu_Legacy.lua`; the original menu hierarchy and action callbacks remain in one source file. YimMenu tabs, ImGui groups, controls, and popups appear as nested Nenyoo menu lists. Controls that depend on game state are added when their conditions become true.
|
||||
|
||||
Copy this folder to `Documents\Nenyoo\scripts\user\UltimateMenu\`, then enable `Ultimate_Menu.lua` from Nenyoo's Scripts menu. Keep the `lib` folder beside the entry script. The script targets GTA V Legacy build 3889 and uses the online menus only after joining GTA Online.
|
||||
Copy the contents of this folder to `%LOCALAPPDATA%\Nenyoo\Plus\Scripts\User\UltimateMenu\`, then select `Ultimate_Menu.lua` from Nenyoo's Scripts menu to load its page. Keep the `lib` folder beside the entry script. The script targets GTA V Legacy build 3889 and uses the online menus only after joining GTA Online.
|
||||
|
||||
The adapter requires a Nenyoo build exposing `__ny_execute_as_script` and `__ny_request_script_host`. The host request uses Nenyoo's cooperative script-host election and cannot evict a healthy current host. Actions that rely on becoming mission-script host therefore need in-game validation. GTA V Enhanced is outside this edition's scope.
|
||||
|
||||
The mock-runtime check in `lib/tests/load_yim_test.lua` covers menu construction, all exposed action and input callbacks, stat and native return bridges, and controls that appear after a game-state change. Run it with Lua 5.4 from the repository root. It does not validate GTA Online results or the visual menu in a running game.
|
||||
|
||||
Follow [TESTING.md](TESTING.md) for the in-game checks and a failure-report template.
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
# Nenyoo Legacy in-game verification
|
||||
|
||||
Use GTA V **Legacy build 3889** and the Nenyoo DLL built with the `__ny_execute_as_script` and `__ny_request_script_host` Lua bridges. The package must be at `%LOCALAPPDATA%\Nenyoo\Plus\Scripts\User\UltimateMenu\` with `Ultimate_Menu.lua` and `lib\yim_compat.lua` beside `lib\Ultimate_Menu_Legacy.lua`. Open `Ultimate_Menu.lua` from Nenyoo's Scripts menu; it is a menu page that loads when opened.
|
||||
|
||||
## First run
|
||||
|
||||
1. In Story Mode, open the page. Confirm `Ultimate Menu 1.73 By L7NEG` appears with `Story Mode`, `Self Menu`, `Recovery Menu`, `Online Services Menu`, `Collectibles`, `Events Menu`, `Gun Van Menu`, `YimResupplier`, and `Heists Data Editor Menu`. Open and back out of several nested lists. Record any missing row, empty page, freeze, or Lua error.
|
||||
2. In `Story Mode`, record the current character's cash, use `Current Character Cash` to set a distinct value, and confirm the game shows it. Restore the original value. Verify an online-only action does not write stats in Story Mode.
|
||||
3. Join a GTA Online session and reopen the menu. Verify changing text, toggle, slider, combo, and button controls update the displayed value or game state. Leave the session and confirm Story Mode controls still work.
|
||||
4. In `Gun Van Menu > Weapons > Edit Weapons`, search for `Pistol`, select its row, and use `Set Weapon` on a recorded slot. Check that the displayed slot and the in-game Gun Van show Pistol. Restore the original weapon. Test `Remove Weapon` and `Close`, then reopen the editor.
|
||||
5. For a business you own, open `YimResupplier` and verify its controls appear after ownership is detected. Test a teleport to a known property and confirm the landing position. Repeat after changing sessions.
|
||||
|
||||
## Full feature pass
|
||||
|
||||
The mock check inventories over a thousand actions; opening their rows does not prove their effects. For a full claim, test **each** action, toggle, input, slider, and choice under the game conditions it requires. Cover `Self Menu`, `Story Mode`, `Recovery Menu` (rank, skills, awards, account unlocks, LSCM), `Online Services Menu`, `Collectibles`, `Events Menu`, `Ultimate Money Methods Menu` (businesses and warehouse), `Gun Van Menu`, `YimResupplier`, `Reports Menu`, `Heists Data Editor Menu` (Apartment, Agency, Autoshop, Salvage Yard, Cluckin Bell, Doomsday, Casino, Cayo, Kortz), and `Missions Selector And cooldown Menu`. `Credits` needs only a display check.
|
||||
|
||||
Record the exact menu path and control label, session type and relevant property/mission ownership, value before, chosen action, value after, whether it persisted after a session change, and pass/fail. Mark unavailable conditions as **untested**, not passed. Save a screenshot or short recording for visual failures, and the relevant lines from `%LOCALAPPDATA%\Nenyoo\Plus\nenyoo.log` for errors. Some heist and mission actions request script host; test them while the named mission script is active and record whether host was actually acquired. A healthy current host cannot be displaced by Nenyoo's cooperative request, so those effects are not guaranteed in every session.
|
||||
|
||||
Report the first failure with this format:
|
||||
|
||||
```
|
||||
GTA build / Nenyoo DLL build:
|
||||
Session and mission/property state:
|
||||
Menu path > exact control:
|
||||
Value before / value entered / value after:
|
||||
What happened instead:
|
||||
Error text or log lines (if any):
|
||||
```
|
||||
|
||||
Do not mark the port fully verified until every applicable control has an observed result. The automated Lua mock and DLL build cover loading and API calls, not GTA Online outcomes.
|
||||
@@ -1,6 +1,6 @@
|
||||
-- @nenyoo-menu
|
||||
-- Ultimate Menu for Nenyoo (GTA V Legacy).
|
||||
-- Install this entire folder under Documents\Nenyoo\scripts\user.
|
||||
-- Install this package under %LOCALAPPDATA%\Nenyoo\Plus\Scripts\User\UltimateMenu.
|
||||
|
||||
local source = debug.getinfo(1, "S").source
|
||||
assert(source:sub(1, 1) == "@", "Ultimate Menu must be loaded from a file")
|
||||
|
||||
@@ -41,7 +41,7 @@
|
||||
- For **YimMenuV2 Enhanced**:
|
||||
Coming Soon (WIP)
|
||||
- For **Nenyoo GTA V Legacy**:
|
||||
Copy the contents of [`Nenyoo`](Nenyoo) to `Documents\Nenyoo\scripts\user\UltimateMenu\`. In Nenyoo, open `Scripts` and enable `Ultimate_Menu.lua`. The `lib` folder must stay beside the entry script. Join GTA Online before using online actions.
|
||||
Copy the contents of [`Nenyoo`](Nenyoo) to `%LOCALAPPDATA%\Nenyoo\Plus\Scripts\User\UltimateMenu\`. In Nenyoo, open `Scripts` and select `Ultimate_Menu.lua` to load its menu page. The `lib` folder must stay beside the entry script. Join GTA Online before using online actions.
|
||||
|
||||
The Nenyoo edition translates the YimMenu Legacy menu hierarchy and controls. It requires a Nenyoo build with the named-script execution and host-request Lua bridges. GTA V Enhanced has not been validated.
|
||||
</details>
|
||||
|
||||
Reference in New Issue
Block a user