---

🌟 Overview

mSurvival is the definitive lightweight core designed for modern Survival servers (1.21.11). Built with performance in mind, it consolidates all the essential survival features into a single, modular plugin.

Tired of installing multiple plugins for homes, spawn, RTP, and utility commands? mSurvival replaces them all with a clean, optimized, and fully translatable system, reducing clutter while keeping your server fast and efficient.

✨ Features

• 🏠 Home GUI System: Manage homes through an intuitive menu.

  • Left-click to teleport
  • Right-click to delete
  • Configurable max homes

• 🌍 Spawn System: Set a global spawn with /setspawn and teleport players instantly with /spawn.

• 🎲 Async RTP: Safe random teleport that finds a valid location before teleporting (no lag spikes).

• 🎮 Gamemode Commands: Quick commands (/gmc, /gms, /gma, /gmsp) with player targeting support.

• 🔙 Back System: Return to your last location after teleport or death using /back.

• 🗑️ Trash GUI: 54-slot inventory to safely delete unwanted items (/trash).

• ⚙️ Modular System: Enable or disable every feature directly from the config.

• 🌐 Fully Translatable: All messages are editable in messages.yml.

• 🎨 Color Support: Supports both classic (&) and HEX colors (&#RRGGBB).

• 🚀 Lightweight & Optimized: Built for modern Paper servers with zero performance impact.

📥 Installation

1. Download the mSurvival.jar file and place it into your server's plugins folder.
2. Restart your server.
3. Configure settings in config.yml.
4. Customize messages in messages.yml.

---

⚙️ config.yml

The main configuration file handles all technical settings and module toggles:

Click to view default config.yml

# mSurvival - Configuration File
# This file contains ONLY technical settings.

modules:
  gamemode: true
  spawn: true
  home: true
  back: true
  rtp: true
  trash: true

spawn:
  world: world
  x: 0.5
  y: 64.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0

home:
  max-homes: 3

rtp:
  radius: 5000
  min-radius: 100
  max-attempts: 20

---

🌐 messages.yml

This file contains all plugin messages and supports full color customization:

Click to view default messages.yml

# mSurvival - Messages File
# Supports & color codes and &#RRGGBB hex colors.

prefix: "&8[&b&lmSurvival&8] "
no-permission: "&cYou don't have permission to do that."
player-only: "&cThis command can only be used by players."
player-not-found: "&cPlayer '&e{player}&c' not found or not online."
module-disabled: "&cThis module is currently disabled."

# --- Gamemode ---
gamemode:
  set-self: "&aYour gamemode has been set to &e{mode}&a."
  set-other: "&aSet &e{player}&a's gamemode to &e{mode}&a."
  set-other-notify: "&aYour gamemode was set to &e{mode} &aby &e{sender}&a."
  invalid: "&cInvalid gamemode. Use: 0/creative, 1/survival, 2/adventure, 3/spectator."

# --- Spawn ---
spawn:
  set: "&aSpawn location has been set!"
  teleported: "&aYou have been teleported to spawn."
  not-set: "&cSpawn location is not set. Ask an admin to use /setspawn."

# --- Home ---
home:
  set: "&aHome '&e{home}&a' has been set!"
  deleted: "&aHome '&e{home}&a' has been deleted."
  teleported: "&aTeleported to home '&e{home}&a'."
  max-reached: "&cMaximum number of homes reached (&e{max}&c)."
  gui:
    title: "&8&lYour Homes"
    item-name: "&b{home}"
    item-lore:
      - "&7Left-click to &aTeleport"
      - "&7Right-click to &cDelete"

# --- Other ---
rtp:
  searching: "&eSearching for a safe location..."
  teleported: "&aTeleported to a random location!"
back:
  teleported: "&aReturned to your previous location."
trash:
  title: "&8&lTrash"

---