feat: upload files

Author: Github-Samuel

LICENSE

@@ -0,0 +1,104 @@
+# sd-selfstorage
+
+sd-selfstorage is a comprehensive self-storage rental system for FiveM that allows players to rent or purchase storage units with advanced features including auto-renewal payments, access management, upgrades, and more.
+## Features
+- 🏢 **Rent or Purchase** - Players can either rent units weekly or buy them permanently
+- 💳 **Auto-Renewal System** - Automatic payments from bank accounts (configurable)
+- 👥 **Access Management** - Share storage access with other players
+- ⬆️ **Storage Upgrades** - Purchase additional slots and weight capacity
+- ⏰ **Grace Period System** - 48-hour grace period for overdue payments
+- 🏦 **Banking Integration** - Works with banking systems that support static identifiers
+- 🌍 **Multi-Language Support** - Easy localization system
+- 📦 **ox_inventory Integration** - Full stash system with weight and slot limits
+
+## Preview
+<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/fd9b534a-89c9-4931-846d-b4d079fa8e7c" />
+
+![FiveM_GTAProcess_GMUO1cRVPE](https://github.com/user-attachments/assets/f38e24d3-713d-477b-b1c1-66834e828e3d)
+![FiveM_GTAProcess_aNNN2aegP8](https://github.com/user-attachments/assets/969b86bc-90b1-4c12-bc24-e291499ef179)
+<img width="1920" height="1080" alt="FiveM_GTAProcess_Wk93zMVrwo" src="https://github.com/user-attachments/assets/2727e1d3-c744-4c35-abb0-5da62e4f332f" />
+
+
+## 🔔 Contact
+
+Author: Samuel#0008  
+Discord: [Join the Discord](https://discord.gg/FzPehMQaBQ)  
+Store: [Click Here](https://fivem.samueldev.shop)
+
+## 💾 Installation
+
+1. Download the latest release from the repository
+2. Extract the downloaded file and rename the folder to `sd-selfstorage`
+3. Place the `sd-selfstorage` folder into your server's `resources` directory
+4. Add `ensure sd-selfstorage` to your `server.cfg`
+5. Configure the banking functions in `server/main.lua` (lines 14-37), if you want auto-renewal to work.
+6. Adjust the config file to your needs
+
+## 📖 Dependencies
+- [ox_inventory](https://github.com/overextended/ox_inventory)
+- [ox_lib](https://github.com/overextended/ox_lib)
+- [qbx_core](https://github.com/Qbox-project/qbx_core) or [qb-core](https://github.com/qbcore-framework/qb-core)
+- oxmysql
+
+## 📖 Configuration
+
+### Banking System Setup
+The script supports two modes depending on your banking system:
+
+#### For Banking Systems with Static Identifiers (IBAN, Account Numbers)
+```lua
+Banking = {
+    hasStaticIdentifiers = true,
+    noIdentifierMessage = 'Your banking system does not support automatic payments'
+}
+```
+
+#### For Banking Systems without Static Identifiers
+```lua
+Banking = {
+    hasStaticIdentifiers = false,
+    noIdentifierMessage = 'Your banking system does not support automatic payments'
+}
+```
+
+When `hasStaticIdentifiers = false`:
+- Auto-renewal features are disabled
+- Bank account linking is hidden
+- Only manual payments are available
+- Grace period and deletion systems still work
+
+### Banking Functions
+Edit the banking functions in `server/main.lua` (lines 14-37):
+
+```lua
+-- Example Integration with RxBanking
+Banking.GetPlayerAccount = function(identifier)
+    local accountData = exports['RxBanking']:GetPlayerPersonalAccount(identifier)
+    if type(accountData) == "table" then
+        return accountData.iban
+    elseif type(accountData) == "string" then
+        return accountData
+    end
+    return nil
+end
+
+Banking.RemoveAccountMoney = function(accountId, amount, unitId)
+    return exports['RxBanking']:RemoveAccountMoney(
+        accountId, 
+        amount, 
+        'payment', 
+        locale('storage_unit_autorenewal', { id = unitId }), 
+        nil
+    )
+end
+```
+
+## 📜 License
+This resource is protected by copyright. Redistribution or modification without permission is prohibited.
+
+## 🤝 Support
+For support, join our [Discord](https://discord.gg/FzPehMQaBQ) or create an issue on GitHub.
+
+
+
+

README.md

@@ -0,0 +1,61 @@
+local EnableNotifOX = false -- Enable use of ox_lib for notifications if available
+local EnableNotifLation = false -- Enable use of lation_ui for notifications if available
+
+--- Capitalizes the first letter of a string and lowercases the rest.
+---@param str string The string to capitalize.
+---@return string The capitalized string.
+CapitalizeFirst = function(str)
+    return str:sub(1, 1):upper() .. str:sub(2):lower()
+end
+
+--- Selects and returns the most appropriate notification function based on the current game setup.
+-- This function checks the available libraries and configurations to determine which notification method to use.
+-- It then returns a function tailored to use that method for showing notifications.
+---@return function A function configured to show notifications using the determined method.
+local CreateNotificationFunction = function()
+    if lib ~= nil and EnableNotifOX then
+        return function(message, type)
+            local title = CapitalizeFirst(type or 'inform')
+            lib.notify({
+                id = math.random(1, 999999),
+                title = title,
+                description = message,
+                type = type or 'inform'
+            })
+        end
+    elseif EnableNotifLation then
+        return function(message, type)
+            local title = CapitalizeFirst(type or 'inform')
+            exports.lation_ui:notify({
+                title = title,
+                message = message,
+                type = type or 'info',
+            })
+        end
+    else
+        if Framework == 'esx' then
+            return function(message, _)
+                ESX.ShowNotification(message)
+            end
+        elseif Framework == 'qb' then
+            return function(message, type)
+                QBCore.Functions.Notify(message, type or 'info')
+            end
+        end
+
+        return function(message, type)
+            error(string.format("Notification system not supported. Message was: %s, Type was: %s", message, type))
+        end
+    end
+end
+
+--- The chosen method for showing notifications, determined at the time of script initialization.
+local Notify = CreateNotificationFunction()
+
+--- Display a notification to the user.
+-- This function triggers a notification with a specific message and type.
+---@param message string The text of the notification to be displayed.
+---@param type string The type of notification, which may dictate the visual style or urgency.
+ShowNotification = function(message, type)
+    Notify(message, type)
+end

bridge/client.lua

@@ -0,0 +1,37 @@
+-- Framework detection function
+local DetectFramework = function()
+    if GetResourceState('qb-core') == 'started' then
+        return 'qb', exports['qb-core']:GetCoreObject()
+    end
+    
+    if GetResourceState('es_extended') == 'started' then
+        return 'esx', exports['es_extended']:getSharedObject()
+    end
+    
+    return nil, nil
+end
+
+-- Detect and initialize framework
+local framework, core = DetectFramework()
+
+if not framework then
+    error([[
+        ^1CRITICAL ERROR: No supported framework detected!^0
+        ^3This resource requires one of the following frameworks:^0
+        - QBCore (qb-core)  
+        - ESX (es_extended)
+        
+        Please ensure your framework is started before this resource.
+    ]])
+    return
+end
+
+Framework = framework
+Core = core
+
+-- Set framework-specific globals for compatibility
+if Framework == 'qb' then
+    QBCore = Core
+elseif Framework == 'esx' then
+    ESX = Core
+end