Lithera RP [ EN | FR | DE ]
Released
LitheraRP is a roleplay gamemode for s&box.
Changes
What's changed in Lithera RP [ EN | FR | DE ] with each update.
🎁 Added
- Server operators can now configure a global owned-object limit from the spawn settings panel.
🧼 Improved
- Improved server performance and stability for high-population sessions, especially around props, vehicles, NPCs, printers, statistics and autosaves.
- Reworked anti-propkill processing with a centralized scheduler, bounded per-frame work and nearby-only vehicle checks.
- Vehicle seats now release correctly after exits, deaths, disconnects and rapid vehicle changes, while driver input and replication avoid full-scene scans.
- Printers, ambient NPCs, statistics, autosaves and addon ticks now use staggered or bounded work to reduce synchronized frame spikes.
- Weapon firing, reloads, shotgun pellets and grenades now use stricter host authorization with bounded traces and consistent latency handling.
- Jail state, inventory wipes and corrupted local save recovery now remain authoritative across reconnects and restarts.
🪛 Fixed
- Player saves and backend sessions now recover safely from slow requests, lost responses, rapid reconnects and shutdown timing without duplicating economy changes.
- Bank transactions now retain their order, retry safely after backend outages and avoid duplicate history rows after a lost response.
- Death cash drops and owned-object spawns now commit transactionally, preventing lost money, duplicate drops and ownerless objects when spawning fails.
🎁 Added
- Code addons can now declare required and optional versioned dependencies, conflicts, failure policies, protocol versions and operator-granted capabilities.
- Jobs, items, shop stock and clothing can now be added, replaced or suppressed through reversible priority layers that restore the previous state when an addon is disabled.
- Addon storage now supports player, server and world documents with schema migrations, serialized writes and atomic file replacement.
- Addons can now publish versioned services and local JSON events for explicit inter-addon integration.
- Initial player spawning can wait for the exact client addon snapshot, with fingerprint acknowledgement, timeout handling and required-addon failure policy.
- The Operator addon panel now displays requested capabilities, lets operators grant them explicitly and configures the client readiness timeout.
- Weapon firing and reloading now separate local prediction from host authorization, with host-owned ammo, projectiles, impacts and damage.
🧼 Improved
- The addon event bus now exposes 118 verified hooks across player lifecycle, inventory, economy, combat, doors, vehicles, seats, world objects, voice, chat and phone systems.
- Custom addon networking now supports namespaced JSON messages before or after pawn creation, with payload limits, rate limits and optional host permission checks.
- Inventory and world-drop mutations now commit once through operation IDs, applied-quantity bounds and distinct item identifiers.
- Rebuilt the Creator code-addon documentation into focused guides for setup, lifecycle, Context APIs, every hook, networking, persistence, services, registries, UI, security and troubleshooting.
🪛 Fixed
- Host weapon validation now rejects stale, replayed, out-of-order, over-rate or wrong-owner requests and correlates reported hits with the authorized shot.
- Voluntary seat exits now fail closed on the host and raise their committed event only after the player has actually left the seat.
- Damage hooks now report resolved, applied, absorbed and overkill values instead of treating the requested amount as the final result.
- Dealer purchase events now report the quantity actually delivered and the amount actually charged.
- Player pawn creation events now distinguish the selected factory, the prefab actually used and fallback creation.
- Disabling an addon now cancels pending async work and unwinds tracked registrations, resources, services and callbacks without allowing late continuations to restore them.
🎁 Added
- Addon authors can now add new native phone apps, replace core phone apps or disable selected core apps cleanly.
- Native addon consumables are now supported through the backpack Use flow, with host-side item, slot and effect validation.
- Addons can add sellable products to the existing weed and meth dealers, including native UI summaries and host-side pricing.
- Custom Toolgun modes can now register mode ids, permission nodes and host actions without touching the core Toolgun list.
- Addon moderation and VIP flows are covered by chat commands, namespaced permissions, admin panels, addon logs and connection hooks.
- The reference addon now includes a counterfeit-document production loop, forged-document dealer product, VIP status command, mod note command, phone app and custom press Toolgun mode.
- Added source-contract coverage for Toolgun relays, balance mutations, public addon APIs, native phone/inventory/dealer/NPC integration, clean addon uninstall and cloud asset shadows.
🧼 Improved
- Every native Toolgun host action now passes through the cancelable ToolgunActionRequested hook before it places or mutates anything.
- Player cash and bank changes now pass through a single BalanceChangeRequested pre-hook before commit, with MoneyChanged still raised after success.
- Addons can now override or decorate configured NPCs by exact id or type, including the native dealer NPCs.
- Universal property eviction now covers property groups, single doors, runtime doors and penthouse ownership from addon code.
- Data-only addon installs now write an uninstall ledger so clean removal can drop unchanged addon data while preserving later operator edits.
- Runtime map doors keep their fallback model and retry cleanly if a dynamic cloud model is slow or unavailable.
- The loading screen now handles compile-time cloud assets and runtime-mounted packages separately, so a slow mount cannot hold the player forever.
🪛 Fixed
- Fixed metal, wooden and plastic doors showing as Error models when old local compiled assets were shadowing the cloud versions.
- Door cloud models now apply to both visuals and collisions, with retry handling while the asset is still mounting.
- Weed pots no longer get stuck on a broken visual when the cloud package finishes loading a little late.
🚯 Removed
- Removed stale local compiled door and wired-glass assets that could override the official cloud assets again later.
🎁 Added
- Code addon SDK for s&box Targeted Addons: ILitherarpAddon lifecycle, host/client activation, host tick hooks and shutdown teardown.
- Code loading is opt-in at global and per-addon level, gated by trusted ParentPackage metadata, with local.* support for editor development.
- Addon context can register runtime jobs, shop stock, NPCs, custom NPC kinds, clothing, runtime items, config files, localization, screen panels and chat commands.
- Public addon config sections sync through the normal config snapshot, while per-player addon sections sync privately to the owning client.
- Gameplay event bus exposes cancelable pre-hooks and post-events across connection, jobs, economy, combat, law, bank, salary, shops, dealers, property, chat, inventory, votes, heists, phone, taxi, drugs and props.
- Per-addon player data persistence stores JSON under addon_data/<addon>/<steamId>.json, separate from core player saves.
- Status effects API added with timed effects, damage-over-time helpers, addon-scoped ids and automatic cleanup.
- Public host primitives added for player teleport, owned vehicle spawning, property-group release, group bank accounts and owned-object management.
- Addon UI registry supports persistent addon panels and controlled hiding/restoring of non-protected core panels.
- Example addon project ships with config, a job, food item, HUD panel, chat command, gameplay hooks, custom vehicle vendor NPC and compile-check project.
🧼 Improved
- Added full Addon SDK documentation and updated creator documentation.
🎁 Added
- Bank Clerk NPC added with a dedicated Lithera Bank menu for group accounts and safe deposit boxes.
- Group bank accounts: create named shared accounts, invite online players, manage members, rename accounts, leave accounts and delete empty accounts.
- ATMs now support personal and group account selection for deposits, withdrawals and transaction history.
- Group account rules are configurable, including max members, max led accounts, name length, withdrawal policy and transaction history size.
- Safe Deposit Box: permanent bank storage that survives death and reconnects, with item drag/drop between backpack and safe slots.
- Safe deposit slots can be upgraded from the bank menu using bank funds, with configurable slot totals, default unlocks, access window and purchase tiers.
- Bank menu opens the backpack while using the safe deposit tab and blocks accidental ground drops during safe storage operations.
- Default bank clerk placement and NPC config support added in configs/npcs.json.
- Admin Economy panel can audit group bank accounts, set shared balances and delete group accounts with dedicated permissions.
- Admin Inventory panel can view safe deposit boxes, set unlocked safe slots and clear safe deposit contents with dedicated permissions.
🧼 Improved
- Bank clerk menu hitboxes, centering, clipping and layout were refined for cleaner interaction.
- Safe deposit access stays alive while the bank menu is active and refreshes during safe usage.
- Safe deposit drag/drop now uses safe-grid placement, correct hover previews and scaled drag target hit tests.
- ATM RPCs now keep account/session state tighter when selecting personal or group accounts.
- Added English, French and German localization for the bank menu, bank clerk, group accounts, safe deposits and admin banking tools.
- Added inventory footprint tests for three-column safe deposit grids.
🎁 Added
- Character appearance: gender, body preset, skin tone, hair color, height, age and civilian outfit now persist with the RP profile.
- Character creation designed as a full-screen studio with isolated 3D preview, category filters, search, thumbnails, randomization, undo/redo and walk/idle preview.
- Clothing catalogue scans mounted Citizen clothing, infers categories, handles thumbnails and supports configured extra clothing from cloud packages.
- Wardrobe ownership system: purchased clothing is saved per character and the editor only equips owned wardrobe items, with free hair/face cosmetics preserved.
- Clothing Shop NPC: browse categories, preview thumbnails, buy items with configurable prices and see owned clothing at a glance.
- Appearance Clinic NPC: edit RP identity, hair, outfit and protected body options after creation with configurable change costs.
- Health Clinic NPC: pay for direct healing with prices and medical values moved to configs/medical.json.
- Clothing config added in configs/clothing.json with legacy avatar toggle, custom catalogue entries, category/resource pricing, shop blacklist and equipment blocklist.
- NPC Config tool/editor can place, move, remove and edit configured NPCs, including clothing shop, appearance clinic and health clinic entries saved in configs/npcs.json.
- Admin player appearance tab can grant/remove owned clothing and apply live character appearance changes with new permission nodes.
🧼 Improved
- Added English, French and German localization for the character studio, clothing shop, appearance clinic and health clinic.
🎁 Added
- City Hall heist: lockpick the City Hall safebox, open the vault and extract visible cash or gold loot.
- Info Broker NPC: buy intel for estimated payout, city heat, personal cooldowns and cash in stolen City Hall loot.
- Vault payouts can be treasury-based or fixed, with configurable min/max payout, global cooldown, per-user cooldown and blocked jobs.
- Mayor vault panel lets government review City Hall treasury exposure, vault state and active cooldowns from the opened safe.
- Visible vault loot tiers show cash and gold resources based on the reserved payout, with hold-to-collect progress in the pressable tooltip.
- New City Hall safebox prefab with custom safe models, materials and opening/closing sounds.
- Heist config is editable through the Operator config editor and ships as configs/heist.json.
🪛 Fixed
- Fix host request when exiting a vehicle.
🎁 Added
- Runtime Map ATM tool: operators can place, remove and disable persistent map ATMs saved in configs/map_atms.json.
- Map ATM config supports scene-default restoration and rebuilds through the Operator config editor.
- Job spawn points moved to configs/spawn_points.json with reload/reset commands and a litherarp.spawn_here helper.
- Scheduled restart system with configs/restart.json, timezone-aware schedules, lead time and alert thresholds.
- In-game restart alert panel shows countdowns, urgent alerts and restart reasons to connected players.
- Friendly Operator restart config panel added for editing schedules without raw JSON work.
- Added permission nodes for map ATM management and scheduled restart controls.
- Added English, French and German restart localization plus restart config logic tests.
🧼 Improved
- Admin-only tool modes are now hidden unless the player has the matching permission.
- Leaving admin mode now clears any active noclip movement state on the owner client.
- Map door transition sounds now resolve and play more reliably.
- Config metadata refreshes after hotload so newly managed sections appear correctly.
🎁 Added
- Community server config foundation: generated JSON files with validation, fallback reports and public client snapshots.
- Most gameplay systems are now configurable: jobs, shops, NPCs, modules, spawn rules, tools, vehicles, emergency, government, rules and rewards.
- In-game Operator console with overview, config health, editable config files, specialized editors and restart/reload/reset actions.
- Ranks and permissions system with Operator rank, inheritance, wildcard nodes, permission-gated admin tabs and configurable chat prefixes/colors.
- Community identity and social links: server display name, extra links and community/official server labeling in player-facing UI.
- Theme system with safe visual tokens, HUD-only styles, advanced stylesheet mode and bundled community theme examples.
- Creator server token verification and admission gate for authorized community server access.
- Addon manifest importer: mount trusted data add-ons, import config patches, back up edited files and roll back failed imports.
- Runtime Map Door and Glass tools let operators place persistent doors and glass panes saved to server config.
- Configurable NPC placements, vendor bindings, access requirements and ambient NPC look-at behavior.
- Added community config docs, example packs, demo themes and sample data-addon/firearm-addon manifests.
- Added broad tests for config validation, permissions, jobs, shop, NPCs, rewards, tools, vehicles, admission and themes.
🧼 Improved
- Admin console redesigned with better player management, ticket badges, rank editing, health checks and config issue visibility.
- Community-safe validation added for config files, permissions, ranks, URLs, themes, asset references and addon patches.
- Backend-only features, rewards visibility and server warnings now adapt cleanly between official and community servers.
- Scoreboard rank prefixes, community server names, Discord icon loading, phone GPS visibility and jail dialog inputs polished.
- Disabled modules now hide or block related UI and server actions more consistently.
🎁 Added
- Backpack inventory reworked with multi-slot item footprints, a dedicated gear section and clearer drag/drop previews.
- Equipable backpacks: the Tactical Backpack unlocks extra inventory slots and applies its backpack clothing while equipped.
- Dedicated ammunition section tracks stored ammo by type with unload/drop actions and 40mm ammo support.
- Consumables and protection can now be used from inventory: food restores hunger and kevlar grants armor.
- Item definitions now support localized names, descriptions, rarity, texture icons, slot size and gameplay metadata.
- Body loot now includes backpack items, stored ammo and clearer item source labels.
- Admin inventory panel can inspect and manage player hotbars, backpack slots and item grants with slot footprints.
- Character creation now has configurable first/last name pools and shuffle buttons.
- Static RP NPCs now have ambient look-at behavior so dealers feel less frozen.
🧼 Improved
- Added localized inventory, item and dealer strings in English, French and German.
🪛 Fixed
- Backpack drag/drop, split, merge and slot placement rules hardened for multi-slot items and equipped backpack slots.
- Inventory UI tooltips, drag ghost, phone slot and dealer badges refreshed for clearer feedback.
🎁 Added
- Wall Builder tool: create custom walls from two corners with adjustable depth and placement preview.
- Blueprint tool: select owned props, save local blueprints and paste them later with preview and rotation controls.
- New building tools: Precision, Stacker, Material, Color, Light and Text Sign.
- Button tool: place physical buttons linked to fading doors alongside keypad support.
- Modern spawn menu building workflow with grouped tools, resource selectors and blueprint selector popups.
- Prop Access panel lets owners grant trusted players toolgun and physgun access to their props.
- Prop Cleanup panel lets players remove their spawned removable objects with confirmation.
- Linked Objects panel highlights and manages constraints, keypads, buttons and fading-door links.
🧼 Improved
- Duplicator and blueprint pastes now validate object counts, bounds, transforms, packages and allowed components before spawning.
- Placement validation now blocks spoofed positions, invalid coordinates, range abuse and protected targets.
- Fading doors, keypads and buttons are preserved more reliably across duplication and blueprint workflows.
- Toolgun and prop permission checks are stricter and more consistent across building tools.
- Expanded English, French and German localization for building, admin and spawn-menu UI.
🎁 Added
- Property groups: multiple doors can now be bought, sold and managed as one named property.
- For-sale signs and a dedicated purchase panel make listed properties easier to find and buy.
- Functional apartment elevator with cabin controls, floor call stations, animated doors and passenger-safe movement.
- Penthouse system: buyable residence with rent, owner controls, residents, guests and temporary access.
- Penthouse access requests, doorbell notifications, silent alarm and elevator lockdown controls.
- Penthouse security console and in-world screens for monitoring elevator and access activity.
- Elevator audio pass with moving, door opening and door closing sounds.
- Rewards system: daily and streak rewards, Discord account linking and detailed reward steps.
- Rules acceptance system with local persistence, backend sync and a refreshed rules panel.
🧼 Improved
- Death screen reworked with clearer revive state, avatar presentation and medic-aware messaging.
- Keypad cracker feedback improved, including penthouse elevator button cracking support.
🪛 Fixed
- Government warrants now sync to clients and allow police breach actions on approved targets.
🎁 Added
- Full vehicle system: physics-based driving with wheel joints, suspension, steering and brake simulation.
- Vehicle access: lockable vehicles with owner keys, key sharing and lockpick support.
- Vehicle doors and hatches: animated swing doors with hinge pivots, hoods and trunks.
- Breakable vehicle glass: per-window damage with shard particles and trace-through support.
- Vehicle headlights, horn, exhaust particles and engine sound controller.
- Vehicle HUD: speed, RPM, gear indicator, brake lights, hotkey overlay and phone-aware positioning.
- Vehicle door access panel: lock/unlock UI with key management.
- Vehicle entry guard: door-state-aware seat entry/exit with collision suppression.
- Localization: fully configurable localization system.
- Taxi job: dispatch NPC, spawnable taxi vehicle with configurable fare, metered billing and passenger detection.
- Taxi phone app: passengers can call a taxi from anywhere, drivers see waypoint markers on-screen.
- Taxi dashboard and passenger screens: in-world displays baked into the prefab.
- Taxi customer HUD: ride status, fare counter and destination tracking.
- Full French and English localization for vehicles, taxi, chat and loading screens.
- New localization files: taxi.json, vehicle.json and loading.json for both languages.
- Expanded localization defaults with structured key registration.
🧼 Improved
- Player body mass corrected from 500 to 85 (realistic weight, fixes vehicle physics interactions).
- Anti-prop kill system updated to handle vehicle collisions.
- Physgun updated to support vehicle grabbing for admins.
- Lockpick reworked with server-side channeling to prevent instant-break exploits.
- Rework changelogs ui.
🪛 Fixed
- Inventory bar layout improvements.
- Loading screen enhancements.
- Chat panel refinements.
- Speculative fix for Discord icon in esc menu.
🎁 Added
- Full vehicle system: physics-based driving with wheel joints, suspension, steering and brake simulation.
- Vehicle access: lockable vehicles with owner keys, key sharing and lockpick support.
- Vehicle doors and hatches: animated swing doors with hinge pivots, hoods and trunks.
- Breakable vehicle glass: per-window damage with shard particles and trace-through support.
- Vehicle headlights, horn, exhaust particles and engine sound controller.
- Vehicle HUD: speed, RPM, gear indicator, brake lights, hotkey overlay and phone-aware positioning.
- Vehicle door access panel: lock/unlock UI with key management.
- Vehicle entry guard: door-state-aware seat entry/exit with collision suppression.
- Localization: fully configurable localization system.
- Taxi job: dispatch NPC, spawnable taxi vehicle with configurable fare, metered billing and passenger detection.
- Taxi phone app: passengers can call a taxi from anywhere, drivers see waypoint markers on-screen.
- Taxi dashboard and passenger screens: in-world displays baked into the prefab.
- Taxi customer HUD: ride status, fare counter and destination tracking.
- Full French and English localization for vehicles, taxi, chat and loading screens.
- New localization files: taxi.json, vehicle.json and loading.json for both languages.
- Expanded localization defaults with structured key registration.
🧼 Improved
- Player body mass corrected from 500 to 85 (realistic weight, fixes vehicle physics interactions).
- Anti-prop kill system updated to handle vehicle collisions.
- Physgun updated to support vehicle grabbing for admins.
- Lockpick reworked with server-side channeling to prevent instant-break exploits.
- Rework changelogs ui.
🪛 Fixed
- Inventory bar layout improvements.
- Loading screen enhancements.
- Chat panel refinements.
- Speculative fix for Discord icon in esc menu.
🎁 Added
- Printer hint card for first time user.
🧼 Improved
- Better printer temperature warnings.
- Explosions radius sound.
🪛 Fixed
- Weed growning pot model.
- Acetone model
- Pseudoephedrine Pills model.
- Props & entities deletion after player disconnect (60s delay).
🎁 Added
- Phone item: purchasable from the arms dealer (Tools category, $750), stored in a dedicated phone slot and persisted across sessions.
- Phone UI: GTA V-style holdable HUD opened by holding the Up arrow, with arrow-key navigation and a configurable binding section in phone.json.
- Phone: Messages app.
- Phone: Calls app.
- Phone voice.
- Phone: Bank app.
- Phone: GPS app.
- Phone settings.
- Fence NPC: black-market dealer that buys spare phones from the backpack and owned entities (printers, weed pots, drug machines) at a fraction of their original price.
- New phone dragging support in the backpack.