readme/plugin.json update

Author: 3rdit

README.md

@@ -1,7 +1,7 @@
 # ScyllaNinja
 Author: **Script-Ware Software**
 
-_Automated ScyllaHide injection and setup for Binary Ninja's debugger_
+_Automated ScyllaHide injection and setup/configuration for Binary Ninja's debugger_
 
 ## Description
 
@@ -23,31 +23,46 @@ ScyllaHide handles PEB manipulation, NT API hooking, and timing protection to hi
    - `HookLibraryx64.dll`
    - `HookLibraryx86.dll`
 
-4. Configure in `Edit > Preferences > Settings > Debugger > ScyllaHide`:
+4. Configure in `Edit > Settings > Debugger > scyllahide`:
    - Set "ScyllaHide Directory" to the path containing extracted files
-   - Select a profile (default: Basic)
+   - Enable "Enable Automatic ScyllaHide Injection" (if you want)
+   - Select a profile (default: Basic) or make a custom one
 
-5. Open a x64/x86 binary of your choice
+5. Open a x64/x86 binary and start debugging
 
-6. Set a breakpoint on the program's entry
-
-7. ScyllaHide is automatically injected and set up.
+6. ScyllaHide is automatically injected when the debugger hits the initial breakpoint
 
 ## Usage
 
-Once configured, ScyllaHide automatically injects when you start debugging any Windows executable. Console output will indicate injection status.
+### Automatic Injection
+
+If configured (see Settings), ScyllaHide automatically injects when you start debugging any Windows executable. The status bar shows real-time progress during injection, and console output logs detailed status.
+
+### Manual Injection
+
+You can manually inject ScyllaHide at any time during a debug session via:
+- **Plugins > ScyllaNinja > Inject ScyllaHide**
+
+This is useful for:
+- Retrying if automatic injection failed
+- Injecting after the initial breakpoint
+- Re-injecting after modifying settings
+
+The plugin prevents accidental double-injection by tracking injection state and prompting for confirmation.
 
 ## Settings
 
-Found in Binary Ninja Settings under `Debugger > ScyllaHide`:
+Found in Binary Ninja Settings under `Debugger > scyllahide`:
 
 | Setting | Default | Description |
 |---------|---------|-------------|
-| Enable ScyllaHide | true | Automatically inject when debugger hits initial breakpoint |
+| Enable Automatic ScyllaHide Injection | false | Automatically inject when debugger hits initial breakpoint |
 | Profile | Basic | Pre-configured hook profile (preset profiles use built-in configs) |
 | ScyllaHide Directory | plugin folder | Directory containing InjectorCLI and HookLibrary DLLs |
 | Individual Hooks | varies | PEB, NT API, and timing hooks (only apply when Profile = Custom) |
 
+**Note:** Remember that the individual hook settings are only used when Profile is set to "Custom". For preset profiles like "Basic" or "VMProtect x86/x64", ScyllaHide uses its already built-in configurations.
+
 ## Minimum Version
 
 This plugin (was only tested on but likely) requires the following minimum version of Binary Ninja:
@@ -60,6 +75,8 @@ The following dependencies are required for this plugin:
 
 * ScyllaHide binaries (InjectorCLI + HookLibrary DLLs) from https://github.com/x64dbg/ScyllaHide/releases
 
+The plugin will alert you if these files don't exist and are not set up in the settings. 
+
 ## License
 
 This plugin is released under an MIT license.

plugin.json

@@ -3,15 +3,15 @@
 	"name": "ScyllaNinja",
 	"type": ["helper", "ui"],
 	"api": ["python3"],
-	"description": "Automatically inject ScyllaHide anti-anti-debug DLL when debugging Windows executables",
-	"longdescription": "Binary Ninja integration for [ScyllaHide](https://github.com/x64dbg/ScyllaHide) by x64dbg. Automatically injects the ScyllaHide DLL when the debugger hits the initial breakpoint, helping bypass common anti-debugging techniques.\n\n**Setup:**\n1. Download ScyllaHide binaries from https://github.com/x64dbg/ScyllaHide/releases/tag/v1.4\n2. Extract InjectorCLI (x86/x64) and HookLibrary DLLs (x86/x64)\n3. Configure directory in Settings > Debugger > ScyllaHide\n4. Select a profile and start debugging\n\nScyllaHide handles PEB manipulation, NT API hooking, and timing protection to hide the debugger from anti-debug checks.",
+	"description": "Automated ScyllaHide injection and setup/configuration for Binary Ninja's debugger",
+	"longdescription": "Binary Ninja integration for [ScyllaHide](https://github.com/x64dbg/ScyllaHide) by x64dbg. Automatically injects the ScyllaHide DLL when the debugger hits the initial breakpoint, helping bypass anti-debugging techniques commonly found in packed or protected executables.\n\n**Features:**\n- Automatic injection on debug start with status bar progress feedback\n- Manual injection via Plugins > ScyllaNinja > Inject ScyllaHide\n- Intelligent process detection with fuzzy matching\n- Multi-binary support with independent injection state\n- Double-injection prevention\n\n**Setup:**\n1. Download ScyllaHide binaries from https://github.com/x64dbg/ScyllaHide/releases/tag/v1.4\n2. Extract InjectorCLIx64.exe, InjectorCLIx86.exe, HookLibraryx64.dll, HookLibraryx86.dll\n3. Configure in Settings > Debugger > scyllahide\n4. Enable automatic injection and select a profile\n5. Start debugging - ScyllaHide injects automatically\n\nScyllaHide handles PEB manipulation, NT API hooking, and timing protection to hide the debugger from anti-debug checks.",
 	"license": {
 		"name": "MIT",
 		"text": "Copyright (c) 2025 Script-Ware Software\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
 	},
 	"platforms": ["Windows"],
 	"installinstructions": {
-		"Windows": "1. Install plugin via Binary Ninja Plugin Manager or copy to plugins directory\n2. Download ScyllaHide from https://github.com/x64dbg/ScyllaHide/releases/tag/v1.4\n3. Extract InjectorCLIx64.exe, InjectorCLIx86.exe, HookLibraryx64.dll, HookLibraryx86.dll\n4. Set ScyllaHide directory in Settings > Debugger > ScyllaHide\n5. Restart Binary Ninja"
+		"Windows": "1. Install plugin via Binary Ninja Plugin Manager or copy to %APPDATA%\\Binary Ninja\\plugins\n2. Download ScyllaHide from https://github.com/x64dbg/ScyllaHide/releases/tag/v1.4\n3. Extract InjectorCLIx64.exe, InjectorCLIx86.exe, HookLibraryx64.dll, HookLibraryx86.dll to a directory\n4. Configure in Settings > Debugger > scyllahide:\n   - Set ScyllaHide Directory\n   - Enable automatic injection (optional)\n   - Select profile (default: Basic)\n5. Open a binary and start debugging"
 	},
 	"dependencies": {},
 	"version": "1.0.0",