From 6312852dbc766fa953f6caf7c0f1f85e98ad838e Mon Sep 17 00:00:00 2001 From: lu Date: Thu, 16 Apr 2026 16:06:14 +0200 Subject: [PATCH 1/4] docs: refactor readme and declare core dependencies --- README.md | 144 +++++++++++++++++-------------------------------- fxmanifest.lua | 6 +++ 2 files changed, 56 insertions(+), 94 deletions(-) diff --git a/README.md b/README.md index 5e8350c..ea9c3ae 100644 --- a/README.md +++ b/README.md @@ -1,117 +1,73 @@ -# VORP Core +# vorp_core -## Introduction +`vorp_core` is the base framework layer for RedM servers running VORP. -VORP Core is a comprehensive Lua-based framework for RedM, designed to enhance server functionality and player experience with a wide array of configurable settings and commands. +It provides the shared player session logic, character state handling, jobs, groups, callbacks, notifications, commands, and core exports that other VORP resources build on top of. -## Requirements +If your server uses multiple VORP resources, this is one of the main resources that needs to be loaded correctly first. -- [oxmysql](https://github.com/overextended/oxmysql/releases): A must-have for database operations, ensuring smooth data handling and integration. +> [!NOTE] +> This repository is the framework layer, not a complete gameplay pack by itself. Resources such as inventory, housing, hunting, crafting, and character systems are expected to run around it. -## Installation Guide +## Dependencies -1. **Setup:** - - Download and ensure `oxmysql` is properly set up and configured in your RedM server environment. -2. **VORP Core Installation:** - - Rename the downloaded folder to `vorp_core`. - - Move the `vorp_core` folder into your server's resources directory, usually found under `\resources\[VORP]\vorp_core`. - - Include `ensure vorp_core` in your server's `resources.cfg/server.cfg` file, placing it at the top of the load order for priority loading. +`vorp_core` requires these resources to be available: -## Documentation +- `oxmysql` +- `spawnmanager` +- `vorp_menu` -- [Documentation](https://docs.vorp-core.com/introduction) -- Direct link to the full VORP Core documentation for in-depth details and guides. +## Installation ---- +1. Place `vorp_core` in your server resources folder. +2. Make sure the required dependencies are started before it. +3. Add `ensure vorp_core` to your server config. +4. Start dependent VORP resources such as `vorp_character` and `vorp_inventory` after `vorp_core`. +5. Review the config files before going live: + `config/config.lua`, `config/commands.lua`, `config/logs.lua`, and `translation/language.lua`. -## Features Overview +A typical load order looks like this: -## Configuration Options (`config.lua`) +```cfg +ensure oxmysql +ensure spawnmanager +ensure vorp_menu +ensure vorp_core +``` -### Server Settings -- **Language:** Set the server's language, referring to available options in the 'translation' folder. -- **OneSync:** Toggle OneSync integration (`true` for enabled). -- **Database Updates:** Enable automatic database updates. -- **Player Info Logs:** Configure logging of player information on join/leave. +## What This Resource Handles -### Starting Configuration -- **Initial Resources:** Set starting amounts for gold, money, role-play currency, and experience points. -- **Default Player Settings:** Configure default job, job grade, user group, and job label for new players. -- **Whitelist and Auto-update:** Manage whitelist settings and auto-updates. +`vorp_core` is responsible for core framework behavior such as: -### Player Limits -- **Health and Stamina:** Set maximum health and stamina for players. -- **PvP Settings:** Enable or disable player vs player combat and toggling. +- player session and initialization flow +- shared callbacks and framework exports +- job and group management +- admin and utility commands +- framework notifications and UI helpers +- player state, respawn, and server-side character loading hooks -### Multicharacter Support -- **Character Limits:** Set the maximum number of characters a player can create. -- **Discord ID Saving:** Choose to save Discord IDs in the character/user database. +For full configuration and API usage, use the official docs: -### UI Core Settings -- **UI Visibility:** Manage the visibility of various UI elements, including player cores and the Dead Eye core. +- [VORP Documentation](https://docs.vorp-core.com/introduction) -### Webhook Configurations -- **Discord Integration:** Configure webhook color, name, logo, and footer for Discord integration. +## Common Setup Mistakes -### Map Configurations -- **Radar Settings:** Customize radar types for different scenarios (on foot, on horse). +The most common issues are usually these: -### Respawn Settings -- **Health on Respawn/Resurrection:** Define health parameters for respawning and resurrection. -- **Respawn Mechanics:** Configure respawn timers, keys, and combat logging penalties. +- missing `oxmysql` or starting it after `vorp_core` +- starting `vorp_menu` after `vorp_core` +- changing the folder name instead of keeping it as `vorp_core` +- placing dependent resources before `vorp_core` in the load order +- expecting `vorp_core` alone to replace the rest of the VORP stack +- leaving development-oriented settings enabled in production without reviewing the config first -### Ban System Configurations -- **Time Formatting:** Set the date and time format for ban notifications. -- **Time Zone Settings:** Configure server time zone and time difference from UTC. +> [!IMPORTANT] +> If the framework starts but other VORP resources fail to load correctly, check resource order before changing code. In most cases the issue is a missing dependency or a bad start sequence. -### Command Permission Settings -- **Command Permissions:** Manage permissions for using various commands, including admin rights in the database. +## Support -### Discord Rich Presence Integration -- **Rich Presence Settings:** Customize Discord rich presence, including maximum players, application ID, and button configurations. +If you run into an issue: ---- - -### Commands Overview (`commands.lua`) - -##### Administrative Commands -- **addGroup:** Assign a group to a player with specified ID and group name. -- **addJob:** Assign a job to a player, including job name, grade, and salary. -- **addItem:** Add items to a player's inventory with item name and quantity. -- **addWeapon:** Provide weapons to a player with weapon name and ammo count. -- **delMoney:** Remove currency from a player's account, specifying type and amount. -- **addMoney:** Add currency to a player's account, specifying type and amount. -- **delWagons:** Delete a player's wagons. -- **revive:** Revive a player with specified ID. -- **teleport:** Teleport a player to a marked location. -- **delHorse:** Delete a player's horse. -- **heal:** Heal a player and replenish their needs. -- **addWhitelist:** Add a player to the whitelist. -- **unWhitelist:** Remove a player from the whitelist. -- **ban:** Ban a player with specified duration. -- **unBan:** Unban a player. -- **warn:** Issue a warning to a player. -- **unWarn:** Remove a warning from a player. -- **charName:** Change a character's name. -- **charCreateAdd:** Allow a player to create additional characters. -- **charCreateRemove:** Remove a player's ability to create additional characters. -- **myJob:** Display the player's current job and details. - -These commands and configurations offer extensive control over the server's gameplay, administration, and player management, ensuring a tailored and smooth experience for all participants. - ---- - -## Support and Community - -For assistance, join the [VORP Core Discord](https://discord.gg/DHGVAbCj7N) community. Engage with developers and server administrators, share insights, and stay updated on the latest features and improvements. - ---- - -## Credits - -- **Original Framework:** Inspired by the [VORP-Core C# version](https://github.com/VORPCORE/VORP-Core/releases), this Lua version extends the core's functionality while maintaining its foundational principles. -- **Contributors:** Special thanks to `goncalobsccosta#9041` and all community members for their contributions and support in the development and enhancement of VORP Core. - ---- - -VORP Core Lua Version offers a robust platform for RedM servers, providing the tools necessary for a highly customizable and immersive gameplay experience. +- if you know your way around the code, feel free to open a PR +- if not, open an issue on GitHub +- or join the VORP Discord: [discord.gg/DHGVAbCj7N](https://discord.gg/DHGVAbCj7N) diff --git a/fxmanifest.lua b/fxmanifest.lua index f28bc9b..5a18b47 100644 --- a/fxmanifest.lua +++ b/fxmanifest.lua @@ -36,6 +36,12 @@ files { ui_page 'ui/index.html' +dependencies { + 'oxmysql', + 'spawnmanager', + 'vorp_menu' +} + version '3.3' vorp_checker 'yes' vorp_name '^4Resource version Check^3' From 88a9ee84bfd299c3753256ad9493d9f556e7594a Mon Sep 17 00:00:00 2001 From: lu Date: Thu, 16 Apr 2026 16:12:42 +0200 Subject: [PATCH 2/4] docs: replace repeated overview with config warning --- README.md | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index ea9c3ae..6abe0f7 100644 --- a/README.md +++ b/README.md @@ -35,18 +35,12 @@ ensure vorp_menu ensure vorp_core ``` -## What This Resource Handles +## Configuration -`vorp_core` is responsible for core framework behavior such as: +> [!WARNING] +> Configuring `vorp_core` can take time. Read the configuration files carefully and adapt them to your server before going live. The default setup is not meant to match every server out of the box. -- player session and initialization flow -- shared callbacks and framework exports -- job and group management -- admin and utility commands -- framework notifications and UI helpers -- player state, respawn, and server-side character loading hooks - -For full configuration and API usage, use the official docs: +For full configuration details and API usage, use the official docs: - [VORP Documentation](https://docs.vorp-core.com/introduction) From fefb174fe1b130ef41d9e4b6309a8cd0e22f61a5 Mon Sep 17 00:00:00 2001 From: lu Date: Thu, 16 Apr 2026 18:38:56 +0200 Subject: [PATCH 3/4] docs: add credits section and acknowledge contributors in README refactor: remove dependencies block from fxmanifest --- README.md | 8 ++++++++ fxmanifest.lua | 6 ------ 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 6abe0f7..24eaad1 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,14 @@ The most common issues are usually these: > [!IMPORTANT] > If the framework starts but other VORP resources fail to load correctly, check resource order before changing code. In most cases the issue is a missing dependency or a bad start sequence. +## Credits + +**Original Framework:** Inspired by the VORP Core C# version, this Lua implementation extends the core functionality while preserving its foundational principles. + +**Contributors:** Special thanks to **goncalobsccosta** and all community members for their contributions and support in the development and improvement of VORP Core. + + + ## Support If you run into an issue: diff --git a/fxmanifest.lua b/fxmanifest.lua index 5a18b47..f28bc9b 100644 --- a/fxmanifest.lua +++ b/fxmanifest.lua @@ -36,12 +36,6 @@ files { ui_page 'ui/index.html' -dependencies { - 'oxmysql', - 'spawnmanager', - 'vorp_menu' -} - version '3.3' vorp_checker 'yes' vorp_name '^4Resource version Check^3' From 42ea899fdab7002c004283eac470fc4082367b87 Mon Sep 17 00:00:00 2001 From: lu Date: Thu, 16 Apr 2026 18:41:48 +0200 Subject: [PATCH 4/4] docs: remove extra line breaks and add contributors acknowledgment in README --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 24eaad1..aa0963b 100644 --- a/README.md +++ b/README.md @@ -64,8 +64,6 @@ The most common issues are usually these: **Contributors:** Special thanks to **goncalobsccosta** and all community members for their contributions and support in the development and improvement of VORP Core. - - ## Support If you run into an issue: