Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Guide how to install RED4ext.
You need to make sure that Visual C++ Redistributable 2022 is installed.
Download the latest zip (e.g. red4ext_x.y.z.zip
) file from GitHub.
Extract the content of the archive in the game's directory.
Launch the game.
(Optional) Check the log file in <game_directory>/red4ext/logs/red4ext.log
to make sure everything works.
Download the plugin.
(Optional) If the plugin does not provide a directory structure, create a directory with the plugin name in <game_directory>/red4ext/plugins
.
Copy the plugin files as following:
If you have created a directory at step 2, copy the files in the newly created directory.
If you did not create a directory, copy the files in <game_directory>/red4ext/plugins
.
(Optional) Start the game and verify <game_directory>/red4ext/logs/game.log
if the plugin is loaded correctly.
Description about the configuration file.
The configuration file can be found in <game_directory>/red4ext/config.ini
.
If there is no configuration file present then the file is automatically generated, with the default values, when the game is started.
Even if the configuration file has ini
extension, in fact, it is a TOML
file See toml.io for more information.
An example of the configuration file.
Name
Type
Default
Description
version
unsigned integer
0
The file's version.
logging
level
string
info
The global log level.
Accepted values:
off
trace
debug
info
warning
error
critical
flush_on
string
info
The minimum log level that will trigger the flush.
Accepted values:
trace
debug
info
warning
error
critical
max_files
integer
5
The maximum number of rotated log files.
Note: A log file is rotated every time the game starts.
max_file_size
integer
10
The maximum size, in megabytes, of a log file.
plugins
enabled
boolean
true
Enable / disable plugins system.
ignored
string[]
[]
The specified plugins are ignored and will not loaded.
dev
console
boolean
true
Enable / disable the external console (useful for development).
wait_for_debugger
boolean
false
Block the process until a debugger is attached.
Where to find the documentation
You can browse Red4Ext via Rayshader's excellent web tool NativeDB, where all documentation will be gathered and kept up-to-date by volunteers.
If you want to get involved, check out the github repository or this thread on the REDmodding Discord.
RED4ext is currently only a plugin manager for plugins that extends REDengine 4. It takes care of loading the plugins for the specified game's version.
RED4ext.SDK is a library that can be used to extend REDengine 4. The library provide the following features:
Interacting with the game's scripting VM (e.g. calling functions or accessing class properties);
Creating new native classes or functions;
Reversed game's structures;