SwissKnife - Alerts & Guidance Toolkit 🛠️

!Minecraft !Build Version !Kotlin !License

SwissKnife is a tailored utility plugin for PaperMC built to solve a specific problem: the lack of flexibility in existing notification tools.

Developed to meet the unique demands of a production server, it combines essential alerts and player guidance tools into a single, highly customizable package.

✨ Features

• Custom Welcome System: Greet players with fully customizable Titles, Subtitles, and Chat messages upon joining.

• Dynamic BossBar & Death Compass:

  • Displays a custom BossBar message.
  • Features a built-in compass pointing to the player's last 5 death locations.
  • Smart Priority: The BossBar automatically hides during Boss fights or Raids to keep the focus on the action.

• Scheduled Restart Alerts: Set up automated countdowns and messages for server maintenance, updates, or backups.

  • Note: This handles the notifications only; actual restarts should be managed via Cron or Pterodactyl schedules.
  • Modern Formatting: Full support for MiniMessage (rich colors/events) and PlaceholderAPI integration for all messages.

🛠️ Requirements

• Server: PaperMC (Recommended version: 26.1.2)
• Dependency: GriefPrevention (Required)

🚀 Installation

1. Download the latest .jar from the releases page.
2. Ensure PlaceholderAPI is installed on your server.
3. Drop the swissknife.jar into your /plugins folder.
4. Restart or reload the server.

⌨️ Commands

Command	Description	Permission
/swissknife reload	Reload config file.	Admin

⚙️ Configuration

The configuration file will be generated at plugins/SwissKnife/config.yml.

Everything in SwissKnife is designed to be personalized. You can toggle modules on or off and adjust every string to match your server's style using the config.yml

This plugin supports MiniMessage (Adventure) tags for rich text formatting and internal placeholders for dynamic information.

# welcome alerts settings
welcome:
  enabled: true
  title: "<gold>Server <aqua>Name"
  subtitle: "<gray>Welcome <white>%player_name%</white>!"
  message: |
    <green>Welcome back to the server, <white>%player_name%!
    <gold>• <yellow>Use <gold>/home <yellow>to return to your base.
    <gold>• <yellow>Use <gold>/claim <yellow>to protect a new territory.
    <gold>• <yellow>Join our <gold>Discord <yellow>to report any issues!
    <aqua>[NOTICE] <white>This server may have players recording or streaming.
    <gray>Please avoid sharing personal info or using inappropriate language.

restart alerts settings

restart: enabled: true schedules: - "3:00" - "12:00" - "18:19" alerts: [1800, 600, 60, 30, 10, 3, 2, 1] messages: minutes: "The server will restart in # minutes!" minute: "The server will restart in # minute!" seconds: "The server will restart in # seconds!" second: "The server will restart in # second!" restarting: "Restarting now..."

hud settings

hud:

action bar settings

actionbar: enabled: true message: "Next restart at %swissknife_restarttime_formated%"

boss bar settings

bossbar: enabled: true message: "Player: %player_name% ❤ %player_health_rounded%" hide-during-raids: true hide-near-bosses: true compass: enabled: true north: icon: 'N' color: "" south: icon: 'S' color: "" east: icon: 'E' color: "" west: icon: 'W' color: "" divider: value: " - - | - - " color: "" waypoints: death: enabled: true icon: '☠' color: "" despawn-time: 1800 messages: death: "#I %player_name% died at location #X #Y #Z (#W)." near: "You are close to your items!" waypoint: enabled: false icon: 'V' note: "TODO" spawn: enabled: false icon: '#' node: "TODO"

## 🏗️ Development
Built with **Kotlin** for the Paper API.

### Build from source:
```bash
# Clone the repository
git clone https://github.com/alexribeirodesa/paper-swissknife.git

# Build with Gradle
./gradlew build

☕ Support the Project

If this plugin helps your server, consider supporting its development!

Every coffee helps me keep the "Paper Projects" series updated and free.