Paradigm Version 12.0.6
- Refactored all config and language file handlers to use UTF-8 encoding for reading and writing files, ensuring proper handling of non-ASCII characters
- Added a new Simplified Chinese translation by @KiiroDAYO https://github.com/Avalanche7CZ/Paradigm/issues/11
Changelog
Refactoring
- Refactored player cconversion, platform interfaces, and event system.
- Platform abstractions (
IComponent
,IPlayer
,IPlatformAdapter
). - Introduced
ICommandSource
andIEventSystem
for platform-independent command & event handling. - Refactored command registration to use
ICommandSource
andCommandDispatcher<?>
. - Improved permission checks, messaging, and code maintainability by reducing direct MC dependencies.
Features
- Added anonymous telemetry reporting (configurable, anonymized server metrics - The mod only sends player count and which version of mod u are using).
- Added robust JSON validation (
JsonValidator
) with auto-syntax correction and preserved user values. - Added argument support for
CustomCommand
(advanced tab completion & validation fixed). - Added /paradigm reload command to reload configs at runtime.
- Added help command module with interactive help for all modules.
Improvements
- Enhanced debug logging across initialization, restart scheduling, and config handling.
- Refined restart scheduler (bossbar, chat, title notifications).
- Improved announcement logic, placeholder replacement, and permission handling.
- Group Chat: new join request system, invite cooldowns, clickable UI, better feedback & messages.
- Staff Chat: static enable check, improved logging format, and higher priority than Group Chat.
Fixes
- Fixed placeholder replacement for null players.
- Updated language files with new translations & formatting.
- Improved update checking (now uses Modrinth API).
f21.0.beta6
✨ New Features
-
JSON Validator Utility
- Validates and auto-fixes JSON syntax in configuration files.
- Integrated into all config handlers for safer error handling and better user feedback.
-
Anonymous Telemetry (Configurable, Default: TRUE)
- Optional telemetry reporting with privacy-friendly settings.
-
Custom Commands Enhancements
- Improved typed argument support.
- Improved tab completion for easier usage.
-
Group Chat Improvements
- Join requests and invite accept/deny commands.
- Expanded functionality for group communication.
🛠 Improvements
- Refactored config handlers with lazy loading and thread safety.
- Improved announcements with randomized selection.
- Expanded language utility methods for better localization support.
REMEMBER TO BACKUP YOUR CONFIGS, JUST IN CASE!
✨ New Features
🚀 Completely Revamped Custom Commands
The custom command system has been significantly upgraded, offering a level of power and flexibility inspired by popular server plugins.
-
Argument Support
Commands can now accept and validate arguments.- Use placeholders like
$1
,$2
for specific arguments. - Use
$*
for multi-word text. - Arguments can be validated as specific types (e.g., number, boolean) with automatic error handling.
- Use placeholders like
-
Advanced Autocomplete
Configure tab-completion for command arguments:- Player names
- Gamemodes (
survival
,creative
) - Worlds
- Custom lists of words
-
Conditional Logic
Create complex commands that run different actions based on conditions such as:has_item
has_permission
is_op
-
Persistent Cooldowns
Add cooldowns to any command to prevent spam.
Cooldowns persist through server restarts. -
Area Restrictions
Limit commands to:- Specific worlds
- Coordinate areas
Perfect for spawn-only commands or event zones.
-
Customizable Join/Leave Messages
Set up custom messages for:- Player joins
- Player leaves
Includes a special message for first-time joins.
-
New Restart Commands
/restart
now includes:/restart now
→ Immediate restart/restart cancel
→ Cancel a scheduled restart
🛠️ Improvements & Updates
-
Sound Control
playSound
now accepts aSoundSource
category parameter for precise sound playback control in features like Mentions and Restart modules. -
Config Resilience
All config handlers now merge loaded values with defaults instead of overwriting them.- Better backward compatibility
- More resilience to missing fields in config files
✨ New Features
🚀 Completely Revamped Custom Commands
The custom command system has been significantly upgraded, offering a level of power and flexibility inspired by popular server plugins.
-
Argument Support
Commands can now accept and validate arguments.- Use placeholders like
$1
,$2
for specific arguments. - Use
$*
for multi-word text. - Arguments can be validated as specific types (e.g., number, boolean) with automatic error handling.
- Use placeholders like
-
Advanced Autocomplete
Configure tab-completion for command arguments:- Player names
- Gamemodes (
survival
,creative
) - Worlds
- Custom lists of words
-
Conditional Logic
Create complex commands that run different actions based on conditions such as:has_item
has_permission
is_op
-
Persistent Cooldowns
Add cooldowns to any command to prevent spam.
Cooldowns persist through server restarts. -
Area Restrictions
Limit commands to:- Specific worlds
- Coordinate areas
Perfect for spawn-only commands or event zones.
-
Customizable Join/Leave Messages
Set up custom messages for:- Player joins
- Player leaves
Includes a special message for first-time joins.
-
New Restart Commands
/restart
now includes:/restart now
→ Immediate restart/restart cancel
→ Cancel a scheduled restart
🛠️ Improvements & Updates
-
Sound Control
playSound
now accepts aSoundSource
category parameter for precise sound playback control in features like Mentions and Restart modules. -
Config Resilience
All config handlers now merge loaded values with defaults instead of overwriting them.- Better backward compatibility
- More resilience to missing fields in config files
Bug Fixes:
- Fixed issues with sound playback for restart and mention notifications.
- Resolved mixin-related issues affecting mod functionality.
Improvements & Refactoring:
- Server restart scheduling logic has been refactored and consolidated for better reliability and maintainability.
- Added null checks to configuration loading handlers to prevent data corruption.
- Configuration handling and chat modules (Announcements, MOTD, Restart, Mentions) have been significantly refactored for improved stability, null safety, and error handling.
- Enhanced group chat and staff chat logic with stricter validation and more robust toggling.
- Updated sound playback to include sound categories for more precise control.
Version f21.0.beta3 Changelog
This update introduces powerful new features for server administration, major improvements to the configuration system, and significant backend refactoring for better stability and future development.
✨ New Features
- Advanced Custom Commands: The custom command system has been significantly upgraded with powerful new logic and actions:
- Conditional Actions: Create complex commands that run different actions based on whether a player meets certain conditions (e.g.,
has_item
,has_permission
,is_op
). - Persistent Cooldowns: Add a cooldown (in seconds) to any custom command to prevent spam. Cooldowns are saved and persist through server restarts.
- Area Restrictions: Restrict commands to specific coordinates or worlds, allowing you to create region-specific commands for hubs, dungeons, or special zones.
- Conditional Actions: Create complex commands that run different actions based on whether a player meets certain conditions (e.g.,
- Customizable Join/Leave Messages: A new module has been added to control the messages displayed when a player joins, leaves, or connects for the very first time. You can now create unique welcome experiences for your players!
- Restart Commands: Server administrators now have direct control over restarts:
/restart now
: Instantly triggers a server restart with a 60-second countdown./restart cancel
: Aborts any pending scheduled restart.
- Custom Toast Notifications: An experimental feature to display "toast" style pop-up notifications in-game. These can be triggered by commands and are now used for Group Chat actions.
🚀 Improvements & Optimizations
- Massive Config System Overhaul: The entire configuration system has been refactored. Your config files (
main.json
,chat.json
, etc.) will now include helpful descriptions for each option. Most importantly, this new system safely preserves your custom settings when you update the mod, only adding new default options where needed. - Dynamic Debug Logger: The
debugEnable
flag inmain.json
now dynamically controls the log level. When enabled, it provides much more detailed information for troubleshooting without requiring a server restart.
🔧 Refactors & Technical Changes
- Platform Adapter Abstraction: A major internal refactor was completed to introduce a "Platform Adapter." This separates the core mod logic from platform-specific code (Fabric API). This makes the codebase much cleaner, improves testability, and paves the way for easier updates and potential ports to other platforms in the future.
- Code Organization: Chat-related modules have been moved into their own dedicated
chat
package for better project structure.
Paradigm - Fabric 1.21.1 beta2 Changelog
Fixes & Improvements
Restart Module
- Completely overhauled the scheduling logic to fix severe server lag and crashes (Watchdog).
- The server now shuts down correctly without getting stuck.
- The "Initializing..." boss bar is now temporary and disappears correctly.
- The configuration file is now more robust and will not crash the server if it's invalid.
Chat Modules (StaffChat & GroupChat)
- Fixed the major bug causing messages to be duplicated in both private and public chat.
- Corrected message formatting to properly display player names.
Core System
- Fixed a critical bug where configurations were not loading correctly on server startup.
Known Issues
- Redirected chat messages (Staff/Group Chat) spam a harmless
NullPointerException
in the console. - Warning sounds in the Restart module are not functional yet.
Paradigm Version 12.0.5 (The Modernization Update for 1.12.2)
This is a massive update for the Minecraft 1.12.2 version of Paradigm! The entire mod has been rewritten from the ground up to match the modern architecture and feature set of the latest versions, making it more powerful, stable, and easier to maintain.
PLEASE TEST EVERYTHING, IF THERE IS BUG REPORT IT!
✨ New Features (for 1.12.2)
- Custom Commands are Here!
- The full
CommandManager
module has been back-ported from the modern versions. You can now create your own custom commands with multiple actions by simply creating.json
files in theconfig/paradigm/commands/
folder!
- The full
- Introducing Group Chat!
- The
GroupChat
module has been back-ported, allowing players to create, join, and chat in their own private groups. All commands from the modern versions are included (/groupchat create
,/invite
,/toggle
, etc.).
- The
- Staff Chat is Back!
- The Staff Chat module (
/sc
) has been completely refactored and back-ported, providing a private channel for your team to coordinate, complete with the optional boss bar indicator.
- The Staff Chat module (
- Standardized JSON Configurations:
- The old
.cfg
files have been completely replaced! All configuration for the 1.12.2 version now uses the same easy-to-read.json
format as the Fabric version, making server management much simpler. Your old configs will be replaced with new, self-documenting JSON files.
- The old
⚙️ Improvements & Fixes
- Complete Code Refactor: The entire internal structure of the mod has been modernized to use a more stable and efficient service-based architecture.
- Unified Message Parser: All modules now use the same powerful message parser, ensuring that features like
[link]
,[hover]
, and[command]
tags work consistently everywhere. - Bug Fixes: Fixed a critical server crash (
NullPointerException
) that could occur when players logged in and received the MOTD. - Improved Logging: The debug logger is now more consistent and provides better information for troubleshooting.
- Permission System Parity: The
PermissionsHandler
has been updated to match the structure of modern versions, improving compatibility with permission mods.
-
Configuration File Changes:
- All configuration management is now centralized in
/config
. - Any changes made to these config files will be applied correctly when the server restarts.
- All configuration management is now centralized in
-
Language Support:
- Introduced a new
Lang
class for easier language management. - Language selection can now be customized through the main config file.
- Available languages: English (
en
), Czech (cs
), and Russian (ru
).
- Introduced a new
-
Language File Enhancements:
- Both standard color codes and hex colors can now be used in language JSON files for greater flexibility in text formatting.
-
MOTD:
- The MOTD configuration format has been updated to
JSON
for easie configuration
- The MOTD configuration format has been updated to
-
Other Changes:
- The FTBRanks permission check is included.
- Integrated tag handling directly within the MessageParser class (former ColorUtils)
- Fixed error about sound string in Restart class
- Dynamic custom permissions register for ForgeEssentials and LuckPerms mod
-
New Custom Command Feature:
- Added the ability to define custom commands through the configuration file.
- Supported actions: message, run_console, run_command, teleport