Core

# REDEMPIRE Core
## Unified API
All new integrations should load one API object on the side where they run. The
older exports are still supported for backwards compatibility.
'''lua
-- server
local REDEMPIRE = exports.jrs_core:getCoreApi()
local character = REDEMPIRE.GetCharacter(source)
REDEMPIRE.AddMoney(source, 25)
REDEMPIRE.AddXP(source, 10, 'mission_reward')
REDEMPIRE.NotifyRightTip(source, 'Reward received', 3000)
'''
'''lua
-- client
local REDEMPIRE = exports.jrs_core:getCoreApi()
REDEMPIRE.NotifyRightTip('Ready', 3000)
REDEMPIRE.SetCustomDestination(vector3(0.0, 0.0, 0.0), 'Destination')
REDEMPIRE.Rpc('jrs:getPlayerData', function(playerData)
    print(json.encode(playerData))
end, {})
'''
REDEMPIRE Core is the main framework resource for a RedM server. It handles player connections, character state, money, gold, and dirty money, jobs, groups, XP 
**Resource:** `jrs_core`
**Version:** `1.0.10`
**Game:** RedM / Red Dead Redemption 2
**Author:** jrs
---
## Main Features
- Character loading and authoritative character-ready state.
- Player money, gold, dirty money, job, grade, group, inventory data, coordinates, and metadata.
- XP and level system with configurable requirements up to level 100.
- Compact HUD for gold, money, player ID, job, level, and town.
- Per-character HUD position, size, and visibility saving.
- HUD editor command with move, resize, visibility, reset, save, and cancel controls.
- Right-to-left compact HUD slots: the icon starts on the right and the text extends to the left.
- Reset All restores the original default HUD layout and default element sizes.
- Automatic fallback icon when a job-specific image does not exist.
- RedM notification API for client and server resources.
- Server callbacks and client RPC support.
- Input wheel item synchronization.
- Custom 3D waypoint support.
- Map discovery unlocking.
- Steam, Discord, whitelist, and double-connection checks.
- Administrator commands with per-group permissions.
---

# jrs_inventory
## v1.6.30 - Storage transfer slots + centered inventory navigation
- Centered Inventory search directly below the title.
- Category filter and action tabs are separated into clear rows.
- Storage uses five real columns with visible slot numbers.
- Drag player Inventory -> Storage and Storage -> player Inventory with source-aware drop targets.
- Dropping onto an empty Storage slot persists that Storage slot; dropping Storage content onto a free player slot requests that exact player slot.
- Empty Storage slot drops persist the selected Storage slot in the storage JSON.
- Added clear PLAYER INVENTORY / STORAGE transfer labels and lightweight drop feedback.
- Keeps wallet, gold, dirty money, clothing, ground and hotbar hidden in Storage mode.
- REDEMPIRE Core only.
# v1.6.9 - Quick slots + three inventory sounds
- REDEMPIRE Core only.
- Uses exactly three local MP3 assets inside the normal Inventory: open, close, and click.
- Removed the old hover sound and the generated weight-warning beep. Storage/robbery/other NUI surfaces remain silent.
- Fixed the open sound order so it plays after the inventory becomes visible; close sound plays before the normal inventory hides.
- Rebuilt Quick Slots 1-5: drag inventory items/weapons to assign, drag filled quick slots to swap, and right-click a quick slot to clear it.
- Quick-slot drag/drop is rebound after every inventory render, fixing slots that stopped accepting drops after a refresh.
- Hotbar state is validated client-side and server-side, deduplicated, repaired after legitimate stack-ID changes, and authoritatively synced back to the client
- Active 1-5 input is checked every frame only while at least one quick slot is assigned; an empty hotbar keeps the long idle sleep.
## v1.6.8 - Compact connected / instant-open inventory
- REDEMPIRE Core only.
- Restores the older compact panel dimensions while keeping Clothing, Inventory, Ground, Wallet and slots 1-5 connected.
- Opens immediately from the synchronized client cache; authoritative inventory/ground data refreshes in the background.
- The inventory sound set is local and scoped to the normal Inventory view only.
- Drag/drop uses shorter, low-cost feedback settings for smoother slot movement.
## v1.6.7 - Connected responsive inventory UI
- Matched the supplied wide reference layout: Clothing + Inventory + Ground in one aligned three-column composition.
- Wallet is attached below Clothing; Quick Slots are attached below Inventory.
- Hotbar keys are 1 through 5.
- Added a dedicated local menu-open sound (`html/sounds/ui_open.mp3`).
- Removed the visible NUI loading overlay; panels appear only when authoritative inventory data is ready.
- Kept all assets local and preserved REDEMPIRE Core-only integration and server-authoritative transfer/security logic.
- Responsive single-scale layout keeps the complete UI visible on common 16:9, 16:10, ultrawide, 2K and 4K screens.
# jrs_inventory v1.6.5 - RedM Native Instant Open
This build removes `RegisterKeyMapping` from the inventory open flow and uses the RedM control hash (`Config.openinv`) directly. A dedicated one-control-per-fra
## Ultra-Low Idle Pass (v1.6.3)
This build targets the case where Resource Monitor showed more client time while the inventory was closed than while NUI was open. The remaining idle work was m
- Empty hotbar: no hotbar control natives are called; the loop sleeps for 500ms.
- Active hotbar: polling reduced from 10ms to 25ms and only assigned slots are checked.
- Hotbar polling no longer allocates temporary Lua tables every cycle.
- Inventory/holster/lantern polling reduced to 50ms while closed and 250ms while NUI owns focus.
- Holster and lantern actions are edge-triggered so holding a key does not repeat expensive weapon natives.
- Ground scanner sleeps for 2 seconds when no drops exist, and reads player coordinates only once per scan when drops do exist.
- Ground scanning now uses distance tiers (far / near / prompt) instead of one aggressive idle rate.

# jrs_loadingscreen 2.5.0
JRS loading screen for RedM with direct `jrs_core` / `jrs_character` handoff.
## Start order
'''cfg
ensure jrs_core
ensure jrs_loadingscreen
ensure jrs_character
'''
## Main configuration
UI/media settings are in `web/config_main.js`.
### Video
'''js
VIDEO: {
    ENABLE: true,
    VIDEO: "background.mp4",
    MUTE_VIDEO: false,
},
'''
When video is enabled, the image slideshow is automatically inactive at runtime.
The first local image remains available only as an instant fallback while the MP4 starts.
### Images
'''js
IMAGES: {
    ENABLE_SLIDER: true,
    SLIDER_DURATION: 10000,
    ENABLE_OVERLAY: true,
    OVERLAY_FRAME_DURATION: 80,
    ENABLE_BORDER_IMAGE: true,
    IMAGE_LIST: [
        { NAME: "image_1.jpg" },
    ],
},
'''
Images are used only when `VIDEO.ENABLE` is `false`.
### Audio
`MUSIC.VOLUME` is the initial master volume (0-100). The volume slider controls both
music and audible video audio. Mute also controls both sources.
`VIDEO.MUTE_VIDEO = true` is a hard lock: shared controls will never unmute that video.
When video audio is enabled, music does not auto-play over it. If `MUSIC.ENABLE` is
`false`, only the master Mute/Volume controls remain visible; music-only transport
buttons are hidden.
The player's master mute/volume choices are stored locally by the loading screen.
## Character Selection / SKIP
With the matching JRS character integration:
1. Character Selection paints behind the loading screen.