Paradigm

Paradigm is a modular server administration and communication tool for Minecraft, designed to give you powerful control over server messaging, player interactions, and automation. Whether you need scheduled announcements, dynamic MOTD, staff coordination channels, or custom commands, Paradigm provides a complete suite of features to enhance your server's functionality and keep your community engaged.

Current Version: 1.2.0b | Author: Avalanche7CZ | License: CC-BY-NC-ND-4.0

---

Core Features

📢 Advanced Announcement System

• Multiple Message Channels: Broadcast messages globally, via action bar, title, or boss bar with independent scheduling
• Random Message Support: Configure random announcement rotations to keep messages fresh
• Flexible Scheduling: Set custom intervals for each message type (milliseconds to hours)
• Dynamic Formatting: Full support for Minecraft text components with colors, styles, and interactive elements
• Server Status Broadcasts: Announce server events and status changes automatically

💬 Communication & Chat Features

• Mentions System: Players can ping each other with @PlayerName syntax with configurable cooldowns and permissions
• Group Chat: Create and manage private chat groups for teams, friends, or special discussions
• Staff Chat: Dedicated private channel for server administrators with optional boss bar indicator when enabled
• Join/Leave Messages: Customize welcome and departure messages with player-specific information
• Message Formatting Parser: Advanced text parsing supporting clickable links, hover events, and command execution

⚙️ Customization & Formatting

• Rich Text Components: Full support for colors, bold, italic, underline, and strikethrough formatting
• Hex Color Codes: Use &#RRGGBB format for unlimited color customization beyond standard Minecraft palette
• Interactive Elements: Add clickable links, runnable commands, and hover tooltips to any message
• Placeholder System: Support for dynamic placeholders in announcements and messages
• Multilingual Support: Built-in translations for Czech, English, and Russian with extensible language system

🎮 Custom Commands & Server Management

• Custom Command Creation: Define custom server commands with multiple actions and flexible arguments
• Restart Scheduler: Automated server restart scheduling with pre-restart commands and warning broadcasts
• Configurable Warning System: Multiple warning messages at customizable intervals before restart
• Countdown Timers: Dynamic countdown displays to alert players of upcoming restarts
• Permission-Based Access: Integrate with LuckPerms for granular permission control

🛠️ Web Configuration Editor

• Live Configuration Editing: Web-based interface for editing configuration files without server restart
• Session Management: Secure WebSocket connections for real-time configuration updates
• Visual Configuration: User-friendly interface for managing complex settings

📊 Development Features

• Modular Architecture: Clean plugin system with ParadigmModule interface for extensibility
• Debug Logging: Built-in debug logger for development and troubleshooting
• Event System: Comprehensive event listener system for chat events and server lifecycle
• Telemetry Reporter: Optional telemetry for usage statistics
• JSON Validation: Automatic JSON configuration validation and error reporting

---

Compatibility

Version	Mod Loader	Required Version	LuckPerms	Status
1.21.1	NeoForge	52.1.0+	✅	ACTIVE
1.21.1	Forge	52.1.0+	✅	Active
1.20.1	Forge	47.4.2+	✅	Active
1.19.2	Forge	41.1.0+	✅	Active
1.18.2	Forge	40.2.21+	✅	Active
1.21.1	Fabric	0.16.14+	✅	Active
1.21.8	Fabric	0.16.14+	✅	Active
1.21.6	Fabric	0.16.14+	✅	Active
ANY FABRIC	NeoForge + Sinytra	21.0.8-beta+	✅	EXPERIMENTAL
1.20.1	Fabric	0.14.21+	✅	Active
1.12.2	Forge	14.23.5+	✅	BUG FIXES ONLY

---

Installation

For Forge

1. Download and install the recommended version of Minecraft Forge for your game version (see compatibility table above)
2. Download the latest Forge version of Paradigm from the Releases Page
3. Place the Paradigm .jar file into your server's mods folder
4. (Optional) Install LuckPerms for permission-based features

For Fabric

1. Download and install the Fabric Loader for your game version
2. Download the Fabric API and place it in your mods folder (required)
3. Download the latest Fabric version of Paradigm from the Releases Page
4. Place the Paradigm .jar file into your server's mods folder
5. (Optional) Install LuckPerms for permission-based features

For NeoForge

1. Download and install NeoForge for your game version
2. Download the latest NeoForge version of Paradigm from the Releases Page
3. Place the Paradigm .jar file into your server's mods folder
4. (Optional) Install LuckPerms for permission-based features

For NeoForge via Sinytra Connector (Experimental)

If you prefer to use the Fabric version with NeoForge, you can use Sinytra Connector:

1. Download and install NeoForge for your game version
2. Download Sinytra Connector and place it in your mods folder
3. Download Forgified Fabric API and place it in your mods folder
4. Download the latest Fabric version of Paradigm from the Releases Page
5. Place the Paradigm Fabric .jar file into your mods folder
6. (Optional) Install LuckPerms for permission-based features

Note: The dedicated NeoForge version is recommended. The Sinytra Connector method is experimental and may have compatibility issues.

---

Configuration

File Structure

After running the server once with Paradigm installed, configuration files will be generated in your server's config/Paradigm/ directory:

config/Paradigm/
├── config.json               # Main settings and module toggles
├── announcements.json        # Automated announcement scheduling
├── motd.json                 # Message of the Day configuration
├── mentions.json             # Mention system settings
├── restart.json              # Server restart scheduler
├── chat.json                 # Group chat and staff chat settings
└── cooldown.json             # Cooldown configurations

Using the Web Editor

Paradigm includes a web-based configuration editor for convenient live editing without server restarts. Access the web interface and make real-time changes to your configuration files.

---

Commands Reference

Main Commands

• /paradigm - Display main Paradigm help
• /paradigm help - Show help for Paradigm modules
• /paradigm help <module> - Show help for a specific module
• /paradigm reload <config> - Reload specific config (main, announcements, chat, motd, mention, restart, customcommands, all)
• /paradigm editor - Access web configuration editor

Restart Management

• /restart now - Schedule an immediate server restart
• /restart cancel - Cancel a scheduled restart

Staff Chat

• /sc - Toggle staff chat mode
• /sc toggle - Toggle staff chat mode

Group Chat

• /groupchat create <name> - Create a new group chat
• /groupchat join <name> - Join an existing group chat
• /groupchat leave - Leave current group chat

Mentions

• /mention <player> - Mention a specific player

Web Editor

• /paradigm editor trust - Trust a player for web editor access
• /paradigm editor untrust - Remove web editor trust
• /paradigm editor trusted - List trusted players
• /paradigm editor apply - Apply web editor configuration changes

---

Permissions

Paradigm uses LuckPerms for permission management. Common permission nodes:

paradigm.mention.everyone     # Use @everyone in Mentions
paradigm.mention.player       # Mention individual players
paradigm.staff                # Access staff chat (/sc)
paradigm.restart.manage       # Manage server restarts
paradigm.broadcast            # Send broadcast messages
paradigm.actionbar            # Send actionbar messages
paradigm.title                # Send title messages
paradigm.bossbar              # Send bossbar messages
paradigm.reload               # Reload configurations
paradigm.groupchat            # Use group chat commands

---

License

This project is licensed under the CC-BY-NC-ND-4.0 license. See the LICENSE file for details.

• ✅ You can use this project
• ❌ You cannot modify it
• ❌ You cannot distribute it commercially
• ✅ You must give credit to the author

---

Support & Community

Have questions, need help, or want to try the latest development builds? Join our community on Discord!

---

Credits

Paradigm is developed and maintained by Avalanche7CZ. Special thanks to all contributors and community members who have provided feedback and support.