Paradigm Changelog

2.2.4

This is one of Paradigm's largest updates so far. It introduces the Local Dashboard, expands the permission and moderation systems, adds SQL-backed multi-server storage, and significantly improves command reliability across supported Minecraft versions and loaders.

Added

Local Dashboard

• Added the new Local Dashboard, hosted directly by Paradigm and bound to 127.0.0.1 by default.
• Added /paradigm dashboard open for one-click startup and secure one-time login links.
• Added session authentication, one-time tokens, session expiry, CSRF protection, origin checks, and rate limiting.
• Added dashboard pages for:
  • Server overview and runtime status
  • Multi-server status
  • Storage and storage configuration
  • General configuration
  • Teleports and cooldowns
  • Chat
  • Announcements
  • Restart scheduling
  • MOTD editing
  • Custom commands
  • Command settings
  • Permission management
  • Moderation and punishment history
  • Audit history
• Added typed configuration editing with validation, revision checks, per-page save/reset, unsaved-change protection, and reload/restart notices.
• Added Minecraft-style formatting previews for MOTD, chat, announcements, restart messages, and moderation screens.
• Added full custom-command management with create, edit, rename, duplicate, delete, validation, and targeted reload support.
• Added dashboard audit logging with JSONL storage for JSON installs and SQL-backed storage for SQLite/MySQL installations.
• Added server heartbeat snapshots using networkId, serverId, and serverName for multi-server dashboard status.
• Added masked storage configuration editing and connection testing without automatically migrating the active provider.

Permissions and Groups

• Added clickable in-game permission management through /paradigm perms.
• Added group permission management with allow, deny, remove, and list workflows.
• Added direct user permission management.
• Added group metadata editing for weight, prefix, suffix, and description.
• Added /paradigm permission check|explain <player> <permission> to inspect permission decisions.
• Added permission contexts for:
  • server
  • network
  • world
  • dimension
• Added expiring and permanent permission assignments.
• Added stable permission assignment IDs and exact ID-based removal.
• Added contextual group memberships and user permissions.
• Added effective permission browsing and permission-node search.
• Added external Minecraft/mod command permission discovery.
• Added external command permission enforcement with discovered permission nodes such as command.ftbchunks.claim.
• Added Forge and NeoForge permission-node discovery support.
• Added the optional Paradigm permission handler for resolving external permission checks through Paradigm groups and users.
• Added LuckPerms import and export workflows with dry-run, merge, and confirmed replace modes.
• Added LuckPerms migration support for groups, inheritance, weights, prefixes, suffixes, allow/deny nodes, expiry, supported contexts, memberships, and direct user permissions.

Moderation

• Added moderation commands:
  • /kick
  • /ban
  • /tempban
  • /unban
  • /pardon
  • /ipban
  • /tempipban
  • /unipban
  • /mute
  • /tempmute
  • /unmute
  • /warn
  • /setjail
  • /jail
  • /unjail
• Added a unified punishment system for bans, IP bans, mutes, warnings, and jail actions.
• Added stable punishment IDs.
• Added full punishment lifecycle tracking with active, expired, and revoked states.
• Added permanent and temporary punishments using expiry timestamps.
• Added network-wide and server-specific punishment scopes.
• Added complete per-player punishment history.
• Added punishment detail and exact revoke workflows.
• Added custom formatted ban screens for online bans and blocked login attempts.
• Added UUID and IP ban enforcement before normal player join initialization.
• Added active punishment caching so login checks remain memory-only.
• Added asynchronous punishment refresh for multi-server SQL installations.
• Added IP address normalization and hashed IP-ban matching.
• Added documented read-only SQL views for punishment websites, reporting, Discord bots, and other external integrations.
• Added a read-only moderation API through ParadigmAPI.

Storage

• Added the Paradigm storage layer with:
  • StorageService
  • Domain repository interfaces
  • JSON repository adapters
  • SQLite support
  • MySQL/MariaDB support
  • SQL migrations
• Added config/paradigm/storage.json.
• Added multi-server storage identity using networkId, serverId, and serverName.
• Added SQL server instance registration and dashboard heartbeat support.
• Added /paradigm storage status and /paradigm storage test.
• Added paradigm.storage.manage.
• Added deterministic runtime JDBC library downloading for SQLite and MariaDB.
• Added SHA-256 verification and local runtime driver caching.
• Added storage migration dry-runs.
• Added migration conflict policies:
  • overwrite
  • skip
  • fail
• Added automatic JSON snapshots before JSON ↔ SQL migrations.
• Added documented paradigm_v_* SQL views as the supported read-only integration contract.

Commands and Utilities

• Added admin utility commands:
  • /vanish
  • /god
  • /invsee
  • /endersee
  • /repair
  • /enchant
  • /sudo
  • /near
  • /whois
  • /top
  • /jump
• Added paradigm.<command>.others permissions for commands that can target another player.
• Added native player speed handling across Fabric, Forge, and NeoForge.
• Added configurable cooldowns and teleport warmups for home, back, spawn, warp, and teleport-request commands.
• Added a shared command catalog for command IDs, aliases, toggles, and command-root ownership.
• Added consistent command execution failure handling across Fabric, Forge, and NeoForge.

Teleports and /back

• Added death-location support for /back.
• Dying now stores the player's death location so /back can return to it after respawn.
• Added safer previous-location handling for homes, warps, spawn, and accepted teleport requests.

Changed

Dashboard

• Reorganized dashboard navigation into Server, Configuration, Administration, and Advanced sections.
• Reworked configuration pages around focused workflows instead of raw schema/debug-oriented forms.
• Reworked MOTD editing with selectable lines, formatting tools, placeholders, templates, and live previews.
• Reworked chat configuration with per-field formatting controls and previews.
• Reworked announcements with compact reorderable message lists and per-message previews.
• Reworked restart scheduling around the active scheduling mode.
• Fixed intervals now use human-readable value/unit controls.
• Real-time schedules now use HH:mm time controls.
• Restart warning thresholds are shown as readable durations instead of raw seconds.
• Reworked permission management around selected groups, users, and permission nodes.
• Reworked moderation around selected players, active punishments, history, filtering, and punishment details.
• Improved dashboard empty states, validation errors, search, pagination, dirty-state handling, and narrow-screen layouts.

Permissions

• Permission mutations now use the same shared administration service from commands and the dashboard.
• External command permission enforcement now defaults to deny_only.
• Strict external command permissions remain available through configuration.
• command.<path> is now the primary generated command permission format.
• Compatibility aliases remain supported but are no longer stored as duplicate discovered nodes.
• Permission context and assignment handling now uses structured models instead of parsing formatted display strings.
• Unsupported LuckPerms contexts are reported and skipped instead of being silently converted to global permissions.

Moderation

• Moderation commands and dashboard actions now use the same punishment lifecycle and cache.
• Temporary punishments are represented by expiry timestamps instead of separate temporary punishment types internally.
• /unban, /unmute, /unjail, and related actions now revoke punishment records instead of deleting history.
• Paradigm-created bans are managed independently from Minecraft's vanilla ban list.
• Raw IP addresses are no longer exposed through normal moderation output, public SQL views, audit entries, or the public Java API.

Storage

• SQLite is now the default runtime data provider for new installations.
• Existing storage.json provider choices are preserved and are never silently changed.
• JSON configuration files remain JSON regardless of the selected runtime data provider.
• Release jars no longer bundle SQLite or MariaDB JDBC drivers.
• SQL drivers are downloaded and verified only when required.
• Storage migration output now includes migration mode, conflict policy, backup path, and conflict counts.
• SQL warp handling now treats names case-insensitively.

Command Reliability

• Built-in gameplay commands now use mapped native platform operations instead of reflection-based Minecraft method and field guessing.
• Improved cross-loader handling for heal, feed, fly, speed, clear inventory, gamemode, time/weather, god, vanish, inventory inspection, repair, enchant, movement utilities, player locations, and remote addresses.
• Disabled Paradigm commands now release conflicting command roots so vanilla or another mod can provide the same command.
• Command ownership and command toggles now use one shared command catalog.
• Staff and group chat messages are routed before the public chat pipeline to reduce leaks into Discord/chat integration mods.
• WebEditor remains available as a fallback workflow, while the Local Dashboard is now the primary administration interface.

Fixed

Commands

• Fixed /ban and other moderation commands sometimes resolving to Minecraft or another mod's command instead of Paradigm.
• Fixed command ownership metadata drifting out of sync with command toggle registration.
• Fixed command failures being silently swallowed on some Forge versions.
• Fixed /heal, /feed, /fly, and several other utility commands randomly failing between Minecraft versions and loaders.
• Fixed /clearinv, time, and weather commands relying on console fallbacks that could report false success.
• Fixed native speed handling so /speed 1 consistently restores normal movement speed.
• Fixed multi-argument custom commands dropping nested arguments.
• Fixed /customcommandsreload not fully replacing previously registered custom commands.
• Fixed third-party command permission enforcement by adding pre-dispatch guards on Fabric, Forge, and NeoForge.

Teleports

• Fixed Fabric home, warp, spawn, back, and teleport-request commands failing to capture the current player location.
• Fixed cross-dimension home and warp teleports reporting success when the platform teleport failed.
• Fixed /tpa and /tpahere reporting success through failed console teleport fallback paths.
• /home, /warp, /spawn, and /tpaccept now save the previous /back location only after a successful teleport.
• /tpaccept no longer consumes a pending teleport request when the teleport fails.
• Fixed SQL-backed home and warp suggestions remaining empty until a list command refreshed the local cache.

Moderation

• Fixed online bans using a generic disconnect path instead of the configured Paradigm ban screen.
• Fixed JSON moderation storage not preserving permanent punishment metadata.
• Fixed dashboard moderation and login enforcement using different punishment paths.

Permissions

• Fixed duplicated external command discovery entries.
• Fixed dashboard permission checks denying valid authenticated sessions when an online player wrapper could not be reconstructed.
• Fixed permission command and dashboard mutations using separate behavior.
• Fixed exact contextual assignment removal relying on formatted display-string parsing.

Chat

• Fixed staff and group chat messages continuing through the normal public chat event pipeline after being routed privately.
• Improved compatibility with Discord and other chat integration mods that observe normal public chat events.

Dashboard and Storage

• Fixed dashboard shutdown and reload lifecycle issues.
• Hardened dashboard remote-bind warnings, token/session accounting, API error responses, and static asset path handling.
• Improved CSRF, origin, and mutating-request validation.
• Added explicit split-data warnings when a configured SQLite/MySQL provider fails and fallback JSON storage becomes active.
• Fixed dashboard audit storage not consistently following the active data provider.
• Fixed SQL-backed warp lookup, deletion, and listing for mixed-case names.
• Improved WebEditor session creation during temporary Bytebin or live-session connection failures.
• Fixed invalid announcement intervals breaking scheduler startup or reload.
• Fixed scheduled main-thread tasks failing without scheduler-level protection.